1. 概要 

1。1 マーケットプレイス 配布アプリ

1。2 プライベート配布アプリ    

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

2。1 マーケットプレイス配布アプリ 

1. Creator アカウント左側ペインの[Operations]タブに移動します。[アプリケーション] 配下の[マーケットプレイス]をクリックします。Zoho マーケットプレイス > Custom apps からアプリケーションをインストールすることもできます。
   
2. [Custom Apps] タブで、インストールしたいアプリをクリックします。
   

Tip: フィルターと検索を使用すると、次の既定のフィルター設定（カテゴリ、エディション、価格、評価）を使って、要件に基づいてアプリを簡単に絞り込んで閲覧できます。

3. [Install] をクリックします。有料アプリの場合は、[今すぐ購入]ボタンをクリックし、支払いを完了してからインストールを続行します。
   
4. 個人情報を販売者（開発者／パートナー）と共有することを説明する確認ポップアップが表示されます。続行するには、利用規約に同意し、[Install] をクリックします。
   
5. インストールを続行するには、[続ける] をクリックします。
   

2。2 プライベート配布アプリ

1. 開発者／パートナーから送信されたメール招待を承認し、アプリケーションを共有できるようにします。
2. アカウント宛てに送信されたメール内の[Install Application]ボタンをクリックして、アプリをインストールします。
   

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

2。2。1 ライセンスの種類と有効期限

開発者がアプリケーションをプライベート共有する際は、ライセンスを通じて、どのくらいの期間アプリにアクセスして利用できるかを選択します。アプリは、次のいずれかのライセンスタイプで共有されます。

試用ライセンス

試用ライセンスでは、購入を決定する前に、一定期間アプリケーションを試用できます。このライセンスを使用すると、開発者が設定した 15 日、30 日、60 日のいずれかの期間、アプリを実際に操作して体験できます。

1. インストールされたアプリケーションの有効期限は、アプリケーションをアカウントにインストールした時点から開始されます。
2. 試用期間が終了すると、アプリはアカウント内で完全に無効化されます。既存データは表示できますが、新しいデータを追加することはできません。
3. アプリが自社の業務ニーズに合っている場合は、開発者に連絡して継続利用について相談できます。開発者は同じアプリをサブスクリプションライセンスに切り替え、継続的にアクセスできるようにします。
4. 試用期間終了後、開発者はアカウントからアプリとそのすべてのデータを完全に削除できます。

セキュリティに関するヒント: このアプリは評価目的で共有されています。アプリケーションの機能を試す際は、テストデータのみを使用してください。試用期間が終了すると、開発者はいつでもアカウントからアプリとそのデータを完全に削除できます。

サブスクリプションライセンス

サブスクリプションライセンスでは、アプリケーションを長期間継続して利用できます。このライセンスは、アプリケーションを本番利用する準備が整ったときに使用します。開発者が設定した有効期限に基づき、一定期間（数か月）または有効期限なしでアクセスできます。

1. Months - アプリは指定された月数（1～36 か月）の間、有効な状態で利用できます。
1. インストールされたアプリケーションの有効期限は、アプリケーションをアカウントにインストールした時点から開始されます。
2. サブスクリプション期間が終了すると、アプリは無効化され、既存データの表示のみ可能で、新しいデータを追加することはできません。
   
3. 開発者は、サブスクリプションの有効期限が切れた後、アプリケーションへのアクセスを完全にブロックすることもできます。この場合、閲覧専用モードも含め、アプリに一切アクセスできなくなります。ただし、[Backup] > [ダウンロード]（[Operations] 内）から、アプリケーションのデータをダウンロードすることは可能です。
4. サブスクリプションの更新については、開発者に連絡できます。更新が完了すると、アプリは自動的にアカウント内で再度有効化されます。
   

1. Lifetime - アプリには有効期限がなく、アカウントから無期限にアクセスできます。
   

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

