> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arc.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# REST Connector

> すべてのHTTP メソッド、OAuth 2.0、ArcScript で駆動するURL とヘッダーをサポートし、RESTful API Web サービスを利用するための動的なREST リクエストを構築します。

export const TlsClientAuthentication = () => <>
    <p><em>双方向TLS 認証が必要な場合のクライアント認証に関する設定です。</em></p>

    <table>
      <thead>
        <tr><th>設定</th><th>説明</th></tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Private Certificate</strong></td>
          <td>TLS クライアント認証時に提示されるプライベート証明書です。</td>
        </tr>
        <tr>
          <td><strong>Certificate Password</strong></td>
          <td>TLS クライアント証明書にアクセスするために必要なパスワードです。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const CommonProxySettings = () => <>
    <p>これらは、接続のルーティング先となるプロキシを識別し認証するための一連の設定です。デフォルトでは、このセクションは<a href="/26.3/self-hosted/ja/getting-started/administration/settings/security">Security Settings</a> ページの<a href="/26.3/self-hosted/ja/getting-started/administration/settings/proxy-settings">Proxy Settings</a> 部分にあるグローバル設定を使用します。チェックボックスをオフにすると、コネクタ固有の設定を指定できます。</p>
    <table>
      <thead>
        <tr><th>設定</th><th>説明</th></tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Proxy Type</strong></td>
          <td>プロキシベースのファイアウォールで使用されるプロトコル。</td>
        </tr>
        <tr>
          <td><strong>Proxy Host</strong></td>
          <td>プロキシベースのファイアウォールの名前またはIP アドレス。</td>
        </tr>
        <tr>
          <td><strong>Proxy Port</strong></td>
          <td>プロキシベースのファイアウォールのTCP ポート。</td>
        </tr>
        <tr>
          <td><strong>Proxy User</strong></td>
          <td>プロキシベースのファイアウォールで認証するために使用するユーザー名。</td>
        </tr>
        <tr>
          <td><strong>Proxy Password</strong></td>
          <td>プロキシベースのファイアウォールで認証するために使用するパスワード。</td>
        </tr>
        <tr>
          <td><strong>Authentication Scheme</strong></td>
          <td>デフォルトの<strong>None</strong> のままにするか、次の認証スキームのいずれかを選択します：<strong>Basic</strong>、<strong>Digest</strong>、<strong>Proprietary</strong>、または<strong>NTLM</strong>。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const CommonActionType = ({resource = "script"}) => <>
    <p>このコネクタは、3 つのコネクタアクションタイプのいずれも実行できます。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>• <em>Trigger</em> は、スケジュールに基づいて{resource}を実行し、フローに送信するファイルを生成する場合があります。このアクションはフローの起点として機能します。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>• <em>Transform</em> は、フローからのメッセージを{resource}への入力として受け取り、出力を生成します。このアクションはフローの中間として機能します。</p>
    <p style={{
  paddingLeft: '1.5rem',
  marginTop: '0.25rem',
  marginBottom: '0.25rem'
}}>• <em>Terminal</em> は、フローからのメッセージを{resource}への入力として受け取り、フローの終端として機能します。</p>
  </>;

export const NameDescription = ({extraRows}) => <table>
    <thead>
      <tr>
        <th>設定</th>
        <th>説明</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><strong>Connector Id</strong></td>
        <td>コネクタの静的で一意の識別子です。</td>
      </tr>
      <tr>
        <td><strong>Connector Type</strong></td>
        <td>コネクタ名とその機能の説明を表示します。</td>
      </tr>
      <tr>
        <td><strong>Connector Description</strong></td>
        <td>コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。</td>
      </tr>
      {extraRows}
    </tbody>
  </table>;

export const SlasTab = ({siteName = "CData Arc"}) => <>
    <p><em>サービスレベルアグリーメント（SLA）の設定に関する設定です。</em></p>
    <p>
      SLA を使用すると、フロー内のコネクタが送受信すると見込まれるボリュームを設定し、そのボリュームを達成すると見込まれる期間を設定できます。{siteName} は、SLA が達成されない場合にユーザーへ警告するメールを送信し、SLA を<em>At Risk</em> としてマークします。これは、SLA が間もなく達成されない場合に<em>Violated</em> としてマークされることを意味します。これにより、ユーザーは介入してSLA が達成されない理由を特定し、適切な対応を取る機会を得られます。At Risk 期間の終了時点でもSLA が達成されない場合、SLA はviolated としてマークされ、ユーザーに再度通知されます。
    </p>
    <p>
      SLA を定義するには、<strong>Expected Volume</strong> をオンに切り替え、<strong>Settings</strong> タブをクリックします。
    </p>
    <img src="/public/images/sla_empty.png" alt="SLA Empty" />
    <ul>
      <li>コネクタに送信と受信の個別のアクションがある場合は、ラジオボタンを使用してSLA がどちらの方向に適用されるかを指定します。</li>
      <li>ウィンドウの<strong>Expect at least</strong> 部分で、次を設定します。
        <ul>
          <li>処理を見込む最小トランザクション数（ボリューム）を設定します。</li>
          <li><strong>Every</strong> フィールドを使用して期間を指定します。</li>
          <li>SLA を有効にするタイミングを指定します。<strong>Starting on</strong> を選択した場合は、日付および時刻フィールドを入力します。</li>
          <li>SLA を有効にしたい曜日のチェックボックスをオンにします。必要に応じて、ドロップダウンで<strong>Everyday</strong> を選択します。</li>
        </ul>
      </li>
      <li>ウィンドウの<strong>Set status to 'At Risk'</strong> 部分で、SLA をAt Risk としてマークするタイミングを指定します。
        <ul>
          <li>デフォルトでは、SLA が違反状態になるまで通知は送信されません。これを変更するには、<strong>Send an 'At Risk' notification</strong> をオンにします。</li>
        </ul>
      </li>
    </ul>
    <p>
      次の例は、月曜日から金曜日まで毎日1000 件のファイルを受信すると見込むコネクタ向けに設定されたSLA を示しています。1000 件のファイルが受信されていない場合、期間の終了の1時間前にAt Risk 通知が送信されます。
    </p>
    <img src="/public/images/sla_defined.png" alt="SLA Configuration Example" />
    <Note>
      必要に応じてSLA アラートをオフにすることができます。これはメンテナンスウィンドウ中に役立ちます。navbar で<strong>Settings</strong> をクリックし、<strong>Alerts &gt; General Alerts</strong> に移動します。タブレットと鉛筆のアイコンをクリックして編集し、<strong>SLA Alerts</strong> 設定のチェックを外します。
    </Note>
  </>;

export const AlertsTab = ({siteNameShort = "Arc"}) => <>
    <p><em>アラートの設定に関する設定です。</em></p>
    <p>
      サービスレベルアグリーメント（SLA）を実行する前に、通知用のメールアラートをセットアップする必要があります。デフォルトでは、{siteNameShort} は<a href="/26.3/self-hosted/ja/getting-started/administration/settings/alerts">Alerts</a> タブのグローバル設定を使用します。このコネクタに別の設定を使用するには、<strong>Override global setting</strong> をオンに切り替えます。
    </p>
    <p>
      デフォルトではエラーアラートが有効になっており、エラーが発生するたびにメールが送信されます。これをオフにするには、<strong>Enable</strong> チェックボックスのチェックを外します。
    </p>
    <p>
      <strong>Subject</strong>（必須）を入力します。<strong>Allow {siteNameShort}Script in Subject</strong> をチェックすると、<strong>Subject</strong> フィールドで{siteNameShort}Script を使用できます。これを選択すると、<strong>{siteNameShort}Script エディタ</strong>ボタンが表示されます（<img src="/public/images/rest_arcscript_editor.png" alt="arcscript editor button" style={{
  display: 'inline',
  verticalAlign: 'middle',
  margin: 0
}} />）。
    </p>
    <p>
      必要に応じて<strong>Recipient</strong> のメールアドレスをカンマ区切りのリストで入力します。
    </p>
  </>;

export const MiscConnector = () => <>
    <p><em>Miscellaneous 設定は、特定のユースケース向けの設定です。</em></p>
    <table>
      <thead>
        <tr>
          <th>設定</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Other Settings</strong></td>
          <td>非表示のコネクタ設定をセミコロン区切りのリストで設定できます（例：<code>setting1=value1;setting2=value2</code>）。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const Logging = () => <>
    <p><em>ログの作成と保存を制御する設定です。</em></p>
    <table>
      <thead>
        <tr>
          <th>設定</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Log Level</strong></td>
          <td>コネクタが生成するログの詳細度です。サポートを依頼する際は、これを<strong>Debug</strong> に設定してください。</td>
        </tr>
        <tr>
          <td><strong>Log Subfolder Scheme</strong></td>
          <td>選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。<strong>Weekly</strong> オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。</td>
        </tr>
        <tr>
          <td><strong>Log Messages</strong></td>
          <td>処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、<strong>Transactions</strong> タブからファイルのコピーをダウンロードできなくなる場合があります。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const MacrosExamples = ({extraMacros = []}) => <>
    <p>
      %Ext% や %ShortDate% などの一部のマクロは引数を必要としませんが、引数を必要とするものもあります。
      引数を取るすべてのマクロは次の構文を使用します。<code>%Macro:argument%</code>
    </p>

    <p>引数を取るマクロの例を次に示します。</p>

    <ul>
      <li>%Header:headername%：<code>headername</code> はメッセージ上のヘッダーの名前です。</li>
      <li>%Header:mycustomheader% は、入力メッセージに設定された<code>mycustomheader</code> ヘッダーの値に解決されます。</li>
      <li>%Header:ponum% は、入力メッセージに設定された<code>ponum</code> ヘッダーの値に解決されます。</li>
      <li>%RegexFilename:pattern%：<code>pattern</code> は正規表現パターンです。例えば、<code>%RegexFilename:^([\w][A-Za-z]+)%</code> は、ファイル名の最初の単語にマッチしてそれに解決され、大文字・小文字を区別しません（<code>test_file.xml</code> は<code>test</code> に解決されます）。</li>
      <li>%Vault:vaultitem%：<code>vaultitem</code> は<a href="/26.3/self-hosted/ja/getting-started/administration/settings/global-settings-vault">Vault</a> 内のアイテムの名前です。例えば、<code>%Vault:companyname%</code> は、Vault に保存された<code>companyname</code> アイテムの値に解決されます。</li>
      <li>%DateFormat:format%：<code>format</code> は許容される日付形式です（詳細は<a href="/26.3/self-hosted/ja/scripting/value-formatters/date-formatters#sample-date-formats">日付形式のサンプル</a>を参照してください）。例えば、<code>%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%</code> は、ファイルの日付とタイムスタンプに解決されます。</li>
      {extraMacros.filter(item => item.example).map(item => <li key={`ex-${item.name}`}>{item.example}</li>)}
    </ul>

    <p>次の例に示すように、より高度なマクロを作成することもできます。</p>

    <ul>
      <li>1 つのファイル名で複数のマクロを組み合わせる：<code>%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%</code></li>
      <li>マクロの外側にテキストを含める：<code>MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%</code></li>
      <li>マクロの内側にテキストを含める：<code>%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%</code></li>
    </ul>
  </>;

