Workato Connector SDKの使用
WorkatoのConnector SDKには、カスタムコネクターを構築、テスト、開発、共有できる多数の機能があります。 この記事では、プラットフォームの基本機能を取り上げ、コネクターのDevelopmentプロセスをより円滑に進めるために、さまざまな機能を活用する方法について説明します。
開始する前に
Connector SDKの表示
Workatoアカウントにサインインし、カスタムコネクターを構築する予定のワークスペースに移動します。
構築した、または他のユーザーからクローンしたカスタムコネクターのレジストリを表示するには、ツール > Connector SDKをクリックします。 サインインしている場合は、カスタムアダプターページにアクセスして、これを直接開くことができます。
新しいカスタムコネクターの作成
Connector SDKのメイン画面から、新しいカスタムコネクターを作成できます。
ページの右上隅に、新しいカスタムコネクターを作成するボタンが表示されます。 これをクリックすると、新しいカスタムコネクターのホームページに移動します。 このページでは、カスタムコネクターコードの記述を開始し、共有リンクやバージョン履歴などの有用な情報を確認できます。
ツール > Connector SDKをクリックします。
新規コネクターをクリックします。
開始点としてWorkatoテンプレートによるガイドまたはOpenAPI仕様をインポートを選択し、次へをクリックします。 OpenAPIはベータ版であり、OpenAPI 3.0仕様で提供する必要があることに注意してください。 詳しくはOpenAPI仕様を参照してください。
ローカルマシンからアイコンをアップロードするにはアイコンロゴを選択します
コネクターの説明とロゴを指定し、エディターに移動をクリックします。
説明とロゴを指定します
ソースコードを追加し、コネクションを設定して、リリースおよび共有する前にコネクターをテストします。
コネクターのタイトル、説明、ロゴの変更
カスタムコネクターを作成すると、デフォルトのタイトル、ロゴ、空の説明が自動的に割り当てられます。 個人レジストリ内でカスタムコネクターを検索しやすくするために、これらのフィールドに入力する必要があります。
カスタムコネクターのタイトルを変更するには、次の手順を実行します。
カスタムコネクターの横にある鉛筆アイコンをクリックします。
表示されるボックスでコネクター名を編集します。
変更を保存するには、緑色のチェックマークをクリックします。
保存するには、緑色のチェックマークを選択するか、フィールドからフォーカスを外します
カスタムコネクターのロゴを変更するには、次の手順を実行します。
既存のロゴ画像をクリックして、システムアップロードウィンドウを開きます。
ローカルマシンからアイコンをアップロードするには、アイコンロゴを選択します
アップロードするロゴを選択します。 このロゴは、レジストリ内でカスタムコネクターを表し、レシピで使用するときに表示されます。
カスタムコネクターの説明を変更するには、次の手順を実行します。
カスタムコネクターのホームページで設定タブに移動します。
説明を変更するには、設定タブに移動します
カスタムコネクターの説明を更新し、保存をクリックします。 この説明により、他のユーザーはカスタムコネクターをクローンする前にその内容を確認できます。
Workatoコードエディターの使用
Workato SDKプラットフォームでは、コネクターコードの編集にCodeMirrorを使用しており、構文エラーやコードエラーをリアルタイムで確認できます。 Workatoは、コードエディターで使用できる許可リスト登録済みRubyメソッドのセットを提供しています。 この許可リストに含まれていないRubyメソッドはエラーとして強調表示されます。
コードエディターには、操作を簡単にする基本的なホットキーのセットがあります。
| 機能 | ホットキー |
|---|---|
| 永続検索 | Ctrl-F / Cmd-F |
| 置換 | Shift-Ctrl-F / Cmd-Option-F |
| すべて置換 | Shift-Ctrl-R / Shift-Cmd-Option-F |
| 現在の行/選択範囲を自動インデント | Shift-Tab |
| 保存 | Ctrl-S / Cmd-S |
カスタムコネクターの削除
実行中のレシピで有効になっているカスタムコネクターは削除できません。 削除する予定のカスタムコネクターが実行中のレシピで有効になっている場合、ポップアップ通知が表示されます。
削除されたカスタムコネクターは復元できません
削除は永続的です。 削除されたカスタムコネクターは復元できません。 削除されたコネクターからクローンされたカスタムコネクターは削除されません。
カスタムコネクターを削除するには、次の手順を実行します。
削除する予定のカスタムコネクターをクリックします。
削除（ゴミ箱）アイコンをクリックします。 削除する予定のカスタムコネクターが実行中のレシピで有効になっている場合、ポップアップ通知が表示されます。
カスタムコネクターを削除するには、これらのレシピを停止または編集します
プロンプトが表示されたら、削除を選択してコネクションを完全に削除します。 このアクションは元に戻せません。
最終更新日: