スクリプト タスクでの変数の使用

Foreach ループ コンテナ内でのスクリプト タスクの使用

Foreach ループ コンテナ内でスクリプト タスクを繰り返し実行する場合、そのスクリプトは通常、列挙子内の現在のアイテムの内容を処理する必要があります。たとえば、Foreach File 列挙子を使用する場合、スクリプトは現在のファイル名を取得する必要があります。また、Foreach ADO 列挙子を使用する場合、スクリプトは現在のデータ行の列の内容を取得する必要があります。

変数を使用すると、Foreach ループ コンテナとスクリプト タスク間のこうしたやり取りが可能になります。[Foreach ループ エディタ] の [変数のマッピング] ページでは、単一の列挙アイテムによって返されたデータの各アイテムに、変数が割り当てられます。たとえば、Foreach File 列挙子の場合は、ファイル名のみがインデックス 0 で返されるためマッピングが必要な変数は 1 つのみですが、各行の複数のデータ列を返す列挙子の場合は、スクリプト タスクで使用する各列に、個別の変数をマップする必要があります。

列挙アイテムを変数にマップしたら、マップされた変数をスクリプトで使用できるように、[スクリプト タスク エディタ] の [スクリプト] ページで、それらの変数を ReadOnlyVariables プロパティに追加する必要があります。フォルダ内の画像ファイルを処理する Foreach ループ コンテナ内のスクリプト タスクの例については、「スクリプト タスクによる画像の操作」を参照してください。

変数の例

次の例では、スクリプト タスク内の変数にアクセスし、その変数を使用してパッケージ ワークフローのパスを決定する方法を示します。このサンプルでは、CustomerCount および MaxRecordCount という名前の整数型の変数を作成し、[スクリプト タスク エディタ] の ReadOnlyVariables コレクションに追加したものとします。CustomerCount 変数には、インポートされる顧客レコード数が格納されます。この値が MaxRecordCount の値よりも大きい場合、スクリプト タスクから失敗が報告されます。MaxRecordCount のしきい値を超過したために失敗が発生した場合、ワークフローのエラー パスには、任意の必要なクリーンアップを実装できます。

サンプルを正常にコンパイルするには、Microsoft.SqlServer.ScriptTask アセンブリへの参照を追加する必要があります。

Public Sub Main()

    Dim customerCount As Integer
    Dim maxRecordCount As Integer

    If Dts.Variables.Contains("CustomerCount") = True AndAlso _
        Dts.Variables.Contains("MaxRecordCount") = True Then

        customerCount = _
            CType(Dts.Variables("CustomerCount").Value, Integer)
        maxRecordCount = _
            CType(Dts.Variables("MaxRecordCount").Value, Integer)

    End If

    If customerCount > maxRecordCount Then
            Dts.TaskResult = ScriptResults.Failure
    Else
            Dts.TaskResult = ScriptResults.Success
    End If

End Sub

using System;
using System.Data;
using Microsoft.SqlServer.Dts.Runtime;

public class ScriptMain
{



    public void Main()
    {
        int customerCount;
        int maxRecordCount;

        if (Dts.Variables.Contains("CustomerCount")==true&&Dts.Variables.Contains("MaxRecordCount")==true)

        {
            customerCount = (int) Dts.Variables["CustomerCount"].Value;
            maxRecordCount = (int) Dts.Variables["MaxRecordCount"].Value;

        }

        if (customerCount>maxRecordCount)
        {
            Dts.TaskResult = (int)ScriptResults.Failure;
        }
        else
        {
            Dts.TaskResult = (int)ScriptResults.Success;
        }

    }

} 

関連項目

タスク

概念