3.2.7 予約プロパティ一覧
予約プロパティとは,JP1/AOがプロパティキーの定義や用途を規定している特殊なサービスプロパティです。プロパティキーは「reserved.」で始まります。このプロパティは,[入力プロパティマッピング]ダイアログボックスまたは[出力プロパティマッピング]ダイアログボックスで,部品プロパティにマッピングして使用します。ユーザーが,プロパティの定義や値を設定する必要はありません。
入力プロパティとして予約プロパティをマッピングすると,部品実行時に予約プロパティの値が部品プロパティの値に反映されます。
予約プロパティを使用するには,[入力プロパティマッピング]ダイアログボックスの[プロパティ一覧から選択]を選択します。
または,[直接入力]を選択し,「マッピングパラメータ」に「?dna_予約プロパティキー?」の形式で,予約プロパティを指定できます。この場合,部品実行時に部品プロパティの一部として値が反映されます。
出力プロパティとして予約プロパティを使用すると,任意の部品プロパティの値が予約プロパティに格納されます。[出力プロパティマッピング]ダイアログボックスで,[プロパティ一覧から選択]を選択すると,出力プロパティに対して,値を反映する先のサービスプロパティとして指定できます。
予約プロパティキー |
説明 |
---|---|
reserved.loop.index |
繰り返し実行部品の繰り返し実行の回次を表す1〜99の数値を参照するためのプロパティです。 繰り返し実行の回次とは,繰り返し実行部品のプロパティ「inputProperties」に指定された「,」区切りのデータのうち,何番目のパラメータに対応する実行かを表しています。繰り返し実行方式が「parallel」の場合でも回次を参照できます。この予約プロパティを参照指定で使う場合は?dna_reserved.loop.index?と記述します。 このプロパティは,reserved.loop.inputと同じように,繰り返し実行部品の配下のフロー内で,かつ,サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.loop.input |
繰り返し実行部品の入力プロパティ「inputProperties」の値を参照するための予約プロパティです。 繰り返し実行部品の入力プロパティで指定したコンマ区切りの値のうち,フローの繰り返し回数に対応した項目の値が入力されます。例えば,入力プロパティが「A,B,C」だった場合,繰り返しの回次に応じて「A」,「B」,「C」が順に入力されます。繰り返しは99回まで実行できます。 |
reserved.loop.output |
繰り返し実行部品の出力プロパティ「outputProperties」に値を代入するための予約プロパティです。 このプロパティに出力された値が,コンマ区切りで出力プロパティに反映されます。例えば,部品の出力プロパティの値がフローの繰り返し回数に対応して「X」,「Y」,「Z」となった場合,出力プロパティには「X,Y,Z」という結果が反映されます。 |
reserved.service.category |
タスクの生成元となったサービスに設定されているカテゴリを参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.service.category?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.service.name |
タスクの生成元となったサービスの名称を参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.service.name?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.service.resourceGroupName |
タスクの生成元となったサービスが登録されているリソースグループを参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.service.resourceGroupName?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.step.path |
実行中のステップのIDを参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.step.path?と記述します。 タスクログに出力される部品実行開始および終了時のメッセージの埋め字と同じ値になります。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.step.prevReturnCode |
先行のステップ(接続された関連線の接続元となるステップ)の戻り値を参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.step.prevReturnCode?と記述します。 先行のステップが複数ある場合は,すべての戻り値の論理和が設定されます。先行のステップがない場合は0が設定されます。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 タスクをリトライする場合に,先行のステップを実行しないで,この予約プロパティを参照するステップから実行するときは,先行ステップの戻り値として前回ステップを実行したときの戻り値が設定されます。※ |
reserved.task.description |
タスクの説明を参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.task.description?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.task.dir |
タスク実行時に一時的に作成される,データフォルダのパスを参照するための予約プロパティです。 このプロパティは,タスク実行時にタスクごとの一意のフォルダパスに展開されます。 このフォルダは,タスクを実行するときJP1/AOサーバ上に作成され,タスクのアーカイブ時に削除されます。 なお,名称が「task」で始まるファイルやフォルダは,JP1/AOで予約されているため,ユーザーは作成しないでください。 |
reserved.task.id |
タスクIDを参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.task.id?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.task.name |
タスク名を参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.task.name?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.task.submitter |
タスクの実行者のユーザーIDを参照するためのプロパティです。 タスクをリトライした場合でも,リトライしたときのユーザーではなく,タスクを実行したときのユーザーのユーザーIDを参照します。 この予約プロパティを参照指定で使う場合は?dna_reserved.task.submitter?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.task.url |
[タスク詳細]ダイアログボックスへのURLを参照するためのプロパティです。 この予約プロパティを参照指定で使う場合は?dna_reserved.task.url?と記述します。 サービスプロパティをマッピングできる部品であればどの部品でも使用できます。 |
reserved.terminal.account |
ターミナル接続部品で使用されたユーザーIDを参照するための予約プロパティです。 ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。 接続に使用するユーザーアカウントが入力されます。 |
reserved.terminal.password |
ターミナル接続部品で使用されたパスワードを参照するための予約プロパティです。 ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。 接続に使用するユーザーアカウントのパスワードが入力されます。 |
reserved.terminal.suPassword |
ターミナル接続部品で使用された管理者のパスワードを参照するための予約プロパティです。 ターミナルコマンド実行部品の入力プロパティ「commandLine」で使用します。 接続で使用するスーパーユーザーのパスワードが入力されます。 |
- 注※
-
タスクをリトライした場合,予約プロパティに設定される値の例を次に示します。
フローにstep1,step2,step3というステップがあり,step2とstep3にはそれぞれ「reserved.step.prevReturnCode」が定義されています。step1の戻り値は0,step2の戻り値は63で失敗,step3は未実行という状態でタスクが失敗したとします。
この状態で[失敗したステップからリトライ]を実行する場合,step2から見た「reserved.step.prevReturnCode(step1の戻り値)」は0になります。また,[失敗した次のステップからリトライ]を実行する場合,step3から見た「reserved.step.prevReturnCode(step2の戻り値)」は63になります。