ヒント: フィルターと検索を使うことで、次のデフォルトフィルターオプション(Categories、プラン、Price、Rating)を利用して、要件に応じたアプリを簡単に探すことができます。
セキュリティに関するヒント: このアプリは評価目的で共有されています。アプリケーションの機能を試す際は、テストデータのみを使用してください。トライアルが終了すると、開発者はいつでもあなたのアカウントからアプリとそのデータを完全に削除できます。
メモ: インストール済みアプリケーションでは、開発環境はサポートされません。まず更新内容をステージ環境に移動して十分にテストし、その後本番環境に反映する必要があります。[ソリューション]ページから(インストール済みアプリと作成したアプリの共通方法)
[環境]ページから(インストール済みアプリと作成したアプリの共通方法)
[オペレーション]から(インストール済みアプリのみ)
オペレーションからアプリを環境に追加する -
Creator アカウントで、[オペレーション] > [マーケットプレイス] > [インストール済みアプリ]に移動します。
環境に追加したいアプリケーションを選択します。
ページ上部のAdd to Environmentボタンをクリックします。続いて表示されるポップアップでAddをクリックします。アプリケーションがステージ環境に追加されると、テスト用の更新を実施できるようになります。
メモ: これまでにこのアプリケーションに追加されていた開発者は削除されます。必要に応じて、後からステージ環境に再追加できます。インストール済みアプリケーションは、本番環境にのみ保持できます。
メモ: 管理対象アプリケーションの場合、削除を実行する前にステージ版と本番版の内容が同一である必要があります。
メモ: インストール済みアプリケーションは、本番環境にのみ保持できます。
3.3 トラブルシューティング
インストール済みアプリケーションを環境に追加すると、そのアプリは自動的にステージ環境に作成されます。ただし、同時に作成できるのは最大 3 つのアプリケーションまでです。そのため、アプリケーションは環境には追加されますが、ステージ環境でのアプリ作成が開始されない場合があります。これは次の状況で発生します。
一度に環境へ4 つ以上のアプリを追加しようとした場合。
3 つのアプリを環境に追加しようとしているが、すでに別のアプリケーションでステージ作成が進行中の場合。言い換えると、追加しようとしているアプリ数は、ステージ環境でのアプリ作成キューにある空きスロット数と同数である必要があります。そうでない場合、ステージ環境の作成は開始されません。
依存関係のあるアプリまたは独立したアプリのセットを 4 セット以上追加しようとした場合。つまり、あるアプリとその依存アプリは、このカウントにおいて 1 セットとして扱われます。
上記のシナリオでは、アプリケーションは環境には追加されますが、ステージ環境には作成されません。この場合は、次の手順に従ってステージ環境でアプリを手動作成する必要があります。
[Environments]タブに移動し、ステージ環境が作成されていない対象アプリケーションの横にある横向きの三点リーダーをクリックします。
[Create & Access]オプションを選択します。
ステージ環境でのアプリ作成が開始され、ステータスはCreating stage appになります。完了すると、ステータスはStage app creation completeに変わり、ステージ環境のバージョンはv1.0 となります。
環境ステータス -
Stage app not yet created - このステータスは、アプリケーションが環境に追加されたものの、開発環境およびステージ環境には自動作成されていないことを示します。この場合、アプリ作成を手動で開始する必要があります。
Creating stage app - ステージ環境でアプリを作成中です。
Error in app creation - ステージ環境でのアプリ作成に失敗しました。解決方法については詳細を参照してください。
Personalization: Localization でアプリの言語設定をカスタマイズできます。デフォルトではカスタムアプリは日本語で利用できますが、次のオプションから選択できます。
- 特定の言語: すべてのユーザーに対して優先言語を 1 つ設定します。
- ブラウザーの言語: ユーザーの Web ブラウザーの言語設定に基づいて、アプリの UI 要素を自動的に翻訳します。
- Zoho アカウントの言語: ユーザーの Zoho アカウントで設定されている言語に基づいて、アプリの UI 要素を翻訳します。
- ユーザーの優先言語: ユーザーが複数の言語を切り替えて利用できるようにします。
インストール済みアプリケーションを表示するには:
Creator アカウントで Operations > Marketplace に移動します。
[Installed Applications] をクリックします。
開発者が新機能、バグ修正、パフォーマンス改善、セキュリティ強化などをリリースした場合は、アプリケーションを更新する必要があります。更新することで、アプリケーションを安定かつ安全に保ち、最新の機能に対応させることができます。
スライダー内の[Status]列には、各バージョンのステータスが表示されます。
Yet to update in stage:そのバージョンの更新が、まだステージ環境に適用されていない状態です。
Yet to update in production:そのバージョンの更新がステージ環境に適用済みで、本番環境への公開待ちの状態です。
メモ:ステージ環境での更新は、バージョンの整合性を保つために必ず順番に適用してください。本番環境へのデプロイ時には、任意のバージョンを選択して公開できます。
インストール済みアプリを環境に追加すると、接続はアカウントレベルで共有され、ステージ環境と本番環境の両方から参照されます。この共有利用により、アプリの更新を環境間で移動した場合でも、接続に関する動作はステージと本番で同じになります。バージョン更新時には、次のようなケースが発生します。
アプリの更新により接続の権限が変更される場合、既存の接続認可は失効します。同じ接続がステージと本番の両方で使用されているため、接続を再認可する必要があり、この再認可はすべての環境に適用されます。そのバージョンを本番に昇格させた後は、接続の機能に影響はありません。古いバージョンを本番に昇格させた場合、その更新は適用されずスキップされ、システムは引き続きステージの最新バージョンを参照します。
アプリの更新により接続の表示名が変更される場合、既存の認可を失効させることなく、その変更はすべての環境に反映されます。
アプリの更新の一部として新しい接続が追加され、それがステージに適用された場合、その接続は作成され、ステージ環境でのテストに利用できます。 本番環境は、更新が公開されるまで、その接続なしで動作し続けます。
更新に接続の削除が含まれている場合でも、本番環境がその接続を使用している間は、ステージ環境に更新を適用しても接続は削除されません。 接続が削除されるのは、その更新が本番に公開された後であり、これにより両方の環境で同じアプリバージョンが動作するようになります。
接続を先に削除し、その後同じリンク名で新しい接続を導入する更新が保留中の場合、本番環境に削除の更新が公開されるまで、その新しい接続の作成をステージ環境に適用することはできません。
接続を含むアプリは、ステージ環境と本番環境の両方で同じバージョンが動作している状態になるまで、環境から削除することはできません。
アプリケーションに利用可能な更新がある場合は、次の手順で更新できます。
Installed Applicationsタブで対象アプリをクリックし、利用可能な更新を表示します。
Updatesタブで、対象バージョンの横にあるUpdateボタンをクリックして、更新をインストールします。
アプリの更新に接続の変更が含まれている場合、その変更は自動的に本番環境に反映されます。ただし、接続の権限セットに変更がある場合は、更新適用後に再認可が必要です。
ヒント:アップデート前にアプリケーションのバックアップを作成しておくと、データ損失を防ぐことができます。
画面内のVersion Historyタブをクリックします。
メモ:インストール済みアプリケーションが環境に追加される前は、バージョン履歴には本番環境バージョンの更新のみが表示されます。[Installed Applications]タブで任意のアプリをクリックします。
画面内のVersion Historyタブをクリックします。
Tip: 営業時間外にアップデートをスケジュールすることを推奨します。
[Operations] > [Marketplace] > [Installed Applications] に移動します。
メモ: インストール済みアプリケーションを削除すると、そのアプリケーションに関連付けられているインストール済み接続も削除されます。
接続一覧ページで、対象のインストール済み接続の横にある省略記号メニューから、Use Per-Environment Authorizationを選択します。
接続の詳細ページで、認可の横にある「Use Per Environment」ボタンをクリックします。
5.8.6クライアント認証情報を更新する
インストール済み接続に関連付けられている OAuth クライアント認証情報(Client ID と Client Secret)を更新できます。これは通常、サードパーティの OAuth プロバイダー側で認証情報が更新された場合に必要となります。
クライアント認証情報を更新する手順
Microservices > Connections に移動します。
対象のインストール済み接続をクリックし、Connection Detailsページを開きます。
Client Credentials セクションで、一覧に表示されている認証情報名の横にあるUpdateアイコンをクリックします。
表示されるポップアップで、既存の認証情報リストから新しいClient Nameを選択し、サードパーティ OAuth アプリの更新後の新しいClient Secretを入力します。新しいClient ID とClient Secretを追加することもできます。既存のクライアントシークレットは表示されず、再利用することはできません。
Update and Authorizeをクリックし、接続を再認可して動作を復元します。
アプリケーションのライブモードからクライアント認証情報を更新することもできます。
クライアント認証情報名を編集するには:
カスタム認証情報で接続を作成した場合、クライアント認証情報名は自動生成されます。クライアント認証情報名を編集するには、対象の接続の Connection Detailsページに移動し、下図の編集アイコンをクリックします。