Blogical

AWS/Salesforceを中心に様々な情報を配信していきます(/・ω・)/

Salesforce Customer 360 - Mulesoft(2) - API ビルド

日頃よりお世話になっております。

ロジカル・アーツ株式会社のSE 輪島 幸治です。

Salesforceのパートナー企業向けウェビナーのMulesoftのコンテンツが共有されていたので、 検証させて頂いたのでMulesoftで検証した結果について簡単にまとめさせて頂こうと思います。

この記事では、API ビルドについてをご紹介させて頂きます。

Mulesoftについて

Mulesoftは、SalesforceSalesforce Customer 360プロダクトの一つにある クラウドインテグレーション(iPaaS:Integration platform as a service)プラットフォームです。

・MuleSoft Anypoint Platform www.salesforce.com

Customer 360

trailhead.salesforce.com

trailhead.salesforce.com

Wikipedia - クラウドインテグレーション

クラウドインテグレーションは、データ、プロセス、 サービス指向アーキテクチャSOA)、およびアプリケーション統合に対処するクラウドコンピューティングサービスとして提供されるシステム統合ビジネスの一形態である。

前回の記事

設定手順

Anypoint Platform APIビルド

この記事では、公開Exchangeから既存のAPI仕様を調査する方法を説明してから、 Anypoint Platformを使用したAPIビルドをご紹介させて頂きます。

1.まず、ユーザ名、パスワードを使用して、Anypoint Platformにログインします。

・Anypoint Platform

anypoint.mulesoft.com

f:id:logicalarts:20211215212124p:plain
図1

2.Anypoint Platformにログイン後、Exchangeのセクションにある[Discover & share]から、 公開Exchangeから既存のAPI仕様を調査することができます。[Discover & share]を押下します。

f:id:logicalarts:20211215234653p:plain
図2

3.Exchangeの画面が表示されましたら、[All types]>[REST APIs]をクリックします。

f:id:logicalarts:20211215234702p:plain
図3

4.画面右上のメニューをクリックして、メニューを表示させ、[Design Center]をクリックします。

f:id:logicalarts:20211215234707p:plain
図4

f:id:logicalarts:20211215234711p:plain
図5

5.Design Center画面を表示して、[Create new]>[New API Spec]を押下します。

f:id:logicalarts:20211215234721p:plain
図6

6.New API Specのウィンドウが表示されましたら、API TitleとAPI Specを設定して、[Create API Spec]を押下します。 Nameには、hello-world​と入力して、"I'm comfortable designing it on my own"の選択リストでは、RAML 1.0を選択します。

f:id:logicalarts:20211215234725p:plain
図7

7.API Designer エディタの画面が表示され、エディタにサンプルのRAML定義が表示されていることを確認します。

f:id:logicalarts:20211215234730p:plain
図8

8.次のRAMLをコピーして、API Designer エディタにペーストします。

#%RAML 1.0
title: hello, world
version: v1
description: A greeting for the world

types:
 greeting:
   properties:
     todays-greeting: string

/greeting:
     get:
       responses:
         200:
           body:
             application/json:
               type: greeting
               example:
                 {todays-greeting: "test-greeting"}
         404:
           body:
             application/json:
               properties:
                 message: string
               example: |
                 {
                   "message" : "Greeting not found"
                 }

ステップ 2.API 仕様の設計:https://docs.mulesoft.com/jp/general/api-led-design

f:id:logicalarts:20211215234737p:plain
図9

9.API Designer エディタにペーストしたら、API endpointsセクションにて、[GET]をクリックします。

f:id:logicalarts:20211215234742p:plain
図10

10.Responseのセクションにexamplesが表示され、ステータスコードが200の場合と404の場合のレスポンスが画面に表示されます。レスポンス確認後、右上の[Try it]を押下します。

f:id:logicalarts:20211216080439p:plain
図11

11.[Send]を押下します。

f:id:logicalarts:20211215234753p:plain
図12

12.APIへのリクエストが行われ、Response値が返却されます。右下の点記号のボタンをクリックします。

f:id:logicalarts:20211215234757p:plain
図13

13.メニューが表示されますので、"Response details"をクリックします。

f:id:logicalarts:20211215234802p:plain
図14

14.Response detailsが表示されていることを確認します。

f:id:logicalarts:20211215234808p:plain
図15

15.画面右上の[Publish]をクリックして、[Publish to Exchange]を押下します。

f:id:logicalarts:20211215234813p:plain
図16

16.Exchangeに共有するAPI仕様が表示されますので、必要事項を入力して、[Publish to Exchange]を押下します。

f:id:logicalarts:20211215234819p:plain
図17

17.[Done]を押下します。

f:id:logicalarts:20211215234823p:plain
図18

18.作成したAPIがExchangeに共有されていることを確認するために、Design CenterからExchangeに移動します。画面右上のメニューをクリックします。

f:id:logicalarts:20211216084055p:plain
図19

19.Exchangeをクリックします。

f:id:logicalarts:20211216084108p:plain
図20

20.Exchangeを表示すると、作成したAPIがExchangeに共有されていることを確認します。APIをクリックします。

f:id:logicalarts:20211215234832p:plain
図21

21.[Share]をクリックします。

f:id:logicalarts:20211215234837p:plain
図22

22.CollaboratorsとPublicに共有できることを確認します。デフォルトはCollaboratorsになっているので、Publicをクリックすることで、共有時のオプションを確認できます。

f:id:logicalarts:20211215234842p:plain
図23

f:id:logicalarts:20211215234848p:plain
図24

MulesoftのAPI ビルドについては、以上です。

Mulesoftで検証させて頂いた範囲は、API ビルドまでで、Anypoint StudioやAdvanced REST クライアントについては、未検証なので、改めて評価したいと思います。

よろしくお願いいたします。

弊社について

・ロジカル・アーツ株式会社 - AppExchange

appexchangejp.salesforce.com

弊社の特長

Salesforce導入コンサルティングサービス (SalesCloud/ServiceCloud/CommunityCloud/AppCloud/Pardot/Einstein Analytics/EinsteinChatBot)

Salesforceへの機能移行、データ移行サービス、サポートサービス  新規はもちろん、既存システムを活用・併用しながらのSalesforce運用も支援いたします。

・カスタムアプリケーション開発  弊社のサービスのひとつである、派遣業務にて、Salesforceを活用しております。