分散アプリのインストールと管理

分散アプリのインストールと管理

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

このページの内容  
このページでは、ユーザーがZoho Marketplaceまたはプライベート配布からアプリをインストールする方法と、開発者/パートナーが公開した更新を確認してインストールする方法について説明します。
利用条件
Zoho Creator アカウントを持つスーパー管理者は、Zoho Marketplace で公開されているアプリや、開発者がプライベート配布しているアプリを自分のアカウントにインストールできます。

1. 概要 

Zoho Creator では、Zoho Developer Console を使用して設計されたカスタムアプリをインストールし、ビジネスニーズに合わせて利用できます。Zoho Marketplace では、Zoho Creator アカウントにすばやく追加できるさまざまなローコードアプリが提供されており、プライベート配布アプリは、特定のニーズに合わせた専用ソリューションを提供することで、排他性を確保します。

1.1 Marketplace 配布アプリについて

Zoho Marketplaceは、開発者が構築したローコードアプリを検索してインストールできるプラットフォームです。これらのアプリは多様なニーズに対応するよう設計されており、ゼロから構築することなく、Zoho Creator アカウントに簡単に統合できます。この方法により、時間と労力を節約し、要件に合った完全な機能を備えたアプリケーションをすばやく活用できます。

1.2 プライベート配布アプリ    

開発者/パートナーと連携して、自社のビジネスニーズに合ったカスタムアプリを簡単に構築できます。開発者/パートナーは、要件に正確に沿ったアプリを作成します。アプリの準備ができたら、あなたに対してプライベートに共有され、あなただけがインストールしてアクセスできるようになります。この方法により、Zoho Marketplace 上で一般公開されることなく、ビジネスに必要な柔軟性とカスタマイズ性を確保しつつ、プライバシーと排他性を維持できます。

2. アプリケーションのインストール  

2.1 Marketplace 配布アプリ 

Marketplace からアプリケーションをインストールするには、Zoho Creator アカウントが必要です。Creator アカウントにアクセスしたら、次の操作を行います。
  1. Creator アカウント左ペインのOperationsタブに移動し、Applicationsの下にあるMarketplaceをクリックします。あるいは、Zoho Marketplace> Custom appsからアプリケーションをインストールすることもできます。
  2. [Custom Apps] タブで、インストールしたいアプリをクリックします。

Infoヒント: フィルターと検索を使うことで、次のデフォルトフィルターオプション(Categories、プラン、Price、Rating)を利用して、要件に応じたアプリを簡単に探すことができます。

  1. Installをクリックします。有料アプリの場合は、Buy nowボタンをクリックし、支払いを完了してからインストールに進みます。
  2. 個人情報を仕入先(開発者/パートナー)と共有することを説明する確認ポップアップが表示されます。続行するには、利用規約に同意し、Installをクリックします。
  3. インストールを続行するには、Continueをクリックします。
メモ: インストールにかかる時間は、アプリの複雑さによって異なります。通常、この処理には数分程度かかります。
アプリのインストールが完了すると、自動的にアプリケーションの本番モード(Live モード)にリダイレクトされ、そのまま利用を続けることができます。



2.2 プライベート配布アプリ

開発者またはパートナーから直接共有されたプライベート配布アプリケーションをインストールするには、次の手順に従います。
  1. 開発者/パートナーから送信されたメール招待を承諾し、アプリケーションの共有を許可します。
  2. アカウント宛てに送信されたメール内のInstall Applicationボタンをクリックして、アプリをインストールします。
Zoho Creator アカウントにリダイレクトされたら、Installをクリックしてインストールを開始します。


アプリのインストールが完了すると、自動的にアプリケーションの本番モード(Live モード)にリダイレクトされ、そのまま利用を続けることができます。

2.2.1 ライセンス種別と有効期間
開発者がアプリケーションをプライベート共有する際は、ライセンスによって、あなたがそのアプリにアクセスして利用できる期間を設定します。アプリは次のいずれかのライセンス種別で共有されます。

