メッセージに添付ファイルを追加する

メッセージには複数のパートがあり、それぞれが独自のコンテント・タイプを持ち、異なるデータを持つ可能性があります。テキストと添付ファイルを組み合わせるなど、これらの異なるパーツを1つのリクエストで送信することができます。マルチパートメッセージを送信するには、まずメッセージに添付ファイルのパーツを追加する必要があります。以下のオプションを使用できます：

ペイロードタブで
ファイル追加ボタンから

ペイロードタブから添付ファイルを追加します。

ペイロードタブにメッセージパートを直接追加するには、まずメッセージをマルチパートメッセージに変換する必要があります。変換したいメッセージを選択し、マルチパートアイコンを切り替えてください。

メッセージの部分を次のように追加します。

パーツの追加を選択します。
このような選択肢があります：
- プレーンテキスト部分をメッセージに含める場合は、コンテンツの入力を選択します。
- ファイルを送信する場合は、ファイルへのリンクを選択します。
添付ファイルを追加する
選択したオプションに応じて、次のように進みます：
- メッセージ部分の内容を入力し、「保存」をクリックします。
- 添付するファイルを選択し、「開く」をクリックします。
API Scan は自動的にファイルパスを追加し、ファイル形式に基づいて Content-Type フィールドに入力します。
必要に応じて、新しい部品の名前など、部品のプロパティを編集します。
メッセージにMTOMを使用したい場合は、MTOMを有効にしてください。

ボタンで添付ファイルを追加

添付ファイルを追加したいメッセージがまだマルチパートメッセージでない場合、ファイルの追加ボタンを使ってファイルを追加できます。それ以外の場合、ボタンは無効になります。

ファイルを追加するには、以下の手順に従ってください：

メッセージを選択し、ファイルを追加アイコンをクリックしてください。
ドロップダウンメニューから「添付ファイル」を選択します。

後続のダイアログで、添付したいファイルを選択し、「開く」をクリックします。

API Scan マルチパートビューに切り替わり、ファイルが新しいパートとしてペイロードに追加されます。API Scan は自動的にファイルパスを追加し、ファイル形式に基づいてContent-Typeフィールドに入力します。
必要に応じて、新しい部品の名前など、部品のプロパティを編集します。
メッセージにMTOMを使用したい場合は、MTOMを有効にしてください。

メッセージ伝送最適化メカニズム（MTOM）の使用

MTOMは、画像やPDFファイルなどのバイナリデータのウェブサービスとの送受信を最適化します。MTOMでは、バイナリデータはSOAPメッセージのペイロードには含まれず、Multipurpose Internet Mail Extension (MIME)添付ファイルとして送信されます。

メッセージにMTOMを使用するには、以下の手順に従ってください。

メッセージのマルチパートフレームを選択し、 MTOM を有効にしてください。

以下のMTOM情報を指定できます：
- MTOM-Content-Transfer-Encoding 。別の値を指定しない場合、 APIスキャンはバイナリを使用します。
- MTOM-Content-Type 。別の値を指定しない場合、 APIスキャンは multipart/related を使用します。
- Content-Disposition ヘッダーからファイル名のスターパラメータを省略するにはファイル名のスターを省略します。これは、WebサービスまたはClientアプリケーションがファイル名のスターパラメータを正しく処理できず、送信したメッセージを拒否する場合に役立ちます。

メッセージのメインパート項目を選択し、ペイロードに含まれるバイナリデータを含む添付ファイルへのリンクを入力してください。以下の参照を使用してください："<inc:Include href="cid:myfile.myfileextension" xmlns:inc="http://www.w3.org/2004/08/xop/include"/>" 。

例：

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:upl="http://UploadService">
    <soapenv:Header/>
    <soapenv:Body>
        <upl:UploadFile>
            <upl:messages>
                <upl:UploadFileMessage>
                    <upl:FileData><inc:Include href="cid:data.bin" xmlns:inc="http://www.w3.org/2004/08/xop/include"/></upl:FileData>
                    <upl:FileName>data.bin</upl:FileName>
                </upl:UploadFileMessage>
            </upl:messages>
        </upl:UploadFile>
    </soapenv:Body>
</soapenv:Envelope>
                                                            

マルチパートの項目とプロパティ

マルチパートビューには、これらのメッセージアイテムが一覧表示されます。

マルチパートフレームは、メッセージの内容をすべてのパートで表示します。
マルチパートメッセージの最初の部分であるメインパート。この部分は省略できません。
パーツ2からパーツ n まで、追加するパーツ数に応じて変化します。

追加された各パーツについて、以下のプロパティを編集できます：

プロパティ名	説明
パーツ名	パーツに新しい名前をアサインすることも、デフォルト名 Part <2-n>
ファイル名	添付ファイル名
処分タイプ	フォームデータやファイルアップロードなど、各部分の処分タイプを指定します。
コンテンツタイプ	Content-Typeは、使用するプロトコルとデータ形式によって異なります。
リンクファイル	添付ファイルのパスと名前。
パートをスキップ	テストランから一部をスキップする場合は、 Skip Part チェックボックスを選択します。メッセージをAPI テストケースとしてエクスポートすると、モジュール属性としてプロパティを追加することもできます。

添付ファイルにヘッダーを追加する

各パートのヘッダーを編集することができます。そのためには、以下の手順に従ってください。

編集したい添付ファイルの部分を選択してください。
ヘッダーセクションに移動し、適切な行をダブルクリックしてヘッダーを編集してください。

添付ファイルパーツの削除

削除したいパーツを選択し、「パーツの削除」をクリックします。子パートの番号は、削除されたパートの位置によって変わります。