TriggerPlaybook コンポーネントは、主にサブプレイブックを呼び出す機能を提供します。
機能説明
操作 | 説明 | シナリオ |
setOutput | プレイブックの出力を定義します。 | メイン プレイブックによってサブプレイブックが呼び出され、メイン プレイブックがサブプレイブックからの出力コンテンツを取得する必要がある場合に使用されます。 |
callSubTaskWithQps | サブプレイブックを呼び出します（QPS 制限付き）。 | 外部サブプレイブックを呼び出すときに、メイン プレイブックで使用されます。 |
コンポーネント構成例
このトピックでは、TriggerPlaybook コンポーネントの各アクションのパラメーター構成例を提供します。これらの例は、テスト プレイブックとしてインポートできます。可視化フロー エディターを使用すると、各アクションの構成パラメーターをより直感的に理解してテストし、コンポーネントの機能ロジックと使用方法を簡単に習得できます。手順については、「プレイブックのインポート」をご参照ください。
説明
まず、サンプルデータを JSON ファイルとして保存してください。
setOutput の例
{
"cells": [
{
"position": {
"x": -440,
"y": -170
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white",
"strokeOpacity": 0.95,
"stroke": "black",
"strokeWidth": 2
},
"label": {
"text": "start", // 開始
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle", // 中央
"textVerticalAnchor": "top" // 上
}
},
"visible": true, // 表示
"shape": "circle", // 円
"id": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4",
"zIndex": 1,
"data": {
"nodeType": "startEvent", // 開始イベント
"appType": "basic", // 基本
"nodeName": "start", // 開始
"icon": "icon-circle", // 円アイコン
"description": "Playbook start node. A playbook must have one and only one start node, which requires input data configuration for the playbook." // プレイブックの開始ノード。プレイブックには開始ノードが 1 つだけ必要です。プレイブックの入力データ設定が必要です。
},
"markup": [
{
"tagName": "circle", // 円
"selector": "body" // 本文
},
{
"tagName": "text", // テキスト
"selector": "label" // ラベル
}
],
"isNode": true // ノード
},
{
"shape": "custom-edge", // カスタムエッジ
"zIndex": 1,
"id": "5293c3f9-e1c9-4a49-b0eb-635067dc67e8",
"data": {
"nodeType": "sequenceFlow", // シーケンスフロー
"appType": "basic", // 基本
"icon": "icon-upper-right-arrow", // 右上矢印アイコン
"isRequired": false // 不要
},
"isNode": false, // ノードではない
"source": { // ソース
"cell": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4"
},
"target": { // ターゲット
"cell": "ebdc953c-2902-4133-abfd-9fc5ad707b21"
},
"vertices": []
},
{
"position": {
"x": 170,
"y": -170
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white", // 白
"strokeOpacity": 0.95,
"stroke": "black", // 黒
"strokeWidth": 2
},
"path": { // パス
"r": 12,
"refX": "50%",
"refY": "50%",
"fill": "black", // 黒
"strokeOpacity": 0.95,
"stroke": "black", // 黒
"strokeWidth": 4
},
"label": {
"text": "end", // 終了
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle", // 中央
"textVerticalAnchor": "top" // 上
}
},
"visible": true, // 表示
"shape": "circle", // 円
"id": "317dd1be-2d20-460e-977e-1fc936ffb583",
"zIndex": 1,
"data": {
"nodeType": "endEvent", // 終了イベント
"appType": "basic", // 基本
"nodeName": "end", // 終了
"icon": "icon-radio-off-full", // ラジオオフフルアイコン
"description": "end" // 終了
},
"markup": [
{
"tagName": "circle", // 円
"selector": "body" // 本文
},
{
"tagName": "circle", // 円
"selector": "path" // パス
},
{
"tagName": "text", // テキスト
"selector": "label" // ラベル
}
],
"isNode": true // ノード
},
{
"position": {
"x": -297,
"y": -185
},
"size": {
"width": 137,
"height": 66
},
"view": "react-shape-view",
"shape": "activity", // アクティビティ
"id": "ebdc953c-2902-4133-abfd-9fc5ad707b21",
"zIndex": 1,
"data": {
"nodeType": "action", // アクション
"appType": "component", // コンポーネント
"nodeName": "DataFormat", // データフォーマット
"valueData": {
"outputFields": "[{\"fieldName\":\"name\",\"fieldValue\":\"${event.name}_Sub\"},{\"fieldName\":\"age\",\"fieldValue\":\"${event.age}_Sub\"}]" // 出力フィールド
},
"icon": "https://sophon-gen-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1719222281702_DataFormat_logo.png?Expires=1745549020&OSSAccessKeyId=STS.NVgz************&Signature=HtvRQuo%2BgDw7egOVmZYuihj3Z9Q%3D&security-token=CAIS2AJ1q6Ft5B2yfSjIr5XSMYv%2FoLYV1pKpSULpgXcPZulDnJOc0Dz2IHhMenFpAegcv%2Fw%2BlGFZ6%2F8elrp6SJtIXleCZtF94oxN9h2gb4fb400mTGGK0s%2FLI3OaLjKm9u2wCryLYbGwU%2FOpbE%2B%2B5U0X6LDmdDKkckW4OJmS8%2FBOZcgWWQ%2FKBlgvRq0hRG1YpdQdKGHaONu0LxfumRCwNkdzvRdmgm4NgsbWgO%2Fks0OP3AOrlrBN%2Bdiuf8T9NvMBZskvD42Hu8VtbbfE3SJq7BxHybx7lqQs%2B02c5onDWwAJu0%2FXa7uEo4wydVNjFbM9A65Dqufxn%2Fpgt%2Braj4X7xhhEIOVJSSPbSZBbSxJNvU1RXDxQVcEYWxylurjnXvF%2Bo1K1xOgUGin%2B2svzhw6RGJ1dq8DgINtD0jokjPndRVbLXs84nxS7gbsGn76oY2zradH%2FdU4vuWVwMytAXxqAASmDGMrrsc17A02zxAGygdO5NYPui1jn%2BSY7C6gPM7rbo6PMdEFZX2yrNrPIWiL%2FZl3CXTr9B84IhYB%2BqtLWbOidAj9UOvH7iCjL%2B%2FWVElkcfZzL6gT%2B0Ech6QH3PTlC6B%2FT4e69%2FsLD%2BogKYS8Ziv%2F%2Fbd8%2BlrcMu5FNBBFigttDIAA%3D", // アイコン
"description": "Generate new data" // 新しいデータを生成する
,
"advance": {
"inputParamMode": false, // 入力パラメータモード
"onError": "stop_cur_flow", // 現在のフローを停止
"rspStatusType": 3,
"rspStatusThreshold": 0
},
"componentName": "DataFormat", // データフォーマット
"actionName": "formatdata" // データフォーマット
},
"isNode": true // ノード
},
{
"shape": "custom-edge", // カスタムエッジ
"zIndex": 1,
"id": "5ae3f1ac-4d5b-433b-a9e7-725ea53f36db",
"data": {
"nodeType": "sequenceFlow", // シーケンスフロー
"appType": "basic", // 基本
"icon": "icon-upper-right-arrow", // 右上矢印アイコン
"isRequired": false // 不要
},
"isNode": false, // ノードではない
"source": { // ソース
"cell": "ebdc953c-2902-4133-abfd-9fc5ad707b21"
},
"target": { // ターゲット
"cell": "025181c9-9678-45a1-bbd9-0a7fa3eb2b7e"
},
"vertices": []
},
{
"position": {
"x": -60,
"y": -190
},
"size": {
"width": 137,
"height": 66
},
"view": "react-shape-view",
"shape": "activity", // アクティビティ
"id": "025181c9-9678-45a1-bbd9-0a7fa3eb2b7e",
"zIndex": 1,
"data": {
"nodeType": "action", // アクション
"appType": "component", // コンポーネント
"nodeName": "TriggerPlaybook_1", // TriggerPlaybook_1
"valueData": {
"infos": "[{\"fieldName\":\"name\",\"fieldValue\":\"${DataFormat.datalist.*.name}\"},{\"fieldName\":\"age\",\"fieldValue\":\"${DataFormat.datalist.*.age}\"}]" // 情報
},
"icon": "https://sophon-gen-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1666576284868_TriggerPlaybook_logo.svg?Expires=1745549020&OSSAccessKeyId=STS.NVgz************&Signature=%2FjtIi%2Btlp%2FH9PxUne6LeG4lS%2B2Y%3D&security-token=CAIS2AJ1q6Ft5B2yfSjIr5XSMYv%2FoLYV1pKpSULpgXcPZulDnJOc0Dz2IHhMenFpAegcv%2Fw%2BlGFZ6%2F8elrp6SJtIXleCZtF94oxN9h2gb4fb400mTGGK0s%2FLI3OaLjKm9u2wCryLYbGwU%2FOpbE%2B%2B5U0X6LDmdDKkckW4OJmS8%2FBOZcgWWQ%2FKBlgvRq0hRG1YpdQdKGHaONu0LxfumRCwNkdzvRdmgm4NgsbWgO%2Fks0OP3AOrlrBN%2Bdiuf8T9NvMBZskvD42Hu8VtbbfE3SJq7BxHybx7lqQs%2B02c5onDWwAJu0%2FXa7uEo4wydVNjFbM9A65Dqufxn%2Fpgt%2Braj4X7xhhEIOVJSSPbSZBbSxJNvU1RXDxQVcEYWxylurjnXvF%2Bo1K1xOgUGin%2B2svzhw6RGJ1dq8DgINtD0jokjPndRVbLXs84nxS7gbsGn76oY2zradH%2FdU4vuWVwMytAXxqAASmDGMrrsc17A02zxAGygdO5NYPui1jn%2BSY7C6gPM7rbo6PMdEFZX2yrNrPIWiL%2FZl3CXTr9B84IhYB%2BqtLWbOidAj9UOvH7iCjL%2B%2FWVElkcfZzL6gT%2B0Ech6QH3PTlC6B%2FT4e69%2FsLD%2BogKYS8Ziv%2F%2Fbd8%2BlrcMu5FNBBFigttDIAA%3D", // アイコン
"advance": {
"inputParamMode": false, // 入力パラメータモード
"onError": "stop_cur_flow", // 現在のフローを停止
"rspStatusType": 3,
"rspStatusThreshold": 0
},
"componentName": "TriggerPlaybook", // TriggerPlaybook
"actionName": "setOutput" // setOutput
},
"isNode": true // ノード
},
{
"shape": "custom-edge", // カスタムエッジ
"zIndex": 1,
"id": "4f5dfe7c-751a-405c-a9b4-c0ff7c083ad9",
"data": {
"nodeType": "sequenceFlow", // シーケンスフロー
"appType": "basic", // 基本
"icon": "icon-upper-right-arrow", // 右上矢印アイコン
"isRequired": false // 不要
},
"isNode": false, // ノードではない
"source": { // ソース
"cell": "025181c9-9678-45a1-bbd9-0a7fa3eb2b7e"
},
"target": { // ターゲット
"cell": "317dd1be-2d20-460e-977e-1fc936ffb583"
},
"vertices": []
}
]
}callSubTaskWithQps の例
{
"cells": [
{
"position": {
"x": -440,
"y": -170
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white",
"strokeOpacity": 0.95,
"stroke": "#63ba4d",
"strokeWidth": 2
},
"label": {
"text": "start",
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle",
"textVerticalAnchor": "top"
},
"path": {
"stroke": "#63ba4d"
}
},
"visible": true,
"shape": "circle",
"id": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4",
"zIndex": 1,
"data": {
"nodeType": "startEvent",
"appType": "basic",
"nodeName": "start",
"icon": "icon-circle",
"description": "プレイブックの開始ノード。 プレイブックには開始ノードが 1 つだけ必要で、そのノードでプレイブックの入力データを構成する必要があります。"
},
"markup": [
{
"tagName": "circle",
"selector": "body"
},
{
"tagName": "text",
"selector": "label"
}
],
"isNode": true
},
{
"shape": "custom-edge",
"attrs": {
"line": {
"stroke": "#63ba4d",
"targetMarker": {
"stroke": "#63ba4d"
}
}
},
"zIndex": 1,
"id": "5293c3f9-e1c9-4a49-b0eb-635067dc67e8",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"icon": "icon-upper-right-arrow",
"isRequired": false
},
"isNode": false,
"source": {
"cell": "58d87b7d-28d9-4f0e-b135-4adc4f1a70e4"
},
"target": {
"cell": "bf7d41ee-bd07-4b57-a3bc-02b50603c4f5"
},
"vertices": [
],
"visible": true,
"router": {
"name": "manhattan",
"args": {
"padding": 5,
"excludeHiddenNodes": true,
"excludeNodes": [
"clone_node_id"
]
}
}
},
{
"position": {
"x": 240,
"y": -170
},
"size": {
"width": 36,
"height": 36
},
"attrs": {
"body": {
"fill": "white",
"strokeOpacity": 0.95,
"stroke": "#63ba4d",
"strokeWidth": 2
},
"path": {
"r": 12,
"refX": "50%",
"refY": "50%",
"fill": "#63ba4d",
"strokeOpacity": 0.95,
"stroke": "#63ba4d",
"strokeWidth": 4
},
"label": {
"text": "end",
"fontSize": 12,
"refX": 0.5,
"refY": "100%",
"refY2": 4,
"textAnchor": "middle",
"textVerticalAnchor": "top"
}
},
"visible": true,
"shape": "circle",
"id": "317dd1be-2d20-460e-977e-1fc936ffb583",
"zIndex": 1,
"data": {
"nodeType": "endEvent",
"appType": "basic",
"nodeName": "end",
"icon": "icon-radio-off-full",
"description": "終了",
"cascaderValue": [
{
"label": "DataFormat_1",
"value": "${DataFormat_1}",
"children": [
]
},
{
"label": "TriggerPlaybook",
"value": "${TriggerPlaybook}",
"children": [
]
}
]
},
"markup": [
{
"tagName": "circle",
"selector": "body"
},
{
"tagName": "circle",
"selector": "path"
},
{
"tagName": "text",
"selector": "label"
}
],
"isNode": true
},
{
"position": {
"x": -144,
"y": -185
},
"size": {
"width": 137,
"height": 66
},
"view": "react-shape-view",
"shape": "activity",
"id": "bf7d41ee-bd07-4b57-a3bc-02b50603c4f5",
"zIndex": 1,
"data": {
"nodeType": "action",
"appType": "component",
"nodeName": "TriggerPlaybook",
"valueData": {
"event": "[{\"fieldName\":\"name\",\"fieldValue\":\"TriggerPlaybook\"},{\"fieldName\":\"age\",\"fieldValue\":\"18\"},{\"fieldName\":\"ip\",\"fieldValue\":\"192.168.10.1\"},{\"fieldName\":\"scope\",\"fieldValue\":\"1766185894104675\"}]",
"tenantId": "1359316744907524",
"taskName": "system_aliyun_waf_batch_whitelist_book"
},
"icon": "https://sophon-gen-v2.oss-cn-zhangjiakou.aliyuncs.com/componentUpload/1666576284868_TriggerPlaybook_logo.svg?Expires=1745548802&OSSAccessKeyId=STS.NVL1uKAoNQbuFQBTpRHpZMCaN&Signature=w22i0vzkKODDUY9xNAwfril0uTo%3D&security-token=CAIS2AJ1q6Ft5B2yfSjIr5X5es%2F%2FrLBv5qCeRHfzsHAHRP92oobKrDz2IHhMenFpAegcv%2Fw%2BlGFZ6%2F8elrp6SJtIXleCZtF94oxN9h2gb4fb4yMGWW6K0s%2FLI3OaLjKm9u2wCryLYbGwU%2FOpbE%2B%2B5U0X6LDmdDKkckW4OJmS8%2FBOZcgWWQ%2FKBlgvRq0hRG1YpdQdKGHaONu0LxfumRCwNkdzvRdmgm4NgsbWgO%2Fks0OP3AOrlrBN%2Bdiuf8T9NvMBZskvD42Hu8VtbbfE3SJq7BxHybx7lqQs%2B02c5onDWwAJu0%2FXa7uEo4wydVNjFbM9A65Dqufxn%2Fpgt%2Braj4X7xhhEIOVJSSPbSZBbSxJNvU1RXDxQVcEYWxylurjnXvF%2Bs5SwZtdAf0rM946UoJvc3YDI5hWbc8mJsTnhSSTAEIv%2By8ptqoFOtH7DkLTHWR7hCtv2305QYbPzMytAXxqAAa%2Bmv7bOZIL67fKJSGOwNGVYwDkNYp2zvM3zoahdc4lQ0oeSmmNoFIvUzRWck5dqsTWQ0D%2BJzP45DavayQJlYdzomPe%2B1HdN%2BLEIuOGaP202XYPIW6ZE2GI8R2Vq6WYhXZEaMB5PmDGO59NwFAhuZCkhixpwmkFhiuNhw6P3XmoTIAA%3D",
"advance": {
"inputParamMode": false,
"onError": "stop_cur_flow",
"rspStatusType": 3,
"rspStatusThreshold": 0
},
"componentName": "TriggerPlaybook",
"actionName": "callSubTaskWithQps",
"status": "success",
"cascaderValue": [
]
},
"isNode": true
},
{
"shape": "custom-edge",
"attrs": {
"line": {
"stroke": "#63ba4d",
"targetMarker": {
"stroke": "#63ba4d"
}
}
},
"zIndex": 1,
"id": "439e42d8-8ff8-4b12-9c8e-32e16a4fb9db",
"data": {
"nodeType": "sequenceFlow",
"appType": "basic",
"icon": "icon-upper-right-arrow",
"isRequired": false
},
"isNode": false,
"source": {
"cell": "bf7d41ee-bd07-4b57-a3bc-02b50603c4f5"
},
"target": {
"cell": "317dd1be-2d20-460e-977e-1fc936ffb583"
},
"vertices": [
],
"visible": true,
"router": {
"name": "manhattan",
"args": {
"padding": 5,
"excludeHiddenNodes": true,
"excludeNodes": [
"clone_node_id"
]
}
}
}
]
}callSubTaskWithQps
サブプレイブックが実行されると、実行レコードが生成されます。レコードを表示するには、「プレイブック実行レコードを表示する」をご参照ください。
パラメーターの説明
パラメーター | 説明 | |
プレイブックを選択 | 現在のアカウントにあるすべてのプレイブック。 | |
入力 | サブプレイブックの開始ノードに構成された入力パラメーター。 | |
出力 | サブプレイブックの開始ノードに構成された出力パラメーター。 | |
詳細設定 | maxTasks | サブプレイブック実行の最大同時実行数。 0 以下の場合、デフォルトの制限 ( 20 ) が使用されます。設定可能な上限は 50 です。 例：デフォルトの制限を使用してサブプレイブックを 100 回呼び出す必要がある場合、 100 回すべてを同時に実行するわけではありません。代わりに、最初に 20 回実行し、残りの 80 は待機します。最初の 20 のタスクが完了すると、残りの 80 から新しいタスクが開始され、レート制限効果が生まれます。 |
waitMaxTimeOneTask | 1 つのサブプレイブック実行の最大待機時間（秒単位）。デフォルトは 43200 （ 12 時間）で、最大値は 86400 （ 1 日）です。 | |
waitMaxTime | すべてのプレイブックの最大待機時間（秒単位）。デフォルトは 43200 （ 12 時間）で、最大値は 86400 （ 1 日）です。 | |
SetOutput 操作
プレイブックの出力パラメーターとパラメーター値を定義します。
パラメーターの説明
プレイブック用に構成された 出力パラメーター が使用されます。これらは、プレイブックの 開始ノード の入力および出力パラメーターセクションで構成する必要があります。開始ノードのパラメーター設定については、「開始/終了」をご参照ください。
パラメーター値は、定数、式、先行ノードからの出力値などをサポートします。詳細については、「コンポーネントパラメーターとノード実行フロー」をご参照ください。