インストール済みアプリケーションは、テストとデプロイを効率化するために Zoho Creator の環境に追加できます。環境を使用すると、本番ユーザーに公開する前に、安全にアプリケーションをテストできます。詳細は、「環境」ページを参照してください。

インストール済みアプリを環境に追加すると、ステージ環境で新しいバージョンや改善点をテストしてから、本番環境の有効なアプリケーションを更新できるため、安定性とバージョン管理を確保できます。ステージ環境では、新機能の確認、ワークフローの検証、最近の変更が期待どおりに動作することの確認を行ってから、本番環境で更新および管理できます。

メモ: インストール済みアプリケーションでは、開発環境はサポートされません。まず更新内容をステージ環境に移動して十分にテストし、その後本番環境に反映する必要があります。

3。1 アプリを環境に追加する

インストール済みアプリを環境に追加する方法は、次の3通りあります。

1. ソリューションページから（インストール済みアプリと作成したアプリで共通）

2. 「環境」ページから（インストール済みアプリと作成したアプリで共通）

3. ［Operations］から（インストール済みアプリのみ）

Operations からアプリを環境に追加する -

1. Creator アカウントで、Operations > マーケットプレイス > Installed appsに移動します。
   

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

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

   

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

3。2 環境からアプリを削除する

アプリケーションを環境から削除すると、マルチステージデプロイが無効になります。インストール済みアプリケーションの場合、本番環境は常に保持されます。保持されたバージョンは本番専用のスタンドアロンアプリケーションとなり、［ソリューション］ページに表示されます。

アプリケーションを環境から削除しても、アプリケーション自体は削除されません。アプリケーションを削除すると、Zoho Creator アカウントからそのアプリケーションとすべてのデータが完全に削除されます。これに対し、「削除（Removal）」は、保持された本番バージョンをそのまま残したまま、環境機能のみを無効にします。

メモ: 管理対象アプリケーションの場合、削除を続行する前に、ステージと本番のバージョンが同一である必要があります。

3。2。1 環境からアプリケーションを削除する手順 

1. Environments に移動し、対象アプリケーションの横にある三点リーダーアイコンをクリックして、環境から削除を選択します。選択したアプリが表示された環境から削除ペインが表示されます。
   
2. アプリケーションを選択ボタンをクリックして、削除したい追加のアプリケーションを選択します。
   
   
3. メモ: インストール済みアプリケーションは、本番環境にのみ保持できます。
4. クリック 続行して削除を実行します。
   

3。3 トラブルシューティング     

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

• 一度に 3 つを超えるアプリを環境に追加しようとした場合。

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

• 依存関係のあるアプリ／ないアプリのセットを、3 セットを超えて追加しようとした場合。つまり、依存アプリを含む 1 つのアプリ群は、このカウント上 1 セットとして扱われます。

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

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

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

ステージ環境でのアプリ作成が開始され、ステータスはCreating stage appになります。完了後、ステータスはStage app creation 完了およびステージ環境のv1。0 に変更されます。

Environment statuses-

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

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

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

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

4。1 アプリへのアクセス

4。2 アプリ設定の表示 

インストール済みアプリケーションが販売者、開発者、またはパートナーによるものである場合、次の内容を含む設定ページにアクセスできます。

1. 権限: ユーザー権限およびポータルユーザー権限を表示し、開発者によって提供されたすべてのロールとデータ共有設定を確認できます。
   

• パーソナライズ: ローカライズの［Localization］でアプリの言語設定をカスタマイズします。初期設定では、カスタムアプリは日本語で利用可能ですが、次の設定から選択できます。

4。3 アプリの詳細を表示する  

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

1. Creator アカウントで、Operations > マーケットプレイス に移動します。
   
   
   

2. [Installed アプリケーション] をクリックします。
   
   

1. Application - アプリケーション名を示します
   
2. バージョン - 現在インストールされているアプリのバージョン
   
3. サブスクリプション - 非公開配布アプリの場合は「該当なし」、または「無料」「有料」「試用版の有効期限切れ」「プランの有効期限切れ」など
   
4. ステータス - 既定では「有効」ですが、Solutions ページから 無効 にすることもできます

4。4 アプリを更新する

1. 環境が有効なアプリ- アプリケーションでマルチステージデプロイが有効になっており、本番バージョンに影響を与えることなく、開発者から提供されるバージョンをテストおよび更新できます。
2. 環境なしのアプリ - 環境に追加されていないアプリケーションは、直接更新できます。これらの更新は、そのままアプリケーションの有効バージョン（本番）に反映されます。
   

Environment 有効アプリ

Environment 未使用アプリ

Environment 有効アプリ

インストール済みアプリを Stage に正常に追加した後は、EnvironmentsページまたはOperationsページから、アプリケーションを最新バージョンに更新できます。バージョンの更新は、次のように管理できます。

1. Creator アカウントのEnvironmentsペインで、アプリケーションの横にある三点リーダーをクリックし、バージョン 更新を選択して、利用可能なバージョンとその更新ステータスを表示します。
   
2. 表示されたスライダーで、更新タブ内の特定のバージョンの横にある更新ボタンをクリックします。
   
3. アプリケーションの最新バージョンを Stage に移動してテストするには、To Stageを選択します。
   

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

1. Yet to 更新 in stage - Stage 環境でまだバージョン更新が適用されていない場合。

2. Yet to 更新 in production - バージョン更新が Stage に適用され、本番環境に反映する準備ができている場合。

メモ: バージョンの進行を正しく維持するため、Stage での更新は順番どおりに適用してください。本番環境にデプロイする際は、任意のバージョンを選択して公開できます。

Stage でのテストが完了したら、To Productionを、更新ボタンの下からクリックして、テスト済みバージョンのアプリケーションを本番環境に公開します。また、バージョン履歴タブから、更新されたすべてのバージョンの履歴を表示できます。

Tip: 更新は、業務時間外にスケジュールすることを推奨します。

4。4。2 バージョン更新時の外部連携

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

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

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

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

• 更新に連携の削除が含まれる場合、本番環境がその連携を引き続き使用しているため、更新が Stage に適用されても連携は削除されません。連携は、その更新が本番環境に公開された後にのみ削除され、両方の環境で同じアプリバージョンが動作するようにします。

• 連携を先に削除し、その後同じリンク名で新しい連携を追加する更新が保留中の場合、削除の更新が本番環境に公開されるまで、新しい連携の作成更新を Stage に適用することはできません。

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

これらの動作により、環境間の一貫性が保たれ、バージョン更新時に外部連携を管理する際の競合が防止されます。

Environment 未使用アプリ

インストール済みアプリケーションは、Environment を有効にしなくても更新できます。これらの更新は、アプリケーションの本番（有効）バージョンに直接反映されます。

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

1. 「Installed アプリケーション」タブでアプリをクリックし、そのアプリに利用可能な更新を表示します。
   

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

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

4。5 アプリ更新時のエラー

アプリケーションを更新する際、次のいずれかのステータスが表示される場合があります。

1. 新しいバージョンへの更新 - インストール済みアプリが指定期間内に更新されていない場合、システムによってアプリケーションが無効化されます。これは、ユーザーがサポート終了バージョンを使用している場合や、開発者から必須更新が公開されている場合に発生します。

4。7 バージョン履歴

環境対応アプリ

非環境アプリ

環境対応アプリ

[バージョン履歴] タブには、現在インストールされているバージョン、インストール日時、インストールの詳細などが一覧表示されます。[バージョン履歴] タブにアクセスするには、次の操作を行います。

1. [インストール済みアプリケーション] タブで任意のアプリをクリックします。
   

2. ページ内の[バージョン履歴]タブをクリックします。
   

メモ: インストール済みアプリケーションが環境に追加される前は、[バージョン履歴] には本番環境のバージョン更新のみが表示されます。

非環境アプリ

