OpenAPIベースコネクターのソースコードのアップグレード

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

時間の経過とともに、OpenAPIソースコードの新しいバージョンがリリースされます。 これらの更新には、新機能、機能強化、および/またはバグ修正が含まれる場合があります。

OpenAPIの新しいバージョンが利用可能になると、コネクターのソースコードページに次のバナーが表示されます。

Workato UIの更新されたOpenAPIコネクターバージョンバナー

更新を活用するには、新しいバージョンを適用し、ワークスペースでコネクターを再リリースする必要があります。 アップグレードの実行方法は、コネクターをカスタマイズしているかどうかによって異なります。


前提条件

OpenAPIコネクターのソースコードをアップグレードするには、次が必要です。


カスタマイズしていないコネクターのアップグレード

1

まだサインインしていない場合は、Workatoアカウントにサインインします。

2

ツール > Connector SDKに移動します。

3

アップグレードするOpenAPIコネクターのタイルをクリックします。

4

更新がありますバナーで、コネクターを更新ボタンをクリックします。

Workato UIの更新されたOpenAPIコネクターバージョンバナー

5

変更を確認した後、ページの右上隅にある最新バージョンをリリースボタンをクリックします。 これにより、ワークスペースでコネクターの新しいバージョンがリリースされ、レシピで使用できるようになります。

6

表示されるウィンドウで、変更内容を要約します。

変更の概要と確認ウィンドウ

7

完了したら、リリースをクリックします。

成功すると、バージョン[X]が正常にリリースされましたバナーが表示されます。


カスタマイズしたコネクターのアップグレード

コネクターのソースコードをカスタマイズしている場合、アップグレードプロセスには追加の手順があります。

このチュートリアルでは、GitHubに組み込まれているもののようなファイル比較ツールを使用して、コードバージョン間の差分を特定します。 WorkatoのRecipe Diff機能を使用したことがある場合、概念は同じですが、レシピを対象とします。

たとえば、次の画像はGitHub内のファイルのテキスト比較です。

GitHubの差分の例

ステップ1:両方のバージョンのコードを取得

このステップでは、カスタマイズしたコネクターコードと、新しいバージョンのソースコードを取得します。

1

まだサインインしていない場合は、Workatoアカウントにサインインします。

2

ツール > Connector SDKに移動します。

3

アップグレードするOpenAPIコネクターのタイルをクリックします。

4

カスタマイズしたソースコードを選択して、テキストファイルなどの便利な場所にコピーします。 次のステップでこれが必要になります。

5

更新がありますバナーで、コネクターを更新ボタンをクリックします。 これにより、カスタマイズしたソースコードが新しいバージョンで上書きされます。

Workato UIの更新されたOpenAPIコネクターバージョンバナー

このページは今は開いたままにしておきます。次のステップで必要になります。

ステップ2:バージョンを比較して競合を解決

このステップでは、ファイル比較ツールでコードバージョンを比較し、変更を適用して競合を解決します。

このセクションの手順と例ではDiffcheckerを使用しますが、使い慣れたファイル比較ツールを使用できます。

1

ファイル比較ツールで、カスタマイズしたコードをコピーして元のテキストフィールドに貼り付けます。

2

新しいバージョンのソースコードをコピーして変更後のテキストフィールドに貼り付けます。

セットアップは次のようになります。

Diffcheckerアプリでのコードセットアップ

3

差分を検索をクリックします。

4

コードバージョン間の差分が強調表示されます。 セクションごとにバージョンを比較し、カスタマイズしたコードから保持する内容新しいバージョンのコードから使用する内容を決定します。

次の例では、カスタマイズしたコネクターのタイトル新しいバージョンのコードにマージして保持しました。

カスタマイズしたコードから新しいバージョンのコードへの変更の適用

5

バージョン間の変更全体を確認するまで、前のステップを繰り返します。

ステップ3:新しいバージョンをテスト

このステップでは、SDKのコードをテストタブを使用して、コネクターの新しいバージョンをテストします。

コードをテストタブを使用するには、少なくとも1つの有効なコネクションが必要です。

1

ファイル比較ツールで、カスタマイズしたコードの新しいバージョンをコピーします。

2

Workatoアカウントでコネクターを開いているブラウザーウィンドウに戻ります。

3

カスタマイズしたコードをソースコードフィールドに貼り付けます。

4

デバッグセクションで、コネクションおよびアクションオプションを使用して新しいバージョンをテストします。

コードをテストタブは、現在コードエディターにあるコードの最新バージョンで実行されます。 テストを実行する前に、保存されていない変更が保存され、コネクターの新しい最新バージョンが作成されます。 これが発生すると通知が表示されます。

テストと問題の解決が完了したら、新しいバージョンのリリースに進みます。

ステップ4:新しいバージョンをリリース

このステップでは、ワークスペースでコネクターの新しいバージョンをリリースします。 新しいバージョンをリリースすると、レシピで使用できるようになります。

1

新しいバージョンのテストが完了したら、ページの右上隅にある最新バージョンをリリースボタンをクリックします。

2

表示されるウィンドウで、変更内容を要約します。

変更の概要と確認ウィンドウ

3

完了したら、リリースをクリックします。

成功すると、バージョン[X]が正常にリリースされましたバナーが表示されます。

Last updated: