本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 範例：以程式設計方式整合 Amazon S3 與 Amazon Connect Customer Profiles
<a name="customerprofiles-s3-integration"></a>

使用客戶設定檔 [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html) API，您可以透過程式設計方式為 S3、Salesforce、Marketo 等建立整合。

在本主題中，我們將示範如何建立同步間隔為 15 分鐘 (目前支援的最小值) 的 S3 整合。

## 步驟 1：建立 JSON 檔案
<a name="step1-cpintegration"></a>

使用下列內容建立檔案：

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

若要使用您自己的值來自訂 JSON，請遵循下列指示：
+ `FlowName`：可以是字串 [a-zA-Z0-9][\$1w\$1@\$1.-]\$1
+ `ScheduleStartTime`：設定為紀元時間目前 `DateTime` \$1 5 分鐘。
+ `FirstExecutionFrom`：前往 S3，查看檔案日期，並使用最早日期之前的日期。
+ `Tasks`：定義 `TaskType`。在 `Sourcefields` 欄位中，您必須提供該陣列您的 CSV 的所有各欄。然後，對於該陣列中的每個項目，您需要指定 `ConnectorOperator`。此範例適用於具有兩欄：`colA` 和 `colB` 的 CSV 檔案。

## 步驟 2：呼叫 PutIntegration API
<a name="step2-cpintegration"></a>

使用您的值建立並自訂 JSON 檔案之後，請呼叫 [PutIntegration](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutIntegration.html) API，如下列範例所示：

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

來自 `PutIntegration` 的回應會傳回流程 URI。例如：

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

## 步驟 3：呼叫 Amazon AppFlow StartFlow API
<a name="step3-cpintegration"></a>

使用流程 URI 呼叫 Amazon AppFlow [StartFlow](https://docs.aws.amazon.com/appflow/1.0/APIReference/API_StartFlow.html) API。例如：

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