ステージ環境への公開

ステージ環境への公開

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

Notes
このヘルプページは Developer Console バージョン 6 をご利用のユーザー向けです。旧バージョン(Developer Console 5)をご利用の場合は、こちらをクリックしてください。ご利用中の Developer Console のバージョンを確認する方法をご覧ください。

1. このページの内容

開発環境からステージ環境にアプリケーションを公開し、その後クライアントに配布できるようにする方法について説明します。続行する前に、環境の概要を参照することをおすすめします。
Idea

2. 利用条件

スーパー管理者はアプリケーションを作成し、割り当てられた開発者が環境を使って編集およびテストできるようにします。

3. ステージ環境に公開する手順

アプリの開発が完了したら、次の手順としてアプリケーションまたはその変更内容をテストします。このテストはステージ環境で実行されます。アプリをステージに公開するには、次の操作を行います。
  1. 左メニューのEnvironments(環境)セクションに移動します(Deploy(デプロイ)配下)。
  2. 画面右上のPublish to Stage(ステージに公開)をクリックします。


  3. Select Apps(アプリを選択)ページで、ステージに公開するアプリを選択し、続行をクリックします。アプリを選択すると、Stagingページに、そのアプリに対して行われたすべての変更が一覧表示されます。


  1. ステージ環境に公開するコンポーネントを選択し、続行をクリックします。
     

Notes
メモ:
- 変更一覧から複数のコンポーネントを選択でき、選択したコンポーネントの変更のみが公開されます。コンポーネントに変更があっても選択されていない場合、その変更は公開されません。リストが長い場合は、検索バーを使用して特定のコンポーネントを検索・選択できます。
- コンポーネントをクリックすると、そのコンポーネントに対する変更内容と変更の種類が表示されます。Added は新しいコンポーネントが追加されたこと、Updated は既存のコンポーネントが更新されたこと、Deleted はコンポーネントが削除されたことを意味します。
  • 一部の変更には依存関係が含まれる場合があります。依存関係とは、あるコンポーネントが正しく機能するために、1 つまたは複数の別のコンポーネントが存在している必要がある関係のことです(ルックアップ項目など)。選択したコンポーネントに依存関係がある場合、依存先のコンポーネントも自動的に選択されます。

    例えば、販売者管理アプリで、新規苦情を送信フォームに、同じアプリ内の販売者を追加フォームへのルックアップ項目が含まれている場合、この 2 つの間には依存関係が存在します。新規苦情を送信を選択すると、販売者を追加も自動的に選択され、このコンポーネントが正しく動作するように一緒に公開されます。

  1. バージョンの詳細を指定します。バージョンの詳細ページで設定します。


    アプリケーションに対する変更のうち、1 回の公開で反映されるものをバージョンと呼びます。次の項目を設定します。
  • バージョンの件名説明を指定します。
  • バージョンの種類を選択します: メジャーアップデート(例:バージョン 1 から 2 への変更)またはマイナーアップデート(例:バージョン 1 から 1.1 への変更)。1.2 などのマイナーアップデートバージョンをメジャーアップデートとして反映する場合は、この例では 2 に切り上げられます。
  • メール通知の送信先とするスーパー管理者または開発者を選択します。ここにはアプリケーションのスーパー管理者と開発者が一覧表示され、最大 3 名まで選択できます。

変更を公開する前に、公開処理が正常に完了するよう、いくつかの検証が実行されます。
  • データ損失:この注意は、コンポーネントが削除され、その変更がステージ環境に公開される場合に表示されます。公開時に、関連するデータも削除されることをスーパー管理者と開発者に警告します。たとえば、アプリケーションをステージ環境に公開し、そのステージ環境でのテスト中にフォームへ入力が行われた後、そのフォームを削除して再度変更を公開すると、先ほどステージ環境でテスト中にフォームへ追加されたすべての入力データが削除されます。
  • 権限:この注意は、権限または役割 が削除され、その削除操作がステージ環境に公開される場合に表示されます。これは、スーパー管理者と開発者に対し、削除された権限または役割 が、削除時に指定した新しい権限または役割にマッピングされることを知らせます。
  • 公開後:これは、スーパー管理者と開発者に対し、暗号化や数式項目の変更が行われた場合、通常の公開時間に加えて公開処理に追加の時間がかかる可能性があることを知らせます。

  1. 公開]をクリックします。公開処理が開始されます。


  • Environmentsページでは、Stageセクション内のアプリケーションのステータスが公開処理中と表示されます。
  • 公開処理が完了すると、アプリのStageバージョンが一覧表示されます。



その後、アプリケーションを引き続きテストして、問題がないことを確認できます。テストが完了したら、アプリケーションをマーケットプレイスで配布するか、クライアントとプライベートに共有できます。

4. 外部連携を公開する手順

