Show Menu
主題×

流量執行通知

Adobe Experience Platform可讓您從外部來源擷取資料,同時提供您使用服務建構、標示及增強傳入資料的 Platform 能力。 您可以從多種來源(例如Adobe應用程式、雲端儲存空間、資料庫等)擷取資料。
Adobe Experience Platform Flow Service ,用於收集和集中內部不同來源的客戶資料 Platform。 該服務提供用戶介面和REST風格的API,所有支援的源都可從中連接。
有了Adobe I/O Events,您就可以訂閱事件,並使用網頁勾點來接收有關流程執行狀態的通知。 這些通知包含有關流式執行成功或導致執行失敗的錯誤的資訊。
本檔案提供如何訂閱事件、註冊網頁勾選和接收通知的步驟,其中包含有關您流程執行狀態的資訊。

快速入門

本檔案需要對Adobe Experience Platform的下列元件有正確的認識:
本檔案也要求您瞭解網頁勾點,以及如何將網頁勾點從一個應用程式連接至另一個應用程式。 如需網頁勾 選的詳細資訊 ,請參閱下列檔案。

註冊您的網頁掛接

若要接收有關流程執行狀態的通知,您必須透過指定唯一的網頁掛接URL作為事件註冊詳細資訊的一部分來註冊網頁掛接。 若要將Webhook連線至您的 I/O Events 訂閱,請造訪 Webhook服務 ,並複製所提供的唯一URL。

訂閱事件

取得唯一的網頁掛接URL後,請前往 Adobe I/O Events ,並依照資料擷取通知檔案中 資料擷取通知 概述的步驟開始訂閱事件。
在訂閱程式中,請確定您選擇 Platform 通知作為事件提供者,並選取下列事件訂閱:
  • Experience Platform來源的流程運行成功
  • Experience Platform來源的流運行失敗
當系統提示您提供網頁掛接位址時,請使用您先前取得的網頁掛接URL。

接收流量執行通知

連線網頁掛接並完成事件訂閱後,您就可以開始透過網頁掛接控制面板接收流量執行通知。
通知會傳回執行的擷取工作數、檔案大小和錯誤等資訊。 通知也會傳回與您以JSON格式執行的流程相關聯的裝載。 響應有效負載可分類為 sources_flow_run_success sources_flow_run_failure
如果在流建立過程中啟用了部分提取,則僅當錯誤數低於在流建立過程中設定的錯誤閾值百分比時, 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": "{IMS_ORG}",
    "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-int.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": "{IMS_ORG}",
        "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": "{IMS_ORG}",
        "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": "{IMS_ORG}",
          "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,可導致成功和未成功收錄檔案的概述。
有關錯誤 消息的詳細資訊 ,請參見附錄。

後續步驟

您現在可以訂閱事件,讓您接收有關流程執行狀態的即時通知。 如需流量執行和來源的詳細資訊,請參閱來 源概觀

附錄

以下章節提供使用流程執行通知的其他資訊。

瞭解錯誤訊息

從來源複製資料或將複製的資料處理至時,可能會發生擷取錯誤 Platform。 有關特定錯誤的詳細資訊,請參閱下表。
錯誤
說明
CONNECTOR-1001-500
從源複製資料時出錯。
CONNECTOR-2001-500
將複製的資料處理到時出錯 Platform。 此錯誤可能與剖析、驗證或轉換有關。