vb-process-local

Gruntプロセスでアプリケーション・ソースをローカルに処理します。

処理操作は、様々なテンプレートを解決し、複数のアプリケーション・リソースをさらに変更(追加および更新)します。

このタスクを実行するには、Visual BuilderインスタンスにアクセスするためのVisual Builder URLと資格証明を指定する必要があります。タスクの実行時に資格証明を直接指定できます。または、accessTokenオプションを使用して、有効なOAuthアクセス・トークンを指定できます。資格証明とOAuthアクセス・トークンの両方を指定した場合、タスクはアクセス・トークンを使用して認証します。

次の表では、vb-process-localタスクのサブタスク、フック、入力および出力について説明します:

詳細	説明
サブタスク	該当なし
マルチタスク	該当なし
フック	該当なし
input	`${gitSources}`
output	`build/processed/*`

次の表に、vb-process-localタスクのオプションを示します。 :ceサフィクスは、アプリケーションにWebコンポーネントが含まれる場合のみ必要であり、その結果、コンポーネント交換を参照します。

認証オプション

名前	必須	デフォルト値	説明
url[:ce]	いいえ	該当なし	コンポーネント交換サービスのURL。アプリケーションがWebコンポーネントを参照しない場合は不要です。管理者に連絡して、「テナント設定」ページで使用可能なVisual Builderインスタンスで使用されるコンポーネント交換のURLを取得してください。公開されているコンポーネント交換のURLについては、Oracle IntegrationでのOracle Visual Builderの管理のコンポーネント交換の管理を参照してください。
username[:ce]	いいえ	該当なし	コンポーネント交換サービスにアクセスするためのユーザー名。 `:ce`サフィクスはオプションです。
password[:ce]	いいえ	該当なし	コンポーネント交換サービスにアクセスするためのパスワード。 `:ce`サフィクスはオプションです。 `--password` Gruntオプションで指定されたパスワードは、特殊文字が含まれる場合は一重引用符(')で囲む必要があります。一般に、`--password`オプションには常に引用符を使用することをお勧めします。特に、ジョブ変数を使用してパスワードが指定されているVB Studioジョブではこの引用符を使用することをお勧めします。たとえば: `grunt vb-deploy '--password=password' ...`。アプリケーションがパブリックに使用可能なコンポーネント交換のコンポーネントを使用している場合に、`--username`および`--password`オプションを指定した`vb-process-local`タスクの例を次に示します: `grunt vb-process-local --url:ce=https://devinstance4wd8us2-wd4devcs8us2.uscom-central-1.oraclecloud.com/profile/devinstance4wd8us2-wd4devcs8us2/s/devinstance4wd8us2-wd4devcs8us2_compcatalog_3461/compcatalog/0.2.0 --username:ce=comp.catalog --password:ce=password`
accessToken[:ce]	いいえ	該当なし	コンポーネント交換サービスにアクセスするためのOAuthアクセス・トークンの値。指定した場合、ユーザー名およびパスワードのオプションは必要ありません。 `:ce`サフィクスはオプションです。

ビルド・オプション

名前	必須	デフォルト値	説明
target	いいえ	build	ビルド・ディレクトリの名前。
git-sources	いいえ	./	ビジュアル・アプリケーション・ソースのロケーション。

その他のオプション

名前	必須	デフォルト値	説明
mode	いいえ	default	ビルド・モードを定義します: デフォルト: Visual Builderランタイム・サービスへのデプロイメントのためのビジュアル・アプリケーション・アセットを構築 fa: 「Oracle Cloudアプリケーション」環境にデプロイするためのビジュアル・アプリケーション・アセットを作成
fa-indexHtml-resolveVariables	いいえ	true	`mode=fa`で、このプロパティが`false`に設定されている場合、生成された`index.html`はJETおよびVB URLおよびバージョン・テンプレート変数を解決しません。ファイルには%JET_CDN_PATH%などが含まれます。
fa-inject-pwa-tokens	いいえ	false	`mode=fa`の場合、ビルドは次のトークンを`index.html`に注入 `<!-%APPLE_ICONS_LINKS%> <!%SPLASHSCREENS_LINKS%->` 「Oracle Cloudアプリケーション」サーブレットは、これらのトークンを実行時に解決する必要があります。
enableTelemetry	いいえ	false	生成された`index.html`にTrace.ConsoleProfileイニシャライザを注入
追加ロケール	いいえ	該当なし	このアプリケーションでサポートされている追加のロケールのカンマ区切りリスト(`"it,es"`など)。アプリケーションに特定の言語の翻訳済バンドルが含まれる場合、このパラメータを設定します。たとえば、フランス語とドイツ語ですが、デプロイされたアプリケーションにはスペイン語も必要です。このパラメータをスペイン語(`"es"`)に設定すると、翻訳がまだ使用できない場合でも、スペイン語ロケール用にバンドルがデプロイされます。これにより、ロケール・バンドルがないため、デプロイされたアプリケーションでネットワークの問題を回避できます。

defaultビルド・モードではなく、faビルド・モードを使用して、「クモの網」アプリケーションのindex.htmlのテンプレート解決プロセスをより適切に制御できます。以下のテンプレート作成マークを解決します:

vb-process-localタスクの構成で定義されている次のテンプレート変数によって制御できます:

%BASE_URL%
%JET_CDN_PATH%
%JET_CDN_VERSION%
%VB_CDN_PATH%
%VB_VERSION%
%JET_UI_STYLE_PATH%

このタスクにresolveTemplate構成オブジェクトが指定されていない場合、これらの変数は結果となるindex.htmlで未解決のままになります。

resolveTemplate構成オブジェクトが少なくとも空のオブジェクトに設定されている場合、テンプレート変数は、アプリケーションのバージョン・ファイル(private/custom/versions.json or resources/package/versions.json)から取得した値、またはこれらが存在しない場合のデフォルト値で解決されます。例外は%BASE_URL%変数で、デフォルトがなく、resolveTemplate構成オブジェクトに値が明示的に指定されるまで、テンプレート変数参照は結果のindex.htmlに保持されます(次の例を参照):

grunt.initConfig({
  "vb-process-local": {
    options: {
      resolveTemplate: {
          BASE_URL: 'http://oracle.cloud/abc',
      }
    }
  },
});

また、構成オブジェクトには、他のテンプレート変数の値も含まれることがあります。その場合、構成値はバージョン・ファイルおよびデフォルトよりも優先されます。

環境変数を解決するための設定

vb-process-localタスクは、vb-deployタスクによってアプリケーション・アセットがVisual Builderランタイム・インスタンスにデプロイされたときに解決される、様々な環境変数を含む静的アプリケーション・アセットを作成します。アプリケーションをVisual Builderインスタンスにデプロイしない場合は、ビルド中にこれらの変数を解決できます。たとえば、vb-serveタスクと組み合せたローカル・アプリケーション開発では、アプリケーションをローカルで迅速にテストできます。

Gruntfile.jsファイルに次の構成を追加することで、環境変数値を定義できます(grunt.initConfig()メソッド・コールに渡すオブジェクトに構成を追加することもできます)。 vb-process-local環境構成のGruntfile.jsの例を次に示します:

grunt.config('vb-process-local.environment', {
       "env.userProfileUrl": "_currentuser",
       "env.vbServer.url": "http://127.0.0.1:3000/",
       "env.vbServer.context": "",
       "env.application.id": "myApp",
       "env.application.version": 1618840321144,
       "env.profileId": "base_configuration",
        });

次の表では、Gruntビルド・プロセス中に使用される環境変数のリストについて説明します:

名前	説明
`app-flow.json`
env.profileId	選択したアプリケーション・プロファイル
env.userProfileUrl	ユーザー・プロファイルURL
env.oauthUserProfileUrl	OAuthユーザー・プロファイルURL
env.idcsInfo	IDCS情報
`catalog.json`
env.catalogJson	catalog.jsonファイルのコンテンツ全体
`index.html`
env.vbServer.url	Visual Builderランタイム・サーバーのURL
env.vbServer.context	Visual Builderランタイム・サーバーのコンテキスト・パス
env.application.version	アプリケーションのバージョン