MuleSoft Composer for Salesforce: はじめに

コンポーザーをセットアップする前に、記載された要件を満たしていることを確認します。その後、セットアップを行ってコンポーザーの使用を開始することができます。

要件と制限事項

コンポーザーをセットアップする組織は、Salesforce Unlimited Edition、Enterprise Edition、または Performance Edition の組織である必要があります。Sandbox 組織では設定できません。
組織でサポートされる同時ユーザーの最大数は 25 です。
組織では Lightning が有効になっている必要があります。
組織用の個別の Mulesoft Composer ライセンスを購入する必要があります。
会社のネットワークに厳格なファイアウォールやブロックされている IP アドレスのリストがある場合、ネットワーク管理者は、許可されているアドレスのリストに *.mulesoft.com を追加する必要があります。

コンポーザーで使用される IP アドレスは動的なため、Mulesoft では IP アドレスのリストを提供できません。
データ取得元とデータ取得先に対して作成した接続の IP 制限を緩和する必要があります。手順は、このトピックの設定セクションに含まれます。
現在、コンポーザーではモバイルプラットフォームはサポートされていません。

ブラウザー要件:

コンポーザーへのアクセスにシークレットモードや非公開のブラウザーを使用しないでください。
コンポーザーでは Salesforce キャンバスが使用されるため、キャンバスと同じブラウザー要件があります。つまり、Safari ブラウザーの場合、Safari セキュリティ設定で [サイト越えトラッキングを防ぐ] オプションをオフにする必要があります。
Firefox または Chrome を使用する場合、サードパーティ Cookie を許可する必要があります。
別のシステムへの接続を作成する場合、各接続のコンポーザーリファレンスセクションに記載された要件と制限を確認します。
日付値を含むコンポーザー項目では YYYY-MM-DDThh:mmZ 形式が使用されます。

使用可能なリージョン

MuleSoft Composer for Salesforce では、組織の Anypoint Platform コントロールプレーンおよびランタイムプレーンは、Salesforce インスタンスのあるポッドのデータセンターに基づいて事前に選択されます。マッピングは内部で行われ、ユーザーはマッピングを変更できません。すべての米国および APAC ポッドで米国東部 (北バージニア) が使用され、すべての EU ポッドで EU (フランクフルト) が使用されます。

コンポーザーのセットアップ

コンポーザーを使用できるようにするには、Salesforce システム管理者はコンポーザーをセットアップする必要があります。このセットアップには、インストール、権限の割り当て、Salesforce 組織設定のいくつかの調整が含まれます。

コンポーザー設定ページを見つける

「システム管理者」プロファイルを持つシステム管理者として Salesforce 組織にログインします。より多くの権限があっても、複製または調整されたプロファイルを使用しないでください。
[設定] 歯車アイコンをクリックして、[設定] を選択します。
検索バーに「composer」と入力します。
検索結果から [MuleSoft Composer] を選択します。

検索結果でコンポーザーが見つからない場合は、組織用のコンポーザーのライセンスを購入する必要がある可能性があります。

次に、コンポーザーをインストールし、Salesforce 組織にいくつかの調整を加えて、コンポーザーが適切に機能するようにします。

システム管理者: セッション設定を調整する

Salesforce コンポーザーサイドバーで [Settings (設定)] > [Security (セキュリティ)] > [Session Settings (セッション設定)] をクリックします。
[Sessions Settings (セッション設定)] ページの [Session Settings (セッション設定)] サブセクションで、[Lock sessions to the IP address from which they originated (ログイン時の IP アドレスとセッションをロックする)] チェックボックスをオフにします。
[Save (保存)] をクリックします。

システム管理者: コンポーザーをインストールして Salesforce 組織設定を調整する

[Mulesoft Composer の管理パッケージをインストール] セクションで、[管理パッケージをインストール] をクリックします。

インストールが完了すると、追加のステップが表示されます。システム管理者がインストールを実行すると、コンポーザー権限セットが自動的に付与されます。
[Change the Type of Permitted Users (許可されているユーザーの種別を変更)] セクションで [Open Settings (設定を開く)] をクリックし、コンポーザー用の Salesforce 接続アプリケーションページを起動して、2 個の設定を変更します。
1. [許可されているユーザー] ドロップダウンで、[管理者が承認したユーザーは事前承認済み] を選択します。
2. [IP 制限の緩和] ドロップダウンで、[IP 制限の緩和] を選択します。
3. 変更を保存します。
[Configure MuleSoft Services (MuleSoft サービスを設定)] セクションで、[Initiate Configuration (設定を開始)] をクリックします。

