---
schema_version: "1"
id: c71c81795ee658e05f6767b746a7ad2f2431fd5311c13637edda5618fc4099ac
title: Salesforce Marketing Cloud Connector 4.1 の例
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/salesforce-marketing-cloud-connector/4.1/salesforce-mktg-connector-examples.md
canonical_url: https://docs.mulesoft.com/jp/salesforce-marketing-cloud-connector/4.1/salesforce-mktg-connector-examples
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 4e357fc6fc5f72e01421d30844bf1e554ec81ccf2a11a01d00744af72909b368
description: MuleSoft Documentation Site
release: "4.1"
latest: true
---
# Salesforce Marketing Cloud Connector 4.1 の例

Salesforce Marketing Cloud Connector の Mule フローの例を示します。

- [リストの作成](#create-list)
- [リストの取得](#retrieve-list)​

## [](#始める前に)始める前に

- Java 8、11、または 17
- Anypoint Studio 7.5 以降
- Mule Runtime Engine (Mule) 4.3.0 以降
- DataWeave
- Salesforce Marketing Cloud の OAuth ログイン情報

## [](#接続の設定)接続の設定

接続を保護するには、接続項目の値を指定する必要があります。次の手順を実行します。

- [接続の設定ファイルを作成する](#create-config-file)​。
- [接続のグローバル要素を設定する](#configure-conn)​。
- [プロパティファイルのグローバル要素を設定する](#configure-global)​。

### [](#create-config-file)接続の設定ファイルを作成する

接続のプロパティが含まれる設定ファイルを作成します。

1. `/src/main/resources/`​ フォルダー内に ​`mule-app.properties`​ という名前のファイルを作成します。
2. `mule-app.properties`​ ファイルに、次のような接続の一連のプロパティを作成します。括弧で囲まれたテキスト (括弧を含む) を各自の設定の適切な値に置き換えます。
    
    config-with-oauth.clientId=<clientId used to initialize the connection>
    config-with-oauth.clientSecret=<clientSecret used to authenticate the user>
    config-with-oauth.soapEndpoint=<SOAP endpoint address>
    config-with-oauth.authEndpoint=<Authentication endpoint>
    
    これは、選択した接続設定によって異なる場合があります。

プロパティファイルの作成についての詳細は、​[「プロパティプレースホルダーの設定」](https://docs.mulesoft.com/mule-runtime/latest/mule-app-properties-to-configure)​を参照してください。

### [](#configure-conn)接続のグローバル要素を設定する

接続のグローバル要素を設定します。

1. 新しい Mule プロジェクトを作成します。
2. **\[Mule Palette (Mule パレット)\]**​ ビューで、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックして​`「Salesforce Marketing Cloud」`​と入力します。
3. **\[Selected modules (選択したモジュール)\]**​ セクションに ​**\[Salesforce Marketing Cloud Connector\]**​ を追加し、​**\[Finish (完了)\]**​ をクリックします。
4. **\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。
5. **\[Connector Configuration (コネクタ設定)\] > \[Salesforce Marketing Cloud\]**​ を選択し、​**\[OK\]**​ をクリックします。
6. 値を入力して、\[Basic Authentication (基本認証)\] または \[OAuth Client Credentials (OAuth クライアントログイン情報)\] のいずれかを設定します。
7. **\[Test Connection (接続をテスト)\]**​ ボタンをクリックして、Salesforce Marketing Cloud API と接続されていることを確認します。ポップアップに成功メッセージが表示されます。
8. **\[OK\]**​ をクリックします。
9. **\[Global Element Configuration (グローバル要素設定)\]**​ で HTTPS リスナー設定を開きます。
10. **\[TLS\]**​ タブをクリックし、\[TLS Configuration (TLS 設定)\] > \[Edit inline (インライン編集)\] を選択します。
11. 生成されたキーストアの詳細を使用して ​**\[Key Store Configuration (キーストア設定)\]**​ を指定し、この設定で HTTPS を有効にします。
12. **\[OK\]**​ をクリックします。

### [](#configure-global)プロパティファイルのグローバル要素を設定する

`mule-app.properties`​ ファイルのグローバル要素を設定して、Mule がその場所を認識できるようにします。

1. **\[Global Elements (グローバル要素)\]**​ タブをクリックし、​**\[Create (作成)\]**​ をクリックします。
2. **\[Choose Global Type (グローバル種別の選択)\]**​ ダイアログで、​**\[Configuration properties (設定プロパティ)\]**​ を選択し、​**\[OK\]**​ をクリックします。
3. **\[File (ファイル)\]**​ 項目に「​`mule.app.properties`​」と入力します。
4. **\[OK\]**​ をクリックします。

## [](#create-list)リストの作成

この Mule フローでは、サブスクライバーを保存するためのリストを作成します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">[List type (リスト種別)] のデフォルト値は ​<code>[Public (公開)]</code>​ で、すべてのサブスクライバーにリストが表示されるようになります。リストの作成後、他の操作で使用するリスト ID をメモします。</td></tr></tbody></table>

この例では、次の操作を使用します。

- **HTTP Listener**​  
    HTTP 要求からデータを受け入れる
- **Logger**​  
    **HTTP Listener**​ からの HTTP 応答を表示します。
- **Transform Message**​  
    データを Java で出力します。
    
    %dw 2.0
    output application/java
    ---
    \[{
    
    	ListClassification: payload.listClassification,
    	ListName: payload.listName,
    	"Type": payload.listType
    }\]
- **Create entities**​  
    Marketing Cloud API Web サーバーに新しいオブジェクトを作成します。
    
    次の値を入力します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">Value (値)</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Object type (オブジェクト種別)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>List</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connector Configuration (コネクタ設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>Salesforce_Marketing_Cloud_Sfdc_marketing_cloud_config</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Api objects (API オブジェクト)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>payload</code></p>
</div></div></td>
</tr>
</tbody>
</table>
- **Transform Message**​  
    データを JSON で出力します。
    
    output application/json
    ---
    payload

![Create List 操作の Studio フロー](/mulesoft/current/ja-jp/salesforce-marketing-cloud-connector/4.1/_images/salesforce-mktg-create-list.png)

### [](#この例の-xml)この例の XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:sfdc-marketing-cloud="http://www.mulesoft.org/schema/mule/sfdc-marketing-cloud"
      xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
      xmlns:http="http://www.mulesoft.org/schema/mule/http"
      xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
  http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
http://www.mulesoft.org/schema/mule/sfdc-marketing-cloud http://www.mulesoft.org/schema/mule/sfdc-marketing-cloud/current/mule-sfdc-marketing-cloud.xsd">

	<configuration-properties file="mule-app.properties" />
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="2d500821-46be-4da2-a983-832ca1d829de" >
		<http:listener-connection host="localhost" port="8081" />
	</http:listener-config>

	<sfdc-marketing-cloud:config name="Salesforce_Marketing_Cloud_Sfdc_marketing_cloud_config" doc:name="Salesforce Marketing Cloud Sfdc marketing cloud config" doc:id="8c951adc-306a-4212-a33f-4be4b19a0076" >
		<sfdc-marketing-cloud:oauth-client-credentials-connection serviceUrl="${config-with-oauth-v2.serviceUrl}">
			<sfdc-marketing-cloud:oauth-client-credentials clientId="${config-with-oauth-v2.clientId}"
														   clientSecret="${config-with-oauth-v2.clientSecret}"
														   tokenUrl="${config-with-oauth-v2.tokenUrl}" />
		</sfdc-marketing-cloud:oauth-client-credentials-connection>
	</sfdc-marketing-cloud:config>

    <flow name="salesforce-marketing-cloud-oauth-demo-create-list-flow">
        <http:listener path="/create-list" doc:name="HTTP" config-ref="HTTP_Listener_config"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <ee:transform doc:name="Transform Message" doc:id="fab54a8d-4f2d-45cf-9496-9d407bf5837f" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
output application/java
---
[{

	ListClassification: payload.listClassification,
	ListName: payload.listName,
	"Type": payload.listType
}]]]></ee:set-payload>
			</ee:message>
		</ee:transform>
        <sfdc-marketing-cloud:create config-ref="Salesforce_Marketing_Cloud_Sfdc_marketing_cloud_config" objectType="List" doc:name="Salesforce Marketing Cloud"/>
        <ee:transform doc:name="Transform Message" doc:id="a61ae2f3-0821-4884-9a4c-2306071c7ec8" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
output application/json
---
payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
    </flow>
</mule>
```

## [](#retrieve-list)リストの取得

この Mule フローでは、他の操作で使用するリストの ID を取得します。

この例では、次の操作を使用します。

- **HTTP Listener**​  
    HTTP 要求からデータを受け入れる
- **Logger**​  
    **HTTP Listener**​ からの HTTP 応答を表示します。
- **Transform Message**​  
    データを Java で出力します。
    
    %dw 2.0
    output application/java
    ---
    {
    	query: "SELECT ID FROM List WHERE ListName ='" ++ payload.listName ++ "'"
    }
- **Retrieve entities**​  
    SQL クエリを使用して Salesforce Marketing Cloud API Web サーバーからオブジェクトを取得します。
    
    次の値を入力します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">Value (値)</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Connector Configuration (コネクタ設定)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>Salesforce_Marketing_Cloud_Sfdc_marketing_cloud_config</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Query (クエリ)</strong></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[payload.query]</code></p>
</div></div></td>
</tr>
</tbody>
</table>
- **Transform Message**​  
    データを JSON 形式で出力します。
    
    %dw 2.0
    output application/json
    ---
    payload

![Retrieve List 操作の Studio フロー](/mulesoft/current/ja-jp/salesforce-marketing-cloud-connector/4.1/_images/salesforce-mktg-retrieve-list.png)

### [](#この例の-xml-2)この例の XML

この例のフローをすばやく Mule アプリケーションに読み込むには、次のコードを Studio XML エディターに貼り付けます。

```xml
<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:sfdc-marketing-cloud="http://www.mulesoft.org/schema/mule/sfdc-marketing-cloud"
      xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
      xmlns:http="http://www.mulesoft.org/schema/mule/http"
      xmlns="http://www.mulesoft.org/schema/mule/core"
      xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
  http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd
http://www.mulesoft.org/schema/mule/sfdc-marketing-cloud http://www.mulesoft.org/schema/mule/sfdc-marketing-cloud/current/mule-sfdc-marketing-cloud.xsd">

	<configuration-properties file="mule-app.properties" />
	<http:listener-config name="HTTP_Listener_config" doc:name="HTTP Listener config" doc:id="651f3647-d4c9-4536-8d6b-bee43c422625" >
		<http:listener-connection host="localhost" port="8081" />
	</http:listener-config>

	<sfdc-marketing-cloud:config name="Salesforce_Marketing_Cloud_Sfdc_marketing_cloud_config" doc:name="Salesforce Marketing Cloud Sfdc marketing cloud config" doc:id="7ef81352-ca1d-4134-bccb-b211a1951a60" >
		<sfdc-marketing-cloud:oauth-client-credentials-connection serviceUrl="${config-with-oauth-v2.serviceUrl}">
			<sfdc-marketing-cloud:oauth-client-credentials clientId="${config-with-oauth-v2.clientId}"
														   clientSecret="${config-with-oauth-v2.clientSecret}"
														   tokenUrl="${config-with-oauth-v2.tokenUrl}" />
		</sfdc-marketing-cloud:oauth-client-credentials-connection>
	</sfdc-marketing-cloud:config>

    <flow name="salesforce-marketing-cloud-oauth-demo-retrieve-list-flow">
        <http:listener path="/retrieve-list" doc:name="HTTP" config-ref="HTTP_Listener_config"/>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
        <ee:transform doc:name="Transform Message" doc:id="fe31d1a8-d189-4fbd-b96f-99c2eac092e1" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
output application/java
---
{
	query: "SELECT ID FROM List WHERE ListName ='" ++ payload.listName ++ "'"
}]]></ee:set-payload>
			</ee:message>
		</ee:transform>
        <sfdc-marketing-cloud:retrieve doc:name="Salesforce Marketing Cloud" config-ref="Salesforce_Marketing_Cloud_Sfdc_marketing_cloud_config">
			<sfdc-marketing-cloud:query>#[payload.query]</sfdc-marketing-cloud:query>
		</sfdc-marketing-cloud:retrieve>
        <ee:transform doc:name="Transform Message" doc:id="d05834f2-3d96-4e95-bd3b-48057d4ca34e" >
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
output application/json
---
payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
        <logger message="#[payload]" level="INFO" doc:name="Logger"/>
    </flow>
</mule>
```

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)