第 6 章 LCFieldlist クラス
この章では、LCFieldlist クラスのメソッドおよびプロパティについて説明します。
LCFieldlist クラスの概要
LCFieldlist クラスは、レコードのメタデータ (データソースのデータの説明) を表すもので、1 つ以上のレコード値について LCField の形式でデータを参照できます。フィールドリストとは、フィールドとフィールド名を表示順と共に指定するリストです。フィールドリスト内のフィールドは、さまざまな方法で追加、変更、取得、および表示できます。フィールド、フィールド名、および順序はそれぞれ別のエンティティで、各フィールドリスト内でのみ関連を持ちます。
LEI Scripted アクティビティの構文 - 2
IBM® Lotus Enterprise Integrator® (LEI) Scripted アクティビティ向けの LotusScript® Extensions (LC LSX) スクリプトを記述するときには、Dim LCSession を名前付きのセッションとして指定する必要があります。これが、デフォルトのログ文書名となります。LCConnection も、既存の名前付き LEI コネクション文書として宣言する必要があります。
フィールドデータにアクセスする
LCFieldlist オブジェクト内のフィールドのデータは、プロパティとして名前によってアクセスできます。プロパティのデータ型は、フィールドのデータ型により異なります。プロパティは、次の表に示す LotusScript のデータ型の配列です。例えば、フィールドリストに OrderID というフィールドがある場合は、次のスクリプトを使用して最初の値を取得できます。
フィールドリストのマージとマッピング
フィールドリストを LCFieldlistMerge および LCFieldlistMergeVirtual とマージすることにより、フィールドをマッピングできます。マッピングを実行するために、名前ソースとして 1 つ、フィールドおよびデータソースとして 1 つ、計 2 つのフィールドリストを用意します。マージのオプションに応じて、名前ソースの名前とデータソースのフィールドがマッピングされます。さらに、元のフィールドリストの各部分を参照する 3 つ目のフィールドリストが作成されます。仮想フィールドおよび LCFieldlistMergeVirtual を使用すると、データフィールドリストのフィールドのうち指定した仮想コードに一致するものはマッピングから除外され、別の新たな仮想フィールドリストに追加されます。
LCFieldlist クラスのメソッドの要約
ここでは、LCFieldlist クラスのメソッドについて要約します。
LCFieldlist の New メソッド
LCFieldlist のコンストラクタです。
LCFieldlist の Append メソッド
このメソッドは、新しいフィールドを作成し、既存のフィールドリストに追加します。
LCFieldlist の Copy メソッド
このメソッドは、LCFieldlist およびそのすべてのデータの複製コピーを作成します。LCFieldlist のフィールドもすべて複製されるため、2 つのフィールドリストが同じ LCField オブジェクトを参照することはありません。
LCFieldlist の CopyField メソッド
このメソッドは、既存のフィールドをコピーし、フィールドのコピーをフィールドリストの指定された位置に挿入します。
LCFieldlist の CopyRef メソッド
このメソッドは、新しいフィールドリストオブジェクトインスタンスを、別のフィールドリストの部分コピーとして作成します。フィールドリストのフィールドはコピーされるのではなく、参照されます。
LCFieldlist の GetField メソッド
このメソッドは、フィールドリストの指定位置からフィールド参照を取得し、その値を変数に格納します。
LCFieldlist の GetName メソッド
このメソッドは、フィールドリスト内のフィールド名のコピーを取得します。
LCFieldlist の IncludeField メソッド
このメソッドは、既存のフィールドをフィールドリストに追加します。
LCFieldlist の Insert メソッド
このメソッドは、既存フィールドリストのインデックスで指定された位置に新しいフィールドを挿入します。
LCFieldlist の List メソッド
このメソッドでは、フィールドリスト内の 1 つのフィールドの情報を取り出します。繰り返し呼び出すことで、リスト内のフィールドを順に取り出すことができます。
LCFieldlist の Lookup メソッド
このメソッドは、フィールド名に基づいて、フィールドリストからフィールドを検索します。
LCFieldlist の Map メソッド
このメソッドは、フィールドリストのフィールド参照を別のフィールドリストにコピーします。CopyRef メソッドに似ていますが、新しい参照を作成するフィールド名を指定する点が異なります。
LCFieldlist の MapName メソッド
このメソッドは、フィールドの名前を変更してマップします。このメソッドは、ソースとターゲットのフィールド名が異なる場合にフィールドをマッピングするときに使用します。これにより、フィールドの順序を変更でき、一部のフィールドを除外することもできます。
LCFieldlist の Merge メソッド
このメソッドは 2 つのフィールドリストをマージします。1 つのフィールドリストから名前をコピーし、もう 1 つのフィールドリストのフィールドオブジェクトを使用して 3 つ目のマッピングフィールドリストに挿入します。このメソッドは、フィールドマッピングオペレーション時に名前フィールドリストが作成済みの場合、またはフィールドリストのフラグを使用する場合に使用します。
LCFieldlist の MergeVirtual メソッド
このメソッドは、2 つのフィールドリストをマージして、新しいマッピングと仮想フィールドリストを作成します。
LCFieldlist の Remove メソッド
このメソッドは、既存のフィールドをフィールドリストから削除します。関連付けられたメタデータの列は削除されません。結果セットの列の削除または追加がどのようにフェッチや挿入などのオペレーションメソッドに影響するかについては、「フィールドリストのマージとマッピング」を参照してください。
LCFieldlist の Replace メソッド
このメソッドは、新しい LCField オブジェクトを作成し、フィールドリスト内の既存フィールドを上書きします。既存フィールドのデータは新しいフィールドにコピーされません。
LCFieldlist の SetName メソッド
このメソッドは、フィールドリスト内のフィールド名を変更します。
親トピック:
LSX for Lotus Connectors