[バージョン履歴] タブには、現在インストールされているバージョンまでのすべての過去バージョン、アカウントのスーパー管理者のメールアドレス、インストール日時などが一覧表示されます。[バージョン履歴] タブにアクセスするには、次の操作を行います。

1. [インストール済みアプリケーション] タブで任意のアプリをクリックします。
   

2. ページ内の[バージョン履歴]タブをクリックします。
   

5。4。2 アプリの有効化／無効化

インストール済みアプリケーションは、次のいずれかの場合に自動的に無効化されます。

1. マーケットプレイスアプリのサブスクリプション期限切れ - マーケットプレイス経由で配布されるアプリで、アプリケーションのサブスクリプションが期限切れになった場合、アプリは無効化されます。再度有効化するには、ポップアップで Renew をクリックします。マーケットプレイスの支払いページに移動し、アプリケーションのサブスクリプションを更新できます。サブスクリプションが更新されている場合にのみ、アプリを有効化できます。あるいは、アプリケーション詳細ページからサブスクリプションを更新することもできます。
   

1. 新しいバージョンへの更新 - インストール済みアプリが指定期間内に更新されていない場合、システムによってアプリケーションが無効化されます。これは、ユーザーがサポート終了バージョンを使用している場合や、開発者から必須更新が公開されている場合に発生します。

アプリケーションを手動で無効化または有効化するには:

3. 任意のインストール済みアプリケーションにカーソルを合わせ、表示される三点リーダー（…）をクリックします。[無効にする/Enable] を選択します。
4. 更新は順番にのみ適用できます。現在の更新が正常にインストールされて初めて、次の更新が有効になります。たとえば、アプリケーションの現在のバージョンが V3。0 で、V4。0 と V5。0 が更新可能な場合、最新バージョンの V5。0 は、まず V4。0 を正常にインストールしてからでないと適用できません。
   
5. 確認ポップアップで [続ける] をクリックし、更新のインストールを続行します。更新のインストール中は、アプリケーションにはアクセスできません。
   
6. 
   
   
   Tip: 更新は、業務時間外にスケジュールすることを推奨します。

7. 更新は、業務時間外にスケジュールすることを推奨します。

4。8 アプリの削除

1. [Operations] > [マーケットプレイス] > [インストール済みアプリケーション] に移動します。
   

2. 削除したいアプリケーションにカーソルを合わせ、横三点リーダーをクリックします。[削除] を選択します。
   
   また、以下のスクリーンショットのように、アプリケーション詳細ページの横三点リーダーの下にある [削除] をクリックして、そのアプリケーションを削除することもできます。
   

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

4。9 インストール済み外部連携の管理

マーケットプレイスまたはプライベート共有から外部連携を含むアプリをインストールすると、それらの外部連携は「インストール済み外部連携」と呼ばれます。パートナーがアプリケーションを共有した場合や、マーケットプレイスからインストールした場合、開発者が設定した外部連携はアプリの設定の一部として含まれます。

メモ:

- インストール済み外部連携を、他のアプリケーションで編集、削除、再利用することはできません。また、インストール済み外部連携から関連付けられたアプリケーションへのアクセスを無効にすることも制限されています。

- システム接続のアプリアクセスは、参照がすべて削除されるまで無効にできません。

4。9。1. 外部連携へのアクセス

ユーザーは、 アイコンが付いたインストール済み外部連携を、[Microservices] 配下の 外部連携 タブ、またはアプリケーションの有効ページにある外部連携スライダーから確認できます。詳細ページにアクセスすると、各接続には次の情報が表示されます。

1. サービス名: 関連付けられている外部サービスを示します。
2. 権限: サービスに付与されている権限を表示します。
3. 認証済み担当者: 自動作成された認証済みアカウント名を表示します（編集可能）。
4. ステータス: 接続が有効かどうかを表示します。
5. 認証ボタン: まだ認証されていない場合に認証を実行できます。
6. 接続種別: 管理者接続、システム接続、ユーザー接続を、それぞれ異なるアイコンで示します。
7. インストール詳細: インストールしたユーザーとインストール日時を表示します。
8. その他: まだ認証されていない場合の認証ボタン、認証の切り替えボタン、取り消しボタンが表示されます。
   
