View a markdown version of this page

Beispiel: Integrieren Sie Amazon S3 programmgesteuert in Connect Customer Customer Customer Profiles - Amazon Connect-Kunde
Schritt 1: Erstellen einer JSON-DateiSchritt 2: Aufrufen PutIntegrationSchritt 3: Rufen Sie Amazon an AppFlow StartFlow

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Beispiel: Integrieren Sie Amazon S3 programmgesteuert in Connect Customer Customer Customer Profiles

Mithilfe der Customer Profiles PutIntegration API können Sie programmatisch Integrationen für S3, Salesforce, Marketo und mehr erstellen.

In diesem Thema erfahren Sie, wie Sie eine S3-Integration mit einem Synch-Intervall von 15 Minuten erstellen, dem derzeit unterstützten Mindestwert.

Schritt 1: Erstellen einer JSON-Datei

Erstellen Sie eine JSON-Datei mit folgendem Inhalt:

{
    "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"}
        ]
    }
}

Beachten Sie die folgenden Richtlinien, wenn Sie die JSON-Datei mit Ihren eigenen Werten anpassen möchten:

  • FlowName: Kann STRING [A-Z0-9a-z] [\ w! sein! @#.-] +

  • ScheduleStartTime: Auf die aktuelle Epochenzeit von DateTime + 5 Minuten eingestellt.

  • FirstExecutionFrom: Öffnen Sie S3, sehen Sie sich das Dateidatum an und verwenden Sie ein Datum, das vor dem ältesten Datum liegt.

  • Tasks: TaskType definieren. Im Sourcefields-Feld müssen ALLE Spalten angegeben werden, die Sie in diesem Array in Ihrer CSV haben. Anschließend müssen Sie für jedes der Elemente in diesem Array ConnectorOperator angeben. Dieses Beispiel bezieht sich auf ein CSV-Dokument mit zwei Spalten: colA und colB.

Schritt 2: Rufen Sie die API auf PutIntegration

Nachdem Sie die JSON-Datei mit Ihren Werten erstellt und angepasst haben, rufen Sie die PutIntegration API auf, wie im folgenden Beispiel gezeigt:

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

Die Antwort von PutIntegration gibt einen Flow-URI zurück. Beispiel:

{
    "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": {}
}

Schritt 3: Rufen Sie die AppFlow StartFlow Amazon-API auf

Verwenden Sie die Flow-URI, um die AppFlow StartFlow Amazon-API aufzurufen. Beispiel:

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