この画面では、申請APIや申請インポート画面でCSVを取り込む際に使用する申請API設定レコードを作成し、CSVのどの列をフォームテンプレートのどの入力欄に入れるかを設定します。
1. 設定方法
1. Salesforce の標準新規レコード画面で、レコード名・フォームテンプレート・設定キーを設定して保存する
標準の新規レコード画面UIから次の項目を設定します。
ここでは例として、サンプル値列に記載している値を設定して新規レコードを作成します。
| 項目 | 内容 | サンプル値 |
|---|---|---|
| レコード名 | 管理用の名前 | 基幹システム_申請取込 |
| フォームテンプレート | この設定で使うフォームテンプレート | 基幹システム取込用申請テンプレート |
| 設定キー | この申請API設定レコードを特定するための一意なキー | CORE_SYSTEM_IMPORT |
2. リストビューから1で作成した申請API設定レコードを選択して、レコードの編集画面に遷移する
1で作成した申請API設定レコードを開くと、マッピング設定の編集画面が表示されます。
3. CSVを読み込んで列名を取り込む
「ファイルをアップロード」から、この申請API設定で実際に取り込む予定のCSVファイルと同じヘッダー行（1行目）を持つCSVファイルをアップロードします。アップロードするCSVファイルは、次の条件を満たしている必要があります。満たしていない場合はエラーメッセージが表示され、列名は取り込まれません。
- 拡張子が
.csvであること - 1行目に列名（ヘッダー行）が含まれていること
- 列名に重複がないこと
- 区切り文字がカンマ（
,）であること
ここで読み込んだCSVファイルは、マッピングに使う列名の確認にのみ使用されます。必要なのは1行目の列名の情報だけなので、2行目以降のデータ行はあってもなくてもマッピング設定には影響しません。
たとえば以下の形式のようなCSVを読み込むと、画面右側の選択肢としてCSVのヘッダー行の値が表示されます。
受付番号,申請作成日,申請者氏名,所属部署,申請者メール,申請区分,タイトル,内容詳細,処理希望日,支払先名,税込金額,消費税額,支払予定日,連携元ID,連携メモ APP-202606-001,2026/06/01,山田太郎,営業部,yamada.taro@example.co.jp,支払申請,備品購入費支払申請,6月分の備品購入費を支払申請します,2026/06/30,株式会社サンプル商事,55000,5000,2026/07/31,CORE-0001,初回取込データ APP-202606-002,2026/06/03,佐藤花子,管理部,sato.hanako@example.co.jp,経費申請,出張旅費精算申請,大阪出張分の旅費を申請します,2026/06/28,株式会社新大阪ホテル,33000,3000,2026/07/25,CORE-0002,旅費精算データ
4. 各入力欄に対応するCSV列を選ぶ
画面左側にはフォームテンプレートの項目が表示され、右側にはCSV項目の選択欄が表示されます。各項目のプルダウンで対応するCSV列を選び、必要に応じてページ切替や項目検索を使って設定します。以下は「申請番号」に「受付番号」、「申請日」に「申請作成日」、「申請者名」に「申請者氏名」を対応付けた例です。
5. 先頭行の扱いを設定する
「先頭行を無視する（REST API CSV取り込み時）」チェックボックスで、申請データ作成時にアップロードされるCSVの1行目をヘッダー行として読み飛ばすかどうかを設定します。この設定は、申請APIによる取り込みと申請インポート画面からの取り込みの両方に適用されます。
| 設定 | 1行目の扱い | CSV列とのマッピング方法 |
|---|---|---|
| チェックあり | ヘッダー行として読み飛ばし、2行目以降を取り込む | 1行目の列名で対応付ける |
| チェックなし | 1行目から申請データとして取り込む | この画面で読み込んだCSVの列の並び順で対応付ける |
ヘッダー行を含むCSVを取り込む運用の場合は、必ずチェックをオンにしてください。オフのまま取り込むと、ヘッダー行も1件の申請データとして作成されます。
チェックがオフの場合、列の対応付けはこの画面でアップロードしたCSVの列順に依存します。取り込むCSVの列の順序や数を変更した場合は、マッピング設定を見直してください。
6. 保存する
編集が終了したら、画面右上の保存ボタンを押します。
保存ボタンは、編集画面のいずれかの入力欄に変更がある場合だけ有効になります。
2. エクスポートとインポート
申請API設定レコードは、1で設定した「フォームテンプレート」と一緒にエクスポート/インポートされます。
フォームテンプレートのエクスポート/インポート方法については、フォームテンプレートの新規作成・複製 – カミレス – リファレンスを確認してください。
フォームテンプレートのエクスポート/インポート方法については、フォームテンプレートの新規作成・複製 – カミレス – リファレンスを確認してください。