トライアルライセンス
トライアルライセンスでは、購入前にアプリケーションを評価できるよう、一定期間だけアクセスできます。開発者が設定した 15 日、30 日、60 日のいずれかの期間、実際に操作しながらアプリを試用できます。
  1. インストールされたアプリケーションの有効期間は、アプリをアカウントにインストールした時点から開始します。
  2. トライアルが終了すると、アプリはアカウント上で完全に無効化されます。既存データは閲覧できますが、新しいデータを追加することはできません。
  3. アプリがビジネスニーズに合っている場合は、開発者に連絡して継続利用を依頼できます。開発者は同じアプリをサブスクリプションライセンスに切り替え、今後も途切れることなく利用できるようにします。
  4. トライアル終了後、開発者はアプリとそのすべてのデータをあなたのアカウントから完全に削除できます。
Infoセキュリティに関するヒント: このアプリは評価目的で共有されています。アプリケーションの機能を試す際は、テストデータのみを使用してください。トライアルが終了すると、開発者はいつでもあなたのアカウントからアプリとそのデータを完全に削除できます。
サブスクリプションライセンス
サブスクリプションライセンスでは、アプリケーションを長期間継続して利用できます。アプリを本番利用する準備が整ったタイミングで、このライセンスを利用します。有効期間は開発者が設定し、一定の月数、または期限なしでアクセスを許可できます。
  1. Months - アプリは指定された月数(1~36 か月)の間、有効な状態で利用できます。
    1. インストールされたアプリケーションの有効期間は、アプリをアカウントにインストールした時点から開始します。
    2. サブスクリプション期間が終了すると、アプリは無効化され、既存データの閲覧のみ可能で、新しいデータを追加することはできません。
    3. 開発者は、サブスクリプションの有効期限が切れた後、アプリケーションへのアクセスを完全にブロックすることもできます。この場合、閲覧専用モードも含め、アプリに一切アクセスできなくなります。ただし、Backup>DownloadOperations 内)からアプリケーションのデータをダウンロードすることは可能です。
    4. サブスクリプションを更新する場合は、開発者に連絡してください。更新が完了すると、アプリは自動的にアカウント上で再度有効になります。
  1. Lifetime - アプリには有効期限がなく、アカウントから無期限にアクセスできます。

3.インストール済みアプリの環境

インストール済みアプリケーションは、テストとデプロイを効率化するために Zoho Creator の環境に追加できます。環境を使用すると、本番ユーザーに公開する前に、安全にアプリケーションをテストできます。詳しくは、環境のページをご覧ください。
インストール済みアプリを環境に追加すると、ステージ環境で新しいバージョンや改善点をテストしてから、本番環境の本番アプリケーションを更新できるため、安定性とバージョン管理を確保できます。ステージ環境では、新機能の確認、ワークフローの検証、最近の変更が想定どおりに動作するかの確認を行ってから、本番環境で更新と管理を行うことができます。
Notesメモ: インストール済みアプリケーションでは、開発環境はサポートされません。まず更新内容をステージ環境に移動して十分にテストし、その後本番環境に反映する必要があります。

3.1 アプリを環境に追加する

インストール済みアプリを環境に追加する方法は、次の 3 通りあります。
  1. [ソリューション]ページから(インストール済みアプリと作成したアプリの共通方法)

  2. [環境]ページから(インストール済みアプリと作成したアプリの共通方法)

  3. [オペレーション]から(インストール済みアプリのみ)

オペレーションからアプリを環境に追加する -

  1. Creator アカウントで、[オペレーション] > [マーケットプレイス] > [インストール済みアプリ]に移動します。

  2. 環境に追加したいアプリケーションを選択します。

  3. ページ上部のAdd to Environmentボタンをクリックします。続いて表示されるポップアップでAddをクリックします。アプリケーションがステージ環境に追加されると、テスト用の更新を実施できるようになります。

Notesメモ: これまでにこのアプリケーションに追加されていた開発者は削除されます。必要に応じて、後からステージ環境に再追加できます。インストール済みアプリケーションは、本番環境にのみ保持できます。

3.2 環境からアプリを削除する

アプリケーションを環境から削除すると、マルチステージデプロイが無効になります。インストール済みアプリケーションの場合、本番環境は常に保持されます。保持されたバージョンは本番専用のスタンドアロンアプリケーションとなり、[ソリューション]ページに表示されます。
アプリケーションを環境から削除しても、アプリケーション自体が削除されるわけではありません。アプリケーションを削除すると、そのアプリケーションとすべてのデータが Zoho Creator アカウントから完全に削除されます。これに対し、「削除(Remove)」は環境機能のみを無効にし、保持されている本番バージョンはそのまま残します。
Notesメモ: 管理対象アプリケーションの場合、削除を実行する前にステージ版と本番版の内容が同一である必要があります。
3.2.1 アプリケーションを環境から削除する手順 
  1. Environments]に移動し、対象アプリケーションの横にある三点リーダー(ellipsis)アイコンをクリックして、[Remove from Environment]を選択します。選択したアプリが表示された[Remove from environments]ペインが開きます。
  2. Select Applications]ボタンをクリックして、追加で削除したいアプリケーションを選択します。

  3. Notesメモ: インストール済みアプリケーションは、本番環境にのみ保持できます。
  4. Proceed to Remove]をクリックします。

3.3 トラブルシューティング     

インストール済みアプリケーションを環境に追加すると、そのアプリは自動的にステージ環境に作成されます。ただし、同時に作成できるのは最大 3 つのアプリケーションまでです。そのため、アプリケーションは環境には追加されますが、ステージ環境でのアプリ作成が開始されない場合があります。これは次の状況で発生します。

  • 一度に環境へ4 つ以上のアプリを追加しようとした場合。

  • 3 つのアプリを環境に追加しようとしているが、すでに別のアプリケーションでステージ作成が進行中の場合。言い換えると、追加しようとしているアプリ数は、ステージ環境でのアプリ作成キューにある空きスロット数と同数である必要があります。そうでない場合、ステージ環境の作成は開始されません。

  • 依存関係のあるアプリまたは独立したアプリのセットを 4 セット以上追加しようとした場合。つまり、あるアプリとその依存アプリは、このカウントにおいて 1 セットとして扱われます。

上記のシナリオでは、アプリケーションは環境には追加されますが、ステージ環境には作成されません。この場合は、次の手順に従ってステージ環境でアプリを手動作成する必要があります。

  1. Environments]タブに移動し、ステージ環境が作成されていない対象アプリケーションの横にある横向きの三点リーダーをクリックします。

  2. Create & Access]オプションを選択します。

ステージ環境でのアプリ作成が開始され、ステータスはCreating stage appになります。完了すると、ステータスはStage app creation completeに変わり、ステージ環境のバージョンはv1.0 となります。

環境ステータス -

  • Stage app not yet created - このステータスは、アプリケーションが環境に追加されたものの、開発環境およびステージ環境には自動作成されていないことを示します。この場合、アプリ作成を手動で開始する必要があります。

  • Creating stage app - ステージ環境でアプリを作成中です。

  • Error in app creation - ステージ環境でのアプリ作成に失敗しました。解決方法については詳細を参照してください。

4. アプリケーションの管理

Zoho Creator では、インストール済みアプリケーションを一元管理でき、次の操作を実行できます。
  1. アプリへのアクセス
  2. アプリ設定の表示
  3. アプリ詳細の表示
  4. アプリの更新
  5. アプリ更新時のエラー
  6. アプリの有効化/無効化
  7. バージョン履歴の表示
  8. アプリの削除
  9. インストール済み接続の管理

4.1 アプリへのアクセス

インストール済みアプリケーションは、Solutionsページからアクセスできます。フィルタのドロップダウンで[Installed apps]を選択すると、アプリケーションを絞り込めます。


環境を使用していないアプリケーションの場合は、Access Live を選択すると、本番環境でアプリケーションを直接開くことができます。
環境対応アプリケーションの場合は、ドロップダウンから Stage や Production などの対象環境を選択し、その環境でアプリケーションにアクセスします。
あるいは、Operations > Marketplace に移動し、Installed Application タブでアプリを選択します。アプリの横の三点リーダー、またはアプリの詳細ページで三点リーダーをクリックし、Access Live を選択してアプリケーションを表示します。

4.2 アプリ設定の表示 

インストールしたアプリケーションがベンダー、開発者、またはパートナーによるものの場合、以下を含む Settings ページにアクセスできます。

  1. Permissions: 開発者が提供したすべてのロールとデータ共有オプションを含む、ユーザー権限およびポータルユーザー権限を表示します。
