Esempio: integrazione programmatica di Amazon S3 con i profili dei clienti Amazon Connect - Amazon Connect
Passaggio 1: Creazione di un file JSONFase 2: Chiama PutIntegrationPassaggio 3: chiama Amazon AppFlow StartFlow

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempio: integrazione programmatica di Amazon S3 con i profili dei clienti Amazon Connect

Utilizzando l'PutIntegrationAPI Customer Profiles, puoi creare in modo programmatico integrazioni per S3, Salesforce, Marketo e altro.

In questo argomento viene mostrato come creare un'integrazione S3 con un intervallo di sincronizzazione di 15 minuti, il valore minimo attualmente supportato.

Passaggio 1: Creazione di un file JSON

Crea un file JSON con i seguenti contenuti:

{
    "DomainName": "your-domain",
    "ObjectTypeName": "your-object-name", 
    "FlowDefinition": {
        "FlowName": "your-flow-name",
        "KmsArn": "the key ARN is the same as your domain's key",
        "Description": "Created by Customer Profiles",
        "TriggerConfig": {
            "TriggerType": "Scheduled",
            "TriggerProperties": {
                "Scheduled": {
                    "ScheduleExpression": "rate(15minutes)",
                    "DataPullMode": "Incremental",
                    "ScheduleStartTime": 1634244800.435,
                    "FirstExecutionFrom": 1594166400
                }
            }
        },
        "SourceFlowConfig": {
            "ConnectorType":"S3",
            "SourceConnectorProperties": {
                "S3": {
                    "BucketName": "your-bucket",
                    "BucketPrefix": "your-prefix"
                }
            }
        },
        "Tasks": [
            {"TaskType":"Filter","SourceFields":["colA","colB"],"ConnectorOperator":{"S3":"PROJECTION"}},
            {"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colA","TaskProperties":{},"SourceFields":["colA"],"TaskType":"Map"},
            {"ConnectorOperator":{"S3":"NO_OP"},"DestinationField":"colB","TaskProperties":{},"SourceFields":["colB"],"TaskType":"Map"}
        ]
    }
}

Per personalizzare il JSON con valori, seguire le linee guida riportate di seguito:

  • FlowName: Può essere STRING [a-zA-Z0-9] [\w!@#.-]+

  • ScheduleStartTime: Imposta sull'attuale valore di DateTime + 5 minuti nell'ora dell'epoca.

  • FirstExecutionFrom: Vai su S3, controlla la data del file e usa una data precedente alla data più vecchia.

  • Tasks: Definisci TaskType. Nel campo Sourcefields fornisci TUTTE le colonne presenti nel file CSV in quell'array. Quindi, per ciascuno degli elementi di quell'array, specifica i lConnectorOperator. Questo esempio riguarda un documento CSV con due colonne: colA e colB.

Passaggio 2: chiama l'API PutIntegration

Dopo aver creato e personalizzato il file JSON con i tuoi valori, chiama l'PutIntegrationAPI, come mostrato nell'esempio seguente:

aws customer-profiles put-integration --cli-input-json file:///put_integration_s3_cli.json --region us-west-2

La risposta da PutIntegration restituisce un URI di flusso. Ad esempio:

{
    "DomainName": "testDomain",
    "Uri": "arn:aws:appflow:us-west-2:9999999999999:flow/Customer_Profiles_testDomain_S3_Salesforce-Account_1634244122247",
    "ObjectTypeName": "your objec type",
    "CreatedAt": "2021-10-14T13:51:57.748000-07:00",
    "LastUpdatedAt": "2021-10-14T13:51:57.748000-07:00",
    "Tags": {}
}

Fase 3: Chiama l' AppFlow StartFlowAPI Amazon

Usa l'URI del flusso per chiamare l' AppFlow StartFlowAPI Amazon. Ad esempio:

aws appflow start-flow —flow-name uri --region us-west-2