データのステップ

データのステップは、表形式のデータを Docwize に取り込みます。インポート用のステップは、ワークフローの文書や API の応答を読み込んで表にします。CF挿入ステップ は、その表をカスタムフィールドテンプレートに書き込みます。SPタスク はデータベースのプロシージャーを実行し、スキャンリクエストステップ はバーコードや QR コードのスキャン結果を取り込みます。いずれもパレットの ツール＆タスク カテゴリーにあります。

ステップ	用途
Excelインポートステップ	ワークフローの Excel 文書を読み込んで表にします。
CSVインポートステップ	ワークフローの CSV 文書を読み込んで表にします。
JSONからデータフレーム	APIステップ の JSON 応答を表にします。
CF挿入ステップ	表をカスタムフィールドテンプレートに書き込みます。
SPタスク	登録済みのストアドプロシージャーを実行します。
スキャンリクエストステップ	スキャンを待ち、読み取った値をカスタムフィールドに保存します。

ステップ間で表を受け渡す仕組み

接続線はデータを運びません。表を受け取る側のステップ（CF挿入ステップ または JSONからデータフレーム）は、直前に接続されたステップが保存した表を読み込みます。そのため、次のようにします。

• 受け取る側のステップは、表を作ったステップに直接つなぎ、間にほかのステップを挟まない
• 受け取る側のステップへの接続は、ちょうど 1 本にする

よく使う組み合わせ：

• Excelインポートステップ → CF挿入ステップ
• CSVインポートステップ → CF挿入ステップ
• APIステップ → JSONからデータフレーム → CF挿入ステップ
• APIステップ → CF挿入ステップ
• Webhookステップ → CF挿入ステップ

Excelインポートステップ

Excelインポートステップ

カードには Excel Importer と表示されます。ワークフローの文書（Excel ブックであることが必要）を読み込み、次のステップのために表にします。文書は取り込みません。鉛筆アイコンで設定を開きます。シート名 を設定するまで、ステップには 設定エラー と表示されます。

Excelインポートステップを編集

セクション	説明
シート設定	シート名、ヘッダー行インデックス（0 が 1 行目）、ヘッダー行なし（1行目からデータ）。インポートウィザードを開く を選ぶと、ブラウザーでサンプルのブックを読み込み、これらの項目と列の一覧を自動で入力します。
列データタイプ	列をテキスト、数値、日付、ブール値のいずれかに設定します。テキストにすると先頭のゼロが残ります。日付には書式を指定できます。
行除外ルール（正規表現）	列の値がパターン（^Total など）に一致する行を除外します。
停止トリガー（正規表現）	列の値がパターンに最初に一致した行で、読み込みを止めます。
変換ステップ	仮想キー生成 で、複数の列を結合して新しいキー列を 1 つ作ります。

• シート名 を空にすると、最初のシートを読み込みます。
• 停止トリガーは、除外ルールより先に適用されます。

CSVインポートステップ

CSVインポートステップ

カードには CSV Importer と表示されます。ワークフローの CSV 文書を読み込み、次のステップのために表にします。

CSVインポートステップ設定

ダイアログには 設定ステータス が表示されます。設定は、ウィザードを開く で開くウィザードで行います。

CSV インポートのウィザード

パース設定 では、デリミター、開始行、1 行目をヘッダーとして扱うかどうか、重複したヘッダーの扱い、前後の空白の除去、停止に使う列とパターン、空文字列をnullに変換（既定でオン）を設定します。続くウィザードのスキーマの手順では、取り込む列を選び、列名を変え、データ型を設定し、複数の元の列を 1 つにまとめられます。

• ウィザードを使わなくても、ステップは実行されます。その場合は、カンマ区切り、UTF-8、ヘッダーありとして読み込みます。
• CF挿入ステップ では、取り込む列を、スキーマの手順で付けた名前で対応付けます。スキーマの手順で名前を変えていない列は、CSV のヘッダー名で対応付けます。重複したヘッダーは name_1、name_2 のようになります。