export const MacrosTable = ({siteName = "CData Arc", extraMacros = []}) => <>
    <p>
      ファイル命名戦略でマクロを使用すると、データの整理効率と文脈の理解を高めることができます。
      ファイル名にマクロを組み込むことで、識別子、タイムスタンプ、ヘッダー情報などの関連情報を
      動的に含めることができ、各ファイルに有用な文脈を提供します。
    </p>

    <p>{siteName} は次のマクロをサポートしています。これらはすべて次の構文を使用します。<code>%Macro%</code></p>

    <table>
      <thead>
        <tr><th>マクロ</th><th>説明</th></tr>
      </thead>
      <tbody>
        <tr><td>ConnectorID</td><td>コネクタのConnectorID に評価されます。</td></tr>
        <tr><td>ConnectorName</td><td>コネクタの名前に評価されます。ファイル名やパスに接続名を含めることができます。例えば、どのデータベース接続が生成したかによってバックアップファイルにタグを付けるために使用できます。</td></tr>
        <tr><td>Ext</td><td>コネクタが現在処理しているファイルの拡張子に評価されます。</td></tr>
        <tr><td>Filename</td><td>コネクタが現在処理しているファイルのファイル名（拡張子を含む）に評価されます。</td></tr>
        <tr><td>FilenameNoExt</td><td>コネクタが現在処理しているファイルのファイル名（拡張子を除く）に評価されます。</td></tr>
        <tr><td>MessageId</td><td>コネクタが出力しているメッセージのMessageId に評価されます。</td></tr>
        <tr><td>RegexFilename:<em>pattern</em></td><td>コネクタが現在処理しているファイルのファイル名に正規表現パターンを適用します。</td></tr>
        <tr><td>Header:<em>headername</em></td><td>コネクタが現在処理しているメッセージ上の対象ヘッダー（<code>headername</code>）の値に評価されます。</td></tr>
        <tr><td>LongDate</td><td>システムの現在の日時を長い形式（例：Wednesday, January 24, 2024）で評価します。</td></tr>
        <tr><td>ShortDate</td><td>システムの現在の日時をyyyy-MM-dd 形式（例：2024-01-24）で評価します。</td></tr>
        <tr><td>DateFormat:<em>format</em></td><td>システムの現在の日時を指定された形式（<code>format</code>）で評価します。利用可能な日時形式については、<a href="/26.3/self-hosted/ja/scripting/value-formatters/date-formatters#date-formats-with-literal-characters">日付形式のサンプル</a>を参照してください。</td></tr>
        <tr><td>Vault:<em>vaultitem</em></td><td>指定されたVault アイテムの値に評価されます。</td></tr>
        {extraMacros.map(item => <tr key={item.name}>
            <td>{item.name}</td>
            <td>{item.description}</td>
          </tr>)}
      </tbody>
    </table>
  </>;

export const Performance = () => <>
    <p><em>コネクタへのリソースの割り当てに関する設定です。</em></p>
    <table>
      <thead>
        <tr>
          <th>設定</th>
          <th>説明</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td><strong>Max Workers</strong></td>
          <td>このコネクタでファイルを処理するためにスレッドプールから消費されるワーカースレッドの最大数です。設定すると、<a href="/26.3/self-hosted/ja/getting-started/administration/settings/advanced-settings">Advanced Settings</a> ページの<a href="/26.3/self-hosted/ja/getting-started/administration/settings/performance-settings">Performance Settings</a> 部分にあるデフォルト設定が上書きされます。</td>
        </tr>
        <tr>
          <td><strong>Max Files</strong></td>
          <td>コネクタに割り当てられた各スレッドが送信するファイルの最大数です。設定すると、<a href="/26.3/self-hosted/ja/getting-started/administration/settings/advanced-settings">Advanced Settings</a> ページの<a href="/26.3/self-hosted/ja/getting-started/administration/settings/performance-settings">Performance Settings</a> 部分にあるデフォルト設定が上書きされます。</td>
        </tr>
      </tbody>
    </table>
  </>;

export const siteNameShort = "Arc";

export const siteName = "CData Arc";

REST コネクタは、RESTful API Web サービスを利用するための動的なREST リクエストの構築をサポートします。

## 主な機能

* すべてのHTTP メソッド（GET、POST、PUT、PATCH、DELETE）をサポートする完全なRESTful API クライアント
* API の自動設定とリクエスト生成のためのSwagger インポート機能
* OAuth 2.0、Bearer Token、AWS Signature、API Key、Basic / Digest 認証を含む高度な認証
* URL、ヘッダー、フォームデータでの{siteNameShort}Script サポートによる動的なリクエストの構築
* raw、form-data、URL エンコード、ファイルアップロードを含む柔軟なボディタイプ

## 概要

REST コネクタは、REST リクエストのヘッダー、認可、ボディ、HTTP メソッドを構築するためのシンプルなインターフェースを提供します。リクエストボディは、コネクタの設定で静的に設定することも、コネクタが処理するファイルに基づいて動的に生成することもできます。

### アクション

<CommonActionType resource="request" />

## コネクタの設定

### 設定タブ

*コネクタのコア設定に関連する設定。*

#### 設定

<NameDescription />

#### 高度な設定