メモ: これらの権限は閲覧専用であり、編集することはできません。
  • Personalization: Localization でアプリの言語設定をカスタマイズできます。デフォルトではカスタムアプリは日本語で利用できますが、次のオプションから選択できます。

  1. 特定の言語: すべてのユーザーに対して優先言語を 1 つ設定します。
  2. ブラウザーの言語: ユーザーの Web ブラウザーの言語設定に基づいて、アプリの UI 要素を自動的に翻訳します。
  3. Zoho アカウントの言語: ユーザーの Zoho アカウントで設定されている言語に基づいて、アプリの UI 要素を翻訳します。
  4. ユーザーの優先言語: ユーザーが複数の言語を切り替えて利用できるようにします。
 メモ: ベンダー(開発者/パートナー)が開発・公開したインストール済みアプリは、ソースコード保護のため編集できません。
ただし、Zoho が提供するギャラリーアプリの場合は、インストール後にアプリを編集でき、環境も有効化できます。


4.3 アプリ詳細の表示  

インストール済みアプリケーションを表示するには:

  1. Creator アカウントで Operations > Marketplace に移動します。


  2. [Installed Applications] をクリックします。

インストール済みアプリの詳細は こちら で確認できます:
  1. Application - アプリケーション名
  2. Version - 現在インストールされているアプリのバージョン
  3. サブスクリプション - 非公開配布アプリの場合は対象外、または Free、Paid、Trial Expired、Plan Expired
  4. Status - 既定では Enabled ですが、Solutions ページから無効化できます。
3. 対象のアプリケーションをクリックすると、そのアプリケーションのインストール元、開発者、インストールの詳細、更新の詳細、およびバージョン履歴を確認できます。


4.4 アプリの更新

開発者が新機能、バグ修正、パフォーマンス改善、セキュリティ強化などをリリースした場合は、アプリケーションを更新する必要があります。更新することで、アプリケーションを安定かつ安全に保ち、最新の機能に対応させることができます。

更新手順は、アプリケーションの種類によって異なります。
  1. 環境対応アプリ - アプリケーションでマルチステージデプロイが有効になっているため、本番(Production)のライブ版に影響を与えることなく、開発者からのバージョンをテストおよび更新できます。
  2. 非環境アプリ - 環境に追加されていないアプリケーションは、直接更新できます。これらの更新は、アプリケーションのライブ版(Production)に直接反映されます。
環境を有効にしたアプリ
環境を有効にしていないアプリ
環境を有効にしたアプリ
インストール済みアプリをステージ環境に正常に追加した後は、EnvironmentsページまたはOperationsから、アプリケーションを最新バージョンに更新できます。バージョン更新は次のように管理します。
  1. CreatorアカウントのEnvironmentsペインで、対象アプリの横にある三点リーダーをクリックし、Version Updatesを選択して、利用可能なバージョンとその更新状況を確認します。
  2. 表示されたスライダーで、Updateタブ内の対象バージョンの横にあるUpdateボタンをクリックします。
  3. 最新バージョンのアプリケーションをステージ環境に移動してテストするには、To Stageを選択します。

スライダー内の[Status]列には、各バージョンのステータスが表示されます。

    1. Yet to update in stage:そのバージョンの更新が、まだステージ環境に適用されていない状態です。

    2. Yet to update in production:そのバージョンの更新がステージ環境に適用済みで、本番環境への公開待ちの状態です。

Notesメモ:ステージ環境での更新は、バージョンの整合性を保つために必ず順番に適用してください。本番環境へのデプロイ時には、任意のバージョンを選択して公開できます。

ステージ環境でのテストが完了したら、To Productionを[Update]ボタンの下からクリックして、テスト済みバージョンのアプリケーションを本番環境に公開します。すべての更新済みバージョンの履歴は、Version Historyタブから確認できます。

Info
ヒント:更新は、業務時間外にスケジュールして実行することを推奨します。

4.4.2 バージョン更新時の接続

 インストール済みアプリを環境に追加すると、接続はアカウントレベルで共有され、ステージ環境と本番環境の両方から参照されます。この共有利用により、アプリの更新を環境間で移動した場合でも、接続に関する動作はステージと本番で同じになります。バージョン更新時には、次のようなケースが発生します。 

  • アプリの更新により接続の権限が変更される場合、既存の接続認可は失効します。同じ接続がステージと本番の両方で使用されているため、接続を再認可する必要があり、この再認可はすべての環境に適用されます。そのバージョンを本番に昇格させた後は、接続の機能に影響はありません。古いバージョンを本番に昇格させた場合、その更新は適用されずスキップされ、システムは引き続きステージの最新バージョンを参照します。

  • アプリの更新により接続の表示名が変更される場合、既存の認可を失効させることなく、その変更はすべての環境に反映されます。

  • アプリの更新の一部として新しい接続が追加され、それがステージに適用された場合、その接続は作成され、ステージ環境でのテストに利用できます。 本番環境は、更新が公開されるまで、その接続なしで動作し続けます。

  • 更新に接続の削除が含まれている場合でも、本番環境がその接続を使用している間は、ステージ環境に更新を適用しても接続は削除されません。 接続が削除されるのは、その更新が本番に公開された後であり、これにより両方の環境で同じアプリバージョンが動作するようになります。

  • 接続を先に削除し、その後同じリンク名で新しい接続を導入する更新が保留中の場合、本番環境に削除の更新が公開されるまで、その新しい接続の作成をステージ環境に適用することはできません。

  • 接続を含むアプリは、ステージ環境と本番環境の両方で同じバージョンが動作している状態になるまで、環境から削除することはできません。

これらの動作により、環境間の一貫性が保たれ、バージョン更新時の接続管理における競合が防止されます。
環境を有効にしていないアプリ
インストール済みアプリケーションは、環境を有効にしなくても更新できます。これらの更新は、アプリケーションの本番(ライブ)バージョンに直接反映されます。

アプリケーションに利用可能な更新がある場合は、次の手順で更新できます。

  1. Installed Applicationsタブで対象アプリをクリックし、利用可能な更新を表示します。

  2. Updatesタブで、対象バージョンの横にあるUpdateボタンをクリックして、更新をインストールします。

アプリの更新に接続の変更が含まれている場合、その変更は自動的に本番環境に反映されます。ただし、接続の権限セットに変更がある場合は、更新適用後に再認可が必要です。

4.5 アプリ更新時のエラー

アプリケーションを更新する際、次のいずれかのステータスが表示される場合があります。
  1. データ損失の警告:更新をクリックした際にデータ損失の可能性がある場合(たとえば、開発者によってコンポーネントが削除され、新しいバージョンが公開される場合など)、削除されるコンポーネントの詳細が表示されます。

Infoヒント:アップデート前にアプリケーションのバックアップを作成しておくと、データ損失を防ぐことができます。
  1. データ移行を実行中:一部のアプリ更新では、データの更新が必要になる場合があります。たとえば、数式項目の式を更新すると、既存データが再計算されます。このような場合は、「データ移行を実行中」のステータスが表示されます。このステータスをクリックすると、変更対象となる具体的なデータを確認できます。
  2. エラー発生:更新中にエラーが発生した場合、「更新中にエラーが発生しました」というステータスが表示されます。このステータスをクリックすると、サポート用のエラー概要と詳細を確認できます。
インストール済みアプリについては、ユーザーが非推奨バージョン(Marketplace)を使い続けている場合や、必須アップデート(プライベート配布)をインストールしていない場合、一定期間後にシステムによってアプリケーションが無効化されることがあります。
  1. Marketplace 配布アプリ - システムで非推奨となったバージョンのアプリケーションを使用している場合、120日以内に自動的に動作を停止し、無効化されます。アプリが無効化されるのを防ぐには、常に有効なバージョンに更新しておいてください。アプリは、有効なバージョンに更新した後で再度有効化できます。
  2. プライベート配布アプリ - プライベート配布されているアプリで必須アップデートが利用可能な場合は、30日以内にその必須バージョンへ更新する必要があります。アプリが無効化されるのを防ぐには、常に有効なバージョンに更新しておいてください。
アップデートが正常にインストールされると、アプリケーションを引き続き利用できます。

4.6 アプリの有効化/無効化

インストール済みアプリケーションは、次のいずれかの条件に該当すると自動的に無効化されます。
  1. Marketplace アプリのサブスクリプション有効期限切れ - Marketplace経由で配布されているアプリで、アプリケーションのサブスクリプションが有効期限切れになると、そのアプリは無効化されます。再度有効化するには、ポップアップでRenew(更新)をクリックします。Marketplace の支払いページに移動し、アプリケーションを更新できます。サブスクリプションを更新しない限り、アプリを有効化することはできません。あるいは、アプリケーション詳細ビュー画面からサブスクリプションを更新することもできます。
  1. 新バージョンへの更新 - インストール済みアプリが、指定された期間内に更新されていない場合、システムによってアプリケーションが無効化されます。これは、ユーザーが非推奨バージョンを使用している場合や、開発者から必須アップデートが送信されている場合に発生します。
アプリケーションを手動で無効化/有効化するには:

いずれかのインストール済みアプリにカーソルを合わせ、表示される三点リーダー(横の三点)をクリックします。次に、Disable/Enableを選択します。

Notes
メモ:アプリケーションが無効化されると、そのアプリに関連するレコードの追加や変更はできません。

4.7 バージョン履歴

アプリケーションのバージョン履歴と、その更新内容を確認できます。
環境対応アプリ
非環境アプリ
環境対応アプリ
Version History」タブには、現在インストールされているバージョン、インストール日時、インストールの詳細などが表示されます。バージョン履歴タブにアクセスするには、次の操作を行います。
  1. Installed Applications]タブで任意のアプリをクリックします。
  2. 画面内のVersion Historyタブをクリックします。

Notesメモ:インストール済みアプリケーションが環境に追加される前は、バージョン履歴には本番環境バージョンの更新のみが表示されます。
非環境アプリ
Version History」タブには、現在インストールされているバージョンまでのすべての過去バージョン、アカウントのスーパー管理者のメールアドレス、インストール日時などが表示されます。バージョン履歴タブにアクセスするには、次の操作を行います。
  1. Installed Applications]タブで任意のアプリをクリックします。

  2. 画面内のVersion Historyタブをクリックします。

5.4.2 アプリの有効化/無効化

インストール済みアプリケーションは、次のいずれかの条件に該当すると自動的に無効化されます。
  1. Marketplace アプリのサブスクリプション有効期限切れ - Marketplace経由で配布されているアプリで、アプリケーションのサブスクリプションが有効期限切れになると、そのアプリは無効化されます。再度有効化するには、ポップアップでRenew(更新)をクリックします。Marketplace の支払いページに移動し、アプリケーションを更新できます。サブスクリプションを更新しない限り、アプリを有効化することはできません。あるいは、アプリケーション詳細ビュー画面からサブスクリプションを更新することもできます。
  1. 新バージョンへの更新 - インストール済みアプリが、指定された期間内に更新されていない場合、システムによってアプリケーションが無効化されます。これは、ユーザーが非推奨バージョンを使用している場合や、開発者から必須アップデートが送信されている場合に発生します。
アプリケーションを手動で無効化/有効化するには:
  1. いずれかのインストール済みアプリにカーソルを合わせ、表示される三点リーダー(横の三点)をクリックします。Disable/Enableを選択します。
  2. アップデートは順番にのみ適用できます。現在のアップデートが正常にインストールされるまで、次のアップデートは有効になりません。たとえば、アプリケーションの現在のバージョンが V3.0 で、V4.0 と V5.0 が更新可能な場合、最新バージョンの V5.0 は、まず V4.0 を正常にインストールしてからでないと適用できません。
  3. 確認ポップアップでContinue(続行)をクリックして、アップデートのインストールを進めます。アップデートのインストール中は、アプリケーションにはアクセスできません。


  4. InfoTip: 営業時間外にアップデートをスケジュールすることを推奨します。

  5. アップデートは、可能であれば営業時間外にスケジュールすることを推奨します。

4.8 アプリの削除

削除すると、アプリケーションはアカウントから完全に削除されます。アプリケーションを削除するには:
  1. [Operations] > [Marketplace] > [Installed Applications] に移動します。

  2. 削除したいアプリケーションにカーソルを合わせ、横三点リーダーをクリックします。[削除] を選択します。

    または、アプリケーション詳細ページで、下図のように横三点リーダーの下にある [削除] をクリックしてアプリケーションを削除することもできます。

メモ: インストール済みアプリケーションを削除すると、そのアプリケーションに関連付けられているインストール済み接続も削除されます。

4.9 インストール済み接続の管理