JSONからデータフレーム

JSONからデータフレームステップ

直前に接続されたステップの JSON 応答を表にします。接続されたステップがちょうど 1 つで、それが APIステップ、Webhookステップ、Forge のステップ、Excelインポートステップ、CSVインポートステップ、別の JSONからデータフレームステップ、バッチ収集のいずれかでない場合、ステップには 設定エラー と表示されます。ネストされたキー には、データまでのドット区切りのパス（例：data.items）を指定します。オブジェクトは 1 行になり、リストは項目ごとに 1 行になります。

• ネストされたキー を空にすると、応答全体をそのまま読み込みます。
• 見つからないパスはエラーにならず、空の表になります。実際の応答で確認してください。

CF挿入ステップ

CF挿入ステップ

直前のステップの表を、ワークフローの文書のカスタムフィールドテンプレートに書き込みます。鉛筆アイコンで設定を開きます。

カスタムフィールド挿入ステップを編集

設定	説明
テーブル名	カスタムフィールドテンプレート。View_CF_DOCS Goods Receipt のように、ビュー名で表示されます。
仮想主キー	行を識別する列。書き込み先の列名で指定します。1 つずつ入力して Enter キーを押します。
挿入タイプ	挿入 は新しい行だけを追加し、既存の行はそのまま残します。アップサート は新しい行を追加し、既存の行を更新します。ドロップして更新 はアップサートと同じ処理に加えて、表に含まれない行を削除します。
グリッドとして挿入	ワークフローの文書ではなく、テンプレートの共有グリッドに書き込みます。
マッピング	ソース列 から ターゲット列 への対応付け。マッピングを追加 または Excelからインポート で追加します。元の列が見つからないとステップは失敗します。ただし、そのマッピングが 任意 の場合は失敗しません。

• キーの列はすべて対応付け、仮想主キー にも指定してください。キーが空の行はスキップされます。
• ドロップして更新 は、表にすべての行がそろっている場合にだけ選んでください。
• 2 つのマッピングで書き込み先の列が同じ場合は、カードに警告が表示されます。使われるのは最後のマッピングだけです。

SPタスク

SPタスクステップ

カードのタイトルは SP Job です。SPジョブ設定 で選んだストアドプロシージャーまたはデータベース関数を実行し、次に進みます。実行中、ワークフローは待機します。

プロシージャーは、Docwize がワークスペースのデータベースに登録します。登録用の画面はなく、登録されるまで一覧は空です。SQL Server では、@dw_id パラメーターを宣言したプロシージャーに、ワークフローの文書の ID が渡されます。SPジョブ設定 を空にすると、このステップは失敗します。

スキャンリクエストステップ

スキャンリクエストステップ

誰かがワークフローのアクションからバーコードまたは QR コードをスキャンするまで（スキャン開始 を選び、USBスキャナー または カメラスキャナー を選択）、ワークフローを一時停止します。読み取った値はカスタムフィールドに保存され、ワークフローは次に進みます。カスタムフィールドテンプレートとフィールドを選ぶまで、ステップには 設定エラー と表示されます。

スキャンリクエストステップを編集

設定	説明
スキャンメッセージ	スキャンする人に表示する指示。
スキャンヘルプメモ	スキャンメッセージと一緒に表示する補足の説明。
入力タイプ	USBスキャナーのみ または カメラのみ にすると、その方法でしかスキャンできません。スキャンする人が選択（既定）では、両方を選べます。
カスタムフィールドテンプレート / カスタムフィールドテンプレートフィールド	スキャンした値の保存先。
カスタムフィールドテンプレート日付フィールド	任意。スキャンした日時が入ります。
スキャンごとに新しい行を追加	オフ（既定）では、最初のスキャンで行が追加され、以降のスキャンはその行を上書きします。オンにすると、スキャンのたびに新しい行が追加されます。

関連する設定

• 連携のステップ：APIステップ
• フロー制御のステップ：Webhookステップ
• ワークフローのステップ：キャンバスとパレット