Salesforce 証明書は 1 年後に期限切れになります。期限切れの証明書を更新するには、[Initiate Configuration (設定を開始)] をクリックします。

MuleSoft で、コンポーザー専用の環境を提供するための Anypoint Platform のインスタンスが作成および設定されます。MuleSoft により、Anypoint Platform のインスタンスが作成および設定されると、組織をプロビジョニングするときに Salesforce インスタンスのポッドに基づいて自動的にリージョンが選択されます。詳細は、「使用可能なリージョン」を参照してください。
[Assign Users to MuleSoft Composer (ユーザーへの MuleSoft Composer の割り当て)] セクションで、[Assign Users (ユーザーの割り当て)] ボタンをクリックして、Salesforce の [権限セット] ページに直接移動します。
1. [Composer User (コンポーザーユーザー)] または [Composer Administrator (コンポーザー管理者)] をクリックします。
  1. 「Composer User (コンポーザーユーザー)」権限では、フローの作成と管理など、コンポーザー機能全体にアクセスできます。
  2. 「Composer Administrator (コンポーザー管理者)」権限では、[Settings (設定)] ページにアクセスして、メール設定や API 共有を管理できます。
2. [Manage Assignments (割り当ての管理)] をクリックして、[Add Assignments (割り当てを追加)] をクリックします。
3. コンポーザーの使用権限を受け取る各ユーザーの横にあるチェックボックスをオンにします。
4. [Add (追加)] をクリックします。この権限セットの割り当てまたは取り消しはいつでも行うことできます。
[Launch MuleSoft Composer (MuleSoft Composer を起動)] セクションで、[Launch (起動)] ボタンをクリックしてコンポーザーを開始します。

コンポーザーが適切に設定されました。アプリケーションランチャーで「コンポーザー」を検索し、コンポーザーを開始することができます。

1 つのライセンスを使用して 2 つの Salesforce 組織間でデータを同期できます。コンポーザーをセットアップする場合、フローを作成するプライマリ組織を選択し、その組織のコンポーザー内で 1 つ以上の他の Salesforce 組織への接続を作成できます。

ユーザー: コンポーザーへのアクセス権を確認する

コンポーザーをインストールした Salesforce システム管理者でない場合、コンポーザーアプリケーションへのアクセス権があることを確認します。

Salesforce 組織でアプリケーションランチャーを開きます。
検索バーに「composer」と入力します。
検索結果から [MuleSoft Composer] を選択します。

検索結果に [MuleSoft Composer] が表示されない場合、Salesforce 組織用のコンポーザーを購入する必要があるか、コンポーザーにアクセスする権限がない可能性があります。

コンポーザーページが表示されたら、最初のフローを作成する準備が整っています。コンポーザーを使用する前に詳細を確認する場合は、このセクションの他のトピックを参照してください。

フローの失敗通知の有効化

システム管理者はメールを介したフローの失敗通知を有効にできます。有効になっていると、15 分ごとまたはフローの実行時に実行をチェックします。フローが失敗すると、コンポーザーはフローのオーナーにメールを送信します。

注意:

同じエラーに対して最大 4 個の連続するメールが送信されます。
フローのエラーログは 24 時間ごとにリセットされます。
エラーログはフローが実行されている間のみ実行されます。

メール通知を有効にする手順は、次のとおりです。

コンポーザーの [Home (ホーム)] ページで、[Settings (設定)] をクリックします。
[Account (アカウント)] ページが表示されます。
サイドバーで [Email Notification (メール通知)] をクリックします。
[Receive email notifications when flows fail to run (フローの実行が失敗した場合にメール通知を受信)] 行で、メール通知を有効にするようにボタンを切り替えます。

Anypoint Platform へのコンポーザーの接続

MuleSoft Composer for Salesforce と Anypoint Platform の両方を使用している組織は 2 つの製品を接続できます。

Anypoint Platform に MuleSoft Composer for Salesforce をリンクする手順は、次のとおりです。

