資料流執行通知
Adobe Experience Platform允許從外部來源擷取資料，同時讓您能夠使用Platform服務來建構、加標籤及增強傳入資料。 您可以從多種來源(例如Adobe應用程式、雲端儲存、資料庫和許多其他來源)內嵌資料。
Flow Service API是用來從Platform內不同的來源收集及集中客戶資料。 此服務提供使用者介面和RESTful API，所有支援的來源都可從此API連線。
透過Adobe I/O事件，您可以訂閱事件並使用Webhook接收有關流量執行狀態的通知。 這些通知包含有關流程執行成功或導致執行失敗的錯誤的資訊。
本檔案提供如何訂閱事件、註冊webhook以及接收包含流程執行狀態資訊的通知的步驟。
快速入門
本教學課程假設您已建立至少一個要監視其流程執行的來源連線。 如果您尚未設定來源連線，請先造訪來源概觀設定您選擇的來源，再返回本指南。
本檔案還需要實際瞭解Webhook以及如何將Webhook從一個應用程式連線到另一個應用程式。 如需Webhook的簡介，請參閱I/O Events 檔案。
註冊webhook以取得資料流執行通知
若要接收資料流執行通知，您必須使用Adobe Developer Console註冊webhook以進行Experience Platform整合。
請依照有關訂閱I/O Event通知的教學課程，取得如何完成此作業的詳細步驟。
IMPORTANT
在訂閱程式期間，請確定您選取 平台通知 作為事件提供者，並選取下列事件訂閱：
- Experience PlatformSource的資料流執行成功
- Experience PlatformSource的資料流執行失敗
接收資料流執行通知
在您的webhook已連線且事件訂閱完成時，您可以開始透過webhook儀表板接收流量執行通知。
通知會傳回執行內嵌工作數、檔案大小和錯誤等資訊。 通知也會傳回與您以JSON格式執行的流程相關聯的裝載。 回應承載可分類為sources_flow_run_success或sources_flow_run_failure。
IMPORTANT
如果在流程建立處理期間啟用部分擷取，則只有在錯誤數低於流程建立處理期間設定的錯誤臨界值百分比時，包含成功和失敗擷取的流程才會標示為
sources_flow_run_success。 如果成功的資料流執行包含錯誤，這些錯誤仍會包含在傳回裝載中。成功
成功的回應會傳回一組定義特定流程執行特性的metrics，以及概述資料轉換方式的activities。
{
"event_id": "aec55616-1715-487f-8044-ba648cc8ffee",
"event": {
"createdAt": 1597213529158,
"updatedAt": 1597213530760,
"createdBy": "{CREATED_BY}",
"updatedBy": "{UPDATED_BY}",
"createdClient": "{CREATED_CLIENT}",
"updatedClient": "{UPDATED_CLIENT}",
"sandboxId": "7127a4f0-def8-11e9-83ce-e79494b1c2a5",
"sandboxName": "prod",
"imsOrgId": "{ORG_ID}",
"id": "933cf9f4-cf01-4d75-bcf9-f4cf010d750a",
"flowId": "1c6f1047-dcaf-48fe-af10-47dcaf08feaf",
"providerRefId": "test1234",
"etag": "\"5100ec97-0000-0200-0000-5f338b5b0000\"",
"metrics": {
"durationSummary": {
"startedAtUTC": 1590512053,
"completedAtUTC": 1590512053
},
"sizeSummary": {
"inputBytes": 2048,
"outputBytes": 1024
},
"recordSummary": {
"inputRecordCount": 100,
"outputRecordCount": 70
},
"fileSummary": {
"inputFileCount": 10,
"outputFileCount": 10
},
"statusSummary": {
"status": "success"
}
},
"activities": [
{
"id": "copyActivity",
"updatedAtUTC": 87473822,
"durationSummary": {
"startedAtUTC": 1590512053,
"completedAtUTC": 1590512053
},
"sizeSummary": {
"inputBytes": 2048,
"outputBytes": 1098
},
"recordSummary": {
"inputRecordCount": 100,
"outputRecordCount": 100
},
"fileSummary": {
"inputFileCount": 10,
"outputFileCount": 10
},
"statusSummary": {
"status": "success",
"extensions": {
"adf/pipeline/id": "abcd",
"adf/run/id": "1234"
}
},
"sourceInfo": [
{
"id": "sourceConnectionId1",
"type": "SourceConnection",
"reference": {
"type": "AdfRunId"
}
}
]
},
{
"id": "promotionActivity",
"updatedAtUTC": 87473822,
"durationSummary": {
"completedAtUTC": 1590512053
},
"sizeSummary": {
"inputBytes": 1098,
"outputBytes": 1024
},
"recordSummary": {},
"fileSummary": {
"inputFileCount": 10,
"outputFileCount": 10,
"extensions": {
"manifest": {
"fileInfo": "https://platform.adobe.io/data/foundation/export/batches/01E4TSJNM2H5M74J0XB8MFWDHK/meta?path=input_files"
}
}
},
"statusSummary": {
"status": "success",
"extensions": {
"batchId": "b1",
"acp_request_id": "1234"
}
},
"targetInfo": [
{
"id": "targetConnectionId1",
"type": "TargetConnection",
"reference": {
"type": "batch"
}
}
]
}
],
"slaCreatedAt": 1597213531124,
"processStartTime": 1597213531213,
"header": {
"_adobeio": {
"imsOrgId": "{ORG_ID}",
"providerMetadata": "platform_notifications",
"eventCode": "sources_flow_run_success"
}
},
"transformedTime": 1597213531214
}
}
屬性
說明
metrics定義資料流執行中的資料特性。
activities定義轉換資料所執行的不同步驟和活動。
durationSummary定義流程執行的開始和結束時間。
sizeSummary定義資料量（位元組）。
recordSummary定義資料的記錄計數。
fileSummary定義資料的檔案計數。
fileInfo導向成功擷取檔案之概觀的URL。
statusSummary定義流程執行是成功還是失敗。
失敗
下列回應是失敗的流程執行範例，在處理複製的資料時發生錯誤。 從來源複製資料時也會發生錯誤。 失敗的資料流執行包含造成執行失敗的錯誤相關資訊，包括其錯誤和說明。
[
{
"messages": [
{
"msgType": "eventNotification",
"version": "1.0",
"timestamp": 1597434157622,
"imsOrgId": "{ORG_ID}",
"schema": {
"name": "run-notification",
"version": "1.0"
},
"provider": "FlowService",
"_eventNotificationMeta": {
"category": "Platform Notifications",
"type": "sources_flow_run_failed"
},
"value": {
"createdAt": 1597434147259,
"updatedAt": 1597434157567,
"createdBy": "{CREATED_BY}",
"updatedBy": "{UPDATED_BY}",
"createdClient": "{CREATED_CLIENT}",
"updatedClient": "{UPDATED_CLIENT}",
"sandboxId": "e49ebb00-d0fa-11e9-b164-ed6a398c8b35",
"sandboxName": "prod",
"imsOrgId": "{ORG_ID}",
"id": "d9024c32-2174-4271-824c-322174627101",
"flowId": "cf4fce79-8822-456d-8fce-798822556dc6",
"etag": "\"0c003dbf-0000-0200-0000-5f36e92d0000\"",
"metrics": {
"durationSummary": {
"startedAtUTC": 1597434147190
},
"sizeSummary": {
"inputBytes": -1
},
"fileSummary": {
"inputFileCount": -1
},
"statusSummary": {
"status": "failed",
"errors": [
{
"code": "CONNECTOR-2001-500",
"message": "Error in processing (parsing, validation or transformation) the copied data."
}
]
}
},
"activities": [
{
"id": "promotionActivity",
"updatedAtUTC": 1597434157529,
"durationSummary": {
"startedAtUTC": 1597434147190,
"completedAtUTC": 1597434157212
},
"sizeSummary": {
"inputBytes": -1
},
"recordSummary": {},
"fileSummary": {
"inputFileCount": -1,
"extensions": {
"manifest": {
"fileInfo": "https://platform-stage.adobe.io/data/foundation/export/batches/6f6a900f-e40d-4f0e-9bb9-b614436c3465/meta?path=input_files"
}
}
},
"statusSummary": {
"status": "failed",
"errors": [
{
"code": "CONNECTOR-2001-500",
"message": "Error in processing (parsing, validation or transformation) the copied data."
}
],
"extensions": {
"errors": [
{
"code": "133",
"message": "We are unable to locate any files uploaded for this batch. Please upload files to ingest."
}
]
}
},
"targetInfo": [
{
"id": "e88737aa-27b8-4795-8737-aa27b8f7959e",
"type": "TargetConnection",
"reference": {
"type": "Batch",
"ids": [
"6f6a900f-e40d-4f0e-9bb9-b614436c3465"
]
}
}
]
}
]
}
}
]
}
]
屬性
說明
fileInfo此URL會導向成功擷取且未成功擷取的檔案概觀。
NOTE
如需錯誤訊息的詳細資訊，請參閱附錄。
後續步驟
您現在可以訂閱事件，以便在您的流程執行狀態接收即時通知。 如需資料流執行和來源的詳細資訊，請參閱來源概觀。
附錄
以下各節提供處理流程執行通知的其他資訊。
瞭解錯誤訊息 errors
從來源複製資料或將複製的資料處理到Platform時，可能會發生內嵌錯誤。 請參閱下表，以取得有關特定錯誤的詳細資訊。
錯誤
說明
CONNECTOR-1001-500從來源複製資料時發生錯誤。
CONNECTOR-2001-500將複製的資料處理至Platform時發生錯誤。 此錯誤可能涉及解析、驗證或轉換。
recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089