Visual Builderインスタンスと同じアイデンティティ・ドメインにあるVB Studioインスタンスを使用してビジュアル・アプリケーションを開発する場合、Visual Applicationプロジェクト・テンプレートに基づいてプロジェクトを迅速に開始できます。

1. VB Studioにサインインします。Oracle Cloudホーム・ページからVB Studioへのアクセスを参照してください。
2. 組織ページで、「+作成」をクリックします。
3. 新規プロジェクト・ウィザードの「プロジェクト詳細」ページで、プロジェクトの一意の名前と説明を入力します。
4. 「セキュリティ」で、プロジェクトのプライバシを選択します:
   1. 「プライベート」を選択して、プロジェクト・メンバーにのみアクセスを制限します。

      「検出可能」チェック・ボックスを選択すると、組織管理者またはプロジェクト・メンバーではない組織メンバーは、自分のプライベート・プロジェクトに関する基本情報(名前や所有者の連絡先情報など)を表示できます。発見できない非公開プロジェクトは、非会員には公開されません。

   2. 「共有」を選択して、組織内のユーザーがプロジェクト・コード、Wikiドキュメント、タスクおよびビルドを使用できるようにします。
5. 「優先言語」で、プロジェクト・ユーザーが受信する電子メール通知の言語を指定します。
   ユーザー設定でユーザーインターフェイスが表示される言語を変更できます。
6. 「次へ」をクリックします
7. 「プロジェクト・テンプレート」ページで、「ビジュアル・アプリケーション」プロジェクト・テンプレートを選択し、「次」をクリックします。
8. 「プロジェクト・プロパティ」ページで:
   1. 「Gitリポジトリ名」で、必要に応じてGitリポジトリのデフォルト名を変更します。
   2. 「リージョン」および「コンパートメント」で、Visual Builderインスタンスが存在するOCIリージョンおよびコンパートメントを選択します。
   3. 「開発VBインスタンス」で、まだ選択されていない場合は、Visual Builder開発インスタンスを選択します。
      必要なVisual Builderインスタンスが表示されない場合は、戻ってOCIリージョンおよびコンパートメントの選択内容を変更します。
   4. 「ビジュアル・アプリケーション・テンプレート」で、選択した開発インスタンスで使用可能なビジュアル・アプリケーション・テンプレートを選択します。
      デフォルトでは、VB Studioは「デフォルトVBアプリケーション」テンプレートを使用します。別のテンプレートを選択するには、「テンプレートの変更」をクリックし、テンプレートを選択して「選択済の使用」をクリックします。
   5. (オプション)「ワークスペース名」で、必要に応じてプライベート・ワークスペースの名前を変更します。デフォルトでは、Workspace1です。

      ワークスペースには、このプロジェクトのGitリポジトリのクローン、およびソース・ファイルを含むブランチなど、ビジュアル・アプリケーションの開発に必要なすべてのアーティファクトが含まれます。ワークスペースについてさらに学習するには、ワークスペースの概要および必要な理由を参照してください。

   6. (オプション)「作業ブランチ名」で、必要に応じてワークスペースの作業ブランチ名を変更します。デフォルトでは、branch1です。
      プロジェクトがプロビジョニングされると、Gitリポジトリのmainブランチにアプリケーションのファイルが含まれます。ワークスペースの作成時に、VB Studioはmainブランチのコピーを作成し、指定した名前で名前を変更し、ワークスペースの作業ブランチとして使用します。
   7. 「次へ」をクリックします
9. 「チーム」ページで:
   1. 「メンバーの追加」をクリックし、表示されるリストから、プロジェクトに追加するユーザーまたはグループを選択します。
   2. 追加するメンバーがプロジェクトに含まれるメンバーシップ(プロジェクト所有者、開発者フル・アクセス、開発者限定アクセスまたはコントリビュータ)を選択します。
      各メンバーシップの詳細は、プロジェクト・メンバーシップとはを参照してください。
   3. 「追加」をクリックします。
   4. 必要に応じて、様々なメンバーシップ・タイプを持つ様々なユーザーおよびグループに対して、a、bおよびcのサブステップを繰り返します。
10. 「終了」をクリックします。

デプロイメント・ジョブは、ビジュアル・アプリケーションのビルド・アーティファクトをVisual Builder開発インスタンスにデプロイします。ジョブで、アプリケーションのバージョンとプロファイル、およびビルド・アーティファクトを接続してVisual Builder開発インスタンスにデプロイするために必要な資格証明を指定します。

1. 左側のナビゲータで、「ビルド」 をクリックします。
2. 「ジョブ」タブで、デプロイメント・ジョブをクリックします。
3. 「構成」をクリックします。
4. 「構成」 をクリックします。
5. 「ステップ」タブをクリックします。
6. 「認可」セクションで、このビルド・ステップを実行する認可タイプを指定します。「OAuthの使用」をデフォルトで選択すると、Authorization is requiredメッセージが表示され、このビルド・ステップでは、環境のVisual BuilderインスタンスへのOAuthリクエストを処理するために1回かぎりの認可が必要であることが示されます。「認可」をクリックし、資格証明を入力してVisual Builderインスタンスにアクセスします。ジョブを手動で実行し、プロンプトが表示されたら資格証明を入力することもできます。

   いずれの場合も、初期構成時にOAuth接続を承認することをお薦めします。このステップをスキップすると、デザイナから変更を公開できなくなり、変更のデプロイを試行する前に必要な承認を完了する必要があります。

   承認されると、Authorization has been providedメッセージが表示されます。

   ノート
   
   OAuthが推奨される認可タイプです。OAuth接続の設定で問題が発生した場合のみ、Basic認証を使用します。Basic認証を使用するには、「基本の使用」を選択し、「ユーザー名」および「パスワード」でVisual Builderインスタンスにアクセスできるユーザーの資格証明を入力します。

   OAuthトークン(アクセスおよびリフレッシュ)は、通常の使用中に循環されます。リフレッシュ・トークンは、ユーザーがターゲット・インスタンスにアクセスするたびにアクセス・トークンを取得するために使用されます。このリフレッシュ・トークンは通常、7日間有効です。(トークンの有効期限はIDCSリソース・アプリケーションで設定され、セキュリティ要件によって異なる場合があります。)ユーザーが7日以内にターゲット・インスタンスで認証すると、アクティブなリフレッシュ・トークンによって新しいアクセス・トークンと新しいリフレッシュ・トークンが生成されます。リフレッシュ・トークンが有効であるかぎり、このサイクルは無期限に継続されます。リフレッシュ・トークンが長時間非アクティブ状態(休暇中など)で期限切れになった場合は、「認可の更新」をクリックします(またはジョブを手動で実行するため、期限切れのOAuthトークンを認可するように求められます)。

7. (オプション)アプリケーションのデフォルト・バージョンを上書きするには、「アプリケーション・バージョン」で新しいバージョンを指定します。アプリケーションのvisual-application.jsonファイルに定義されているバージョンを使用するには、空のままにします。
   「URLにアプリケーション・バージョンを含める」チェック・ボックスの選択を解除しないでください。
8. (オプション)「アプリケーション・プロファイル」で、開発アプリケーション・プロファイルを指定します。アプリケーションのデフォルト・プロファイルを使用するには、空のままにします。

   ビジュアル・アプリケーションは、RESTサービスの異なるサーバーのデータにアクセスするため、開発や本番などの環境ごとに異なるセキュリティ設定が必要になる場合があります。アプリケーション・プロファイルを使用すると、環境ごとに異なるサーバーとセキュリティ設定の組合せを定義し、アプリケーションを環境にデプロイするときに使用できます。これにより、開発から本番への移行時にビジュアル・アプリケーションの管理が簡略化されます。詳細は、「アプリケーション・プロファイルについて」を参照してください。

9. (オプション)既存のアプリケーションのデータベースを使用するには、「データ管理」で「既存の環境データの保持」を選択します。

   アプリケーションにクリーン・データベースを使用するには、「データ管理」で「クリーン・データベースの使用」を選択します。

10. 「保存」をクリックします。

開発ビルド・パイプラインは、パッケージング・ジョブで指定されたGitリポジトリのブランチにコミットがプッシュされると自動的に実行されます。

1. 左側のナビゲータで、「ビルド」 をクリックします。
2. 「パイプライン」タブをクリックします。
3. 開発パイプラインの行で、「アクション」 メニューをクリックし、「パイプラインの実行」を選択します。

デプロイメント・ジョブが正常に実行されると、「環境」ページの「デプロイメント」タブでデプロイされたアプリケーションを表示できます。

1. 左側のナビゲータで、「環境」をクリックします。
2. Visual Builder環境を選択します。
3. 「デプロイ」タブをクリックします。
4. 有効になっていない場合は、「ビジュアル・アプリケーション」トグル・ボタンをクリックします。
5. Visual Builderインスタンスが別のアイデンティティ・ドメインのものである場合は、そのアクセス資格証明を指定します。
6. アプリケーションの名前を展開して、デプロイされたアプリケーションのリンクを表示します。
   「デプロイメント」タブには、現在のプロジェクトからデプロイしたアプリケーションが表示されます。プロジェクトの他のユーザーによってデプロイされたアプリケーション、または他のプロジェクトからデプロイされたアプリケーションは表示されません。次に例を示します:

   
   

   
   図visualapp_deployment.pngの説明