Anypoint DataGraph クイックスタートガイド

Anypoint Platform にログインします。

Exchange で、​[Provided by MuleSoft (MuleSoft による提供)]​ をクリックします。

「product api raml definition」​(Product API RAML 定義) を検索して、結果リストから選択します。

[Product API] | [RAML Definition (RAML 定義)]​ で、アセットバージョン 2.0.2 の ​[Download (ダウンロード)]​ > ​[RAML]​ をクリックします。

各自のビジネスグループ ID とアセット名を使用して、​RAML 仕様を Exchange にパブリッシュします​。

Order Systems API についても、アセットバージョン 2.0.3 の ​[Order Systems API] | [RAML Definition (RAML 定義)]​ で同じ手順を繰り返します。

[Anypoint Platform] > [Anypoint DataGraph] で ​[Unified Data Graph (統合データグラフ)]​ ドロップダウンリストから適切な環境を選択し、​[+Add API (+API を追加)]​ をクリックします。

[Add API (API の追加)]​ ページで、[Catalyst Product API] を選択します。

[Next: Configure URL (次へ: URL を設定)]​ をクリックします。

[Configure URL (URL の設定)]​ ページで、API バージョンとアセットバージョンを選択し、​[Confirm Selection (選択内容を確認)]​ をクリックします。

[Add a new URL (新しい URL を追加)]​ を選択します。

[Add URL (URI を追加)]​ 項目で、次の API URL を追加します。 ​https://anypoint.mulesoft.com/mocking/api/v1/sources/exchange/assets/68ef9520-24e9-4cf2-b2f5-620025690913/catalyst-retail-product-api/2.0.2/m/

[Save (保存)]​ をクリックします。

[Next: Configure Security (次へ: セキュリティを設定)]​ をクリックします。

API の GET エンドポイントの認証を指定します (このクイックスタートの例では ​[No Auth (認証なし)]​)。

バージョンと認証の詳細を設定したら、​[Next: Preview Schema (次へ: スキーマのプレビュー)]​ をクリックします。

スキーマのプレビューが完了したら、​[Next: Edit Schema (次へ: スキーマを編集)]​ をクリックします。

Catalyst Product API スキーマのナビゲーションで、​[ProductResponse]​ オブジェクト種別をクリックします。

[Collaboration permissions (コラボレーション権限)]​ ペインで、​[Enable collaboration (コラボレーションを有効化)]​ をクリックします。

デフォルトのクエリメソッドを設定するには、​productsByProductId (productId:String!): ProductResponse​ を選択します。

[Next (次へ)]​ をクリックします。

主キーとして、ドロップダウンリストから ​identifier (String!)​ を選択します。

[Confirm (確認)]​ をクリックします。

[Edit type name and field settings (種別名と項目設定を編集)]​ ペインで、すべての項目が表示されるようにします。

[Next: Add to unified schema (次へ: 統合スキーマに追加)]​ をクリックします。

[Proceed to unified schema (統合スキーマに進む)]​ をクリックします。

[EnumType0]​ をクリックします。

[Desired state (望ましい状態)]​ を ​[Visible (表示)]​ に切り替えます。

[Type settings (種別設定)]​ ペインで、​[Rename Type (種別の名前変更)]​ をクリックします。

種別の名前を ​OrderStatus​ に変更して、​[Confirm (確認)]​ をクリックします。

Catalyst Order API スキーマのナビゲーションで、​[OrderItemSummary]​ オブジェクト種別を選択します。

OrderItemSummary オブジェクト種別とその項目が非表示になっている場合、​[Hidden/Visible (非表示/表示)]​ 切り替えを使用して、​[Desired state (望ましい状態)]​ 値を ​[Visible (表示)]​ に切り替えます。

[Link to another type (別の種別にリンク)]​ ペインまでスクロールして、​[Select the type you want to link to (Target) (リンク先 (対象) の種別を選択)]​ で、​[ProductResponse]​ を選択します。

外部キー項目で、​productId (String!)​ を設定します。

外部キー項目の名前を ​productresponse​ から ​product​ に変更します。

新しいリンク設定を確認して、​[Save changes (変更を保存)]​ をクリックします。

Catalyst Order API スキーマのナビゲーションで、​[OrderSummary]​ 種別を選択します。

[Merge with another type (別の種別とマージ)]​ ペインで、マージ先の種別 (この場合は ​OrderResponseLocal​) を選択します。

差分ビューを使用してマージに 2 つの種別を横並びで比較し、必要に応じて、切り替えを使ってすべての項目を非表示にします。

[Preview merge result (マージ結果のプレビュー)]​ をクリックします。

[Confirm merge (マージを確認)]​ をクリックします。

[Apply Changes (変更を適用)]​ をクリックします。

[Run Operation (操作を実行)]​ をクリックします。

アクセス方法を選択します。この例では、​[Create a new application and use it immediately (新しいアプリケーションを作成してすぐに使用する)]​ を選択します。

[Next (次へ)]​ をクリックします。

[Create a new application (新しいアプリケーションの作成)]​ ウィンドウで、項目に値を入力し、​[Next (次へ)]​ をクリックします。

[Create & Request Access (アクセス権の作成と要求)]​ をクリックします。

変異を作成する前に、統合スキーマがどのようなものか把握しておきます。​[Explore Schema (スキーマを調査)]​ をクリックします。

次の変異の例を追加します。

mutation {
  createOrdersCustomerByCustomerId(
    customerId: "1964401a-a8b3-40c1-b86e-d8b9f75b5842",
    input: {
      customerId: "1964401a-a8b3-40c1-b86e-d8b9f75b5842",
      subtotal: "100.21",
	  taxPrice: "15.22",
	  shippingPrice: "10.00",
	  total: "125.43",
      orderItems: {
        shipmentItems: [{
          orderItemId: "fc3d4900-c5ac-4649-8bc8-cbbef4fe8fde"
          productId: "e1c515f9-102d-4830-b353-18fe48065732"
          productName: "Uniforms Modern Fit Short Sleeve Polo Shirt"
          location: {
            locationId: "1c9a20dc-c585-42fd-ac1a-1216085b76d2"
            deliveryMethod: SHIPMENT
            locationType: PARTNER
          }
          price: "50"
          quantity: 1
        }]
        pickupItems: [{
          orderItemId: "88668866-2c6d-4fa6-9e17-4b2c42e0f051",
          productId: "eb8c8ca7-3c42-4489-a820-3aa138430b75",
          productName: "Smart Slim Micro Stripe Shirt",
          location: {
            locationId: "1c9a20dc-c585-42fd-ac1a-1216085b76d2",
            deliveryMethod: PICKUP,
            locationType: STORE
          },
          price: "50",
          quantity: 1
        }],
      },
      shippingAddress: {
        address: "Street 123",
        city: "San Francisco",
        postalCode: "94210",
        state: "CA",
        country: "US"
      },
    }) {
    identifier
    message
  }
}

[Run (実行)]​ をクリックします。

準備ができたら、次のサンプルクエリを追加します。

{
  ordersByOrderId(orderId: "51c0ba3a-7e64-11e7-bb31-be2e44b06b34") {
    shippingAddress {
      state
      city
      postalCode
    }
    total
    status
    orderItems {
      shipmentItems {
         product {
           model
           description
           brand
           price {
             amount {
               name
               currencyValue
             }
           }
         }
       }
     }
   }
 }

クエリをトレースせずに実行する場合は、​[Run (実行)]​ をクリックします。

クエリを実行してトレースする場合は、アクションメニュー (​…​​) から ​[Trace Query (クエリをトレース)]​ を選択して、​[Run (実行)]​ をクリックします。

クエリに関連するログを表示するには、アクションメニュー (​…​​) から ​[View Response Logs (応答ログを表示)]​ をクリックします。

[View History (履歴を表示)]​ をクリックすると、後からこの同じクエリ (または別のクエリ) にアクセスできます。

クエリと、自動的に生成されたエンドポイントをコピーするには、アクションメニュー (​…​​) から ​[Copy & Share Endpoint (エンドポイントのコピーと共有)]​ をクリックします。