> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# ABBYY FlexiCapture Connect
> ドキュメントのインポートとエクスポート、および Cloud プロジェクトとのデータセットの同期を行う Windows サービス、ABBYY FlexiCapture Connect をインストールして設定します。
ABBYY FlexiCapture Connect は Windows サービスとして動作し、ABBYY FlexiCapture Cloud プロジェクトへのドキュメントのインポート、ABBYY FlexiCapture Cloud プロジェクトからのドキュメントのエクスポート、およびデータセットの同期を行えます。
## システム要件
| 要件 | 詳細 |
| ------------- | --------------------------------------------------------------------------------------------------------- |
| オペレーティング システム | Windows 10、Windows 11、または Windows Server 2012、2012 R2、2016、2019、2022、2025 (いずれも Desktop Experience を含む) 。 |
| RAM | 約500,000件のベンダーを含むデータセットには、2.5 GB以上のRAMを推奨します。 |
| ソフトウェア互換性 | ABBYY FlexiCapture Application Server Release 3 以降、.NET Framework 4.6.1 以降。 |
## セットアップ
ABBYY FlexiCapture Connect を設定するには、次の手順に従います。
このセクションの手順に従う際は、サービス アカウントを使用することをお勧めします。
[https://www.abbyy.com/flexicapture-downloads/cloud/](https://www.abbyy.com/flexicapture-downloads/cloud/) から `FlexiCapture_Connect_Installer_*.msi` ファイルをダウンロードして実行します。
ABBYY FlexiCapture Connect がすでにインストールされていて、既存のバージョンを更新する場合は、`C:\Program Files (x86)\ABBYY FlexiCapture Connect\config.json` にある `config.json` ファイルのバックアップコピーを作成してください。
必要に応じて `config.json` ファイルを変更します ([設定ファイルの説明](#configuration-file-explained)を参照) 。
1. ABBYY FlexiCapture Connect サービスを一時停止します。
2. `ABBYY.FlexiCapture.Connect.exe` ファイルを実行します。詳細なログが表示されたコンソールウィンドウが開きます。
ABBYY FlexiCapture Connect サービスを再起動します。
## 設定ファイルについて
一般的な設定ファイルは次のようになります。
```json theme={null}
{
"url": "https://europe.flexicapture.com/",
"tenant": "testtenant",
"user": "user1",
"password": "password1",
"projects": [
{
"name": "project1",
"import": {
"directory": "C:\\HotFolder\\Import",
"fileMask": "*",
"settings": {
"region": "US",
"verification_type": "NoVerification",
"export_format": "Xml"
},
"createDocument": "ForEachFile",
"period": "00:01:00",
"schedule": [ "12:00:00", "06:00:00" ]
},
"export": {
"directory": "C:\\HotFolder\\Export",
"period": "00:01:00",
"schedule": [ "12:00:00" ]
},
"templates": [
{
"name": "template",
"datasets": [
{
"name": "DataSet",
"file": "C:\\HotFolder\\DataSets\\DataSet.csv",
"period": "00:01:00",
"schedule": [ "12:00:00" ]
}
]
}
]
}
]
}
```
一般的な設定ファイルの各セクションについては、以下で説明します。
### 一般設定
* **url** — テナントの URL (例: `https://europe.flexicapture.com`) 。
* **tenant** — テナント名。
* **user** — サービス アカウントのユーザー名。
* **password** — サービス アカウントのパスワード。
* **projects** — 各Projectの設定を含みます。たとえば、ドキュメントのインポート/エクスポート パラメーターや、データセット同期パラメーターなどです。
ドキュメントをインポートおよびエクスポートするには、テナントアカウントを **External User** として設定します。データセットを同期するには、テナントアカウントに **Administrator** ロール、または **Project Settings Editor** ロールと **External User** ロールの両方が必要です。既定では、テナントアカウントはすべてのProjectにアクセスできます。これは、特定のユーザーロールに付与するアクセス権を調整することで変更できます。詳細については、[ユーザーロールとアクセス権の設定](/ja/flexi-capture/admin-guide/roles-setup)を参照してください。
### Project設定
* **name** — Project名。
* **import** — ドキュメントのインポート設定。
* **export** — ドキュメントのエクスポート設定。
* **templates** — データセット同期の設定。
### インポート設定
* **directory** — ドキュメントのインポート元フォルダーのパスです。
* **fileMask** — ファイルとフォルダーのフィルターです。ワイルドカード `*` と `?` を使用できます。
* **settings** — バッチ の登録パラメーターです。
* **createDocument** — 指定できる値は `ForEachFile` (インポートした各ファイルごとに個別のドキュメントを作成) または `Automatically` (Project のパラメーターを使用) です。この機能を使用するには、まず ABBYY FlexiCapture project で **Document Definition が適用されたときに自動的に** オプションを選択します。
* **period** と **schedule** — タスク スケジュールです。`period` プロパティは task の開始頻度を指定します (たとえば、`"period": "00:02:30"` は 2 分 30 秒ごとに task を開始します) 。`schedule` プロパティは task の開始時刻を指定します (たとえば、`"schedule": [ "09:00:00", "19:00:00" ]` は毎日 9:00 と 19:00 に task を開始します) 。
ファイルがインポートされるたびに、新しい バッチ が作成されます。バッチ 名には現在の日時が含まれます。**period** プロパティと **schedule** プロパティは、それぞれ独立して設定できます。
### エクスポート設定
* **directory** — エクスポートしたファイルの保存先フォルダーのパス。
* **period** と **schedule** — インポート設定と同じ方法で指定するタスクスケジュール。
ドキュメントがエクスポートされると、現在「処理完了」ステージにあるプロジェクト内の各バッチごとにフォルダーが作成されます。これらの保存先フォルダーには、それぞれ対応するバッチと同じ名前が付けられ、すべての処理結果が格納されます。保存先フォルダーが削除されると、プログラムは同じ名前の新しいフォルダーを作成し、そこに処理結果を格納します。**period** プロパティと **schedule** プロパティは、それぞれ独立して設定できます。
### Document Definition 設定
* **name** — 指定したセクションに関連付けられた Document Definition の名前。
* **datasets** — Document Definition のデータセット同期パラメーター。
### データセット同期設定
* **name** — データセットの名前。
* **file** — ERP システムからエクスポートしたマスターデータを含む CSV ファイルへのパス。CSV ファイルの 1 行目には、データセットの field 名をカンマ区切りで記載する必要があります。また、カンマを含む値は二重引用符で囲む必要があります。
* **period** and **schedule** — Import 設定と同じ方法で指定するタスクの実行スケジュール。
データセットを同期する場合:
* 現在のデータセットは新しいものに置き換えられます。
* 既存のレコードのうち、検証オペレーターが変更したもの (値の編集、追加、削除による変更) は保存されて同期されますが、手動で追加した新しいレコードは削除され、同期されません。
* 非常に大きなデータセットでは、同期に数時間かかることがあります。
次の例は、複数の IBAN (国際銀行口座番号) を持つベンダーを含む "Vendors" データセットの CSV ファイルを示しています:
```text theme={null}
Id,Name,Street,City,ZIP,CountryCode,VATID,IBAN,IBAN,BusinessUnitId
1,MacWay,9 Route d'Eschau,Illkirch-Graffenstaden,67411,FR,1A345678901,FR1420041010050500012M02606,FR7630006000011234567890189,1
2,Bottled Water Ltd,Mary Ann St,Cardiff,CF102EN,GB,123456789,GB29NWBK60161331926819,,2
3,CCcompany Ltd.,2 Wilkins Grove,Welwyn Garden City,AL86JS,GB,234567890,GB27BOFI90212729823529,,3
4,MANZANA solutions,"Calle de la Botanica, 15",Madrid,28000,ES,E73895722,ES9121000418450200051332,,4
```
## Windows Vault にサービス アカウントの認証情報を保存する
サービス アカウントの認証情報は、ABBYY FlexiCapture Connect サービス ディレクトリ内の `config.json` ファイルに保存することも、より安全な方法として Windows Vault に保存することもできます。詳細については、[Credential Manager](https://support.microsoft.com/en-us/help/4026814/windows-accessing-credential-manager) および [cmdkey](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/cmdkey) に関する Microsoft の Documentation を参照してください。
ABBYY FlexiCapture Connect が Windows Vault からサービス アカウントの認証情報を取得できるようにするには、次の手順に従います。
新しい Windows アカウントを作成するか、既存の Windows アカウントを選択します。
その Windows アカウントで `cmd.exe` を実行し、次の command を実行します。ここで、`https://europe.flexicapture.com#tenant` は ABBYY FlexiCapture の URL とテナント名を組み合わせたものです。
```text theme={null}
cmdkey /generic:https://europe.flexicapture.com#tenant /user:userName /password:p@ssword
```
ABBYY FlexiCapture Connect サービス ディレクトリにある `config.json` ファイルから、user name と password を削除します。
**Windows Service Manager** (`services.msc`) を起動し、2 番目の手順で選択したものと同じ Windows アカウントで起動するように ABBYY FlexiCapture Connect を設定します。
1. **Services** のプロパティで、**ABBYY FlexiCapture Connect** を開きます。
2. **Log On** タブで、**This account** を選択し、Windows アカウントの認証情報を入力します。
Windows Vault から認証情報を削除するには、次の手順に従います。
**Credential Manager** を開きます。
**Windows Credentials** タブで、削除する認証情報を展開し、**Remove** をクリックします。
## エクスポートを設定する
ABBYY FlexiCapture Connect を使用して ABBYY FlexiCapture Cloud からファイルをエクスポートするには、以下の説明に従ってProjectを設定します。
**\ Properties** ダイアログの **General** タブで、**ルート エクスポート パス** field が空欄のままであることを確認します。詳細については、[Projectのプロパティ](/ja/flexi-capture/project-settings/project-properties)を参照してください。
**Export Settings** ダイアログで、**\ Properties** ダイアログの **General** タブで指定したルート パスからの相対パスとして、エクスポート パスを指定します。このルート パスは空のままにしているため、ルート パスそのものは含めずにディレクトリを指定します。
**If file exists** オプションは無視されます。ABBYY FlexiCapture Cloud から ABBYY FlexiCapture Connect 経由でファイルをエクスポートすると、新しいドキュメントごとに新しいファイルが作成されます。
## 制限事項
現在のバージョンのABBYY FlexiCapture Connectには、次の制限があります。
* 同期できるデータセットは約500,000レコードまでです。
* データセットの更新中は、ユーザーはWeb Stationでベンダーを検索できません。
* 現在のバージョンでは、Project設定に基づくHot Folderのインポートプロファイルは認識されません。
* ABBYY FlexiCapture Connectは、サーバー上で利用可能なすべてのバッチからドキュメントをエクスポートします。Project設定は出力先ディレクトリ名に影響せず、その名前は常に元のバッチ名と同じになります。
* ABBYY FlexiCapture Connectでは、バッチ全体しかエクスポートできません。つまり、ProjectのWorkflow Settingsで**Wait for all documents in a batch**オプションを無効にしても、ドキュメントが個別にエクスポートされることはありません。
* 現在のバージョンでは、1つのバッチ内のすべてのドキュメントの結果を1つのファイルにエクスポートすることはできません。バッチ内の各ドキュメントごとに、エクスポートディレクトリ内に個別のファイルが作成されます。
* 現在のバージョンでは、すべてのバッチの結果を1つのファイルにエクスポートすることはできません。各バッチの各ドキュメントごとに、エクスポートディレクトリ内に個別のファイルが作成されます。
* インポートおよびエクスポートするファイルのサイズは199 MBまでに制限されています。
* プロキシサーバーはサポートされていません。
## トラブルシューティング
エラーが発生した場合は、まず `%LocalAppData%\ABBYY\FlexiCapture\Connect\Logs` にあるログファイルを確認してください。エラーは、設定ファイルに指定された設定が正しくない、または不完全であることが原因で発生する場合もあります。不整合や設定漏れがないか、`config.json` ファイルを確認してください。
エラーが解消しない場合は、ABBYY テクニカルサポートにお問い合わせください。テクニカルサポートでは、`config.json` ファイルとログファイルの両方が必要になる場合があります。