データベースへのエクスポート

ABBYY FlexiCapture から、fieldマッピング、自動テーブル作成、ストアドプロシージャのサポートを使用して、抽出されたデータを ODBC 対応データベースに送信します。

1. Export Settings を開く

   Document Definition エディターで、Document Definition → Export Settings を選択します。

2. データベースエクスポートプロファイルを追加する

   Add をクリックし、Type fieldで Export to ODBC-compatible database を選択します。

3. エクスポート範囲を設定する

   エクスポートを必須にするか、画像をエクスポートするか、どの文書 (エラーあり、エラーなし、または両方) をエクスポートするかを指定します。Next をクリックします。

4. データベースに接続する

   Connection string ボックスに接続パラメーターを入力するか、Setup をクリックして Data Link Properties ダイアログで設定します。データベース用のプロバイダーとドライバーを使用します (データベースプロバイダーとドライバーを参照) 。プロバイダーとドライバーは、エクスポートを実行するコンピューターで使用可能である必要があります。

5. スキーマを選択する

   ドロップダウンリストからスキーマを選択します。Microsoft SQL では、スキーマの指定はオプションです (エクスポート、キャッシュ、ルール管理の場合) 。fieldを空白のままにすると、dbo スキーマが使用されます。PostgreSQL では、public スキーマを指定します。

   データベースにテーブルがない場合、dbo スキーマは一覧に表示されません。使用するには、スキーマfieldで空白の値を選択します。

6. fieldをマッピングする

   Test Connection をクリックして接続を確認し、Document Definition のfieldをデータベースにマッピングします。

   • 新しいテーブルを自動的に作成するには、Create Tables Automatically をクリックします。Document Definition のfieldとそのデータ型に対応した、ドキュメント セクションごとの個別テーブルが作成されます。
   • 既存のテーブルにエクスポートするには、Set Up Field Mapping をクリックし、Field Mapping ダイアログで、ドキュメント セクションごとにデータベーステーブルを、各fieldごとに列を選択します。ストアドプロシージャを使用してデータを保存することもできます。

   Next をクリックします。

7. 画像オプションを設定する

   画像 (文書画像または Picture field) を保存する場合にのみ、このステップを実行します。

   1. 画像をデータベースに保存するか、ファイルとして保存するかを選択します。ファイルとして保存する場合は、ファイル命名テンプレート (Edit をクリック) と上書き時の動作を設定します (エクスポートファイルの命名規則を参照) 。非表示にするfieldを指定します。Next をクリックします。
   2. 画像形式、品質、色を選択します。解像度を変更するには、Change resolution to を選択して値を指定します。PDF または PDF/A では、検索可能な PDF ファイルを作成できます。Next をクリックします。
8. 完了

   エクスポートプロファイル名を入力し、Finish をクリックします。

​

データベースプロバイダーとドライバー

データベース	プロバイダー	ドライバー
Microsoft SQL 2016 SP2、2017、または 2019	OLE DB Provider for ODBC Drivers	SQL Server
Access 2003、2007、または 2010	OLE DB Provider for ODBC Drivers	Microsoft Access Driver
Oracle 10g、11g、または 12c	Oracle Provider for OLE DB	不要
PostgreSQL	OLE DB Provider for ODBC Drivers	不要

プロバイダーを選択する際は、次の点に注意してください。

• Microsoft SQL では、OLE DB Provider for SQL Server を選択すると、特定のデータ型や長いfieldで問題が発生する場合があります。
• 64 ビット版の FlexiCapture を Access データベースに接続するには、64 ビット版の Access Database Engine x64 ドライバーをインストールしてください。
• Oracle については、Oracle データベースへのエクスポートを参照してください。

​

field をデータベースにマッピングする

Field Mapping ダイアログには、左側にドキュメント セクションと field、右側にデータベースのテーブルと列が表示されます。

• データベースにすでにテーブルがある場合は、各セクションに対応するデータベース テーブルと、各 field に対応する列を選択します。
• テーブルがない場合は、Create Tables Automatically をクリックして、エクスポートに必要な構造のテーブルを作成します。文書のfieldは列にマッピングされます。

field グループ、複数のインスタンスを持つ field、文書のテーブルは、それぞれ別のテーブルにエクスポートされ、主キーと外部キーによってメイン テーブルにリンクされます。FlexiCapture は必要に応じてこれらのキーを自動的に追加します。指定する必要があるのは、キーのエクスポート先となる field のみです。

オブジェクト数が少ないスキーマを使用してください。エクスポート前に、ABBYY FlexiCapture はスキーマ内のすべてのオブジェクトに関する情報をデータベースに照会するため、大規模なスキーマではテーブルの作成に長時間 (最大で数時間) かかることがあります。

次のこともできます。

• 既存のテーブルに不足している列を自動的に追加する: 文書のfieldを、(auto) が角括弧で示された類似名のデータベース field にマッピングしたままにするか、field を選択して Auto をクリックします。
• Auto を使用して Document Definition のセクションまたはテーブルの名前に基づく新しいテーブルを作成するか、名前が異なる場合は New を使用して各 field 用のテーブルを作成します。
• Move Up と Move Down を使用して、自動作成されたテーブル内の列の順序を変更します。
• Format を使用して、型付き field の保存方法を設定します。たとえば、Number field の小数点以下の桁数や、Date field の形式と区切り文字を設定できます。

Time field をエクスポートする場合は、データベース テーブルに DateTime 型の列を作成してください。既定の SmallDateTime 列を使用するとエラーが発生します。

選択するオプションに応じて、Picture field の内容と文書画像をファイル システムまたはデータベースにエクスポートできます。別ファイルにエクスポートする場合、ファイル名とパスは対応するデータベース field に保存されます (field のマッピング時に設定します) 。エクスポート パスがネットワーク ディスク上にある場合は、それを使用するすべてのステーションがアクセスできることを確認してください。パス string が 255 文字を超えると、エラーが発生します。その列の文字数制限を増やしてください。

​

ストアドプロシージャを使用したエクスポート

データベーステーブルに直接エクスポートするだけでなく、ストアドプロシージャを使用してデータを保存することもできます。ストアドプロシージャは、SQL 命令のセットを一度コンパイルしてサーバーに保存するデータベースオブジェクトです。ストアドプロシージャでは、数値計算や文字列計算のほか、標準的なデータベース操作を実行できます。

直接エクスポートと比較した利点:

• データベース処理の高速化。
• 追加の計算。
• データ整合性の確保。

Microsoft SQL 用ストアドプロシージャのサンプル:

Create procedure Export( @userId as int, @lastName as nvarchar(255), @firstName as nvarchar(255) )
as
begin
  if Exists( Select Id from Users where Id = @userId ) begin
     Update Users set LastName = @lastName, FirstName = @firstName where Id = @userId
  end else begin
     Insert into Users ( Id, LastName, FirstName ) values ( @userId, @lastName, @firstName )
  end
end

プロシージャに渡される 3 つのパラメーターは、FlexiCapture ドキュメントの field (識別子 UserId、名 FirstName、姓 LastName) です。Users テーブルにこの識別子を持つエントリが存在しない場合は、新しいエントリが追加されます。存在する場合は、そのエントリの名と姓が FlexiCapture の field values に置き換えられます。

​

ストアドプロシージャを使用したエクスポートの設定

まず、データベースへの接続を確立します (上記の手順を参照) 。Set Up Field Mapping をクリックし、データの保存に使用するストアドプロシージャを選択します。テーブル列へのマッピングとは異なり、エクスポートに使用できるfieldは、型が指定されたプロシージャのパラメーターです。各パラメーターの型は、マッピングするDocument Definition fieldのデータ型と一致している必要があります。文書のfieldをプロシージャのパラメーターにマッピングします。

テーブル、複数のインスタンスを持つfieldなどの複合field、および個別のfieldをエクスポートするには、子エントリをメインの文書エントリに関連付けるための適切なインデックスを設定します。戻り値 (@RETURN_VALUE) または出力パラメーターを、エクスポート可能な主キー (ROW_INDEX) として指定します。プロシージャはデータをテーブルに書き込み、現在のエントリの識別子を返します。この識別子は、子エントリをエクスポートする際にプロシージャに渡されます。

​

Oracle データベースへのエクスポート

データをデータベースにエクスポートする際は、ユーザーに使用した認可スキームを使用します。次の項目を指定します。

• ロール: Connect
• 権限: CREATE ANY TABLE (テーブルの作成用) 、INSERT ANY TABLE および UNLIMITED TABLESPACE (データのエクスポート用)

Field Mapping ダイアログの設定に権限は必要ありません。

Oracle データベースでは、Document Definitions 内の field 名が 30 文字を超えないようにしてください。Oracle へのエクスポート時に、30 文字を超える名前は切り詰められます。