）。
Trusted IP Addresses セクションでは、次の機能を使用できます。
| 機能 | 説明 |
|---|---|
| Add | 新しいIP アドレス範囲を入力します。 |
| Edit | 選択したIP アドレス範囲を変更します。 |
| Delete | 選択したIP アドレス範囲をリストから削除します。 |
この機能には次の制限が適用されます。
localhost はリストから変更または削除できません。100.10.100.1-15 は、100.10.100.1 から100.10.100.15 までのIP アドレスが許可されることを示します。100.10.100.0/24 は、100.10.100.0 から100.10.100.255 までのIP アドレスが許可されることを示します。100.10.100.* は、100.10.100 で始まるIP アドレスが許可されることを示します。クライアントがサーバーに到達するには、明確なネットワークパスが必要です。クラウド環境では、次の3か所で変更が必要になる場合があります。
• クラウドコンソールのネットワークルール。
• アプリケーションをホストするマシンのファイアウォールルール。例えば、Amazon AMI を使用する場合、Uncomplicated Firewall（UFW）を使用して目的のポートでのトラフィックを許可できます。Linux 環境での一般的な方法は、1024 より小さいポートから1024 より大きい非標準ポートへトラフィックを転送し、アプリケーションがその非標準ポートを使用するように設定することです。これにより、非rootユーザーが1024 より小さいポートにバインドする際の権限の問題を回避できます。
• Security タブのNetwork Access 部分。
| 設定 | 説明 |
|---|---|
| Connector Id | コネクタの静的で一意の識別子です。 |
| Connector Type | コネクタ名とその機能の説明を表示します。 |
| Connector Description | コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールドです。 |
サービスレベルアグリーメント（SLA）の設定に関する設定です。
SLA を使用すると、フロー内のコネクタが送受信すると見込まれるボリュームを設定し、そのボリュームを達成すると見込まれる期間を設定できます。{siteName} は、SLA が達成されない場合にユーザーへ警告するメールを送信し、SLA をAt Risk としてマークします。これは、SLA が間もなく達成されない場合にViolated としてマークされることを意味します。これにより、ユーザーは介入してSLA が達成されない理由を特定し、適切な対応を取る機会を得られます。At Risk 期間の終了時点でもSLA が達成されない場合、SLA はviolated としてマークされ、ユーザーに再度通知されます。
SLA を定義するには、Expected Volume をオンに切り替え、Settings タブをクリックします。
次の例は、月曜日から金曜日まで毎日1000 件のファイルを受信すると見込むコネクタ向けに設定されたSLA を示しています。1000 件のファイルが受信されていない場合、期間の終了の1時間前にAt Risk 通知が送信されます。
アラートの設定に関する設定です。
サービスレベルアグリーメント（SLA）を実行する前に、通知用のメールアラートをセットアップする必要があります。デフォルトでは、{siteNameShort} はAlerts タブのグローバル設定を使用します。このコネクタに別の設定を使用するには、Override global setting をオンに切り替えます。
デフォルトではエラーアラートが有効になっており、エラーが発生するたびにメールが送信されます。これをオフにするには、Enable チェックボックスのチェックを外します。
Subject（必須）を入力します。Allow {siteNameShort}Script in Subject をチェックすると、Subject フィールドで{siteNameShort}Script を使用できます。これを選択すると、{siteNameShort}Script エディタボタンが表示されます（）。
必要に応じてRecipient のメールアドレスをカンマ区切りのリストで入力します。
; export const MiscConnector = () => <>Miscellaneous 設定は、特定のユースケース向けの設定です。
| 設定 | 説明 |
|---|---|
| Other Settings | 非表示のコネクタ設定をセミコロン区切りのリストで設定できます（例：setting1=value1;setting2=value2）。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。 |
ログの作成と保存を制御する設定です。
| 設定 | 説明 |
|---|---|
| Log Level | コネクタが生成するログの詳細度です。サポートを依頼する際は、これをDebug に設定してください。 |
| Log Subfolder Scheme | 選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。Weekly オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。 |
| Log Messages | 処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、Transactions タブからファイルのコピーをダウンロードできなくなる場合があります。 |
%Ext% や %ShortDate% などの一部のマクロは引数を必要としませんが、引数を必要とするものもあります。
引数を取るすべてのマクロは次の構文を使用します。%Macro:argument%
引数を取るマクロの例を次に示します。
headername はメッセージ上のヘッダーの名前です。mycustomheader ヘッダーの値に解決されます。ponum ヘッダーの値に解決されます。pattern は正規表現パターンです。例えば、%RegexFilename:^([\w][A-Za-z]+)% は、ファイル名の最初の単語にマッチしてそれに解決され、大文字・小文字を区別しません（test_file.xml はtest に解決されます）。vaultitem はVault 内のアイテムの名前です。例えば、%Vault:companyname% は、Vault に保存されたcompanyname アイテムの値に解決されます。format は許容される日付形式です（詳細は日付形式のサンプルを参照してください）。例えば、%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% は、ファイルの日付とタイムスタンプに解決されます。次の例に示すように、より高度なマクロを作成することもできます。
%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%ファイル命名戦略でマクロを使用すると、データの整理効率と文脈の理解を高めることができます。 ファイル名にマクロを組み込むことで、識別子、タイムスタンプ、ヘッダー情報などの関連情報を 動的に含めることができ、各ファイルに有用な文脈を提供します。
{siteName} は次のマクロをサポートしています。これらはすべて次の構文を使用します。%Macro%
| マクロ | 説明 |
|---|---|
| ConnectorID | コネクタのConnectorID に評価されます。 |
| ConnectorName | コネクタの名前に評価されます。ファイル名やパスに接続名を含めることができます。例えば、どのデータベース接続が生成したかによってバックアップファイルにタグを付けるために使用できます。 |
| Ext | コネクタが現在処理しているファイルの拡張子に評価されます。 |
| Filename | コネクタが現在処理しているファイルのファイル名（拡張子を含む）に評価されます。 |
| FilenameNoExt | コネクタが現在処理しているファイルのファイル名（拡張子を除く）に評価されます。 |
| MessageId | コネクタが出力しているメッセージのMessageId に評価されます。 |
| RegexFilename:pattern | コネクタが現在処理しているファイルのファイル名に正規表現パターンを適用します。 |
| Header:headername | コネクタが現在処理しているメッセージ上の対象ヘッダー（headername）の値に評価されます。 |
| LongDate | システムの現在の日時を長い形式（例：Wednesday, January 24, 2024）で評価します。 |
| ShortDate | システムの現在の日時をyyyy-MM-dd 形式（例：2024-01-24）で評価します。 |
| DateFormat:format | システムの現在の日時を指定された形式（format）で評価します。利用可能な日時形式については、日付形式のサンプルを参照してください。 |
| Vault:vaultitem | 指定されたVault アイテムの値に評価されます。 |
| {item.name} | {item.description} |
When clients connect to the configured endpoint and submit a form, they see fields that are laid out exactly as they are configured in the panel above.
The designer includes the following settings (see [Creating Forms](#creating-forms) for more details).
| Setting | Description |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Form URL** | A link to the published form. |
| **Form** | Title of the form (for example, your company name). |
| **Add** | Dropdown to add a section or a detail table. **Add Section** lets you add specific sections to a form, and **Add Detail** lets you add a detail table to the form. Detail tables act like a pre-configured table where the form user can add as many records as they need for the dataset. |
| **Form Fields** | Drag and drop fields into detail table and section areas of the form. Repeat this as many times as necessary. The field types are:
3. Set **Windows Authentication** to **Disabled** for this folder.
## Creating Forms
Forms have fields, sections, and details:
* **Section**: A heading that groups fields together
* **Detail**: An object that acts like a pre-configured table where the form user can add as many records as they need for the dataset
* **Field**: An input box with a label where users enter form data
To get started, click the **Add** button next to the form title, and choose whether to **Add Section** or **Add Detail**.
### Adding Sections
*Sections* divide fields in the form by categorizing them under a heading. For example, the **Ship To** section might contain fields like **Address**, **City**, and **Zip**.
Sections are not required in order to add fields to the form. However, sections provide logical groupings of items that help users quickly understand the form.
To add a section:
1. Choose **Add Section** from the dropdown. Enter a section name.
2. Now you can start [Adding Fields](#adding-fields) to the section.
### Adding Detail Tables
*Detail* tables allow form creators to embed a table in the web form to enable structured, row-based data entry. They include a configurable number of columns which you define during the form creation. They are ideal for capturing repeatable datasets in a single form submission. End users can then dynamically add as many rows as needed and enter values for each column in those rows. See [Accessing Your Form](#accessing-your-form) for an example.
To add a detail table to your form:
1. Click **Add Detail** from the dropdown. Enter a name.
2. Now you are ready to add columns to the table. Select any of the [form field types](#form-field-types).
### Adding Fields
*Fields* are the basic unit of input for the form.
To add a field:
1. Drag an object from the **Form Fields** section into your section or detail table.
2. Enter a **Display Name** (for example, Line Item Id). By default, **XML Name** is populated, but you can use the **Override** checkbox to supply a different name.
3. Use the **Is required** checkbox to specify whether the field is mandatory.
4. The other options vary based on the [form field type](#form-field-types). The following example shows a text field being defined. When you are finished defining the field, click **Add**.
To edit a field, click the link to its name, or the ellipses to the right of the name.
To remove a field, click the ellipses and choose **Remove Instance**.
Drag and drop fields in a section or detail table to reorder their position in the form.
## Submitting Form Data
After you create a form, users access the Form connector's web endpoint and submit data using the form.
For fields in the main form, users simply enter the values that correspond to the labels on the form (which are taken from the name of the fields that you created).
Users can add rows to the detail table by clicking **Add Row**. Once a user enters all their data, they click **Submit** to submit their data. If the submission is successful, a message similar to the following appears.
When a user submits a form, the form data is pushed to the **Transactions** tab. The output is an XML file that contains the following structure:
```xml theme={null}