Workato Connector SDKの使用

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

WorkatoのConnector SDKには、custom connectorの構築、テスト、Development、共有を可能にする多くの機能があります。 この記事では、プラットフォームの基本機能と、さまざまなWorkato機能を活用してコネクターのDevelopmentプロセスを簡素化する方法について説明します。

開始する前に

ツール > Connector SDKに移動します。 custom connectorのレジストリが表示され、自分で構築したすべてのcustom connector、または同僚からクローンしたcustom connectorを確認できるようになります。 サインインしている場合は、Connector SDKページにアクセスします。

SDKへの移動Workatoの上部ナビゲーションバーにあります。 サブスクリプションプランによっては、画面上での表示が異なる場合があります。

新しいcustom connectorの作成

メインのSDKツールホームページで新しいコネクターの作成を開始します。 自分で構築したコネクターやコミュニティからインストールしたコネクターを含め、すべてのコネクターがワークスペースに表示されます。

SDKホームページ

新しいコネクターの作成は、New connectorボタンをクリックすることから開始します。これにより、次の2つの開始点のいずれかからコネクターを作成できるウィザードが表示されます。

  1. サンプルコネクターコードの使用
  2. OpenAPI仕様のインポート

サンプルコードを使用したコネクターの作成

コネクターに適切な名前を指定します。 これは通常、接続先アプリケーションの名前です。 コネクターのロゴを指定することもできます。 このロゴが、接続先アプリケーションのロゴに対応していることを確認します。 個人用レジストリでcustom connectorを検索しやすくするため、これらのフィールドに入力することをお勧めします。

次にWorkatoは、Calendly用のサンプルコネクターを提供します。 Calendlyは無料のスケジューリングソフトウェアで、コネクターの開発と使用を開始するために試用ベースで使用できます。 認証、アクション、トリガーを構築する方法について詳しく案内する、コネクターコード内のコメントに注目してください。

OpenAPI仕様をインポートしたコネクターの作成

このオプションを使用すると、既存のOpenAPI仕様からすぐに使用できるコネクターを生成できます。 詳細

custom connectorの横にある鉛筆(編集)アイコンをクリックして名前を変更することで、custom connectorのタイトルを変更できます。 その後、緑のチェックアイコン(確認)をクリックして変更を保存できます。

タイトル入力フィールドの変更保存するには、緑のチェックを選択するか、フィールドからフォーカスを外します

custom connectorのロゴを変更するには、ロゴ画像をクリックします。 これにより、ブラウザーでシステムアップロードウィンドウが開き、アップロードする新しいロゴを選択できます。 このロゴはレジストリ内でcustom connectorを表し、このcustom connectorをレシピで使用するときに表示されます。

ロゴの変更ローカルマシンからアイコンをアップロードするには、アイコンロゴを選択します

custom connectorのホームページでSettingsタブに移動して、コネクターの説明を変更します。 このタブには、コネクターの説明用のテキスト入力フィールドを含む情報があります。 説明により、他のユーザーはコミュニティライブラリでコネクターを見たときに、そのコネクターについて詳しく知ることができます。

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を削除

有効なレシピで使用されているcustom connectorは削除できません。 コネクターが使用中の場合、削除をクリックすると、Workatoは関連付けられた有効なレシピを表示します。 コネクターを削除する前に、一覧表示されたレシピを停止する必要があります。

削除防止ポップアップcustom connectorを削除するには、これらのレシピを停止または編集します

Workatoは、削除の影響を受ける停止済みのレシピを表示します。 custom connectorを削除しても、そのクローンは削除されません。 クローンは独立したコピーです。

削除ポップアップ警告custom connectorを削除すると、復元できません

Last updated: