外部アセンブリ

ABBYY FlexiCapture のスクリプトで外部 .NET アセンブリを使用するには、Project、バッチタイプ、または Document Definition のプロパティに追加し、.pdb ファイルを使用してデバッグします。

スクリプトおよびグローバルモジュールで、外部アセンブリを使用できます。標準アセンブリとコンパイル済みのユーザーアセンブリの両方を使用できます。

​

外部アセンブリの追加

アセンブリは、バッチタイプ のプロパティ、Projectプロパティ、または Document Definition のプロパティ の .NET References タブで追加できます。追加したアセンブリに含まれるすべてのクラスは、スクリプトおよびグローバルモジュールで使用できます。

バッチタイプまたは Document Definition のプロパティに追加したアセンブリは、該当するバッチタイプまたは Document Definition で使用できます。Projectプロパティに追加したアセンブリは共有アセンブリとなり、Project 内のすべてのバッチタイプおよび Document Definition で使用できます。

異なるバッチタイプや Document Definition で同じアセンブリが必要な場合は、共有アセンブリを使用します。共有アセンブリは、Projectプロパティでのみ更新します。

​

Projectプロパティにアセンブリを追加する

1. Add をクリック

   Projectプロパティの .NET References タブで、Add… をクリックします。

2. アセンブリの種類を選択

   表示された Add Assembly ダイアログで、Standard assembly name または Attached file のいずれかを選択します。

3. アセンブリを指定

   選択した種類に応じて、標準アセンブリ名を入力するか、アセンブリファイルを参照して選択します。

新しいバッチタイプには、共有アセンブリが自動的に適用されます。

​

バッチタイプまたはDocument Definitionに共有アセンブリを追加する

1. Addをクリック

   バッチタイプまたはDocument Definitionのプロパティにある**.NET References**タブで、**Add…**をクリックします。

2. Shared assemblyを選択

   表示されるAdd Assemblyダイアログで、Shared assemblyを選択します。

3. アセンブリ名を選択

   Referenceリストからアセンブリ名を選択します。

既存の標準アセンブリと似た名前の共有アセンブリは追加できません。

次のユーザーアセンブリのサンプルには、名前空間、クラス、メソッドが含まれています。

namespace TestNameSpace
{
    public class Test
    {
        public void Show(string text)
        {
            // FlexiCapture の標準的な手段、すなわち static クラス FCTools の static メソッド
            // void ShowMessage(string text, bool IsError) によって text を表示します。
            ABBYY.FlexiCapture.FCTools.ShowMessage(text, false);
        }
    }
}

追加したアセンブリのクラスとメソッドをイベントハンドラースクリプトで使用できるようにするには、バッチタイプのプロパティ (特定のバッチタイプの場合) またはProjectプロパティ (Default バッチタイプの場合) の**.NET References**タブでアセンブリを追加します。

次のスクリプトでは、Document Definition のプロパティの**.NET References**タブで外部アセンブリを追加します。

• スクリプトルール
• 自動補正スクリプト
• エクスポートスクリプト
• ユーザースクリプト
• ドキュメントアセンブリ スクリプト
• カスタム認識スクリプト

外部アセンブリのクラスとメソッドを使用するスクリプトには、次のコードを含める必要があります。

TestNameSpace.Test test = new TestNameSpace.Test(); // Test クラスのオブジェクトを作成します
test.Show("hello world"); // Test クラスの void Show() メソッドを呼び出します

​

外部アセンブリのデバッグ

外部アセンブリをデバッグするには、アセンブリ ファイルと、シンボル情報を含む .pdb ファイルの両方が必要です。.pdb ファイルがロードされているアセンブリのみデバッグできます。.pdb ファイルは大きいため、作業中のProjectではシンボル情報のロードを無効にしてください。

​

シンボル情報のロードを制御するレジストリ キー

以下のレジストリ キーを使用して、.pdb ファイルをロードするかどうかを制御できます。

レジストリ キー	説明
HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\LoadSymbolsFromOriginalPath	アセンブリ ファイルの元のフォルダーから .pdb ファイルをロードするかどうかを指定します。.pdb ファイルをロードするには、値を true に設定します。
HKEY_CURRENT_USER\Software\ABBYY\FlexiCapture\12.0\Controller\ScriptSupport\PDBSearchLocations	.pdb ファイルの検索パスを設定します。パスはセミコロンで区切って指定します。検索結果として、アセンブリ名と同じ名前のシンボル情報を含む .pdb ファイルが返されます。

デフォルトでは、これらのキーはレジストリに存在しません。必要に応じて、Administrator はユーザーのオペレーティング システムのレジストリにこれらのキーを追加できます。

レジストリの変更を有効にするには、ABBYY FlexiCapture を再起動します。

アセンブリをデバッグするには、マネージド コードへの接続を使用します。