よくある質問 (FAQ)

1. 不安定なバージョンのコネクターを誤ってリリースしてしまいました。最後のバージョンのコネクターを再度リリースするにはどうすればよいですか？

以前の安定したバージョンのコネクターを復元することは簡単です。バージョン履歴を調べ、[Released at] 列を参考にして目的のコネクターのバージョンを見つけてください。すべてのレシピを実行できる安定したバージョンを復元するために、そのバージョンを最新バージョンとして復元してリリースします。

2. バージョンのリリース前またはデバッガーコンソールの使用前に自動保存が行われるのはなぜですか？

自動保存は、コネクターコードの変更が保存されていない場合に限り実行されます。これは、未保存の変更を確実に保存して反映するために実行されるものです。バージョンをリリースする前に、必ずデバッガーコンソールを使用して十分にテストすることをお勧めします。

3. コネクターをサンドボックス環境から本番環境に移動するには、コネクターの共有リンクとパッケージのどちらを使用すればよいですか？

レシピライフサイクル管理によるパッケージは、特定のプランでのみ利用できます。どちらの機能でも SDK コネクターを移行できますが、カスタムコネクターとそれに関連するレシピは、Workato のサンドボックス環境で作成およびテストすることを強くお勧めします。準備ができたカスタムコネクター (およびレシピ) をサンドボックス環境から本番環境へ移行するには、パッケージが最も速い方法になります。

4. 今回の機能強化以前に存在していたすべての既存のコネクターはどうなりますか？

すべての既存のコネクターは、この機能強化と下位互換性があります。既存のコネクターには、リリース以前のバージョンのリストも含まれます。カスタムコネクター作成以降のバージョンを確認できます。新しいバージョンを作成するには、レシピの変更を利用できるように、新しいバージョンをリリースする必要があります。

5. 複製したカスタムコネクターに更新通知がある場合、更新するとどうなりますか？

更新通知は、親コネクターの最新の共有バージョンと常にリンクしています。更新を選択すると常に、現在のカスタムコネクターをもとに新しいバージョンが作成されます。新しく更新されたコネクターを自分のワークスペースにリリースする前に、そのコネクターの変更内容が適切であることを必ず確認してください。新しいコネクターコードは目的に合わせていつでも変更できます。

6. チームのワークスペースでの作業中に、各バージョンで行われた変更と、そのバージョンを作成したユーザーをどのように確認できますか？

バージョン履歴表を見れば、各バージョンのアクションとトリガーの詳細情報がわかります。バージョン履歴表には、バージョンを作成したユーザーと特定のバージョンをリリースしたユーザーが記載されています。今後、バージョン間でのコードへの特定の変更をより詳細に示す機能や、さまざまなバージョンにメモを添付できる機能などが追加される予定です。ご注目ください。

7. レシピの特定バージョンのカスタムコネクターを、すべてのアクティブなレシピにリリースする前にテストするにはどうすればよいですか？

現在、カスタムコネクターのさまざまなバージョンで自動化された多様なテストを実行できるように、SDK プラットフォームでのコーディング操作のさらなる改善に取り組んでいます。

その間の有効な回避策として、最新の安定したバージョンと同じコードをホストする、ダミーのカスタムコネクターを作成してください。このダミーのカスタムコネクターに強化機能を組み込んで、専用のレシピで個別にテストできます。この新しいバージョンを、カスタムコネクターを使用する既存のレシピと新しいレシピの両方のコピーでテストし、以前はなかった不具合が発生していないかどうか確認することをお勧めします。

8. バージョンノートの使用方法に決まりはありますか？

バージョンノートを利用すると、ワークスペース内の他のユーザーやコネクターを共有しているユーザーに簡単に情報を伝えることができます。そのため、ユーザーが自由に使用できるように、バージョンノートは自由形式にしています。自分に最も適したベストプラクティスが何か考えてください。今後、コネクターの変更ログの作成に役立つ追加機能を導入する予定です。新しいアクションやトリガーを作成するなど、新しい節目に到達するたびに、コネクターの説明を更新することをお勧めします。