Visual Builder Studioでページを変更する前に
チームがアプリケーション拡張の作成を開始する前に、まずVisual Builder Studioを設定して構成する必要があります。 これらのステップは、実装ごとに1回のみ完了する必要があります。
開始する前に、次の情報があることを確認します:
-
Visual Builder StudioのインスタンスのURL
URLを取得するには、Oracle Cloudアプリケーション開発インスタンスからナビゲートします。 ナビゲータの「構成」で、Visual Builderを選択します。
Visual Builder Studioの設定には、次のステップが含まれます:
-
必要なロールおよび権限を取得します。
-
Visual Builder Studioユーザーを設定します。
-
プロジェクトおよびワークスペースを作成します。
または、既存のプロジェクトにワークスペースを作成します。
-
ビルド・パイプラインを作成して、変更を本番環境にデプロイします。
必要なロールおよび権限の取得
Visual Builder StudioおよびOracle Cloudアプリケーション・インスタンスを設定するには、FND_ADMINISTER_SANDBOX_PRIV権限が割り当てられていることを確認します。 たとえば、次に示す各ロールには、次の権限があります:
-
アプリケーション管理者(ORA_FND_APPLICATION_ADMINISTRATOR_JOB)
-
アプリケーション開発者(ORA_FND_APPLICATION_DEVELOPER_JOB)
-
営業管理者(ORA_ZBS_SALES_ADMINISTRATOR_JOB)
-
顧客関係管理アプリケーション管理者(ORA_ZCA_CUSTOMER_RELATIONSHIP_MANAGEMENT_APPLICATION_ADMINISTRATOR_JOB)
また、設定およびアクション・メニューの「Visual Builder Studioのページの編集」オプションを表示するには、ユーザーに管理リンクの表示権限(FND_VIEW_ADMIN_LINK_PRIV)が割り当てられている必要があります。 デフォルトでは、この権限は前述の事前定義済ロールに割り当てられます。 必要に応じて、この権限をカスタム・ロールにも付与します。
IDCSでのVisual Builder Studioユーザーの設定
まず、拡張作業を行うためにVisual Builder Studioにアクセスできるようにユーザーを認可する必要があります。 これは、Oracle Identity Cloud Service (IDCS)で実行します。
IDCSの適切なインスタンスにサインインするには、次のステップを実行します:
-
www.oracle.comにナビゲートします。
-
「アカウントを表示」をクリックします。
-
「クラウドにサインイン」をクリックします。
-
「クラウド・アカウント名」フィールドに、本番ポッドの名前(「パン」など)を入力します。 「次」をクリックします。
-
Oracle Cloud「アカウントのログイン」ページは、クラウド・ポータルに固有であり、テスト・ポッドおよび本番ポッドとは別です。 ユーザー資格証明を入力し、「サインイン」をクリックするか、「ここをクリック」リンクを使用してパスワードをリセットします。
Oracle Cloudダッシュボードで、アクティブ・アプリケーション・リージョンに移動し、「アイデンティティ・クラウド」をクリックします。 下にスクロールしてIDCSサービス・インスタンスを表示します:
-
アイデンティティ
Myservicesポータルに関連付けられたIDCSインスタンス。
-
CAKP (たとえば)
本番ポッドに関連付けられたIDCSインスタンス。
-
CAKPTEST (たとえば)
開発者ポッドに関連付けられたIDCSインスタンス。
-
-
テスト環境に関連付けられたIDCSインスタンスにサインインするには、テスト・ポッドのサービス・インスタンスURL (この例ではCAKPTEST)をクリックするか、「サービス・コンソールを開く」リンクをクリックします。
ヒント: 次回使用できるように、このURLをブックマークします。 -
IDCSに直接サインインするか、ページの下部にあるOracle Applications Cloud (Fusion)をクリックして、Oracle Applicationsユーザー資格証明を使用してサインインします。
Identity Cloud Serviceコンソールが表示されたら、ユーザーを認可してVisual Builder Studioにアクセスできるようになりました。 ユーザーまたはユーザーのグループを、Visual Builder Studio管理者(DEVELOPER_ADMINISTRATOR)またはVisual Builder Studioユーザー(DEVELOPER_USER)ロールに割り当てることができます。 これらの2つの事前定義済ロールは、Visual Builder Studioでの作業に固有です。
この例では、Visual Builder Studio管理者(DEVELOPER_ADMINISTRATOR)ロールへのグループの割当てを見てみましょう。 これは、Fusion ApplicationロールとそのユーザーへのVisual Builder Studioアクセス権を提供する方法です。
-
Identity Cloud Serviceコンソールで、ナビゲーション・ドロワーを展開し、Oracle Cloud Servicesをクリックします。
-
DevServiceAppAUTO_<VBSTUDIO_INSTANCE>をクリックします。
-
「アプリケーション・ロール」タブをクリックします。
-
DEVELOPER_ADMINISTRATOR行またはDEVELOPER_USER行で、メニュー・アイコンをクリックし、「グループの割当」をクリックします。
-
「グループの割当」ダイアログで、割り当てるロールを選択し、OKをクリックします。 たとえば:
-
アプリケーション管理者
-
営業管理者
-
顧客関係管理アプリケーション管理者
-
アプリケーション開発者
-
認可プランごとのカスタム・ロール
-
選択したロールを持つユーザーは、Visual Builder Studioにアクセスできるようになりました。 Oracle Cloud Applicationsユーザー更新がIDCSと同期するには、最大12時間かかる場合があります。
詳細は、Oracle Cloud Visual Builder Studioの管理ガイドの「VB Studioユーザーの設定」を参照してください。
プロジェクトおよびワークスペースの作成
Visual Builder Studioでプロジェクトおよびワークスペースをまだ作成していない場合は、標準オブジェクトの詳細ページを構成する前に作成する必要があります。
-
「計画」は、チームがアプリケーション拡張の作成に使用するリソースの集合です。
ノート: この章の手順では、最小限の手動コーディングでページをより迅速に構成するのに役立つ構成要素であるフラグメントを使用します。 フラグメント・ベースの拡張を、フラグメントを使用しない拡張機能とは別に保持する新しいプロジェクトを作成します。 -
「ワークスペース」はプロジェクト内に存在し、Gitリポジトリ、環境およびOracle Cloudアプリケーション・サンドボックスに接続するプライベート作業領域です。
「既に」プロジェクトを作成した場合は、新しいプロジェクトを作成する必要はありません。 かわりに、既存のプロジェクト内に新しいワークスペースを作成できます。 次の項を参照してください。
プロジェクトとワークスペースを同時に作成するには:
-
Visual Builder Studioで、組織サイド・タブをクリックし、プロジェクト・サブタブをクリックします。
-
「+作成」をクリックします。
-
「新規プロジェクト」ダイアログで、プロジェクトの名前と説明を入力します。
-
プロジェクトのセキュリティを、「プライベート」または「共有」のいずれかに設定します。
-
「次」をクリックします。
-
このプロジェクトのテンプレートとして「空のプロジェクト」を選択し、「次」をクリックします。
-
プロパティ・ステップで、「次」をクリックします。
-
チーム・ステップで、チーム・メンバーを追加し、そのメンバー・レベルを選択します。
-
「終了」をクリックします。
Visual Builder Studioは、プロジェクトをプロビジョニングします。完了には数分かかる場合があります。 その後、プロジェクトのホーム・ページにナビゲートされます。
-
プロジェクトの開発環境を作成します。
-
環境サイド・タブをクリックし、「+環境の作成」をクリックします。
-
環境の名前と説明を入力し、「作成」をクリックします。
-
「+インスタンスの追加」をクリックします。
-
「サービス・インスタンスの追加」ダイアログのインスタンス・タイプで、「Oracle Cloudアプリケーション」をクリックします。
-
認証メソッドで、「アイデンティティ・ドメイン」をクリックします。
-
環境に必要なインスタンスを選択し、「追加」をクリックします。
-
-
新規ワークスペースを作成します。
-
ワークスペース・サイド・タブをクリックし、 をクリックします。
-
「新規アプリケーション拡張」ダイアログの「拡張名」フィールドに、拡張名を入力します。
-
「拡張ID」フィールドに、
site_cxsales_Extension
と入力します。 -
「ワークスペース名」フィールドで、デフォルト値を受け入れるか、新しいワークスペース名を入力します。
-
「開発環境」フィールドで、作成した環境を選択します。
-
ベースのOracle Cloudアプリケーション・フィールドで、「CX Sales (CX Salesから)」を選択します。
-
Gitリポジトリ・リージョンで、「新規リポジトリの作成」をクリックします。
-
リポジトリと作業ブランチの両方の名前を入力します。
-
「作成」をクリックします。
-
既存のプロジェクトでのワークスペースの作成
既存のプロジェクトに新規ワークスペースを作成するには:
-
Visual Builder Studioで、左ペインのワークスペース・タブをクリックし、「Gitからのクローニング」をクリックします。
-
Gitからの複製ダイアログで、次の値を入力します。
フィールド
値
ワークスペース名
ワークスペースの名前を入力します。
リポジトリ名
チームのプロジェクトに接続されているGitリポジトリを選択します。 この値については、管理者に問い合せてください。
ブランチ
mainを選択します。
選択済からの新規ブランチ・チェック・ボックス
このチェック・ボックスを選択します。
新規ブランチ名
ブランチの名前を入力します。 たとえば、<user_id>_<feature_name>です。
開発環境
開発環境を選択します。
サンドボックス(オプション)
サンドボックスを選択するか、これを空白のままにして、後でワークスペースにサンドボックスを添付します。
-
「作成」をクリックします。
本番環境のビルド・パイプラインの作成
ビルド・パイプラインを作成して、変更を本番環境にデプロイします。
プロジェクトを作成すると、アプリケーション拡張をテスト環境にデプロイするためにビルド・パイプラインが自動的に作成されました。 次に、本番環境に2つ目のパイプラインを作成する必要があります。
完全な手順は、Oracle Cloud Visual Builder Studioの管理ガイドの「CI/CDパイプラインを実行するためのVB Studioの構成」および「本番環境にデプロイするプロジェクトの設定」を参照してください。