Marketplace から、または個別に共有された接続を含むアプリをインストールすると、それらの接続は「インストール済み接続」と呼ばれます。パートナーがアプリケーションを共有した場合や、Marketplace からアプリケーションをインストールした場合、開発者が設定した接続はアプリのセットアップの一部として含まれます。
メモ:
- インストール済み接続は、他のアプリケーションで編集、削除、再利用することはできません。また、インストール済み接続から関連アプリケーションへのアクセスを無効にすることも制限されています。
- システム接続のアプリアクセスは、参照がすべて削除されるまで無効にできません。
4.9.1. 接続へのアクセス
ユーザーは、ライブモードで、 Connections タブ( Microservices 配下)から、またはアプリケーションのライブモードにある接続スライダーから、インストール済み接続()を表示できます。詳細ページからアクセスする場合、各接続には次の情報が表示されます。
  1. サービス名: 関連付けられている外部サービスを示します。
  2. 権限: サービスに付与されている権限を表示します。
  3. 認可所有者: 自動生成された認可アカウント名を表示します(編集可能)。
  4. ステータス: 接続が有効かどうかを表示します。
  5. [Authorize] ボタン: まだ認可されていない場合に認可を実行できます。
  6. 接続タイプ: 管理者接続、システム接続、ユーザー接続を、それぞれ異なるアイコンで示します。
  7. インストール情報: インストールしたユーザーと日時を表示します。
  8. その他: まだ認可されていない場合に認可を行う [Authorize] ボタン、切り替えボタン、認可取り消しボタンが表示されます。
  9. [Authorize] ボタン: まだ認可されていない接続を認可し、認可の切り替えや取り消しのオプションを提供します。
  10. 環境ごとの認可: 接続作成時にこのオプションが有効化されていない場合でも、各環境ごとに個別の認可を設定できます。
  11. クライアント認証情報: 接続モードとしてクライアント認証情報(カスタム)が選択されている場合、そのクライアント認証情報名が表示されます。
ライブページからアクセスする場合:
  1. サービス名: 関連付けられている外部サービスを示します。
  2. 認可アカウント: 接続が認可されると、自動生成された認可アカウント名を表示します(編集可能)。
  3. 接続リンク名: 作成された接続のリンク名を表示します。
  4. 権限: サービスに付与されている権限の一覧を表示します。
  5. ステータス: 接続が有効かどうかを表示します。
  6. その他: まだ認可されていない場合に認可を行う [Authorize] ボタン、切り替えボタン、認可取り消しボタンが表示されます。
  7. クライアント認証情報: 接続モードとしてクライアント認証情報(カスタム)が選択されている場合、そのクライアント認証情報名が表示されます。
4.9.2. 接続の認可
1. Zoho Creator にログインし、Microservices 配下の [Connections] タブに移動します。
2. インストールされた接続を選択し、 Authorize をクリックします。
      
メモ: 接続の種類によっては、他のユーザーも接続を認可できます。
4.9.3. 認可の切り替え
接続の種類に応じて、既存の認証情報の有効期限が切れた場合や変更が必要な場合に、ユーザーは認可を更新できます。
1. 対象の接続を選択し、[Switch] をクリックします。
      
2. アカウントを選択し、[Reauthorize] をクリックします。OAuth2 接続の場合は、90 秒以内にアクセスを許可する必要があります。

4.9.4. 認可の取り消し
接続の種類に応じて、ユーザーは接続の認可を取り消し、関連するすべてのアプリコンポーネントでの利用を停止できます。
対象の接続を選択し、[Revoke] をクリックします。


4.9.5. 接続の有効化/無効化
Connection Details ページで、ページ上の More アイコンをクリックすることで、インストール済み接続を有効または無効にできます。

4.9.6. 環境ごとの認可 
インストール済みアプリケーションに接続があり、それが環境に追加されている場合、デフォルトでは本番環境とステージング環境で同じ認可が使用されます。この構成は、すべての環境で同じ認証情報を使用する統合に最適です。後から異なる認証情報を使用することにした場合は、Creator で「環境ごとの認可」を有効にすることで、環境ごとに固有の認可を設定できます。環境ごとに異なる認可を使用することで、各環境の要件に合わせてアクセス権限を調整しつつ、環境固有の権限を維持できます。たとえば、本番環境にデプロイする前に、ステージング環境で別の認証情報を使用して追加のテストを実施できます。

環境ごとの認可を有効にする
インストール済み接続に対して環境ごとの認可を有効にするには、次のいずれかの方法を使用します。
  • 接続一覧ページで、対象のインストール済み接続の横にある省略記号メニューから、Use Per-Environment Authorizationを選択します。

  • 接続の詳細ページで、認可の横にある「Use Per Environment」ボタンをクリックします。

これ以降は、任意の環境を選択すると、その環境用の認可が求められます。
一度環境ごとの認可を有効にすると、インストール済みアプリケーションを環境から削除した場合でも、すべての環境で同じ認可を使用する設定に戻すことはできません。ただし、すべての環境を選択して認可を完了することで、実質的に同じ状態にすることは可能です。

5.8.6クライアント認証情報を更新する  

インストール済み接続に関連付けられている OAuth クライアント認証情報(Client ID と Client Secret)を更新できます。これは通常、サードパーティの OAuth プロバイダー側で認証情報が更新された場合に必要となります。

Info
情報: クライアント認証情報を更新すると、その接続を参照しているアプリケーション内の既存のすべての認可が失効します。接続を使用しているアプリケーションは、接続が再認可されるまで一時的に影響を受ける可能性があります。接続に設定した権限が、登録済み OAuth アプリで定義されているスコープの範囲内であることを確認してください。

クライアント認証情報を更新する手順  

  1. Microservices > Connections に移動します。

  2. 対象のインストール済み接続をクリックし、Connection Detailsページを開きます。

  3. Client Credentials セクションで、一覧に表示されている認証情報名の横にあるUpdateアイコンをクリックします。

  4. 表示されるポップアップで、既存の認証情報リストから新しいClient Nameを選択し、サードパーティ OAuth アプリの更新後の新しいClient Secretを入力します。新しいClient ID Client Secretを追加することもできます。既存のクライアントシークレットは表示されず、再利用することはできません。

  5. Update and Authorizeをクリックし、接続を再認可して動作を復元します。

アプリケーションのライブモードからクライアント認証情報を更新することもできます。

クライアント認証情報名を編集するには:

カスタム認証情報で接続を作成した場合、クライアント認証情報名は自動生成されます。クライアント認証情報名を編集するには、対象の接続の Connection Detailsページに移動し、下図の編集アイコンをクリックします。

Notes
メモ:
  1. クライアント認証情報を更新できるのは、その認証情報の所有者(認証情報を追加したユーザー)のみです。その他のロールでは [Update] オプションは無効化され、ホバー時にツールチップが表示されます。 
  2. 管理者および開発者は、認証情報を関連付けられたアプリケーション内でのみ再利用できます。

4.9.7. ポイントとなるメモ
  1. 1 つの接続を複数のクライアントサイドアプリで再利用することはできません。
  2. データのセキュリティを維持するため、各接続はアプリごとに認可する必要があります。
  3. 開発者によって接続が更新されると、クライアント側で再認可が求められます。
  4. インストール済みアプリケーションを削除すると、そのアプリケーションに関連付けられているインストール済み接続も削除されます。

5. 制限事項

  1. インストール済みアプリケーションでは、日付と時刻の設定を構成できません。
  2. 開発者が提供した アプリ URL および アプリアイコン は、ユーザー側で変更できません。
  3. ロールと権限 は開発者が設定した内容から、ユーザー側で変更することはできません。
  4. インストール済みアプリケーションでは、 ページ変数 の設定(開発者が定義した値および現在値)は、ソースコード保護のため閲覧できません。
  5. アップデートは順番にのみ適用できます。つまり、前のアップデートが正常にインストールされて初めて、次のアップデートが有効になります。
  6. インストール済みアプリケーションでは、支払いよりもアップデートが優先されます。たとえば、支払いと Creator アカウントが有効であっても、顧客が非推奨バージョンのアプリを使用している場合、そのアプリは自動的に無効状態に移行します。
  • Developer Console について

  • 前の手順
    前の手順
    これで、Marketplace から、またはパートナーや開発者が共有したアプリケーションを Creator アカウントにインストールする方法を確認しました。続いて、Marketplace配布や、プライベート配布について詳しく学びましょう。