Il OneTrust Integration La sorgente supporta solo l’acquisizione dei dati di consenso e preferenze e non dei cookie.
Il seguente tutorial illustra i passaggi necessari per creare una connessione di origine e un flusso di dati per acquisire dati di consenso storici e pianificati da OneTrust Integration a Adobe Experience Platform utilizzando Flow Service API.
Il OneTrust Integration il connettore di origine e la documentazione sono stati creati da OneTrust Integration team. Per ulteriori informazioni o richieste di aggiornamento, contattare OneTrust team direttamente.
Prima di connettersi OneTrust Integration in Platform, devi prima recuperare il token di accesso. Per istruzioni dettagliate su come trovare il token di accesso, vedi OneTrust Integration Guida di OAuth 2.
Il token di accesso non viene aggiornato automaticamente dopo la scadenza perché i token di aggiornamento da sistema a sistema non sono supportati da OneTrust. Pertanto, è necessario assicurarsi che il token di accesso sia aggiornato nella connessione prima della scadenza. La durata massima configurabile per un token di accesso è di un anno. Per ulteriori informazioni sull’aggiornamento del token di accesso, consulta OneTrust documento sulla gestione delle credenziali client OAuth 2.0.
Il OneTrust Integration Le specifiche API vengono condivise con Adobe per l’acquisizione dei dati.
Il seguente tutorial illustra i passaggi necessari per creare un OneTrust Integration connessione sorgente e crea un flusso di dati per portare OneTrust Integration dati a Platform utilizzando Flow Service API.
Una connessione di base mantiene le informazioni tra l’origine e Platform, incluse le credenziali di autenticazione dell’origine, lo stato corrente della connessione e l’ID univoco della connessione di base. L’ID della connessione di base consente di esplorare e navigare tra i file dall’interno dell’origine e identificare gli elementi specifici che desideri acquisire, comprese le informazioni relative ai tipi di dati e ai formati.
Per creare un ID di connessione di base, effettua una richiesta POST al /connections
endpoint durante la fornitura del OneTrust Integration credenziali di autenticazione come parte del corpo della richiesta.
Formato API
POST /connections
Richiesta
La richiesta seguente crea una connessione di base per OneTrust Integration :
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-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 '{
"name": "ONETRUST base connection",
"description": "ONETRUST base connection to authenticate to Platform",
"connectionSpec": {
"id": "cf16d886-c627-4872-9936-fb08d6cba8cc",
"version": "1.0"
},
"auth": {
"specName": "OAuth2 Refresh Code",
"params": {
"accessToken": "{ACCESS_TOKEN}"
}
}
}'
Proprietà | Descrizione |
---|---|
name |
Nome della connessione di base. Verificare che il nome della connessione di base sia descrittivo, in quanto è possibile utilizzarlo per cercare informazioni sulla connessione di base. |
description |
Valore facoltativo che è possibile includere per fornire ulteriori informazioni sulla connessione di base. |
connectionSpec.id |
ID della specifica di connessione dell'origine. Questo ID può essere recuperato dopo che l'origine è stata registrata e approvata tramite Flow Service API. |
auth.specName |
Tipo di autenticazione utilizzato per autenticare l’origine in Platform. |
auth.params. |
Contiene le credenziali necessarie per autenticare l’origine, incluso il token di accesso per la connessione all’API. |
auth.params.accessToken |
Il token di accesso corrispondente al OneTrust Integration account. |
Risposta
In caso di esito positivo, la risposta restituisce la connessione di base appena creata, incluso il relativo identificatore univoco di connessione (id
). Questo ID è necessario per esplorare la struttura e il contenuto del file sorgente nel passaggio successivo.
{
"id": "622124ca-6d18-47f7-999c-66f599955309",
"etag": "\"2e026443-0000-0200-0000-621f1af80000\""
}
Utilizzando l’ID connessione di base generato nel passaggio precedente, puoi esplorare file e directory eseguendo richieste GET.
Utilizza le seguenti chiamate per trovare il percorso del file che desideri inserire in Platform:
Formato API
GET /connections/{BASE_CONNECTION_ID}/explore?objectType=rest&object={OBJECT}&fileType={FILE_TYPE}&preview={PREVIEW}
Quando si eseguono richieste di GET per esplorare la struttura e il contenuto dei file dell’origine, è necessario includere i parametri di query elencati nella tabella seguente:
Parametro | Descrizione |
---|---|
{BASE_CONNECTION_ID} |
ID della connessione di base generato nel passaggio precedente. |
objectType=rest |
Tipo di oggetto che si desidera esplorare. Attualmente, questo valore è sempre impostato su rest . |
{OBJECT} |
Questo parametro è necessario solo quando si visualizza una directory specifica. Il relativo valore rappresenta il percorso della directory che desideri esplorare. |
fileType=json |
Il tipo di file che desideri portare su Platform. Attualmente, json è l’unico tipo di file supportato. |
{PREVIEW} |
Valore booleano che definisce se il contenuto della connessione supporta l’anteprima. |
Richiesta
curl -X GET \
'https://platform.adobe.io/data/foundation/flowservice/connections/622124ca-6d18-47f7-999c-66f599955309/explore?objectType=rest&object=json&fileType=json&preview=true' \
-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}'
Risposta
In caso di esito positivo, la risposta restituisce la struttura del file su cui è stata eseguita la query.
Il payload di risposta JSON seguente è nascosto per brevità. Seleziona Fai clic su di me per visualizzare il payload di risposta.
{
"format": "hierarchical",
"schema": {
"type": "object",
"properties": {
"number": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"size": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"numberOfElements": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"last": {
"type": "boolean"
},
"pageable": {
"type": "object",
"properties": {
"paged": {
"type": "boolean"
},
"pageNumber": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"offset": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"tokenId": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"limit": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"pageSize": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"unpaged": {
"type": "boolean"
},
"sort": {
"type": "object",
"properties": {
"unsorted": {
"type": "boolean"
},
"sorted": {
"type": "boolean"
},
"empty": {
"type": "boolean"
}
}
}
}
},
"sort": {
"type": "object",
"properties": {
"unsorted": {
"type": "boolean"
},
"sorted": {
"type": "boolean"
},
"empty": {
"type": "boolean"
}
}
},
"content": {
"type": "object",
"properties": {
"LastUpdatedDate": {
"type": "string"
},
"Identifier": {
"type": "string"
},
"Language": {
"type": "string"
},
"TestDataSubject": {
"type": "boolean"
},
"CreatedDate": {
"type": "string"
},
"DataElements": {
"type": "array",
"items": {
"type": "object",
"properties": {}
}
},
"Id": {
"type": "string"
},
"Purposes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Status": {
"type": "string"
},
"LastTransactionDate": {
"type": "string"
},
"CustomPreferences": {
"type": "array",
"items": {
"type": "object",
"properties": {}
}
},
"LastUpdatedDate": {},
"ExpiryDate": {},
"Topics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"IsConsented": {
"type": "boolean"
},
"Id": {
"type": "string"
},
"Name": {
"type": "string"
}
}
}
},
"TotalTransactionCount": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"LastReceiptId": {},
"ConsentDate": {
"type": "string"
},
"LastInteractionDate": {},
"Name": {
"type": "string"
},
"FirstTransactionDate": {
"type": "string"
},
"LastTransactionCollectionPointId": {
"type": "string"
},
"LastTransactionCollectionPointVersion": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"Version": {
"type": "integer",
"minimum": -9007199254740992,
"maximum": 9007199254740991
},
"attributes": {
"type": "object",
"properties": {}
},
"Id": {
"type": "string"
},
"PurposeNote": {},
"WithdrawalDate": {
"type": "string"
}
}
}
}
}
},
"first": {
"type": "boolean"
},
"empty": {
"type": "boolean"
}
}
},
"data": [
{
"number": 0,
"size": 100,
"numberOfElements": 100,
"last": false,
"pageable": {
"limit": 100,
"offset": 0,
"sort": {
"sorted": true,
"unsorted": false,
"empty": false
},
"tokenId": 100,
"pageSize": 100,
"pageNumber": 0,
"unpaged": false,
"paged": true
},
"sort": {
"sorted": true,
"unsorted": false,
"empty": false
},
"content": {
"Id": "de1ab4d2-6ccf-42bd-b363-2d8cac60c88c",
"Language": "en-us",
"Identifier": "gkumar@onetrust.com",
"LastUpdatedDate": "2019-06-05T12:02:07Z",
"CreatedDate": "2018-05-02T03:14:28Z",
"Purposes": [
{
"Id": "9edf57bb-0449-4c15-98e4-8641522e5ff4",
"Name": "Purpose_UAT",
"Version": 1,
"Status": "ACTIVE",
"FirstTransactionDate": "2018-05-02T03:14:27Z",
"LastTransactionDate": "2019-05-29T11:08:26Z",
"WithdrawalDate": "2019-05-29T11:05:30Z",
"ConsentDate": "2018-05-02T03:14:27Z",
"TotalTransactionCount": 5,
"Topics": [
{
"Id": "d6e3d675-3d6f-4f4e-a157-bd93829ee632",
"Name": "Topic_UAT",
"IsConsented": true
}
],
"LastTransactionCollectionPointId": "735c85c8-c69c-44bc-8bad-ec0e806090bd",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "814c073a-95f1-4fc9-8263-1ec62225c5e9",
"Name": "Multi Pur_UAT",
"Version": 1,
"Status": "ACTIVE",
"FirstTransactionDate": "2018-05-02T03:17:33Z",
"LastTransactionDate": "2018-05-02T03:19:49Z",
"ConsentDate": "2018-05-02T03:17:33Z",
"TotalTransactionCount": 4,
"LastTransactionCollectionPointId": "9a5b7375-bc13-47e8-8a58-1ca7d9c06c8e",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "4d52dcc4-82bf-44bf-ac49-854eba6ff8f3",
"Name": "Eloqua_UAT",
"Version": 1,
"Status": "ACTIVE",
"FirstTransactionDate": "2018-05-02T03:26:36Z",
"LastTransactionDate": "2019-03-07T03:23:25Z",
"ConsentDate": "2018-05-02T03:26:36Z",
"TotalTransactionCount": 3,
"Topics": [
{
"Id": "690ad782-6280-4ea4-b62a-1514c39fc838",
"Name": "Eloqua_topic",
"IsConsented": true
}
],
"LastTransactionCollectionPointId": "f8886377-e4b1-45e4-b1c0-d7dacb744db8",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "723300e3-96cb-4da4-abdd-4913c05be215",
"Name": "Purpose 1",
"Version": 2,
"Status": "EXPIRED",
"FirstTransactionDate": "2019-02-27T06:29:48Z",
"LastTransactionDate": "2019-02-28T12:00:45Z",
"ConsentDate": "2019-02-27T06:29:48Z",
"ExpiryDate": "2019-02-28T12:00:45Z",
"TotalTransactionCount": 2,
"LastTransactionCollectionPointId": "3dbfb978-10f9-44a9-9669-d699674edd9d",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "4a5e6278-17f1-4283-beee-29f81cde2bd0",
"Name": "kbpurpose1",
"Version": 1,
"Status": "NO_CONSENT",
"FirstTransactionDate": "2019-03-07T03:21:58Z",
"LastTransactionDate": "2019-05-29T03:56:37Z",
"TotalTransactionCount": 6,
"LastTransactionCollectionPointId": "cea42a12-5de4-421a-b429-092e8d523948",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "a36f98d0-c662-4f61-a2a1-8bdab69e3c3a",
"Name": "Pur 1",
"Version": 1,
"Status": "ACTIVE",
"FirstTransactionDate": "2019-03-07T03:23:25Z",
"LastTransactionDate": "2019-03-07T03:23:27Z",
"ConsentDate": "2019-03-07T03:23:25Z",
"TotalTransactionCount": 2,
"LastTransactionCollectionPointId": "f8886377-e4b1-45e4-b1c0-d7dacb744db8",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "41ebdf32-068b-4239-89ac-42e20262c5a9",
"Name": "Send Notifications about Changes to Preferences",
"Version": 1,
"Status": "ACTIVE",
"FirstTransactionDate": "2019-03-07T03:24:11Z",
"LastTransactionDate": "2019-03-07T03:27:29Z",
"ConsentDate": "2019-03-07T03:24:11Z",
"TotalTransactionCount": 2,
"LastTransactionCollectionPointId": "c29a99a9-de4d-4367-973b-95b0217d0640",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "759d8b24-e4c0-4107-86e2-3a408db13e6b",
"Name": "GJ Purpose 07",
"Version": 2,
"Status": "WITHDRAWN",
"FirstTransactionDate": "2019-03-07T03:27:29Z",
"LastTransactionDate": "2019-05-29T11:09:03Z",
"WithdrawalDate": "2019-05-29T11:09:03Z",
"ConsentDate": "2019-03-07T03:27:29Z",
"TotalTransactionCount": 18,
"LastTransactionCollectionPointId": "cea42a12-5de4-421a-b429-092e8d523948",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "a57ee9da-b494-49e2-b562-6dfa31f190df",
"Name": "kbpurpose2",
"Version": 1,
"Status": "WITHDRAWN",
"FirstTransactionDate": "2019-03-28T03:23:44Z",
"LastTransactionDate": "2019-03-28T03:24:29Z",
"WithdrawalDate": "2019-03-28T03:24:29Z",
"ConsentDate": "2019-03-28T03:23:44Z",
"TotalTransactionCount": 2,
"LastTransactionCollectionPointId": "c29a99a9-de4d-4367-973b-95b0217d0640",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "a1ccd810-94a0-4b58-946b-6705eae15c5b",
"Name": "Purpose01 v2",
"Version": 2,
"Status": "EXPIRED",
"FirstTransactionDate": "2019-05-29T04:05:42Z",
"LastTransactionDate": "2019-06-05T12:02:06Z",
"WithdrawalDate": "2019-05-29T11:09:12Z",
"ConsentDate": "2019-05-29T04:05:42Z",
"ExpiryDate": "2019-06-05T12:02:06Z",
"TotalTransactionCount": 8,
"Topics": [
{
"Id": "af7bf604-2058-4089-985c-c84083e3e3e3",
"Name": "New_Topic",
"IsConsented": true
}
],
"LastTransactionCollectionPointId": "735c85c8-c69c-44bc-8bad-ec0e806090bd",
"LastTransactionCollectionPointVersion": 1
},
{
"Id": "a313353a-e13b-4554-be08-22cf4a78a31c",
"Name": "Purpose_1804 v2",
"Version": 2,
"Status": "ACTIVE",
"FirstTransactionDate": "2019-05-29T04:05:42Z",
"LastTransactionDate": "2019-05-29T11:09:30Z",
"WithdrawalDate": "2019-05-29T11:05:30Z",
"ConsentDate": "2019-05-29T04:05:42Z",
"TotalTransactionCount": 4,
"CustomPreferences": [
{
"Id": "4935d35a-7216-480d-9da9-1aef0e078b89",
"Name": "Custom_S",
"Options": [
{
"Id": "8acc2f9f-37f8-4ace-a513-fae6b7dd0aa9",
"Name": "Option2",
"IsConsented": true
}
]
}
],
"LastTransactionCollectionPointId": "735c85c8-c69c-44bc-8bad-ec0e806090bd",
"LastTransactionCollectionPointVersion": 1
}
],
"TestDataSubject": false
},
"first": true,
"empty": false
}
]
}
Puoi creare una connessione sorgente effettuando una richiesta POST al Flow Service API. Una connessione di origine è costituita da un ID di connessione, un percorso del file di dati di origine e un ID della specifica di connessione.
Formato API
POST /sourceConnections
Richiesta
La richiesta seguente crea una connessione sorgente per OneTrust Integration :
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
-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 '{
"name": "ONETRUST Source Connection",
"description": "ONETRUST Source Connection",
"baseConnectionId": "622124ca-6d18-47f7-999c-66f599955309",
"connectionSpec": {
"id": "cf16d886-c627-4872-9936-fb08d6cba8cc",
"version": "1.0"
},
"data": {
"format": "json"
},
"params": {}
}'
Proprietà | Descrizione |
---|---|
name |
Nome della connessione di origine. Assicurati che il nome della connessione sorgente sia descrittivo, in quanto può essere utilizzato per cercare informazioni sulla connessione sorgente. |
description |
Valore facoltativo che è possibile includere per fornire ulteriori informazioni sulla connessione di origine. |
baseConnectionId |
ID connessione di base di OneTrust Integration. Questo ID è stato generato in un passaggio precedente. |
connectionSpec.id |
ID della specifica di connessione corrispondente all'origine. |
data.format |
Il formato del OneTrust Integration i dati che desideri acquisire. Attualmente, l’unico formato di dati supportato è json . |
Risposta
In caso di esito positivo, la risposta restituisce l’identificatore univoco (id
) della connessione sorgente appena creata. Questo ID è necessario in un passaggio successivo per creare un flusso di dati.
{
"id": "eb5833d3-230d-4700-80cc-bda396e7af8a",
"etag": "\"da04c07f-0000-0200-0000-621f1afc0000\""
}
Per utilizzare i dati sorgente in Platform, è necessario creare uno schema di destinazione che strutturi i dati sorgente in base alle tue esigenze. Lo schema di destinazione viene quindi utilizzato per creare un set di dati di Platform in cui sono contenuti i dati di origine.
È possibile creare uno schema XDM di destinazione eseguendo una richiesta POST al API del registro dello schema.
Per i passaggi dettagliati su come creare uno schema XDM di destinazione, consulta l’esercitazione su creazione di uno schema tramite l’API.
È possibile creare un set di dati di destinazione eseguendo una richiesta POST al API Catalog Service, che fornisce l’ID dello schema di destinazione all’interno del payload.
Per i passaggi dettagliati su come creare un set di dati di destinazione, consulta l’esercitazione su creazione di un set di dati tramite l’API.
Una connessione di destinazione rappresenta la connessione alla destinazione in cui devono essere memorizzati i dati acquisiti. Per creare una connessione di destinazione, devi fornire l'ID di specifica della connessione fissa che corrisponde al Data Lake. Questo ID è: c604ff05-7f1a-43c0-8e18-33bf874cb11c
.
Ora disponi degli identificatori univoci, di uno schema di destinazione, di un set di dati di destinazione e dell’ID della specifica di connessione al Data Lake. Utilizzando questi identificatori, puoi creare una connessione di destinazione utilizzando Flow Service API per specificare il set di dati che conterrà i dati di origine in entrata.
Formato API
POST /targetConnections
Richiesta
La richiesta seguente crea una connessione di destinazione per OneTrust Integration :
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/targetConnections' \
-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 '{
"name": "ONETRUST Target Connection",
"description": "ONETRUST Target Connection",
"connectionSpec": {
"id": "c604ff05-7f1a-43c0-8e18-33bf874cb11c",
"version": "1.0"
},
"data": {
"format": "json"
},
"params": {
"dataSetId": "61f6ca3f33978c19486bb463"
}
}'
Proprietà | Descrizione |
---|---|
name |
Nome della connessione di destinazione. Assicurati che il nome della connessione di destinazione sia descrittivo, in quanto può essere utilizzato per cercare informazioni sulla connessione di destinazione. |
description |
Valore facoltativo che è possibile includere per fornire ulteriori informazioni sulla connessione di destinazione. |
connectionSpec.id |
ID della specifica di connessione che corrisponde a Data Lake. Questo ID fisso è: c604ff05-7f1a-43c0-8e18-33bf874cb11c . |
data.format |
Il formato del OneTrust Integration dati da inserire in Platform. |
params.dataSetId |
ID del set di dati di destinazione recuperato in un passaggio precedente. |
Risposta
In caso di esito positivo, la risposta restituisce l’identificatore univoco della nuova connessione di destinazione (id
). Questo ID è richiesto nei passaggi successivi.
{
"id": "495f761f-310a-4a7b-ae78-5b1152d74b38",
"etag": "\"410a7b0c-0000-0200-0000-621f1afd0000\""
}
Per poter acquisire i dati di origine in un set di dati di destinazione, è necessario prima mapparli sullo schema di destinazione a cui il set di dati di destinazione aderisce. Ciò si ottiene eseguendo una richiesta POST a Data Prep API con mappature di dati definite nel payload della richiesta.
Formato API
POST /conversion/mappingSets
Richiesta
curl -X POST \
'https://platform.adobe.io/data/foundation/conversion/mappingSets' \
-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 '{
"version": 0,
"xdmSchema": "https://ns.adobe.com/{TENANT_ID}/schemas/cfc8cee182e546c1fb35071185524b465e06bf1acb74f30d",
"xdmVersion": "1.0",
"id": null,
"mappings": [{
"sourceType": "ATTRIBUTE",
"source": "content.Identifier",
"destination": "_id",
"name": "id",
"description": "Identifier field"
},
{
"sourceType": "ATTRIBUTE",
"source": "content.Identifier",
"destination": "_exchangesandboxbravo.Identifier"
},
{
"sourceType": "ATTRIBUTE",
"source": "content.Language",
"destination": "_exchangesandboxbravo.Language",
"description": "Language field"
},
{
"sourceType": "ATTRIBUTE",
"source": "content.CreatedDate",
"destination": "_exchangesandboxbravo.CreatedDate",
"description": "Created Date field"
},
{
"sourceType": "ATTRIBUTE",
"source": "content.LastUpdatedDate",
"destination": "_exchangesandboxbravo.LastUpdatedDate",
"description": "Created Date field"
},
{
"sourceType": "ATTRIBUTE",
"source": "content.DataElements",
"destination": "_exchangesandboxbravo.DataElements"
},
{
"sourceType": "ATTRIBUTE",
"source": "content.Purposes",
"destination": "_exchangesandboxbravo.Purposes"
}
]
}'
Proprietà | Descrizione |
---|---|
xdmSchema |
ID del schema XDM di destinazione generato in un passaggio precedente. |
mappings.destinationXdmPath |
Percorso XDM di destinazione in cui viene eseguito il mapping dell’attributo di origine. |
mappings.sourceAttribute |
L’attributo di origine che deve essere mappato su un percorso XDM di destinazione. |
Risposta
In caso di esito positivo, la risposta restituisce i dettagli della mappatura appena creata, compreso l’identificatore univoco (id
). Questo valore è necessario in un passaggio successivo per creare un flusso di dati.
{
"id": "a87f130e82f04d5188da01f087805c4b",
"version": 0,
"createdDate": 1646205694395,
"modifiedDate": 1646205694395,
"createdBy": "{CREATED_BY}",
"modifiedBy": "{MODIFIED_BY}"
}
L’ultimo passaggio per importare dati da OneTrust Integration In Platform è necessario creare un flusso di dati. A questo punto sono stati preparati i seguenti valori obbligatori:
Un flusso di dati è responsabile della pianificazione e della raccolta di dati da un’origine. Puoi creare un flusso di dati eseguendo una richiesta POST e fornendo i valori precedentemente menzionati all’interno del payload.
Per pianificare un’acquisizione, devi prima impostare il valore dell’ora di inizio su tempo epoca in secondi. Quindi, è necessario impostare il valore della frequenza su una delle cinque opzioni seguenti: once
, minute
, hour
, day
, o week
. Il valore di intervallo indica il periodo tra due acquisizioni consecutive, tuttavia, la creazione di un’acquisizione una tantum non richiede l’impostazione di un intervallo. Per tutte le altre frequenze, il valore dell'intervallo deve essere impostato su uguale o maggiore di 15
.
Formato API
POST /flows
Richiesta
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/flows' \
-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 '{
"name": "ONETRUST dataflow",
"description": "ONETRUST dataflow",
"flowSpec": {
"id": "6499120c-0b15-42dc-936e-847ea3c24d72",
"version": "1.0"
},
"sourceConnectionIds": [
"eb5833d3-230d-4700-80cc-bda396e7af8a"
],
"targetConnectionIds": [
"495f761f-310a-4a7b-ae78-5b1152d74b38"
],
"transformations": [
{
"name": "Mapping",
"params": {
"mappingId": "a87f130e82f04d5188da01f087805c4b",
"mappingVersion": 0
}
}
],
"scheduleParams": {
"startTime": "1625040887",
"frequency": "minute",
"interval": 15
}
}'
Proprietà | Descrizione |
---|---|
name |
Nome del flusso di dati. Assicurati che il nome del flusso di dati sia descrittivo, in quanto può essere utilizzato per cercare informazioni sul flusso di dati. |
description |
Valore facoltativo che puoi includere per fornire ulteriori informazioni sul flusso di dati. |
flowSpec.id |
ID della specifica di flusso necessario per creare un flusso di dati. Questo ID fisso è: 6499120c-0b15-42dc-936e-847ea3c24d72 . |
flowSpec.version |
Versione corrispondente dell'ID della specifica di flusso. Questo valore viene impostato automaticamente su 1.0 . |
sourceConnectionIds |
Il ID connessione sorgente generato in un passaggio precedente. |
targetConnectionIds |
Il ID connessione di destinazione generato in un passaggio precedente. |
transformations |
Questa proprietà contiene le varie trasformazioni che devono essere applicate ai dati. Questa proprietà è necessaria per portare dati non conformi a XDM su Platform. |
transformations.name |
Nome assegnato alla trasformazione. |
transformations.params.mappingId |
Il ID mappatura generato in un passaggio precedente. |
transformations.params.mappingVersion |
Versione corrispondente dell'ID di mappatura. Questo valore viene impostato automaticamente su 0 . |
scheduleParams.startTime |
Questa proprietà contiene informazioni sulla pianificazione dell’acquisizione del flusso di dati. |
scheduleParams.frequency |
La frequenza con cui il flusso di dati raccoglierà i dati. I valori accettabili includono: once , minute , hour , day , o week . |
scheduleParams.interval |
L’intervallo indica il periodo tra due esecuzioni consecutive del flusso. Il valore dell'intervallo deve essere un numero intero diverso da zero. Intervallo non richiesto quando la frequenza è impostata come once e deve essere maggiore o uguale a 15 per altri valori di frequenza. |
Risposta
In caso di esito positivo, la risposta restituisce l’ID (id
) del flusso di dati appena creato. Puoi usare questo ID per monitorare, aggiornare o eliminare il flusso di dati.
{
"id": "70045189-42f0-493d-9b9e-be1045a9f4fa",
"etag": "\"1601e900-0000-0200-0000-621f1b080000\""
}
La sezione seguente fornisce informazioni sui passaggi possibili per monitorare, aggiornare ed eliminare il flusso di dati.
Una volta creato il flusso di dati, puoi monitorare i dati che vengono acquisiti tramite di esso per visualizzare informazioni sulle esecuzioni del flusso, sullo stato di completamento e sugli errori. Per esempi API completi, consulta la guida su monitoraggio dei flussi di dati di origine tramite l’API.
Aggiorna i dettagli del flusso di dati, ad esempio il nome e la descrizione, nonché la pianificazione di esecuzione e i set di mappatura associati, effettuando una richiesta PATCH al /flows
endpoint di Flow Service e fornire l’ID del flusso di dati. Quando effettui una richiesta PATCH, devi fornire il codice univoco del flusso di dati etag
nel If-Match
intestazione. Per esempi API completi, consulta la guida su aggiornamento dei flussi di dati di origine tramite l’API.
Aggiorna il nome, la descrizione e le credenziali dell’account di origine eseguendo una richiesta PATCH al Flow Service fornendo l’ID connessione di base come parametro di query. Quando effettui una richiesta PATCH, devi fornire il codice univoco dell’account sorgente etag
nel If-Match
intestazione. Per esempi API completi, consulta la guida su aggiornamento dell’account sorgente tramite l’API.
Elimina il flusso di dati eseguendo una richiesta DELETE al Flow Service fornendo l’ID del flusso di dati che desideri eliminare come parte del parametro di query. Per esempi API completi, consulta la guida su eliminazione dei flussi di dati tramite API.
Elimina l’account eseguendo una richiesta DELETE al Flow Service fornendo l’ID della connessione di base dell’account da eliminare. Per esempi API completi, consulta la guida su eliminazione dell’account sorgente tramite l’API.