スクリプト コンポーネント エディタでのスクリプト コンポーネントの構成

変換および変換先では、[スクリプト変換エディタ] の [入力列] ページが表示されます。変換元では表示されません。このページでは、使用できる入力列から、使用するカスタム スクリプトを選択し、その入力列に読み取り専用でアクセスするか、または読み取り/書き込みでアクセスするかを指定します。

このメタデータに基づいて生成されるコード プロジェクトでは、BufferWrapper プロジェクト アイテムに、各入力のクラスが含まれます。このクラスには、選択した各入力列用の型指定されたアクセサ プロパティが含まれています。たとえば、CustomerInput という名前の入力から整数型の CustomerID 列と文字列型の CustomerName 列を選択した場合、BufferWrapper プロジェクト アイテムには ScriptBuffer から派生した CustomerInput クラスが格納されます。CustomerInput クラスからは、CustomerID という名前の整数型プロパティと、CustomerName という名前の文字列型プロパティが公開されます。この規則により、次のような型チェック付きのコードが記述できます。

Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName

特定の種類のデータ フロー コンポーネントの入力列を構成する方法の詳細については、「特定の種類のスクリプト コンポーネントの開発」で、該当する例を参照してください。

変換元、変換、および変換先では、[スクリプト変換エディタ] の [入力および出力] ページが表示されます。このページでは、カスタム スクリプトで使用する入力、出力、および出力列を追加、削除、および構成します。ただし、次のような制限があります。

• スクリプト コンポーネントを変換元として使用する場合、入力はありませんが複数の出力がサポートされます。

• スクリプト コンポーネントを変換として使用する場合、1 つの入力と複数の出力がサポートされます。

• スクリプト コンポーネントを変換先として使用する場合、1 つの入力がサポートされますが出力はありません。

このメタデータに基づいて生成されるコード プロジェクトでは、BufferWrapper プロジェクト アイテムに、各入力および出力のクラスが含まれます。たとえば、CustomerOutput という名前の出力を作成した場合、BufferWrapper プロジェクト アイテムには、ScriptBuffer から派生した CustomerOutput クラスが含まれます。CustomerOutput クラスには、作成された各出力列用の型指定されたアクセサ プロパティが含まれます。

出力列は、[入力および出力] ページでのみ構成できます。変換および変換先の入力列は、[入力列] ページで選択できます。BufferWrapper プロジェクト アイテムで作成された、型指定されたアクセサ プロパティは、出力列の書き込み専用プロパティです。入力列のアクセサ プロパティは、[入力列] ページで各列に選択した使用法の種類に応じて、読み取り専用または読み取り/書き込みのプロパティになります。

特定の種類のデータ フロー コンポーネントの入力および出力を構成する方法の詳細については、「特定の種類のスクリプト コンポーネントの開発」で、該当する例を参照してください。

注意
エラー行の自動処理のスクリプト コンポーネントでエラー出力として出力を直接構成することはできませんが、別の出力を作成するか、可能な場合はスクリプトを使用してこの出力に行を送信することによって、エラー出力の機能を再現することができます。詳細については、「スクリプト コンポーネントに対するエラー出力のシミュレート」を参照してください。

出力の ExclusionGroup プロパティおよび SynchronousInputID プロパティ

ExclusionGroup プロパティは、同期出力型の変換でのみ、0 以外の値になります。この場合、コードはフィルタまたは分岐を実行し、各行を、ExclusionGroup の 0 以外の同じ値を共有する出力の 1 つに送ります。たとえば変換は、行を既定の出力またはエラー出力のどちらかに送信できます。この場合に追加の出力を作成するには、SynchronousInputID プロパティの値が、コンポーネントの入力の ID と一致する整数に設定されていることを確認します。

SynchronousInputID プロパティは、同期出力型の変換でのみ、0 以外の値になります。このプロパティの値が 0 の場合、出力が非同期型であることを示します。同期出力では、新しい行を追加せず、選択した出力に行が渡されます。このプロパティには、コンポーネントの入力の ID が含まれている必要があります。

