流程執行代表流程執行的例項。 例如,如果排程在早上9:00、上午10:00及上午11:00每小時執行流程,則您會有三個流程執行個體。 流程執行是您的特定組織所專屬。
隨選擷取可讓您建立針對指定資料流執行的流程。 這可讓您的使用者根據指定的引數建立流程執行,並建立擷取週期,而不使用服務權杖。 僅批次來源支援隨選擷取。
本教學課程涵蓋如何使用隨選擷取和建立流程執行的步驟。 Flow Service API.
為了建立資料流執行,您必須先擁有排程為單次擷取的資料流的資料流ID。
本教學課程需要您實際瞭解下列Adobe Experience Platform元件:
如需如何成功呼叫Platform API的詳細資訊,請參閱以下指南: Platform API快速入門.
若要建立以表格為基礎的來源的流程,請向以下網站發出POST請求: Flow Service API,同時提供您要建立執行作業的流程ID,以及開始時間、結束時間和差異欄的值。
表格型來源包括下列來源類別:廣告、分析、同意和偏好設定、CRM、客戶成功、資料庫、行銷自動化、付款和通訊協定。
API格式
POST /runs/
要求
下列請求會建立流程ID的流程執行 3abea21c-7e36-4be1-bec1-d3bad0e3e0de
.
您只需提供 deltaColumn
建立您的首次資料流執行時。 之後, deltaColumn
將修補為的一部分 copy
和中的轉換,將被視為事實的來源。 任何變更 deltaColumn
流執行引數的值會產生錯誤。
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/runs' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json'
-d '{
"flowId": "3abea21c-7e36-4be1-bec1-d3bad0e3e0de",
"params": {
"startTime": "1663735590",
"windowStartTime": "1651584991",
"windowEndTime": "16515859567",
"deltaColumn": {
"name": "DOB"
}
}
}'
參數 | 說明 |
---|---|
flowId |
要針對其建立您的流程執行的流程ID。 |
params.startTime |
隨選資料流執行的排定時間。 此值以unix時間表示。 |
params.windowStartTime |
將會從中擷取資料的最早日期和時間。 此值以unix時間表示。 |
params.windowEndTime |
擷取資料的日期和時間,截止日期為。 此值以unix時間表示。 |
params.deltaColumn |
必須有delta欄才能分割資料,並將新擷取的資料與歷史資料分開。 注意:此 deltaColumn 只有在建立您的第一個流程執行時才需要。 |
params.deltaColumn.name |
差異資料行的名稱。 |
回應
成功的回應會傳回新建立的流程執行的詳細資料,包括其唯一執行 id
.
{
"items": [
{
"id": "3fb0418e-1804-45d6-8d56-dd51f05c0baf",
"etag": "\"1100c53e-0000-0200-0000-627138980000\""
}
]
}
屬性 | 說明 |
---|---|
id |
新建立的資料流執行ID。 請參閱以下指南: 正在擷取流程規格 以取得以表格為基礎的執行規格的詳細資訊。 |
etag |
流程執行的資源版本。 |
若要建立檔案型來源的流程,請向以下發出POST請求: Flow Service API,同時提供您要針對其建立執行的流程ID,以及開始時間和結束時間的值。
檔案型來源包含所有雲端儲存空間來源。
API格式
POST /runs/
要求
下列請求會建立流程ID的流程執行 3abea21c-7e36-4be1-bec1-d3bad0e3e0de
.
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/runs' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json'
-d '{
"flowId": "3abea21c-7e36-4be1-bec1-d3bad0e3e0de",
"params": {
"startTime": "1663735590",
"windowStartTime": "1651584991",
"windowEndTime": "16515859567"
}
}'
參數 | 說明 |
---|---|
flowId |
要針對其建立您的流程執行的流程ID。 |
params.startTime |
隨選資料流執行的排定時間。 此值以unix時間表示。 |
params.windowStartTime |
將會從中擷取資料的最早日期和時間。 此值以unix時間表示。 |
params.windowEndTime |
擷取資料的日期和時間,截止日期為。 此值以unix時間表示。 |
回應
成功的回應會傳回新建立的流程執行的詳細資料,包括其唯一執行 id
.
{
"items": [
{
"id": "3fb0418e-1804-45d6-8d56-dd51f05c0baf",
"etag": "\"1100c53e-0000-0200-0000-627138980000\""
}
]
}
屬性 | 說明 |
---|---|
id |
新建立的資料流執行ID。 請參閱以下指南: 正在擷取流程規格 以取得以表格為基礎的執行規格的詳細資訊。 |
etag |
流程執行的資源版本。 |
建立流程執行後,您可以監視透過它擷取的資料,以檢視有關流程執行、完成狀態和錯誤的資訊。 若要使用API監控您的流量執行,請參閱上的教學課程 監視API中的資料流. 若要使用Platform UI監控您的流量執行,請參閱以下指南: 使用監視儀表板監視來源資料流.