> ## 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. # Partner Mailbox コネクタ > CData Arc のPartner Mailbox コネクタの設定と使用方法に関するガイド。 Partner Mailbox コネクタは、取引パートナー専用のブラウザベースのプライベートメールボックスを提供し、パートナーがログインして、自分宛てに用意されたファイルをダウンロードしたり、送信するファイルをアップロードしたりできるセルフサービス型のファイル交換を実現します。 ## 主な機能 * 取引パートナーごとに専用のメールボックスを用意し、それぞれが独自の認証情報、URL、フォルダツリーを持つ * 典型的なMFT 機能を持たないパートナーのためのセルフサービス型ファイル交換 * ドラッグ＆ドロップで管理できる、整理されたSend/Receive フォルダツリー * 再ダウンロードに対応した、ダウンロード済みファイルの保持期間制御 * パートナーがアップロードできるファイルを制御するファイル拡張子フィルタ * パートナー向けメールボックスページのページタイトルとロゴをカスタマイズ可能 * 他のMFT コネクタと同様、標準の`SubFolder` ヘッダーを使用したフォルダ単位のルーティング ## 概要 各Partner Mailbox コネクタは、1つの取引パートナーのメールボックスを表します。パートナーは専用のWebページを開き、ユーザー名とパスワードで認証を行うと、自分宛てに用意されたファイルのダウンロードや、送信するファイルのアップロードができるようになります。複数の取引パートナーに対応するには、複数のコネクタインスタンスが必要です。 [パートナーのメールボックスページ](#partner-mailbox-ビュー)は、2つのセクションで構成されています。パートナーがダウンロードするファイルが用意されるセクション（Send フォルダ）と、パートナーがファイルをアップロードできるセクション（Receive フォルダ）です。各セクションは独立したフォルダツリーを使用し、管理者がコネクタ設定で管理します。 パートナーがアップロードしたファイルは、他のコネクタから送られてくるファイルと同様に、メッセージとしてArc のフローに入ります。フロー内のルーティングは`SubFolder` ヘッダーによって処理されます。詳細は[ルーティングの仕組み](#ルーティングの仕組み)を参照してください。 > [!NOTE] > > 現在、Webページのみがアクセス方法としてサポートされています。同じメールボックスへのSFTP およびFTP アクセスは、将来のリリースで予定されています。 ## コネクタの設定 ### パートナーメールボックス構成 タブ このタブの上部に表示される**パートナーメールボックスURL** は、パートナーがメールボックスにアクセスするためのアドレスです。このURL は`.../connector///mailbox.rst` の形式を取ります。設定が完了したら、このURL をパートナーと共有してください。 #### メールボックス認証 *パートナーがメールボックスページにログインする際に使用する認証情報。* | 設定 | 説明 | | - | - | | **ユーザー** | パートナーのメールボックスアカウントのユーザー名。各メールボックスにはアカウントが1つあります。 | | **パスワード** | パートナーのメールボックスアカウントのパスワード。 | #### ファイル管理 - パートナーによるダウンロード *パートナー用に用意されたファイルがダウンロード後どのように管理されるかを制御する設定。* | 設定 | 説明 | | - | - | | **パートナーがファイルをダウンロードしたとき** | ファイルを再ダウンロード可能な状態で保持するか、最初のダウンロード後に削除するかを設定します。**保持期間が経過するまでファイルを保持する** を選択すると、ファイルが期限切れになるまで再ダウンロードできます。一方、**ダウンロード後に削除する** を選択すると、最初のダウンロード後にファイルが削除されます。**ダウンロード済みファイルの保持期間** を0に設定すると、**ダウンロード後に削除する** と同じ効果になります。 | | **ダウンロード済みファイルの保持期間** | ダウンロード済みのファイルが再ダウンロード可能な状態で保持される日数です。デフォルトは7日です。保持期間は、ファイルが用意された日ではなく最初にダウンロードされた日から起算され、再ダウンロードしても期間はリセットされません。この設定は、**パートナーがファイルをダウンロードしたとき** が**保持期間が経過するまでファイルを保持する** に設定されている場合にのみ適用されます。 | #### ファイル管理 - パートナーによるアップロード *パートナーがアップロードできるファイルを制御する設定。* | 設定 | 説明 | | - | - | | **ファイル拡張子** | ファイルを受け入れる前に適用されるglobパターンフィルタです。例えば、`*.txt` は.txt ファイルのみを受け入れ、`-*.pdf` は.pdf ファイルをブロックします。複数のファイルタイプを指定する場合はカンマで区切ってください。すべてのファイルタイプを受け入れる場合は空白のままにします。 | #### パートナーメールボックスページ *パートナー向けメールボックスページの外観に関する設定。* | 設定 | 説明 | | - | - | | **ページタイトル** | パートナーのメールボックスページの上部に表示されるタイトルです。 | | **パートナーメールボックスのロゴ** | メールボックスページにロゴとして表示する画像と、ロゴ領域の背景色です。 | #### パートナーメールボックスのフォルダ フォルダ設定は2つのタブに分かれています。パートナーがダウンロードするファイルを用意する**送信フォルダ** と、パートナーがファイルをアップロードするフォルダの**受信フォルダ** です。各タブには、1つのルートフォルダから始まる独立したフォルダツリーがあります。**セクションヘッダー** フィールドでは、パートナーのページ上でそのセクションの上に表示される見出しを設定します。 ルートフォルダの下には、任意の深さでサブフォルダを追加、名前変更、移動、削除できます。フォルダ名には英字、数字、アンダースコアのみ使用でき、同じ親フォルダ内で一意である必要があります（大文字・小文字は区別されません）。ルートフォルダは削除できません。 フォルダにカーソルを合わせ、必要に応じてタブレットと鉛筆のアイコンを使用して名前を変更します。プラス記号のフォルダアイコンを使用すると、ツリーにサブフォルダを追加できます。最上位のフォルダは削除できませんが、ゴミ箱アイコンをクリックするとサブフォルダを削除できます。詳細は[フォルダツリーの管理](#フォルダツリーの管理)を参照してください。 ##### 送信フォルダ | 設定 | 説明 | | - | - | | **セクションヘッダー** | パートナーのメールボックスページのダウンロードセクションの上に表示される見出しです。デフォルトは**あなたへのファイル**です。 | ##### 受信フォルダ | 設定 | 説明 | | - | - | | **セクションヘッダー** | パートナーのメールボックスページのアップロードセクションの上に表示される見出しです。デフォルトは**あなたの提出物**です。 | ### Settings タブ #### Connector Info *コネクタを識別・説明するための一般設定。* | 設定 | 説明 | | - | - | | **Connector Id** | コネクタの静的で一意の識別子。 | | **Connector Type** | コネクタ名とその機能の説明を表示します。 | | **Connector Description** | コネクタおよびフロー内でのその役割について自由形式の説明を提供するためのオプションフィールド。 | ### Advanced タブ #### Advanced Settings | 設定 | 説明 | | - | - | | **Upload History Retention** | パートナーがアップロードしたファイルが、メールボックスページの提出履歴に表示され続ける日数です。デフォルトは30日です。ファイル自体は受け入れられた時点でフローに渡されます。この設定は、パートナーが自分の提出内容を確認できる期間のみを制御します。 | #### Logging *ログの作成と保存を制御する設定です。*
設定 説明
**Log Level** コネクタが生成するログの詳細度です。サポートを依頼する際は、これを**Debug** に設定してください。
**Log Subfolder Scheme** 選択した間隔に従って、コネクタがLogs フォルダ内のファイルをグループ化するよう指示します。**Weekly** オプション（デフォルト）は、コネクタが毎週新しいサブフォルダを作成し、その週のすべてのログをそのフォルダに保存するよう指示します。この設定を空白のままにすると、コネクタはすべてのログをLogs フォルダに直接保存します。多数のトランザクションを処理するコネクタでは、サブフォルダを使用することでログを整理しやすくなり、パフォーマンスが向上します。
**Log Messages** 処理したファイルのログエントリにファイル自体のコピーを含めるには、これをオンにします。これを無効にすると、**Transactions** タブからファイルのコピーをダウンロードできなくなる場合があります。
#### Miscellaneous *Miscellaneous 設定は、特定のユースケース向けの設定です。*
設定 説明
**Other Settings** 非表示のコネクタ設定をセミコロン区切りのリストで設定できます（例：`setting1=value1;setting2=value2`）。通常のコネクタのユースケースや機能では、これらの設定の使用は必要ありません。
### Alerts タブ *アラートの設定に関する設定です。* サービスレベルアグリーメント（SLA）を実行する前に、通知用のメールアラートをセットアップする必要があります。デフォルトでは、Arc は[Alerts](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/alerts.md) タブのグローバル設定を使用します。このコネクタに別の設定を使用するには、**Override global setting** をオンに切り替えます。 デフォルトではエラーアラートが有効になっており、エラーが発生するたびにメールが送信されます。これをオフにするには、**Enable** チェックボックスのチェックを外します。 **Subject**（必須）を入力します。**Allow ArcScript in Subject** をチェックすると、**Subject** フィールドでArcScript を使用できます。これを選択すると、**ArcScript エディタ**ボタンが表示されます（![arcscript editor button](https://docs.arc.cdata.com/26.4/images/rest_arcscript_editor.png)）。 必要に応じて**Recipient** のメールアドレスをカンマ区切りのリストで入力します。 ### SLAs タブ *サービスレベルアグリーメント（SLA）の設定に関する設定です。* SLA を使用すると、フロー内のコネクタが送受信すると見込まれるボリュームを設定し、そのボリュームを達成すると見込まれる期間を設定できます。CData Arc は、SLA が達成されない場合にユーザーへ警告するメールを送信し、SLA を*At Risk* としてマークします。これは、SLA が間もなく達成されない場合に*Violated* としてマークされることを意味します。これにより、ユーザーは介入してSLA が達成されない理由を特定し、適切な対応を取る機会を得られます。At Risk 期間の終了時点でもSLA が達成されない場合、SLA はviolated としてマークされ、ユーザーに再度通知されます。 SLA が*At Risk* または*Violated* に移行したことも[アプリケーションログ](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/activity.md#アプリケーションログ)に書き込まれるため、Application Performance Monitoring（APM）やログ収集ツールでもアラートを設定できます。 SLA を定義するには、**Expected Volume** をオンに切り替え、**Settings** タブをクリックします。 ![SLA Empty](https://docs.arc.cdata.com/26.4/images/sla_empty.png) 次の例は、月曜日から金曜日まで毎日1000 件のファイルを受信すると見込むコネクタ向けに設定されたSLA を示しています。1000 件のファイルが受信されていない場合、期間の終了の1時間前にAt Risk 通知が送信されます。 ![SLA Configuration Example](https://docs.arc.cdata.com/26.4/images/sla_defined.png) > [!NOTE] > > 必要に応じてSLA アラートをオフにすることができます。これはメンテナンスウィンドウ中に役立ちます。navbar で**Settings** をクリックし、**Alerts > General Alerts** に移動します。タブレットと鉛筆のアイコンをクリックして編集し、**SLA Alerts** 設定のチェックを外します。 ## ルーティングの仕組み Partner Mailbox コネクタのルーティングは、他のMFT コネクタでも使用されている標準の`SubFolder` ヘッダーの仕組みを使用します。 **パートナーによるアップロード（Receive フォルダ）** パートナーがファイルをアップロードすると、そのファイルはメールボックスページでパートナーが選択したReceive サブフォルダに書き込まれます。生成されるメッセージには、そのフォルダのパスが設定された`SubFolder` ヘッダーが付与されます。[Branch](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/branch.md) のような下流のコネクタは、このヘッダー値に基づいてメッセージをルーティングできます。これは、複数のReceive サブフォルダを定義する主な理由です。パートナーは適切なフォルダを選択することで送信するファイルの種類を示すことができ、フローはそれに応じて分岐します。 **パートナー宛てにファイルを用意する（Send フォルダ）** パートナーのページ上の特定のSend サブフォルダにファイルを配信するには、メッセージがPartner Mailbox コネクタに到達する\_前に\_、上流のコネクタまたはスクリプトが目的のサブフォルダパスを`SubFolder` ヘッダーに設定しておく必要があります。コネクタ自体にルーティングUI はありません。通常は[Script](https://docs.arc.cdata.com/26.4/cloud/ja/connectors/script.md) コネクタを使用して、フローの早い段階でヘッダーを設定する必要があります。 > [!NOTE] > > 上流のコネクタで`SubFolder` ヘッダーを設定する際は十分に注意してください。ヘッダーが設定されていない場合や、存在しないパスが設定されている場合、ファイルは配信不能として報告され、エラーメッセージビューに追加されます。詳細は[フォルダツリーの管理](#フォルダツリーの管理)を参照してください。 ## フォルダツリーの管理 Send またはReceive フォルダの名前変更、移動、削除は、すでに用意されている、または処理中のファイルに影響を与える可能性があります。このような変更を確定する前に、Arc は影響を受けるフォルダ内の現在のファイル数を表示します。続行する前に、取り残されるファイルがないことを確認してください。 フォルダの名前が変更されたり移動されたりしても、古いパスの下にすでに用意されているファイルは自動的に更新されません。`SubFolder` ヘッダーに古いパスを設定している上流のコネクタまたはスクリプトも、新しいパスを使用するように更新する必要があります。 配信不能として報告されたファイルは、エラーメッセージビューに表示されます。不足しているフォルダを追加するか、上流のスクリプトを修正すれば、それらを再キューイングできます。 ## 保持期間とファイルのライフサイクル 以下のルールは、Send フォルダ内のファイルが用意された後にどのように管理されるかを規定します。 * **Delete after download**：最初のダウンロード後、ファイルはパートナーのメールボックスページから削除されます。**File Retention For Downloaded Files** を0に設定した場合も同じ効果になります。 * **Keep until retention passes**：保持期間が満了するまで、パートナーはファイルを再ダウンロードできます。各ダウンロードは、コネクタのトランザクションログに送信成功として記録されます。 * **保持期間は最初のダウンロードから起算され**、ファイルが用意された時点からではありません。再ダウンロードしても保持期間はリセットされません。 * **一度もダウンロードされていないファイルは、保持期間の設定によって削除されることはありません。** 手動で削除されるまで利用可能な状態が続きます。 * **アプリケーションレベルおよびワークスペースレベルのSend フォルダの[クリーンアップ設定](https://docs.arc.cdata.com/26.4/cloud/ja/getting-started/administration/settings/cleanup-settings.md)は、Partner Mailbox のSend フォルダには影響しません。** Partner Mailbox コネクタは、独自に保持期間を管理します。 ## Partner Mailbox ビュー パートナーは、パートナーメールボックス構成 タブに表示される**パートナーメールボックスURL** にアクセスし、認証情報を入力することでメールボックスにアクセスします。認証にはブラウザネイティブのベーシック認証が使用されます。 メールボックスページには、次の画像に示すように2つのセクションがあります。 ![あなたへのファイルとあなたの提出物のセクションが並んで表示されたパートナーメールボックスページ](https://mintcdn.com/cdata-arc/fuF73A8feEsIWbbA/26.4/images/partner-mailbox-page.png?fit=max\&auto=format\&n=fuF73A8feEsIWbbA\&q=85\&s=f16fa76e77de81a157c3079c18f57d49) ### あなたへのファイル (Send フォルダ) パートナーがダウンロードするために用意されたファイルを一覧表示します。各行には、ファイル名、ファイルサイズ、ファイルが用意された日付、ステータスが表示されます。ステータスは、パートナーがまだダウンロードしていないファイルの場合は**Available**、最初にダウンロードした日付とともに**Downloaded** と表示されます。ダウンロードボタンは、利用可能な行にのみ表示されます。フォルダ全体をダウンロードすると、フォルダ名を付けたzipファイルが返されます。保持期間が経過したファイルは、通知なく一覧から削除されます。 ### あなたの提出物 (Receive フォルダ) パートナーがアップロードしたファイルを一覧表示します。各行には、ファイル名、ファイルサイズ、提出日時、ステータスが表示されます。ファイルをアップロードするには、パートナーはアップロードゾーンにファイルをドラッグ＆ドロップするか、ファイルピッカーを使用して、現在選択されているReceive サブフォルダを対象にします。成功と失敗はトースト通知で表示されます。ファイル拡張子フィルタによってブロックされたアップロードには、拒否の理由を説明する通知が含まれます。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.