> ## 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.

# 認識設定

認識は FineReader Engine のプロファイルによって制御されます。プロファイルは、定義済みプロファイルと、その設定を上書きするオプションのユーザープロファイル (INI ファイル) で構成されます。言語、精度モード、テーブル検出をはじめ、エンジンの設定はすべてプロファイルで決まります。

リクエストで独自のプロファイルが指定されない限り、各ジョブにはデプロイメントのデフォルトプロファイルが使用されます。

## デプロイメントのデフォルト設定

| 値 | 説明 |
| - | - |
| `worker.predefinedProfile` | 定義済みプロファイル。デフォルトは `DocumentConversion_Normal` です。 |
| `worker.userProfile` | 複数行の文字列で指定するユーザープロファイル。デフォルトでは空です。 |

独自のプロファイルを作成する際は、このプロファイルをベースにするとよいでしょう。

```ini profile.ini theme={null}
[PagePreprocessingParams]
CorrectOrientationMode = COM_No

[PageAnalysisParams]
DetectTables = true
DetectPictures = true
DetectTextOnPictures = true

[SynthesisParamsForDocument]
DetectDocumentStructure = true

[RecognizerParams]
LanguageDetectionMode = TSPV_No
TextLanguage = English
Mode = RM_Accurate
LowResolutionMode = true

[XMLExportParams]
WriteCharFormatting = true
WriteParagraphStyles = true
```

FineReader Engine がデフォルトのプロファイルを受け付けない場合、ワーカーは準備完了状態にならず、処理を一切引き受けません。詳しくは[トラブルシューティング](https://docs.abbyy.com/ja/fine-parser/enterprise/reference/troubleshooting.md#workers-are-unready)を参照してください。`worker.userProfile` を変更した後は、ワーカーを再起動してください。詳しくは[変更の適用](https://docs.abbyy.com/ja/fine-parser/enterprise/basics/configuration.md#applying-changes)を参照してください。

## リクエストごとのプロファイル

`POST /parse` と併せて `baseProfile` と `userIni` を送信します。そのリクエストのジョブでは、デフォルトの代わりにこれらが使用されます。

| Field | Value |
| - | - |
| `baseProfile` | 定義済みプロファイルの名前。 |
| `userIni` | ユーザープロファイル。フォームフィールドまたはファイルとして指定します。UTF-8、最大 1 MiB。 |

```bash theme={null}
sed 's/TextLanguage = English/TextLanguage = German/' profile.ini > german.ini
curl -F files=@brief.pdf -F outputTypes=txt \
  -F baseProfile=DocumentConversion_Normal -F userIni=@german.ini \
  http://localhost:8080/parse
```

定義済みプロファイル：`DocumentConversion_Normal`、`DocumentConversion_Accuracy`、`DocumentArchiving_Accuracy`、`DocumentArchiving_Speed`、`TextExtraction_Accuracy`、`TextExtraction_Speed`、`DataExtraction`、`FieldLevelRecognition`、`BarcodeRecognition`、`BarcodeRecognition_Accuracy`、`BarcodeRecognition_Speed`、`HighCompressedImageOnlyPdf`、`BusinessCardsProcessing`、`MachineReadableZone`、`EngineeringDrawingsProcessing`。

FineReader Engine が受け付けないプロファイルを指定した場合、ジョブは理由 `profile-rejected` で失敗し、メッセージに該当する設定名が示されます。このジョブは再試行されません。

## 参照

* [定義済みプロファイル](https://docs.abbyy.com/ja/fine-reader/engine/specifications/predefined-profiles-specification.md)
* [プロファイルの操作](https://docs.abbyy.com/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles.md)
* [言語](https://docs.abbyy.com/ja/fine-parser/basics/languages.md)：FineReader Engine が認識できる言語の名前一覧
