外部アセンブリ - ABBYY Documentation

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

外部アセンブリの追加

アセンブリは、バッチタイプのプロパティ、Projectプロパティ、または Document Definition のプロパティの .NET References タブで追加できます。追加したアセンブリに含まれるすべてのクラスは、スクリプトおよびグローバルモジュールで使用できます。バッチタイプまたは Document Definition のプロパティに追加したアセンブリは、該当するバッチタイプまたは Document Definition で使用できます。Projectプロパティに追加したアセンブリは共有アセンブリとなり、Project 内のすべてのバッチタイプおよび Document Definition で使用できます。異なるバッチタイプや Document Definition で同じアセンブリが必要な場合は、共有アセンブリを使用します。共有アセンブリは、Projectプロパティでのみ更新します。

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

Add をクリック

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

アセンブリの種類を選択

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

アセンブリを指定

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

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

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

Addをクリック

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

Shared assemblyを選択

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

アセンブリ名を選択

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 を再起動します。アセンブリをデバッグするには、マネージドコードへの接続を使用します。

​外部アセンブリの追加

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

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

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

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

外部アセンブリの追加

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

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

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

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