| 設定                    | 説明                                                                                                              |
| --------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Local File Scheme** | コネクタが出力するメッセージにファイル名を割り当てるためのスキームです。ファイル名にマクロを使用して、識別子やタイムスタンプなどの情報を動的に含めることができます。詳細については、[マクロ](#マクロ)を参照してください。 |

### REST Details タブ

*コネクタのリクエスト詳細に関連する設定。*

<img src="https://mintcdn.com/cdata-arc/AKthyJ-LnqphL8js/public/images/rest_details_tab.png?fit=max&auto=format&n=AKthyJ-LnqphL8js&q=85&s=d7edb4aeb071c5f6a67b2f6aded7d4d2" width="700" data-path="public/images/rest_details_tab.png" />

| 設定                                     | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **REST Details**                       | コネクタが実行するアクションを選択します。（3つのオプションの詳細については、[アクション](#アクション)を参照してください。）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Import from Swagger**                | <img src="https://mintcdn.com/cdata-arc/AKthyJ-LnqphL8js/public/images/rest_import_from_swagger.png?fit=max&auto=format&n=AKthyJ-LnqphL8js&q=85&s=db1cffc9d98e2999e3edffbbe7a6cc76" alt="import from swagger" style={{display: 'inline', verticalAlign: 'middle', margin: 0}} width="23" height="25" data-path="public/images/rest_import_from_swagger.png" /> アイコンをクリックすると、Swagger URL から直接API の詳細をインポートできます。                                                                                                                                                                                              |
| **Test**                               | フローに送信されるメッセージやトランザクションを作成せずに、現在の設定をテストします。**Test** をクリックすると、追加のタブを含むウィンドウが開きます（詳細については、[リクエスト設定のテスト](#リクエスト設定のテスト)を参照してください）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Request URL**                        | REST リクエストのHTTP メソッドと送信先HTTP URL です。利用可能なメソッドのオプションは、GET、POST、PUT、PATCH、DELETE です。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Allow {siteNameShort}Script in URL** | クエリが発行される前に、URL 内の{siteNameShort}Script 式の評価を許可するにはこれをチェックします。これを選択すると、**{siteNameShort}Script エディタ**ボタンが表示され（<img src="https://mintcdn.com/cdata-arc/AKthyJ-LnqphL8js/public/images/rest_arcscript_editor.png?fit=max&auto=format&n=AKthyJ-LnqphL8js&q=85&s=787722dc2403ad060cf1a162132beba3" alt="arcscript editor button" style={{display: 'inline', verticalAlign: 'middle', margin: 0}} width="26" height="22" data-path="public/images/rest_arcscript_editor.png" />）、{siteNameShort}Script を使用して動的なリクエストURL を構築できます。詳細については、[リクエストURL とヘッダーでの{siteNameShort}Script エディタの使用](#リクエストurl-とヘッダーでのscript-エディタの使用)を参照してください。 |
| **Body Type**                          | REST リクエストとともに供給されるボディコンテンツのタイプです。HTTP メソッドがGET の場合は表示されません。各オプションの説明については、[ボディ](#body)を参照してください。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Content Type**                       | raw データ転送に使用されるコンテンツのタイプです。**Body Type** が`raw` に設定されている場合にのみ表示されます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

#### Query Params

このタブを使用して、リクエストURL にクエリパラメータを追加します。パラメータを名前と値のペアとして、必要に応じて説明とともに指定します。**Save** をクリックして、パラメータでURL を更新します。

<img src="https://mintcdn.com/cdata-arc/j59334epfVQRoK96/public/images/rest_query_params.png?fit=max&auto=format&n=j59334epfVQRoK96&q=85&s=d40533e359dbd742855744eb4c7b82eb" width="700" data-path="public/images/rest_query_params.png" />

上記の画像には、2セットのクエリパラメータが含まれています。コネクタを保存すると、`api.example.com` のリクエストURL は次のようになります：`https://api.example.com/orders?status=pending&limit=50`

右側の省略記号をクリックすると、**Bulk Edit View** と**Hide Description Column** の2つのオプションを設定できます。

#### Authorization

このタブを使用して、API リクエストの認証資格情報を設定します。

| 設定                         | 説明                                                                                                                                                                                                                                                                                                                                 |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Credentials**            | 以前に設定したConnection から認証資格情報を供給するか、新しい接続を作成するか、または認証なしでリクエストを送信するかを指定します。<br />**From Connection**：これを選択し、ドロップダウンから**Connection** を選択します。**注意**：**Connection** の横にあるプラス記号をクリックして新しい接続を作成します。<br />**No Credentials**：認証なしでリクエストを送信するにはこれを選択します。パブリックAPI の場合や、[クエリパラメータ](#query-params)や[ヘッダー](#headers)を通じて認証を処理する場合に、このオプションを使用します。 |
| **TLS Server Certificate** | TLS サーバーのID を検証するために使用される公開鍵証明書です。証明書をアップロードするか、フィールドを空白のままにして基底のOS / JVM に証明書の検証を実行させるか、または`Any Certificate` に設定して送信先サーバーのID を信頼することができます。Any Certificate は慎重に使用してください。証明書は、意図したサーバーに接続していることを検証するものです。                                                                                                                           |

#### Headers

このタブでは、送信するREST リクエストに含めるHTTP ヘッダーのリストを追加できます。ヘッダーも名前と値のペアとして指定します。詳細については、[静的リクエスト](#静的リクエスト)と[動的リクエスト](#動的リクエスト)を参照してください。右側の省略記号をクリックすると、**Bulk Edit View**、**Allow {siteNameShort}Script in Headers**、**Show Autogenerated Headers** の3つのオプションにアクセスできます。{siteNameShort}Script エディタの使用方法の詳細については、[リクエストURL とヘッダーでの{siteNameShort}Script エディタの使用](#リクエストurl-とヘッダーでのscript-エディタの使用)を参照してください。

#### Body

**Body Type** が`form-data` または`x-www-urlencoded` に設定されている場合は、**Body** タブを使用して、リクエストのボディを構成する名前と値のペア（フィールド）のセットを供給します。次のリストでは、各オプションについてより詳細に説明します。

* **none**：REST リクエストとともにボディは供給されません。
* **form-data**：ボディは名前と値のペア（フィールド）のセットとして供給されます。**Name** の横にあるドロップダウンリストを使用して、フィールドタイプを選択します。
  * **Static**：**Name** と**Value** の両方を供給します。
  * **XML**：UI で**Name** を供給します。**Value** は、コネクタが処理するインプットファイルから動的に読み取られます。詳細については、[動的フォームデータ](#動的フォームデータ)を参照してください。
  * **File**：各コネクタは、1つのボディフィールドをFile に設定できます。これにより、インプットファイルがリクエストのボディで送信されます。コネクタはインプットファイル自体をフォームデータとして使用するため、**Value** フィールドはグレーアウトされます。
  * **Header**：**Value** フィールドを使用して、ボディの読み取り元となるインプットメッセージのヘッダーを指定します。
  * **{siteNameShort}Script**：供給された**Value** は{siteNameShort}Script としてレンダリングされ、結果の値がリクエストボディで使用されます。
* **x-www-urlencoded**：ボディはform-data と同じ方法で設定されますが、名前と値のペアはマルチパートフォームデータの代わりにURL クエリ文字列としてエンコードされます。
* **raw**：ボディは、コネクタが処理するインプットファイルの内容に設定されます。ドロップダウンを使用するか、**Header** セクションでカスタムヘッダーとして指定して、ボディの**Content Type** を選択します。

右側の省略記号をクリックすると、**Bulk Edit View** と**Show Content Type Column** の2つの設定にアクセスできます。コンテンツタイプ列を表示すると、`form-data` および`x-www-form-urlencoded` ボディタイプについて、フィールドごとにコンテンツタイプを供給できます。

#### Options

*リクエストに関連する追加の設定。*

| 設定                                               | 説明                                                                                                                                                                 |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Create an output message for error responses** | デフォルトでは、コネクタは、成功を示さないステータスコードでレスポンスが送信された場合にメッセージをフローに出力しません。この設定を有効にすると、コネクタはこれらのエラーレスポンスについてメッセージをフローに出力します。HTTP-Status-Code ヘッダーを使用して、フローの後段でメッセージをフィルタリングできます。 |
| **Compress HTTP Request**                        | これを有効にすると、リクエストを送信する前に、PUT またはPOST リクエストのボディを`gzip` 形式に圧縮します。送信するリクエストには**Content-Encoding** ヘッダーも追加されます。                                                          |
| **GET Request Body**                             | GET リクエストがインプットメッセージのデータをリクエストのボディとして使用することを許可します。                                                                                                                 |
| **HTTP Version**                                 | REST サービスへの接続時にHTTP 1.0、1.1、2.0 のどれを使用するかを指定します。                                                                                                                   |

### Advanced タブ

#### Authentication

<TlsClientAuthentication />

#### 高度な設定

*前のカテゴリに含まれない設定。*

| 設定                              | 説明                                                                                                                                                                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Chunked Encoding**            | リクエストの送信時にHTTP Chunked Transfer Encoding を使用するかどうかを指定します。これにより、アプリケーションはメッセージの一部（チャンク）を順次送信して、接続への過負荷を回避できます。                                                                                                      |
| **Chunk Size**                  | **Chunked Encoding** が有効な場合の各チャンクのサイズ（バイト単位）です。                                                                                                                                                                    |
| **Follow Authorization Header** | 有効にすると、異なるプロトコルまたはホスト名へのリダイレクトが発生した際に認可ヘッダーを保持します。                                                                                                                                                                 |
| **Output Behavior**             | デフォルトでは、コネクタは`Response` データを含むメッセージを出力します。他のオプションでは、さらに処理できるように`Input Message` を出力するか、メッセージをまったく出力しないようにすることができます。詳細については、[レスポンスイベント](#レスポンスイベント)を参照してください。                                                        |
| **Timeout (seconds)**           | タイムアウトエラーをスローするまでに、REST サーバーからのレスポンスを待機する秒単位の時間です。                                                                                                                                                                 |
| **Response Headers**            | 設定すると、コネクタは指定されたヘッダーをREST メッセージから、ダウンロードされたメッセージのメタデータとして昇格します。複数のヘッダーをカンマ区切りのリストで指定できます。                                                                                                                          |
| **Preserve Cookies**            | アウトプットメッセージにクッキーを保持するには、保持するクッキー名のカンマ区切りのリストを供給します。`*` を使用するとすべてのクッキーが保持されます。**注意**：名前と値のペアのみが保持され、属性のチェックは実行されません。クッキーが意図しない送信先に漏洩しないようにする責任はユーザーにあります。                                                           |
| **TLS Enabled Protocols**       | 送信接続を確立する際にサポートされるTLS / SSL プロトコルのリストです。ベストプラクティスはTLS プロトコルのみを使用することです。SSL v2 およびSSL v3 は脆弱とみなされており、パートナーがより高いバージョンをサポートしていない場合にのみ使用してください。TLS v1.3 は普遍的に採用されているわけではなく、送信先サーバーがサポートしていない場合は拒否される可能性があることに注意してください。 |
| **Processing Delay**            | **トランザクション**タブに配置されたファイルの処理を遅延させる時間（秒単位）です。これはレガシー設定です。ベストプラクティスは、この設定の代わりに[File コネクタを使用](../flows/designing-a-flow#ローカルファイルシステムとのやり取り)してローカルファイルシステムを管理することです。                                                    |

#### Proxy Settings

<CommonProxySettings />

#### Logging

<Logging />

#### Miscellaneous

<MiscConnector />

### Automation タブ

#### Automation 設定

*コネクタによるファイルの自動処理に関連する設定。*

| 設定                        | 説明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Send**                  | コネクタに対して、ファイルの準備ができたら自動的に送信するよう指示するトグルです。                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Retry Interval**        | 送信失敗後、コネクタが再試行するまでに待機する間隔です。                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **Max Attempts**          | コネクタがメッセージの送信を試行する回数です。この値を*1* に設定すると、コネクタは再試行せずに最初の送信試行のみを行うよう指示されます。コネクタは各試行の間に**Retry Interval** で指定された時間だけ待機します。                                                                                                                                                                                                                                                                                                                                                                           |
| **Receive**               | コネクタに対して、設定された間隔で自動的にREST リクエストを行うよう指示するトグルです。                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Interval**              | コネクタが設定されたREST リクエストを行う間隔です。次のフィールドはここでの選択に応じて変わります：<br />**Hourly**：*Minutes Past the Hour* ドロップダウンメニューで、受信ファイルを処理する毎時の分数を指定できます。<br />**Daily**：*Time* フィールドが表示され、受信ファイルを処理する時刻（UTC）を指定できます。<br />**Weekly**：2つのフィールドが表示されます。*Day* で処理する曜日を選択でき、*Time* で受信ファイルを処理する時刻（UTC）を指定できます。<br />**Monthly**：2つのフィールドが表示されます。*Day* で処理する日付を選択でき、*Time* で受信ファイルを処理する時刻（UTC）を指定できます。<br />**Minute**：*Minutes* フィールドが表示され、処理間隔の分数を指定できます。<br />**Advanced**：5桁の*Cron Expression* フィールドで、正確な処理間隔を指定できます。 |
| **Minutes Past the Hour** | 毎時のスケジュールの分のオフセットです。**Receive** が\_Hourly\_ に設定されている場合にのみ適用されます。例えば、この値が5に設定されている場合、オートメーションサービスは1:05、2:05、3:05 などにリクエストを送信します。                                                                                                                                                                                                                                                                                                                                                                |

#### Performance

<Performance />

### Alerts タブ

<AlertsTab />

### SLAs タブ

<SlasTab />

### Transactions タブ

このタブには、コネクタに関連するすべてのメッセージが一覧表示されます。検索バーを使用して特定のメッセージを見つけるか、じょうごアイコンをクリックしてフィルタを適用します。時刻、メッセージの方向、ステータスでフィルタリングできます。

このタブのオプションは、コネクタの[アクションタイプ](#アクション)に応じて異なります：

* コネクタが**Trigger** の場合は、**Receive Files** ボタンを使用してフローを開始します。
* コネクタが**Transform** または**Terminal** の場合は、**Upload Files** ボタンを使用してファイルをフローにアップロードします。

## 接続の確立

任意のREST サービスへの接続を確立するには、有効な送信先URL が必要です。サービスURL はさまざまなHTTP メソッドをサポートでき、取得する特定のWeb サービスアクションまたはデータセットに基づいてメソッドを設定してください。サービスによっては、サービスを利用するために認証またはカスタムヘッダーのセットが必要な場合もあります。

[Authorization](#authorization) タブの**Credentials** セクションでは、接続資格情報を指定できます。次のオプションから選択します：

* **From Connection**：以前に設定した{siteNameShort} の共有Connection を選択するか、**Connection** フィールドの横にあるプラス記号をクリックして[接続の作成](#接続の作成)を行います。
* **No Credentials**：パブリックAPI の場合や、[クエリパラメータ](#query-params)や[ヘッダー](#headers)を通じて認証を処理する場合に使用します。送信先URL がHTTPS URL の場合は、**TLS Server Certificate** をサーバーを識別する公開鍵証明書に設定します。送信先エンドポイントを暗黙的に信頼するには、フィールドを`Any Certificate` に設定します。

### 接続の作成

新しい接続を作成するには、**From Connection** を選択し、**Connection** フィールドの横にあるプラス記号をクリックします。

* 一意の**Connection Name** を入力します。
* **Type** は常にREST に設定されます。
* **Auth Scheme** を選択します。詳細については、[認証](#認証)を参照してください。

### 認証

REST コネクタは多数の認証タイプをサポートしており、各タイプには独自の要件があります：

* Basic（プレーンテキスト）、Digest（暗号化）、NTLM には、ユーザー名とパスワードによる認証が必要です。これらの資格情報は、リクエストのヘッダーとしてREST サービスに供給されます。

* OAuth 認証には、REST サービスのWeb ポータルまたは開発コンソールでのアプリ登録が必要です。アプリ登録に含める**Callback URL** は{siteNameShort} のUI に表示されます。REST サービスに適用される**Grant Type** を選択し、REST サービスのWeb ポータルまたは開発コンソールに表示される詳細から残りの設定を指定します。次に、**Get New Access Token** をクリックして、サービスとやり取りするために必要なトークンを取得します。最初のトークンが取得されると、アプリケーションはトークンが有効期限に近づくとトークンを更新します。

* Bearer Token 認証には、サービスのWeb ポータルまたは開発コンソールから取得したトークンが必要です。

* AWS Signature 認証（Amazon に対する認証用）には、Amazon が提供する設定資格情報（**Access Key**、**Secret Key** など）が必要です。

* API Key 認証にはキーと値のペアが必要で、その後、キーを[ヘッダー](#headers)として追加するか[クエリパラメータ](#query-params)として追加するかを指定する必要があります。

## リクエスト設定のテスト

フローに送信されるメッセージやトランザクションを作成せずに、いつでも現在の設定をテストできます。**REST Details** タブで**Test** をクリックします。次の画像は、Trigger コネクタのテストが成功した際の**Response Body** の結果を示しています。

<img src="https://mintcdn.com/cdata-arc/j59334epfVQRoK96/public/images/rest_test_tab.png?fit=max&auto=format&n=j59334epfVQRoK96&q=85&s=19bab5aa19bc99eb0414b1a4ba610cfb" width="700" data-path="public/images/rest_test_tab.png" />

* **Response Body**：サーバーから返された形式でREST リクエストの出力を表示します。
* **Response Headers**：サーバーから返されたレスポンスに含まれていたレスポンスヘッダーを表示します。
* **Message Headers**：テストの出力に含まれていたメッセージヘッダーを表示します。
* **Log**：テストログを表示します。

Transform およびTerminal コネクタには、**XML**、**Headers**、**Logs** のタブを持つ**Input** ペインがあります。

* **XML** タブは、次の画像に示すように、リクエストのボディでXML フィールドを定義した場合にのみ表示されます。
* **Allow {siteNameShort}Script in URL** または**Allow {siteNameShort}Script in Headers** がチェックされている場合は、**Headers** タブを使用して、スクリプトのコンテキストで使用される可能性のあるメッセージヘッダーを供給します（これらのオプションの詳細については、[リクエストURL とヘッダーでの{siteNameShort}Script エディタの使用](#リクエストurl-とヘッダーでのscript-エディタの使用)を参照してください）。リクエストに`form-data` または`x-www-form-urlencoded` ボディの要素として設定された[Header](#headers) がある場合、ここにヘッダー名が表示され、テストで使用する値を供給できます。
* **Logs** タブには、最後のテストの結果が含まれます。

<img src="https://mintcdn.com/cdata-arc/j59334epfVQRoK96/public/images/rest_test_tab_transform.png?fit=max&auto=format&n=j59334epfVQRoK96&q=85&s=3917d83aa4fbd224826502c2e64a0a3b" width="700" data-path="public/images/rest_test_tab_transform.png" />

## 静的リクエスト

完全に静的なコンテンツを持つREST リクエスト（HTTP GET メソッドを使用するリクエストなど）は、リクエストコンテンツがコネクタのUI で完全に設定されるため、インプットファイルを必要としません。必要な名前と値のペアを、**Header** セクションのカスタムヘッダーまたは**Body** セクションのフォームデータとして追加するだけです。

**受信オートメーション**が有効な場合、静的リクエストはスケジュールに従って自動的に送信できます。各リクエストへのレスポンスは、アウトプットフォルダに保存されるか、フロー内の次のコネクタに渡されます。

**送信オートメーション**が有効な場合、コネクタの**トランザクション**フォルダに到着したファイルも静的リクエストをトリガーします。インプットファイルの内容は無視され、リクエストはUI の設定に従って送信されます。

## 動的リクエスト

REST リクエストには、コネクタの**トランザクション**フォルダに到着するファイルのデータを動的に取り込むことができます。

### Raw インプットデータ

リクエストの**Body Type** を`raw` に設定すると、インプットファイルの内容がREST リクエストのボディとして送信されます。

**Content Type** ドロップダウンを使用して、データの特定のコンテンツタイプを設定します。必要なコンテンツタイプがリストにない場合は、**Header** セクションに\_Content-Type\_ ヘッダーを追加できます。

### 動的フォームデータ

リクエストの**Body Type** を`form-data` または`x-www-urlencoded` に設定すると、コネクタはインプットファイルから特定の値を探してリクエストに取り込みます。`XML` に設定された各名前と値のペアについて、コネクタはインプットファイルをスキャンして、フィールド名と同じ名前を共有し、次に示す特定のXML 構造を使用するXML 要素を探します：

```xml theme={null}
<Items>
  <FormData>
    <FieldName></FieldName>
  </FormData>
</Items>
```

この構造に合わせるため、CData は、[後述](#xml-map-を使用した動的テンプレート)のように、フロー内でREST コネクタの前にXML Map コネクタを使用することを強く推奨します。

コネクタがフィールド名と必要なXML 構造に一致する要素を見つけると、この要素内の値が名前と値のペアの値として使用されます。例えば、ボディに`CustomerID` という名前の動的フィールドがあり、インプットファイルに次のXML が含まれている場合、REST コネクタは`CustomerID` フィールドの値を12354 に設定します。

```xml theme={null}
<Items>
  <FormData>
    <CustomerID>12354</CustomerID>
  </FormData>
</Items>
```

#### XML Map を使用した動的テンプレート

[XML Map](./xml-map/xml-map) コネクタをREST コネクタと組み合わせて使用すると、他のXML データ構造から動的なリクエストを簡単に構築できます。XML Map コネクタは、カスタムXML 構造をREST コネクタが期待するXML 構造に変換します。

まず、リクエストに存在すべき動的（および静的）な**Body** フィールドのセットでREST コネクタを設定します。次に、{siteNameShort} のフローでXML Map コネクタをREST コネクタに接続し、フローの変更を保存します。これにより、XML Map コネクタは、REST コネクタが受信するインプットファイルで期待するフィールドを検出できます。

その後、XML Map コネクタ内で、**Destination File** ドロップダウンにREST リクエストスキーマが含まれます。これをDestination として選択し、**Source File** をカスタムXML 構造に設定します。これによりXML Map のマッピングエディタが取り込まれ、REST リクエストに含める必要があるデータをソース構造から送信先構造にドラッグアンドドロップできます。マッピングが完了すると、XML Map コネクタは、ソースファイルに一致するファイルを有効なREST リクエスト構造に自動的に変換します。

XML Map コネクタの使用方法の詳細については、[XML Map コネクタのドキュメント](./xml-map/xml-map)を参照してください。

#### 動的ヘッダー

{siteNameShort}Script の式を評価して、ヘッダー値として動的な文字列を生成することもできます。詳細と例については、[Headers](#headers) を参照してください。

## リクエストURL とヘッダーでの{siteNameShort}Script エディタの使用

下に示す{siteNameShort}Script エディタを使用して、リクエストURL とヘッダーを構築できます。次の画像はリクエストURL エディタを示していますが、ヘッダー値エディタも同じように機能します。

<img src="https://mintcdn.com/cdata-arc/AKthyJ-LnqphL8js/public/images/rest_arcscript_editor_pane.png?fit=max&auto=format&n=AKthyJ-LnqphL8js&q=85&s=3ff51605a0efc43cb2e494af2f50ab08" width="600" data-path="public/images/rest_arcscript_editor_pane.png" />

コネクタ設定ペインの[REST Details タブ](#rest-details-タブ)で**Allow {siteNameShort}Script in URL** を選択すると、{siteNameShort}Script の式が評価されてURL として動的な文字列が生成されます。例えば、次のURL には日付と時刻が含まれています：

`http://myendpoint.com/api?day=[_ | now('yyyyMMdd HH:mm:ss')]`

このURL には、送信オートメーションを通じてトリガーされるクエリのために、受信メッセージのヘッダーが含まれています：

`http://myendpoint.com/api?customer=[_message.header:customerid]`

最後に、このURL は、最初のクエリにはデフォルトのタイムスタンプを使用し、最後のクエリの時刻から現在のタイムスタンプまでの動的な日付範囲を使用します：

`http://myendpoint.com/api?DateFrom=[_connector.lastruntimestamp | def('2025-01-01T00:00:00-04:00')]&DateTo=[_connector.currenttimestamp]`

式を直接URL に追加することも、エディタを使用して記述することもできます。

**Allow {siteNameShort}Script in Headers** を選択すると、クエリが発行される前に[ヘッダー](#headers)内の{siteNameShort}Script 式の評価が有効になります。例えば、次のヘッダーには日付と時刻が含まれています：

`Timestamp [_ | now('yyyyMMdd')]`

このヘッダーには、送信オートメーションを通じてトリガーされるクエリのための顧客Id が含まれています：

`Customer [_message.header:customerid]`

### メッセージヘッダー

メッセージヘッダーは、{siteNameShort} がフロー全体のデータの進行状況を追跡するのに役立ちます。すべての追跡されたヘッダーはエディタの**Message Header** タブに表示され、式の中で参照できます。

エディタの**Add Message Header** フィールドを使用して既存のヘッダーの名前を指定することで、式に他のメッセージヘッダーを含めることもできます。これらは追跡されたヘッダーである必要はありません。

### Vault

**Vault** タブを使用して、[グローバル設定Vault](../getting-started/administration/settings/global-settings-vault) のアイテムを式に追加します。これは、フロー全体のさまざまな場所で再利用する値がある場合に便利です。それらの値をVault で定義し、式の先頭で参照できます。マッピングでVault のアイテムの\_値\_ を使用したい場合は、角括弧内で参照する必要があることに注意してください。そうしないと、エディタはアイテムの\_名前\_ をリテラルとして解釈します。

### フォーマッタ

フォーマッタは、異なるxpath で返される値の操作をサポートします。フォーマッタは式の中でパイプ文字（|）で区切られ、左から右に評価されます。例えば：

`[xpath('City') | toupper | substring(0,3)]`

この例では、`City` xpath の値が返される前に、すべての文字列文字が大文字に変換され、最初の3文字の部分文字列が結果として返されます。例えば、ソースドキュメントが次の値を持っていたとします：

`<City>Durham</City>`

結果の式は次を返します：

`DUR`

フォーマッタは**Formatters** タブに一覧表示されます。リスト内のフォーマッタをクリックして式に追加します。

## レスポンスイベント

REST コネクタでレスポンスイベントを使用して、サーバーから受信したレスポンス（ボディ、ヘッダー、クッキーなどを含む）とやり取りし、コネクタが生成するアウトプットメッセージを強化できます。`Response` イベントでは、次の特別なアイテムを使用できます。

* [\_cookies](../scripting/introduction-to-arcscript#http-クッキー-_cookies)
* [\_message](../scripting/introduction-to-arcscript#メッセージ-_message)
* [\_request](../scripting/introduction-to-arcscript#http-リクエスト-_request)
* [\_response](../scripting/introduction-to-arcscript#http-レスポンス-_response)

### レスポンスイベントの例

次のスクリプトは、REST 呼び出しから受信したJSON レスポンスを読み取り、JSON に含まれるアクセストークンを解析して、REST コネクタが作成するアウトプットメッセージにヘッダーとして追加します：

```xml theme={null}
<arc:set attr="json.text" value="[_response.body]" />
<arc:set attr="json.map:access_token" value="/json/args/token" />
<arc:call op="jsonDOMGet" item="json">
  <arc:set attr="_message.header:access_token" value="[json.access_token | def('Token not found!')]"/>
</arc:call>
```

次のステップで、何が起こるかを詳しく説明します：

1 サーバーからArc のREST コネクタに返されたレスポンスのボディは、`_response.body` を介してアクセスされ、jsonDOMGet オペレーションのtext 属性に設定されます。jsonDOMGet の他の属性も取り込まれます。例えば、レスポンスボディ内の目的のトークンへのjsonpath を持つ`map` 属性などです。

2 jsonDOMGet オペレーションが呼び出されます。トークンがレスポンスJSON ボディで見つかった場合、`_message.header:access_token` 構文を介してREST コネクタのアウトプットメッセージにメッセージヘッダーとして追加されます。トークンが見つからない場合、`access_token` ヘッダーの値は静的な文字列：*Token not found!* に設定されます。

REST コネクタからのメッセージのアウトプットメッセージ詳細を表示すると、{siteNameShort} ではその結果は次のように表示されます：

<img src="https://mintcdn.com/cdata-arc/j59334epfVQRoK96/public/images/rest_response_event.png?fit=max&auto=format&n=j59334epfVQRoK96&q=85&s=10bf7457f6c4903d4c42cb4823fb523e" width="700" data-path="public/images/rest_response_event.png" />

このタイプのスクリプトは、リクエストを送信した後にサーバーから返された生のJSON レスポンスボディからデータを解析する必要がある場合に便利です。ヘッダーは、フロー内の後続のコネクタで読み取って使用できます。

<Tip>サーバーがXML を使用して応答する場合は、xmlDOMget を使用して同じ結果を得ることができます。</Tip>

## マクロ

<MacrosTable />

### 例

<MacrosExamples />