request.txt ファイルの作成
バイナリ型の添付ファイルの読み込みでは、バッチは zip にまとめられます。この zip には、バイナリ型の添付ファイルへの参照が含まれた request.txt という名前のファイルが、CSV または XML いずれかの形式で格納されます。バイナリ型添付ファイルそれ自体も格納されます。バイナリ型の添付ファイルを含まない CSV または XML バッチファイルとの違いに注意してください。こうしたバッチファイルでは、zip や request.txt ファイルは必要ありません。
request.txt ファイルは zip のベースディレクトリに格納されます。バイナリ型の添付ファイル自体は、ベースディレクトリに格納することも、サブディレクトリに整理して格納することもできます。request.txt ファイルは、zip に格納されたバイナリ型の添付ファイルのマニフェストファイルであり、バイナリ型の添付ファイルを参照する各レコードのデータを保存します。
添付ファイルオブジェクトでは、次の項目を適切な表記で記述することが非常に重要です。
- Name: バイナリ型の添付ファイルのファイル名を記述します。バッチに含める添付ファイルについて、一意の名前を取得するもっとも簡単な方法は、ベースディレクトリからバイナリ型の添付ファイルへの相対パスを使用することです。たとえば、attachment1.gif または subdir/attachment2.doc です。
- Body: バイナリ型の添付ファイルへの相対パスの先頭に # 記号を付けて記します。たとえば、#attachment1.gif または #subdir/attachment2.doc です。
- ParentId: 添付ファイルの親レコード (取引先、ケースなど) を表す ID を記述します。
バッチファイルには、上記以外の添付ファイルオブジェクトの項目 (例: Description など) も含めることができます。詳細は、「Attachment」を参照してください。
サンプルの CSV request.txt ファイル
次に示す CSV のサンプルファイルには、添付ファイルオブジェクトの 2 つのレコードが含まれています。1 つ目のレコードは、zip ファイルのベースディレクトリにあるバイナリ型の添付ファイル attachment1.gif を参照しています。2 つ目のレコードは、zip ファイルのサブディレクトリ subdir にあるバイナリ型の添付ファイル attachment2.doc を参照しています。ParentId 項目を見ると、どちらの添付ファイルレコードも親レコードとして取引先を参照していることがわかります。なお、Account ID の部分は、親となる取引先レコードの Id によって置き換えます。
サンプルの XML request.txt ファイル
次に示す XML のサンプルファイルには、先ほどの CSV のサンプルファイルと同じ 2 つのレコードが含まれています。