MuleSoft Composer for Salesforce のページの一番上にある [Settings (設定)] をクリックします。
[Account (アカウント)] セクションで、[Organization ID (組織 ID)] 項目の値をコピーします。
MuleSoft Composer for Salesforce に接続する Anypoint Platform 組織にログインします。
[Anypoint Platform] ページが表示されます。
ナビゲーションペインで、[Access Management (アクセス管理)] をクリックします。
[Access Management (アクセス管理)] ページが表示されます。
[Access Management (アクセス管理)] ページで、[Composer Sync (コンポーザー同期)] をクリックします。[Composer Sync (コンポーザー同期)] ボタンが使用できない場合は、[Try New Features (新機能を試す)] をクリックしてボタンを有効化してください。
[Add Composer Organization (コンポーザー組織を追加)] ウィンドウが表示されます。
[Add Composer Organization (コンポーザー組織を追加)] ウィンドウの [Organization ID (組織 ID)] 項目で、MuleSoft Composer for Salesforce の [Account (アカウント)] ページからコピーした組織 ID を貼り付けて、[Add (追加)] をクリックします。
MuleSoft Composer for Salesforce を開き、ページを更新します。
MuleSoft Composer for Salesforce のナビゲーションペインで、[Settings (設定)] > [Account (アカウント)] をクリックします。
[Account (アカウント)] ページが表示され、Anypoint Platform からのリンク要求が表示されます。
[Review and Confirm (レビューと確認)] をクリックします。
[Access Token (アクセストークン)] セクションで、[Authenticate in Anypoint (Anypoint で認証)] をクリックします。
Anypoint Platform ログインページが表示されます。
Anypoint Platform にログインします。Anypoint Platform にログインするユーザーがクライアントアプリケーションを作成するための正しい権限を持っていることを確認してください。
[Client App (クライアントアプリケーション)] セクションで、[Create Client App (クライアントアプリケーションを作成)] をクリックします。
これで、コンポーザー組織が Anypoint 組織にリンクされました。

MuleSoft Anypoint Platform ユーザーは、Mulesoft Composer for Salesforce フローでのコンシューム用に Anypoint Platform で管理されている外部で利用可能な API をビジネスユーザーと共有できるようになりました。

API を Anypoint Platform から Mulesoft Composer for Salesforce に共有する前に、次のことを確認してください。

組織で API 管理に Anypoint Platform を使用している。
Anypoint 組織で外部クライアントプロバイダーを使用していない。
現在、Anypoint 組織に「Composer」という名前のクライアントアプリケーションがない。
組織に API Manager によって管理された以下に準拠する REST API がある。
- API 仕様は、RAML または OpenAPI のいずれかを使用している。
- API は、基本認証、ベアラートークン、またはクライアント ID とクライアントシークレットを組み合わせた API キーを使用している。
- API に API Manager の [Consumer Endpoint (コンシューマーエンドポイント)] 項目の値がある。
コンポーザー組織が Anypoint 組織にリンクされている。
公開インターネットから API にアクセスできる。
API が公開ポータルにパブリッシュされている。

外部で使用可能な API を接続する方法についての詳細は、「Rest Consumer Connector リファレンス」を参照してください。

API インスタンスをコンポーザーと共有する

Anypoint API Manager で API を管理する場合、それらの API を MuleSoft Composer for Salesforce と共有できます。

API インスタンスを MuleSoft Composer for Salesforce と共有する手順は、次のとおりです。

Anypoint Platform で API インスタンスを作成します。
Anypoint Platform のナビゲーションペインで、[Exchange] をクリックします。
リストで、共有する API インスタンスを見つけて [Request access (アクセス権を要求)] をクリックし、MuleSoft Composer for Salesforce によって作成されたクライアントアプリケーションをクリックします。
[Request access (アクセス権を要求)] ウィンドウが表示されます。
[Request access (アクセス権を要求)] ウィンドウで、[Request access (アクセス権を要求)] をクリックします。
MuleSoft Composer for Salesforce を開き、フローを開いて、共有 API がキャンバスの [Shared Apps (共有アプリケーション)] セクションに表示されていることを確認します。

Anypoint Platform へのコンポーザー接続を切断する

MuleSoft Composer for Salesforce から Anypoint Platform への接続を切断できます。ただし、この接続を削除しても、既存の設定は削除されません。

Anypoint Platform への MuleSoft Composer for Salesforce 接続を切断する手順は、次のとおりです。

切断する MuleSoft Composer for Salesforce への接続を含む Anypoint Platform 組織にログインします。
[Anypoint Platform] ページが表示されます。
ナビゲーションペインで、[Access Management (アクセス管理)] をクリックします。
[Access Management (アクセス管理)] ページが表示されます。
ナビゲーションペインで、[Connected Apps (接続アプリケーション)] をクリックします。
[Connected Apps (接続アプリケーション)] ページが表示されます。
単一 API へのコンポーザーのアクセスを削除する場合は、必要に応じて、[Connected Apps (接続アプリケーション)] ページで API のオプションボタンをクリックしてから [Remove (削除)] をクリックします。
[Owned Apps (所有アプリケーション)] タブで、[Composer API Sharing (コンポーザー API 共有)] の横にあるオプションボタンをクリックして、[Delete (削除)] をクリックします。
これで、MuleSoft Composer for Salesforce が Anypoint Platform から切断されました。