Workato Connector SDKの使用
WorkatoのConnector SDKには、custom connectorの構築、テスト、Development、共有を可能にする多くの機能があります。 この記事では、プラットフォームの基本機能と、さまざまなWorkato機能を活用してコネクターのDevelopmentプロセスを簡素化する方法について説明します。
開始する前に
SDKプラットフォームのホームページへの移動
ツール > Connector SDKに移動します。 custom connectorのレジストリが表示され、自分で構築したすべてのcustom connector、または同僚からクローンしたcustom connectorを確認できるようになります。 サインインしている場合は、Connector SDKページにアクセスします。
Workatoの上部ナビゲーションバーにあります。 サブスクリプションプランによっては、画面上での表示が異なる場合があります。
新しいcustom connectorの作成
メインのSDKツールホームページで新しいコネクターの作成を開始します。 自分で構築したコネクターやコミュニティからインストールしたコネクターを含め、すべてのコネクターがワークスペースに表示されます。

新しいコネクターの作成は、New connectorボタンをクリックすることから開始します。これにより、次の2つの開始点のいずれかからコネクターを作成できるウィザードが表示されます。
サンプルコードを使用したコネクターの作成
コネクターに適切な名前を指定します。 これは通常、接続先アプリケーションの名前です。 コネクターのロゴを指定することもできます。 このロゴが、接続先アプリケーションのロゴに対応していることを確認します。 個人用レジストリでcustom connectorを検索しやすくするため、これらのフィールドに入力することをお勧めします。
次にWorkatoは、Calendly用のサンプルコネクターを提供します。 Calendlyは無料のスケジューリングソフトウェアで、コネクターの開発と使用を開始するために試用ベースで使用できます。 認証、アクション、トリガーを構築する方法について詳しく案内する、コネクターコード内のコメントに注目してください。
OpenAPI仕様をインポートしたコネクターの作成
このオプションを使用すると、既存のOpenAPI仕様からすぐに使用できるコネクターを生成できます。 詳細
コネクターのタイトル、説明、ロゴの変更
custom connectorの横にある鉛筆(編集)アイコンをクリックして名前を変更することで、custom connectorのタイトルを変更できます。 その後、緑のチェックアイコン(確認)をクリックして変更を保存できます。
保存するには、緑のチェックを選択するか、フィールドからフォーカスを外します
custom connectorのロゴを変更するには、ロゴ画像をクリックします。 これにより、ブラウザーでシステムアップロードウィンドウが開き、アップロードする新しいロゴを選択できます。 このロゴはレジストリ内でcustom connectorを表し、このcustom connectorをレシピで使用するときに表示されます。
ローカルマシンからアイコンをアップロードするには、アイコンロゴを選択します
custom connectorのホームページでSettingsタブに移動して、コネクターの説明を変更します。 このタブには、コネクターの説明用のテキスト入力フィールドを含む情報があります。 説明により、他のユーザーはコミュニティライブラリでコネクターを見たときに、そのコネクターについて詳しく知ることができます。
説明を変更するにはSettingsタブを使用します
Workato Codeエディターの使用
Workato SDKプラットフォームでは、コネクターコードの編集にCode Mirrorを使用します。 コネクターコードを記述するとき、すべての構文エラーまたはコードエラーをリアルタイムで確認できます。 Workatoには、コードエディターでの使用を許可している許可されたrubyメソッドのセットがあります。 つまり、許可リストに含まれていないrubyメソッドがコネクター内のコードによって呼び出されると、強調表示されたエラーになります。
コードエディターには、操作を簡単にする基本的なホットキーのセットが用意されています。
- 永続検索
- PC: Ctrl-F
- MacOS: Cmd-F
- 置換
- PC: Shift-Ctrl-F
- MacOS: Cmd-Option-F
- すべて置換
- PC: Shift-Ctrl-R
- MacOS: Shift-Cmd-Option-F
custom connectorの削除
custom connectorを削除するには、削除をクリックします。
custom connectorを削除
有効なレシピで使用されているcustom connectorは削除できません。 コネクターが使用中の場合、削除をクリックすると、Workatoは関連付けられた有効なレシピを表示します。 コネクターを削除する前に、一覧表示されたレシピを停止する必要があります。
custom connectorを削除するには、これらのレシピを停止または編集します
Workatoは、削除の影響を受ける停止済みのレシピを表示します。 custom connectorを削除しても、そのクローンは削除されません。 クローンは独立したコピーです。
custom connectorを削除すると、復元できません
Last updated: