【プラン案内】
本レシピはStandardプラン以上の有償プランでご利用いただけます。ご利用をご希望の場合は、下記よりお問い合わせください。
【レシピ概要】
CSVファイルを変換してCSVファイルまたはTEXTファイルを出力する方法を解説します。
【前提条件】
変換対象となるCSVファイルをあらかじめご用意のうえ、ActRecipeの「ファイル一覧」よりアップロードしてご利用ください。
1. マイレシピへの登録
- メニューの「シェアレシピ」から、「汎用コンバーター」にチェックを入れ、画面下にある登録ボタンをクリックします。
- 続いて「マイレシピ」から、操作メニューより「編集」を選択します。
参考:シェアレシピ・マイレシピとはなんですか? - ヘッダーでは、レシピ名とレシピ説明を変更することができます。
参考:レシピヘッダーでは何を設定すれば良いですか?
2. コンバートの設定
このレシピでは「コンバート設定」タスクのみを設定します。
「コンバート設定」タスクでは、データマッピングや出力ファイルフォーマットを指定することができます。主な設定項目は以下の通りです。
- データファイル:変換対象となるCSVファイルをあらかじめ「ファイル一覧」よりアップロードし、該当のファイルを選択します。
【入力設定】
| 設定項目 | 設定内容・仕様 |
|---|---|
| 文字コード | 入力ファイル(変換元ファイル)の文字コードを選択します(デフォルトは UTF-8 です)。 |
| 区切り文字 | 入力ファイルの区切り文字を入力します(デフォルトはカンマ , です)。 |
| ヘッダーを無視しない | 入力ファイルのヘッダー行を無視せずに処理するかどうかを指定するスイッチです。 ※ この設定によって後述します「出力指定」の指定方法が異なりますのでご注意ください。 |
| データ開始行 | データの読み込みを開始する行番号を指定します(ヘッダー無しの場合は 0 を指定します)。 |
【入力フィルター】
入力フィルターでは、データファイルから選択したインポートファイルの連携項目を任意の条件に基づいて絞り込むことが可能になります。フィルタ項目の増減は下部の「(+)」アイコン、または、右側の「(-)」アイコンより行っていただけます。
| 設定項目 | 設定内容・仕様 |
|---|---|
| 入力項目 | インポートファイルのヘッダー名を指定します。 |
| 条件 | 以下の条件の内いずれかを指定します。 ・次に等しい:入力項目で指定した項目が、以下の”値”にて指定した値と等しい場合に出力します。 ・次に等しくない:入力項目で指定した項目が、以下の”値”にて指定した値と等しくない場合に出力します。 ・が空:入力項目で指定した項目が、空欄である場合に出力します。 ・が空ではない:入力項目で指定した項目が、空欄ではない場合に出力します。 |
| 値 | 絞り込みたい条件に基づき値を入力します。「XXXX, YYYY」のようにカンマ区切りで入力することで、複数の値を一括で指定することも可能です。 |
| AND・OR | 複数の条件を「かつ(AND)」「または(OR)」で組み合わせることができます。 条件行の左右に「( 」および「 ) 」のプルダウンから条件のグルーピングもでき、「(A かつ B) または (C かつ D)」といった、特定の条件をグループ化して優先させる複雑な絞り込みも可能です。 ※対応可能なネストは1階層(括弧は一重)までです。( ) によるグルーピングは可能ですが、(( )) のように括弧を二重に設定することには対応しておりませんのでご注意ください。 |
【出力設定】
| 設定項目 | 設定内容・仕様 |
|---|---|
| 出力ファイル種別 | 出力ファイルの種類を「CSV」または「TEXT」から選択します。 |
| ヘッダー出力する/しない | 出力ファイルのヘッダーの有無を選択します。 |
| 文字コード | 出力ファイルの文字コードを「UTF-8」「SHIFT_JIS」「SHIFT_JIS (CP932)」から選択します。 |
| 区切り文字 | 出力ファイルの区切り文字を設定します。 |
| クォート | 出力ファイルデータについて「"文字列"」のようにクォートを付与する対象を選択します。 |
| 桁数を超える処理 | 下記の「出力フォーマット」において、指定した桁数を超過した場合の処理を選択します。 |
【出力フォーマット】
出力フォーマットでは、入力ファイルを用いてどのようなアウトプットとするかを決定します。マッピング項目の増減は下部の「(+)」アイコン、または、右側の「(-)」アイコンより行っていただけます。
| 設定項目 | 設定内容・仕様 |
|---|---|
| 項目名 | 出力ファイルのカラム名を入力します。 「ヘッダーあり」を選択している場合、項目名に特定の特殊文字列( _BLANK_ / _NULL_)を指定することで、ヘッダー行の出力形式(空欄出力またはカンマも含めた省略)を制御できます。連携先システムのフォーマット要件(通常のCSV形式、または複数レコード形式等の特殊なCSV形式)に合わせて使い分けてください。👉 特殊文字列(_BLANK_・_NULL_)の設定例・出力イメージはこちら |
| 型 | 出力ファイルの型を指定します。 |
| 桁数 | 出力ファイル項目に桁数制限がある場合は桁数を数字で入力します。 |
| 出力区分 | 出力ファイルにどのような値を使用するかを選択します。 ・固定値:「出力指定」に指定された値をそのまま出力します。 ・参照:「出力指定」に指定された入力ファイルのカラム番号の値を出力します(例:「 #(1)」と指定した場合は入力ファイルの1カラム目が出力されます)。・計算式:Excelとほぼ同様の関数の指定によって出力値を定めることができます(例:「 #(1)&#(2)」と指定した場合はカラム1,2が結合された値が出力されます)。また、参照ファイルデータの情報を集計できる「集計関数(SUM, AVERAGE, MAX, MIN, COUNT)」も利用可能です。👉 集計関数の詳細・計算式サンプルはこちら |
| 出力指定 |
上記の「出力区分」に合わせて出力内容を記入します。その際、利用するファイルの種類により、入力形式が以下のように異なります。 【ユースケース】 入力ファイルから取得した部門を、ファイル一覧内の”変換表(マッピングCSV)”を参照して、部門コードに変換 【計算式】 IFS( #(部門) = $(362025:"部門"), $(362025:"部門コード"), TRUE, "該当なし" ) |
項目名の特殊文字列(_BLANK_・_NULL_)の設定例・出力イメージ
■ _BLANK_:値は出力せず、カンマのみ出力します(空欄カラム)
設定例と出力イメージ:
_BLANK_ を設定した場合の出力ファイルはテキストエディタ等の編集時において、以下のように表示されます。
社員番号,姓,名,,, 111,田中,太郎,項目Aの値,項目Bの値,項目Cの値 222,山田,次郎,項目Aの値,項目Bの値,項目Cの値 333,佐藤,三郎,項目Aの値,項目Bの値,項目Cの値 ・ ・ ・
■ _NULL_:値もカンマも出力しません(完全に省略)
設定例と出力イメージ:
_NULL_ を設定した場合の出力ファイルはテキストエディタ等の編集時において、以下のように表示されます。
社員番号,姓,名 111,田中,太郎,項目Aの値,項目Bの値,項目Cの値 222,山田,次郎,項目Aの値,項目Bの値,項目Cの値 333,佐藤,三郎,項目Aの値,項目Bの値,項目Cの値 ・ ・ ・
集計関数(SUM・AVERAGE・MAX・MIN・COUNT)の利用方法と計算式サンプル
コンバート設定の計算式においては、参照ファイルデータの情報を集計できる「集計関数」も利用可能です。
【利用可能な集計関数】
・SUM(合計)
・AVERAGE(平均)
・MAX(最大値)
・MIN(最小値)
・COUNT(件数)
【計算式の一例】
特定の取引先の金額を自動抽出し、合計を算出するケース:
計算式:SUM(FILTER([ファイル番号]:"金額"), $([ファイル番号]:"取引先コード") = #(取引先コード)))
以下は、あらかじめ「取引明細」のデータを参照ファイルに保存しておき、入力ファイルの変換時に特定の取引先コードをキーにして金額を合計する例です。
① 参照ファイルの例
② 入力ファイルの例
③ 上記の計算式を適用した「出力結果」
・入力ファイルが 取引先コード "A" のとき → 300(100 + 200 の合計)
・入力ファイルが 取引先コード "B" のとき → 30
・入力ファイルが 取引先コード "Z" のとき(一致なし) → #VALUE!
※ 一致なしの際のエラーを回避したい場合は、FILTER関数の第3引数(fallback)に "0" を指定することで 0 を出力させることも可能です。
その他計算式のサンプルは下記ページをご覧ください。
参考:計算式サンプル
【重要】データコンバート設定時の必須ルール
※ ActRecipeのコンバート処理は、設定画面の定義順(上から順番)にデータを上書き更新しながら実行されます。
予期せぬエラーやデータ不整合を防ぐため、設定の際は必ず以下の2点をご遵守ください。
■ 1. 項目名の重複禁止
同じ項目名を複数作ると、すべて同じ値に上書きされます。
-
NG例(項目名は一例です):以下のように全ての項目名を同一名で定義
➔ 最後の#(部署3)により上書きされ、全ての部署が同一名として出力されます。 -
OK例(項目名は一例です):出力項目名をすべて「一意(ユニーク)」に定義
➔ それぞれの#(部署〇)が出力されます。
■ 2. 項目名に「元データの項目名」を使用しない
連携元データのヘッダーの項目名をそのままに、値だけ変換し、以下のように #(項目名) を指定すると、連携元データの項目名の値ではなく、変換後の項目名の値を参照してしまい、後続の計算や変換で「#ERROR!」や変換不具合が発生します。
-
NG例(項目名は一例です):
1. 「入社年月日」を和暦(2019年11月07日)に変換し、出力項目名も「入社年月日」にして上書きする。
➔ 元データ(2019-11-07)が消え、ただの「文字列」に変わる。
2. 後続の「入社年数(DATEDIF)」で#(入社年月日)を参照する。
➔ 文字列を計算しようとするため計算エラー(#ERROR!)になる。 -
OK例①(項目名は一例です):出力項目名(ヘッダー名)を変更する
変換後の出力項目名を「入社日」や「生年月日_変換後」などの「別名」に指定します。
➔ 元データが上書きされずに残るため、すべての計算や変換が正常に動作します。 -
OK例②(項目名は一例です):コンバート設定の順番を入れ替える
計算(DATEDIF等)を行う項目を、上書き変換(和暦変換等)を行う項目よりも「上(前)」に配置してください。
※ 出力指定の条件指定方法のサポートは有償プランにて承っております。詳しくはお問い合わせください。
【出力フィルター】
出力フィルターでは、出力フォーマットによって出力されたファイルを任意の条件に基づいて絞り込むことが可能になります。フィルタ項目の増減は下部の「(+)」アイコン、または、右側の「(-)」アイコンより行っていただけます。
| 設定項目 | 設定内容・仕様 |
|---|---|
| 括弧 ( ) | 複数の条件をグループ化して優先順位を指定できます。各条件行の左端に開始括弧「(」、右端に終了括弧「)」を設定できます。 ※ 対応可能なネストは1階層(括弧は一重)までです。( ) によるグルーピングは可能ですが、(( )) のように括弧を二重に設定することはできません。 |
| 出力項目 | 出力フォーマットにて設定した項目を指定します。 |
| 条件 | 以下の条件の内いずれかを指定します。 ・次に等しい:出力項目で指定した項目が、以下の”値”にて指定した値と等しい場合に出力します。 ・次に等しくない:出力項目で指定した項目が、以下の”値”にて指定した値と等しくない場合に出力します。 ・が空:出力項目で指定した項目が、空欄である場合に出力します。 ・が空ではない:出力項目で指定した項目が、空欄ではない場合に出力します。 |
| 値 | 絞り込みたい条件に基づき値を入力します。「営業部, 開発部」のようにカンマ区切りで入力することで、複数の値を一括で指定することも可能です。 |
| AND・OR | 複数の条件を「かつ(AND)」「または(OR)」で組み合わせることができます。複数の条件を設定した場合、上から順番に1つずつ評価(直列評価)されます。 例:条件A AND 条件B OR 条件C は、(条件A かつ 条件B) または 条件C として処理されます。 【例】 ・ 条件A AND ( 条件B OR 条件C ) → 条件Aを満たし、かつ「条件Bまたは条件Cのどちらか」を満たすデータを出力します。・ ( 条件A AND 条件B ) OR ( 条件C AND 条件D ) → 「条件AとBの両方」を満たす、または「条件CとDの両方」を満たすデータを出力します。 |
「コンバート設定」タスクで設定した値は、ダウンロード/アップロードアイコンによって設定ファイル(JSONファイル)の保存や再利用ができます。
各項目の入力が完了しましたら「保存」ボタンでタスクを保存します。
3. レシピを実行する
マイレシピの操作メニューより「実行」を選択することでレシピを実行できます。
(自動実行についてはこちらをご参照ください)
画面イメージや履歴の確認方法は以下をご参照ください。
参考:レシピを実行するにはどうすれば良いですか?
レシピの実行結果は「レシピ実行履歴」よりご確認いただけます。
また、レシピによって変換されたファイルは「ファイル一覧」に保存されます。
サポート・有償プラン・関連リンクについて
-
有償プランについて
本レシピはStandardプラン以上の有償プランでご利用いただけます。料金プランは下記をご覧ください。
ActRecipeの料金プラン