スケジュール済統合でのパラメータの作成および更新
スケジューリングされたスカラー型スケジュール・パラメータは、スケジューリングされた統合で作成および更新できます。スケジューリングされたパラメータは、ソース・ロケーションから受信したデータのバッチおよび読み取り方法を決定します。 次に、これらのパラメータ値を統合でダウンストリームで使用します。 スケジュール済のオーケストレーションされた統合で使用可能な「スケジュール・パラメータ」ページで、これらのパラメータの値を作成して割り当てます。 割当てアクションでこれらのパラメータに値を割り当てることもできます。 「スケジュール・パラメータ」ページでは、最大5つのパラメータがサポートされています。
作成パラメータ
また、スケジュール済パラメータをビジネス識別子として作成し、割り当てることもできます。これにより、実行時にメッセージのフィールドを追跡できます。 「ビジネス識別子の割当て」を参照してください。
スケジュールされたパラメータは、統合の予定されたすべての実行で使用でき、1つの実行から次の実行へのデータの処理を容易にすることができます。 たとえば、バッチ処理を実行する場合、スケジュールされたパラメータは、実行間のバッチ・データの現在の位置を追跡できます。 この値はスケジュール実行間で使用可能であり、256文字を超えることはできません。
デザイン時にパラメータを作成するには:
- 統合ページで、「作成」をクリックします。
- 「予定されているオーケストレーション」スタイルを選択します。
- ダイアログのフィールドに入力し、「作成」をクリックします。
統合キャンバスが表示されます。
- 「スケジュール」アイコンをクリックし、「スケジュール・パラメータの編集」を選択します。

。 - 「パラメータ名」列でplusアイコンをクリックします。
- 名前、オプションの説明およびデフォルト値を「値」列に入力します。 この例では、
StartSurveyFromDateのパラメータおよび"Current Date (Format: yyyy-mm-ddThh:mm:ss.nnnnnn+|-hh:mm)"の値が入力されます。
- 「閉じる」をクリックして変更を保存し、ページを終了します。
値を指定せずにパラメータを入力すると、「スケジュール」アイコンに赤い警告アイコンが表示されます。 アイコンの上にカーソルを置くと、1つまたは複数のパラメータに値がないことを示すメッセージが表示されます。
- 「割り当て」アクションを統合にドラッグし、名前を入力してOKをクリックします。
- 「名前」列で+をクリックし、「スケジュール・パラメータ」ページで値なしで作成したドロップダウン・リストからパラメータを選択します。
アイコンをクリックして、式ビルダーを起動します。
- 式を作成し、「閉じる」をクリックします。
- 割当てページで、「閉じる」をクリックします。
統合キャンバスに戻ります。
- 「スケジュール」アイコンの上にカーソルを置くと、欠落しているパラメータ値に関するメッセージが消えます。
ノート:
「並列処理アイテム」オプションを選択せずにfor-eachアクションを作成し、for-eachループ内にassignアクションを追加した場合、スケジュール済統合で定義されたパラメータは、割当てアクションで選択対象として表示されます。 後でfor-eachアクションを編集して「並列処理アイテム」オプションを選択すると、影響を受けるassignアクションに、スケジュールされたパラメータが使用されていることを示す赤い障害アイコンが表示されます。 統合を有効にするには、このエラーを修正する必要があります。 「並列処理アイテム」オプションを無効にするか、「再配置」ボタンを使用して、for-eachループの外部にassignアクションを移動できます。
パラメータの更新
- 「Integrations」ページに移動します。
- スケジュール済実行が定義されている統合の行に移動します。
メニューから、「スケジュール」を選択します。
「Schedule and Future Runs」ページが表示されます。
メニューの「スケジュール・パラメータの更新」リンクをクリックします。
- 「新しい値」列のパラメータ値を編集し、「更新」をクリックします。
スケジュール・パラメータ値のオーバーライド
設計時に設定されたスケジュール・パラメータ値は、非定型スケジュール・リクエストを発行するとき、またはアクティブ化された統合でスケジュールを開始するときにオーバーライドできます。 この機能を使用すると、統合を非アクティブ化せずに起動して、パラメータ値を指定できます。
スケジュール・パラメータ値を上書きするには:
-
ダイアログにアクセスして、2つの方法のいずれかでパラメータ値をオーバーライドします。 スケジュール済統合にパラメータが定義されている場合は、「スケジュール・パラメータ」ダイアログが表示されます。 それ以外の場合、このダイアログは表示されず、スケジュールされた統合が開始します。
-
非定型スケジュール統合を発行する場合は、次のいずれかのロケーションから「すぐに送信」を選択します:
-
スケジュールおよび「将来に実行」ページの
メニューから「すぐに送信」を選択します。
-
「統合のモニター」ページで
アイコンをクリックします。
-
-
統合をスケジュールする場合は、スケジュールおよび「将来に実行」ページで、「開始スケジュール」を選択します。
「スケジュール・パラメータ」ダイアログが表示されます。
「
図scheduled_parameters.pngの説明」 -
-
必要なパラメータを更新します。
次のフィールドが表示されます:
-
パラメータ名: 設計時に指定したパラメータ名が表示されます。
-
デフォルト値: 設計時に割り当てたパラメータ値が表示されます。
-
現在の値: 実行時に最近使用された値を表示します。
-
新しい値: オプションで、スケジュール・パラメータの新しい値を入力します。 この値は、現在の値とデフォルト値を上書きします。 このフィールドが空白のままの場合は、現在の値が使用されます。 新しい値や現在の値がない場合は、設計時に定義されたデフォルト値が使用されます。
-
-
特定のパラメータの「新しい値」行に、値を入力します。
統合が割当てアクションを使用してこれらのスケジュール・パラメータ値を更新すると、更新された値が保存され、次のスケジュール実行の現在の値となります。
-
更新内容を保存するために表示されるボタンをクリックします。 ボタンの名前は、更新するスケジュール・パラメータのタイプに基づいています:
-
スケジュールを開始する場合は、「開始スケジュール」をクリックします。
-
非定型の予定された統合を発行する場合は、「すぐに送信」をクリックします。
入力した値は、スケジュール統合の実行時に使用されます。
-
