Workatoの高度なコネクター構築ガイド

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

ここでは、コネクターの使いやすさとコード品質に焦点を当てた最終ガイドを紹介します。 堅牢なコネクターの計画に役立つ演習と、コネクターコードを書くためのガイドラインについて説明します。 この時点で、Connector SDKドキュメントにあるコネクター構築の基本をすでに読んでいることを前提としています。

このガイドでは、オブジェクトベースのコネクターの概念を紹介します。これは、NetSuite、Salesforce、またはWorkato上の数多くの他のコネクターを使用したことがあれば、以前に目にしたことがあるはずです。 オブジェクトベースのコネクターは、ユーザーが作成または更新したいオブジェクトを選択する前に、“作成”や“更新”などの動詞を最初に選択できるようにすることで、煩雑さを軽減するものです。

このガイドから何を得られますか?

このガイドは、幅広い利用者にとって使いやすいコネクターの構築について考えを整理するのに役立ちます。 カスタムコネクターは、チームがWorkato上でサポートされていないWeb APIにすばやく接続する方法として使用できますが、このガイドではコネクター構築の持続可能なアプローチを取り上げます。 Workatoでは、コミュニティのユーザーが自分のカスタムコネクターを、プラットフォーム上の誰でも見つけて使用できるプラットフォーム全体のコネクターへ昇格させることもできます。

独自のWeb API向けにWorkato上でコネクターを構築するためにこのガイドを読んでいる場合、リソース指向のAPI設計を説明しているGoogle API design guideが優れたリソースになります。 適切に構築されたAPIは、Workato上でレシピを作成する際に、コネクター構築の体験だけでなく、アプリケーションのユーザーにとっての連携体験も大幅に容易にします。

オブジェクトベースのコネクター

そもそもオブジェクトベースのコネクターとは何か疑問に思うかもしれませんが、その前に、アプリケーションにおけるリソースとプロシージャが何かを明確にする必要があります。

クラウドベースのアプリケーションを見ると、多くの場合、ほとんどのアプリケーションの中核には複数のリソースがあります。 これらのリソースは、アプリケーションのユーザーが操作し、価値を得られる構造でデータを保持します。 たとえば、銀行アプリケーションのリソースは、銀行の顧客に関するすべての関連情報を含むCustomerである場合があります。

一方で、アプリケーションは、ユーザーのために特定の整理されたリソース内にデータを保持すること以外にも、さまざまなサービスを提供します。 アプリケーションがシステム内のリソースに対して実行するこれらのプロセスも、ユーザーに大きなビジネス価値を生み出します。 たとえば、同じ銀行アプリケーションのプロセスはBank Transferである場合があります。 このプロセスには、各口座の残高確認や操作の原子性の確保など、特定の検証も含まれる場合があります。

Workatoでコネクターを構築する際、オブジェクトベースのコネクターは両方を包含できることが分かっていますが、多くの場合、特定のプロセスに進む前にリソースを扱うことがコネクターの基盤になると見られます。

次の章では、コネクターの計画をより適切に行うのに役立つ思考演習について説明します。

完成したコネクターの共有

他のユーザーと共有するために、コネクターをコミュニティライブラリにアップロードできます。 コネクターを共有すると、APIの採用拡大、サービスへのリード増加、連携ユースケースへの露出拡大につながります。

Last updated: