ランタイム変数の編集

パイプライン・ジョブのランタイム・パラメータとして使用できる一連の変数を選択する方法を示します。

変数ページでは、パイプライン・ジョブのランタイム・パラメータとして使用できる一連の変数を選択できます。パイプラインを実行するとき、これらの変数の入力値が即時利用可能な一連の値またはランタイム値として提供され、ここからのパラメータ値を個々のジョブに使用できます。変数は、「期間」、「インポート・モード」、「エクスポート・モード」などの事前定義済のタイプにすることができます。

カスタム変数パラメータをジョブ・パラメータとして追加することもできます。たとえば、開始期間について代替変数を使用して静的値を渡す場合、変数タイプを「テキスト」に変更し、&ThisMonth#&ThisYearなど、代替変数をパラメータ(統合RESI APIで受け入れられるもの)として指定します。(代替変数は、先頭にアンパサンド(&)が1つまたは2つ付いたユーザー変数名です)。

デフォルトのランタイム変数には、次のものが含まれます:

  • 開始期間
  • 終了期間
  • インポート・モード
  • エクスポート・モード
  • メールの送信
  • 送信先
  • ログの添付
  • ステージ実行

パイプラインのランタイム変数を変更するには:

  1. データ統合ホーム・ページから、パイプラインの右側にあるイメージは「選択」アイコンを示します。をクリックし、「パイプライン詳細」を選択します。

  2. パイプライン・ページから、「変数」タブを選択します。

  3. 変更する変数を選択します。

  4. 「変数名」で、事前定義済の変数名を追加または変更するには、名前を指定します。

    変数名は、ジョブ・パラメータとして参照できます。名前には20文字まで使用でき、スペースを含めることはできません。

  5. 「表示名」で、変数の表示プロンプト名を指定します。

  6. 「表示順」で、変数の表示順を指定します。

  7. パイプラインを実行するために変数の値が必要である場合は、「必須」を選択します。

  8. 「検証タイプ」ドロップダウンから、変数を検証するために使用する値のタイプを選択します。

    検証タイプには次のものが含まれます:

    • リスト—LOV問合せを使用し、バインド値が必要です。
    • テキスト—フリー・フォーム・テキスト・フィールド

    • ファイル—ファイル名。ファイル・ブラウザ・ウィンドウを使用して、ファイルを選択できます。

    • カスタム・リスト—ユーザー定義の値リスト

      この検証タイプを使用するには、「検証のパラメータ」ウィンドウで値リストを指定します。次のように、値はValue,Label形式で指定する必要があり、それぞれの行は改行文字で終了する必要があります

      M,Month
Q,Quarter
Y,Year

    • 参照—使用可能な参照値の使用。

  9. 「検証のパラメータ」ドロップダウンから、検証タイプに基づいて変数の事前定義済パラメータを選択します。

    たとえば、リスト検証タイプに基づいて、次のような開始期間変数のパラメータを選択できます:

    • パイプライン・ステータス
    • パイプライン・エクスポート・モードLOV問合せ
    • グローバル期間名LOV問合せ
    • ロケーション、セキュリティなしLOV問合せ
    • 試算表の変換済のターゲット・エンティティ/勘定科目問合せ別
    • プロセス・モニター問合せ

  10. 「デフォルト値」から、変数のデフォルト値を選択します。

    デフォルト値は、静的値またはPlanning代替変数にすることができます。

    次の表に、デフォルトのランタイム変数およびその説明を示します。

    Table 12-40 デフォルトのランタイム変数および説明

    変数名 使用可能な値
    開始期間 パイプラインのインポート/エクスポート処理スコープに含まれる最初の期間を指定します。データ交換ステップで使用される期間範囲の開始を(「終了期間」とともに)設定して、処理する期間のデータを決定します。
    終了期間 パイプラインのインポート/エクスポート処理スコープに含まれる最後の期間を指定します。期間範囲の終了(「開始期間」で使用)を設定して、データ交換ステップで処理する期間のデータを定義します。
    インポート・モード

    データ交換パイプラインがインポート・ステップ時に受信データのロードを処理する方法、すなわち、既存データをインポートで置き換えるのか、またはターゲットの既存データに追加または更新するのかを指定します。

    • 置換: (デフォルト値)インポート・スコープの既存のターゲット・データを置換してから、新しいデータをロードします。
    • 追加: 既存のターゲット・データを保持し、インポート・ルールに基づいて新しいレコードを追加したり、一致するレコードを更新したりします。
    • インポートしない: データをロードしません。
    • マップして検証: 定義済のマッピングおよび検証ルールを使用してインポートを実行し、ソース・データを変換および検証しますが、データをターゲットに書き込みません。これは、ファイル/フォーマット、マッピング・カバレッジおよびルール検証を確認し、ロード/コミット・モードを実行する前にエラーまたは警告をレビューするために使用されます。
    エクスポート・モード

    データ交換パイプラインによるデータのエクスポート方法を指定します:

    • マージ: (デフォルト値)現在の実行スコープ内のデータのみをエクスポートし、ターゲット・ファイル/ロケーションの既存のエクスポート出力と組み合せます。キーが一致する既存のレコードは更新され、新しいレコードは追加されます。
    • 累計: 現在の実行のエクスポート出力を既存の出力に追加のレコード・セットとして追加し(付加のみ)、以前にエクスポートされたコンテンツを保持します。
    • 置換: 現在の実行スコープの新しいエクスポート出力を生成し、ターゲット・ロケーションにある既存のエクスポート・ファイル/コンテンツを上書きします。
    • ドライ・ラン: 最終的なエクスポート出力を生成または書き込むことなく、エクスポート・プロセス(スコープ選択、フォーマット、検証)を実行し、ファイルを生成する前に結果を検証して問題を検出できるようにします。
    • エクスポートしない: データをエクスポートしません。
    メールの送信

    パイプラインがパイプライン実行の電子メール通知を送信するかどうかを制御します:

    • 常時: 結果(成功、警告または失敗)に関係なく、すべてのパイプライン実行の電子メール通知を送信します。
    • いいえ: (デフォルト値)パイプライン実行の電子メール通知を送信しません。
    • 失敗時: パイプライン実行が失敗した場合(またはエラー・ステータスで終了した場合)にのみ、電子メール通知を送信します。
    • 成功時: パイプライン実行が正常に完了した場合にのみ電子メール通知を送信します。
    送信先 メールの送信が有効な場合のパイプライン実行通知の電子メール受信者リストを指定します。
    ログの添付

    パイプライン実行の実行ログを、パイプライン結果/通知(ジョブ出力または構成済の電子メール/通知ペイロードなど)とともに添付ファイルとして含めるかどうかを制御します。

    • いいえ: (デフォルト値)ログを添付しません
    • はい: ログを添付します
    ステージ実行
    • 最初から開始: (デフォルト値)パイプラインが失敗した場合は、最初からプロセスを再起動します。
    • 失敗から開始: パイプラインが失敗した場合、プロセスを再起動するのではなく、最後に失敗したステージからジョブを開始します。失敗したステージからパイプラインが再起動されると、前のステージのジョブのステータスが新しいパイプライン実行に引き継がれます。

    Note:

    失敗から開始を選択しても、パイプラインが成功した場合は、パイプラインは実行されません。

  11. 「保存」をクリックします。