注意

[スクリプト変換エディタ] による最初の出力作成時には、出力の SynchronousInputID プロパティが、コンポーネントの入力の ID に設定されます。しかし、その後の出力時には、出力の SynchronousInputID プロパティが 0 に設定されます。 同期出力型コンポーネントを作成する場合、各出力の SynchronousInputID プロパティを、コンポーネントの入力の ID に設定する必要があります。このため、最初の出力後は、エディタで出力を作成するたびに、SynchronousInputID 値を 0 からコンポーネントの入力の ID に変更する必要があります。 非同期出力型コンポーネントを作成する場合、各出力の SynchronousInputID プロパティを 0 に設定する必要があります。このため、最初の出力時は、SynchronousInputID 値をコンポーネントの入力の ID から 0 に変更する必要があります。

スクリプト コンポーネントで 2 つの同期出力のうちのいずれかに行を送信する例については、「スクリプト コンポーネントによる同期変換の作成」を参照してください。

スクリプト コンポーネントは、入力と出力の名前を解析し、入力と出力内の列の名前を解析します。次に、これらの名前に基づいて、BufferWrapper プロジェクト アイテムにクラスとプロパティを生成します。見つかった名前に、Unicode カテゴリの UppercaseLetter、LowercaseLetter、TitlecaseLetter、ModifierLetter、OtherLetter、または DecimalDigitLetter に属していない文字が含まれている場合、無効な文字は生成された名前から削除されます。たとえば、スペースは削除されるため、FirstName と [First Name] という名前の 2 つの入力列は、どちらも列名 FirstName を持つと解釈され、予期しない結果が生じます。このような状況を防ぐには、スクリプト コンポーネントで使用される入力と出力の名前、および入力と出力の列の名前には、このセクションで一覧表示されている Unicode カテゴリに属する文字のみが含まれるようにする必要があります。

[スクリプト変換エディタ] の [スクリプト] ページでは、スクリプト タスクに一意の名前および説明を割り当てます。また、次のプロパティの値を割り当てることができます。

注意
SQL Server 2008 Integration Services (SSIS) では、すべてのスクリプトが事前コンパイルされます。以前のバージョンでは、タスクの Precompile プロパティを設定することによって、スクリプトを事前コンパイルするかどうかを指定していました。

ValidateExternalMetadata プロパティ

ReadOnlyVariables プロパティおよび ReadWriteVariables プロパティ

既存の変数をコンマ区切りリストとして、これらのプロパティの値に入力すると、スクリプト コンポーネントのコード内で、その変数に読み取り専用アクセスまたは読み取り/書き込みアクセスできるようになります。変数には、自動生成された基本クラスの ReadOnlyVariables および ReadWriteVariables プロパティを介して、コード内でアクセスします。詳細については、「スクリプト コンポーネントでの変数の使用」を参照してください。

注意
変数名の大文字と小文字は区別されます。

[ScriptLanguage]

[スクリプトの編集] ボタン

[スクリプト変換エディタ] の [接続マネージャ] ページでは、カスタム スクリプトで使用する接続マネージャを追加および削除します。通常、変換元または変換先コンポーネントを作成する場合は、接続マネージャを参照する必要があります。

このメタデータに基づいて生成されるコード プロジェクトの ComponentWrapper プロジェクト アイテムには、選択した各接続マネージャ用の型指定されたアクセサ プロパティを格納する Connections コレクション クラスが含まれます。型指定された各アクセサ プロパティの名前は、接続マネージャ自体の名前と同じであり、IDTSConnectionManager100 のインスタンスとして、接続マネージャへの参照を返します。たとえば、エディタの [接続マネージャ] ページに MyADONETConnection という名前の接続マネージャを追加した場合、次のコードを使用して、スクリプト内のその接続マネージャへの参照を取得できます。

Dim myADONETConnectionManager As IDTSConnectionManager100 = _
    Me.Connections.MyADONETConnection

詳細については、「スクリプト コンポーネントでのデータ ソースへの接続」を参照してください。