Adobe Marketo Connector - Mule 4

Adobe Marketo Connector v3.0

Adobe Marketo 用 Anypoint Connector (Marketo Connector) は、Mule Runtime Engine (Mule) と Adobe Marketo REST API 間の接続を可能にするクローズドソースのコネクタです。このコネクタはサポートされているすべての v1.0 Adobe Marketo API エンドポイントを実装し、Mule 4 DataWeave の機能を提供します。

リリースノート: 『Marketo Connector リリースノート』
Exchange: Marketo Connector Leaving the Site

始める前に

この情報を使用するには、Adobe Marketo、Mule Runtime Engine (Mule)、Anypoint Connector、Anypoint Studio、Mule の概念、Mule フローの要素、グローバル要素に精通している必要があります。

対象リソースへの接続をテストするには、ログイン情報が必要です。

ソフトウェアの要件および互換性情報については、「コネクタリリースノート」を参照してください。

POM ファイル情報

Maven でこのコネクタを使用するには、pom.xml の連動関係情を使用します。

<dependency>
  <groupId>com.mulesoft.connectors</groupId>
  <artifactId>mule-marketo-connector</artifactId>
  <version>x.x.x</version>
  <classifier>mule-plugin</classifier>
</dependency>xml

x.x.x を使用しているコネクタに対応するバージョンに置き換えます。

最新の pom.xml ファイル情報を取得するには、 Anypoint Exchange Leaving the Site でコネクタにアクセスし、[Dependency Snippets (連動関係スニペット)] をクリックします。

Studio プロジェクトへのコネクタの追加

Anypoint Studio には、Studio プロジェクトにコネクタを追加する 2 つの方法があります。Studio タスクバーの Exchange ボタンから追加するか、[Mule Palette (Mule パレット)] ビューから追加します。

Exchange を使用してコネクタを追加する

Studio で Mule プロジェクトを作成します。
Studio タスクバーの左上にある Exchange アイコン (X) をクリックします。
Exchange で、[Login (ログイン)] をクリックし、Anypoint Platform のユーザー名とパスワードを指定します。
Exchange で、「marketo」を検索します。
コネクタを選択して [Add to project (プロジェクトに追加)] をクリックします。
画面の指示に従ってコネクタをインストールします。

Studio でコネクタに追加する

Studio で Mule プロジェクトを作成します。
[Mule Palette (Mule パレット)] ビューで、[(X) Search in Exchange ((X) Exchange 内を検索)] をクリックします。
[Add Modules to Project (モジュールをプロジェクトに追加)] で、検索項目に「marketo」と入力します。
[Available modules (使用可能なモジュール)] で、このコネクタの名前をクリックします。
[Add (追加)] をクリックします。
[Finish (完了)] をクリックします。

Studio に設定する方法

コネクタ操作を Studio キャンバスにドラッグします。
緑のプラスボタンをクリックしてコネクタを設定します。
ウィンドウが表示され、次の項目を設定できます。

項目説明

項目	説明
Base Path (ベースパス)	先頭の Marketo ベースパス (`/` (スラッシュ) など)。
Client Id (クライアント ID)	Marketo クライアント ID。
Client Secret (クライアントシークレット)	Marketo クライアントシークレット。
Host (ホスト)	Marketo インスタンスがホストされるドメイン。
Port (ポート)	Marketo インスタンスのポート。
Protocol (プロトコル)	データ転送に使用するプロトコル (HTTPS など)。
Access Token Url (アクセストークン URL)	認証トークンの取得に使用する URL。

Base Path (ベースパス)

先頭の Marketo ベースパス (/ (スラッシュ) など)。

Client Id (クライアント ID)

Marketo クライアント ID。

Client Secret (クライアントシークレット)

Marketo クライアントシークレット。

Host (ホスト)

Marketo インスタンスがホストされるドメイン。

Port (ポート)

Marketo インスタンスのポート。

Protocol (プロトコル)

データ転送に使用するプロトコル (HTTPS など)。

Access Token Url (アクセストークン URL)

認証トークンの取得に使用する URL。

ユースケース: Studio 7 でのプログラムの作成

Listener、Marketo Create program 操作、および 2 つの Transform Message コンポーネントを含む Studio フロー

ユースケース: XML

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

<mule xmlns:os="http://www.mulesoft.org/schema/mule/os"
xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core"
xmlns:marketo-rest-api="http://www.mulesoft.org/schema/mule/marketo-rest-api"
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/core
http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http
http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/marketo-rest-api
http://www.mulesoft.org/schema/mule/marketo-rest-api/current/mule-marketo-rest-api.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/os
http://www.mulesoft.org/schema/mule/os/current/mule-os.xsd">
	<configuration-properties file="mule-app.properties"
	doc:name="Configuration properties"/>
	<http:listener-config name="HTTP_Listener_config"
	doc:name="HTTP Listener config">
		<http:listener-connection host="localhost" port="8081" />
	</http:listener-config>
	<marketo-rest-api:config name="Marketo_Rest_API_Config" doc:name="Marketo Rest API Config" property_basePath="/"
	property_clientId="${clientId}"
	property_clientSecret="${clientSecret}"
	property_host="${host}"
	property_accessTokenUrl="${accessTokenUrl}"
	property_port="${port}"
	property_protocol="${protocol}"/>
	<os:object-store name="Object_store" doc:name="Object store"  config-ref="ObjectStore_Config"/>
	<os:config name="ObjectStore_Config" doc:name="ObjectStore Config"  />
	<flow name="Create_Form" >
		<http:listener doc:name="HTTP"  config-ref="HTTP_Listener_config" path="/createForm" />
		<ee:transform doc:name="Transform Message">
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
output application/json
---
{
	"description": "FormDemo",
	"folder":"22498",
	"name": "MarketoDemoForm_01"
}]]></ee:set-payload>
			</ee:message>
		</ee:transform>
		<marketo-rest-api:create-form doc:name="Create form" config-ref="Marketo_Rest_API_Config"/>
		<ee:transform doc:name="Object to JSON">
			<ee:message >
				<ee:set-payload ><![CDATA[%dw 2.0
output application/json
---
payload]]></ee:set-payload>
			</ee:message>
		</ee:transform>
		<os:store doc:name="Store form id" key="formId" objectStore="Object_store">
			<os:value ><![CDATA[#[payload.result[0].id]]]></os:value>
		</os:store>
		<set-variable
		value="#[payload.result[0].id]"
		doc:name="Set Variable"
		variableName="id"/>
		<set-variable
		value="#[payload.result[0].name]"
		doc:name="Set Variable"
		variableName="name" />
		<logger level="INFO" doc:name="Logger"
		message="Created form named: #[vars.name] with id: #[vars.id]" />
	</flow>
</mule>xml
コンテンツを展開する