9. 認証ボタン: まだ認証されていない接続を認証でき、あわせて認証の切り替えや取り消しの設定も行えます。
10. 環境ごとの認証: 接続作成時にこのオプションが有効化されていない場合でも、各環境ごとに個別の認証を設定できます。
11. 

有効ページからアクセスした場合:

1. サービス名: 関連付けられている外部サービスを示します。
2. 認証済みアカウント: 接続が認証されると、自動作成された認証済みアカウント名を表示します（編集可能）。
3. 外部連携のリンク名: 作成された接続のリンク名を表示します。
4. 権限: サービスに付与されている権限の一覧を表示します。
5. ステータス: 接続が有効かどうかを表示します。
6. その他: まだ認証されていない場合の認証ボタン、認証の切り替えボタン、取り消しボタンが表示されます。
   

4。9。2. 接続の認証

1. Zoho Creator にログインし、[Microservices] 配下の [外部連携] タブに移動します。

2. インストール済みの接続を選択し、認証 をクリックします。
      

メモ: 接続の種類によっては、他のユーザーもその接続を認証できます。

4。9。3. 認証の切り替え

接続の種類に応じて、既存の認証情報の有効期限が切れた場合や変更が必要な場合に、ユーザーは認証を更新できます。

1. 対象の接続を選択し、[切り替え] をクリックします。
      

2. アカウントを選択し、[再認証] をクリックします。OAuth2 外部連携の場合は、90 秒以内にアクセスを許可する必要があります。

4。9。4. 認証の取り消し

接続の種類に応じて、ユーザーは接続の認証を取り消し、関連付けられているすべてのアプリコンポーネントでの利用を停止できます。

接続を選択し、[取り消す] をクリックします。

4。9。5. 接続の有効化／無効化

Connection 詳細 ページの その他 アイコンをクリックすることで、インストール済み接続を有効または無効にできます。

4。9。6. 環境ごとの認証 

インストール済みアプリケーションに含まれる接続が環境に追加されている場合、初期設定では同じ認証情報が 本番環境とステージング環境の両方で使用されます。この設定は、連携で使用する認証情報が各環境で共通の場合に最適です。後から異なる認証情報を使用したくなった場合は、Creator の「環境ごとの認証」を有効にすることで、環境ごとに固有の認証を設定できます。環境ごとに異なる認証を使用することで、各環境の要件に合わせてアクセスや権限を調整しつつ、環境固有の権限管理を維持できます。たとえば、本番環境へデプロイする前に、ステージング環境で別の認証情報を使用して追加のテストを実施することができます。

​

環境ごとの認証を有効にする
インストール済み接続に対して環境ごとの認証を有効にする方法は次のとおりです。

• 外部連携の一覧ページで、インストール済み接続の横にある三点リーダーメニューから、環境ごとの認証を使用 を選択します。

• Connection 詳細ページで、認証の横にある [環境ごとの認証を使用] ボタンをクリックします。

これ以降、いずれかの環境を選択するたびに、その環境用の認証が求められます。

一度「環境ごとの認証」を有効にすると、インストール済みアプリケーションを環境から削除した場合でも、すべての環境で同じ認証情報を共有する設定には戻せません。ただし、すべての環境を選択してそれぞれ認証を完了することで、実質的に同じ状態を再現することは可能です。

​

4。9。7. 補足メモ

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

5. 制限事項

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

6. 関連トピック 

• Developer Console について
  

• 前の手順

  前の手順

  マーケットプレイスから、またはパートナーや開発者が共有したアプリケーションを Creator アカウントにインストールする方法を確認したら、次はマーケットプレイス配布や、非公開配布についてもご覧ください。