Developer Console で外部連携を公開すると、クライアントが利用できるようになり、クライアントのアプリと外部サービスまたは Zoho 製品との間で、安全かつ機能的な連携が可能になります。公開後、これらの外部連携はアプリのクライアントによって利用できるようになり、外部システムや Zoho サービスへのアクセスが効率化されます。
このプロセスには、連携の作成、ステージング環境でのテスト、その後ユーザーへの公開が含まれます。アプリをインストールした後、クライアントは連携を認証して、その機能を有効にする必要があります。
 

Stage 環境に連携を公開するには、次の手順に従います。

  1. 連携を作成し、Developer Console アカウント内のアプリケーション用に設定します。
  2. 連携のサービス名、連携の種類、権限などの詳細を設定します。
  3. Environmentsタブに移動し、アプリを選択ページから、外部連携を公開したいアプリを選択します。
    Info情報: アプリにリンクされた外部連携は、環境に追加されると公開ライフサイクルの対象になります。
  4. 公開するアプリに関連付けられているコンポーネントを選択します。
  5. Microservicesタブで外部連携を選択し、[続ける]をクリックします。
  6. バージョン詳細ページでバージョンの詳細を指定し、[公開]をクリックします。公開処理が開始されます。
公開が完了すると、外部連携は開発環境またはステージ環境で認証およびテストできるようになります。その後、テスト完了後にアプリをZoho マーケットプレイスで配布するか、プライベートに共有してユーザーに提供できます。

4.1 Developer Console における外部連携の動作

外部連携は、アプリと外部サービスを連携し、シームレスな通信とデータフローを実現するために不可欠な要素です。公開ライフサイクルを管理する際、外部連携は次のように動作します。
  • アプリをマーケットプレイスまたはクライアントに公開する前に、そのアプリに含まれるすべての外部連携を Stage 環境に公開しておく必要があります。
  • 新しく追加した接続や既存接続の変更がある場合、選択した接続の新しいバージョンが、Staging ページ右側のペインに表示されます。
  • 新しい接続を公開する場合は、少なくとも 1 つの依存コンポーネントとあわせて公開する必要があります。
  • 接続名、リンク名、スコープの追加/削除など、接続に対して行った変更は、参照コンポーネントがなくても更新として公開できます。依存関係なしで単独で公開することが可能です。
  • サポート終了となった接続がアプリで使用されている場合、クライアントはその接続を利用できず、通知を受け取ります。ソフトデプリケーションの場合は接続を更新する必要があり、それ以外の場合は代替の接続を使用する必要があります。

4。2 注意事項 

  • 外部連携は、同時に 1 つのアプリケーションにのみ関連付けることができます。一度有効化して公開すると、この設定は変更できません。
  • システム外部連携のみ、公開回数に関係なく複数のアプリからアクセスできます。
  • アプリを配布する際は、クライアント側のスーパー管理者が接続を認証して、その利用を有効化する必要があります。
  • 接続の更新は、同様の手順で Stage に公開し、その後クライアントに配布するか、マーケットプレイスに公開できます。

5. 公開操作

5。1 公開中のロック機構

利用シナリオ

開発 - 編集可否

Stage - 有効可否

公開中にアプリを選択し、次へ をクリックした場合

選択したアプリはロックされます

変更は発生しません

Stage への公開が開始されたとき

選択したアプリはロックされます

選択したアプリはロックされます

 

Stage への公開が完了した、または失敗した場合

選択したアプリはロック解除されます

 

選択したアプリはロック解除されます


5。2
ユーザー競合シナリオ

2 人の開発者、または開発者とスーパー管理者が同じアプリケーションを Stage に公開しようとしている場合:

スーパー管理者または開発者

別の開発者

 

Stage に公開しようとしている場合

アプリ選択画面で

公開中にアプリを選択して次へをクリックしたとき

公開中にアプリを選択して次へをクリックしたとき
 

何も変更は行われません

別のユーザーが変更を公開しようとしていることを知らせる情報バナーが表示されます


ユーザーはそのまま次の画面に進むことができます
 

別のユーザーが変更を公開しようとしていることを知らせる注意ポップアップが表示されます

 

ユーザーはこれ以上先に進むことはできません
 


5.3 Stage への公開ステータスメッセージ

アプリ番号と操作

シナリオ

アプリ公開ステータスメッセージ

アプリ 1 がステージ環境に公開済み


公開処理中

V1.0 を処理中

公開中に一部エラーが発生

公開時にエラーが発生しました

公開が正常に完了

V1.0

Notes
メモ:エラーの詳細は、エラーステータスメッセージをクリックすると表示されます。

次のステップ
前の手順
次のステップ
ステージ環境への変更を公開した後の次の手順は、アプリケーションをテストし、マーケットプレイスを利用するか、クライアント向けにプライベート配布のいずれかで配布することです。
前の手順
アプリケーションを作成する際には、環境の必要性とその使い方を理解しておくことが重要です。理解を深めるには、まず 環境について学ぶことから始めてください。