既知の問題

アプリケーションのアップグレード後にコンポーネントがページにロードされていません

アプリケーションのアップグレード後、アプリケーション/ページのJSON / JavaScriptファイルに無効なJSONデータを返す構成またはコードが含まれている場合、一部のコンポーネントはADP変数にバインドされたときに正しくデータをロードしない可能性があります。

JSONファイルのADPデータに有効なJSON値を割り当てる必要があります。前のアクション(コール・モジュール・アクションやRESTアクションなど)の結果から値を割り当てるADPデータも、有効なJSONである必要があります。 JSON以外の値(NaNやInfinityなどのJavaScript値など)が指定されている場合は、使用する正しいJSON値を選択して置換する必要があります。

無効なJSONが存在する場合、Visual Builderアップグレード・ツールでアプリケーションを正しくアップグレードできない可能性があります。

回避策は、JSONファイルのすべての値が有効なJSONであることを確認することです。

キャッシュ済データが移入されたフィルタ・フィールド

デザイナでフィルタ・フィールドを使用する場合、「Chrome自動入力」フォーム・データ機能によって、一部のパネルおよびダイアログにキャッシュされたデータが移入される可能性があります。たとえば、ナビゲータのフィルタ・フィールドを使用する場合、フィールドにキャッシュされた電子メール・アドレスが表示されることがあります。キャッシュされたデータがフィールドに表示されている場合は、Chromeキャッシュされた自動入力フォーム・データをクリアします:

Chromeブラウザ・ウィンドウの右上にある3つのドットをクリックして、Chromeオプション・メニューを開きます。
メニューから「その他のツール」 > 「参照データのクリア」を選択します。
参照データのクリア・ダイアログ・ボックスで「上級」タブを開きます。
時間範囲ドロップダウン・リストで「全期間」を選択します。
リストから「フォーム・データの自動入力」を選択します。「データのクリア」をクリックします。

トレースは有効ですが、Groovyログ・メッセージが表示されません

トレースは有効ですが、アプリケーションのGroovyスクリプトのログ・メッセージはトレース・ペインの「Groovyログ」タブに表示されない場合があります。

Groovyログがトレース・ペインに表示されていない場合は、ログ・ペインを開き、「ロギングの有効化」をクリックします。トレースを有効にすると、Groovyログがトレース・ペインに表示されます。

非推奨のOracle SaaSアプリケーション・テンプレート・テーマの更新

サンプル「SaaS R13 LightBlueテーマ(ApplicationsCloudUITheme)は非推奨です」は非推奨のAltaテーマに依存します。既存のアプリケーションがこのテーマを使用する場合は、「レッド・ウッドまたは安定したテーマ」を使用するように変換し、CSS変数を使用してテーマをカスタマイズすることをお薦めします。

Oracle Visual Builder 22.10のサンプルSaaS R13 LightBlueテーマ更新は、最終的な計画更新です。

SaaS R13 LightBlueテーマを引き続き使用する既存のアプリケーションでは、Oracle Visual Builder 22.10を使用してアプリケーションを実行する前に更新を適用する必要があります。テーマをアップグレードするには、「GitHubのvbcs-samplesリポジトリ」から更新されたバージョンのOracle SaaS R13テーマ・ファイル(ApplicationsCloudUI-n.n.n.zip)をダウンロードし、更新されたテーマ・リソースをアプリケーションにインポートし、webアプリケーション設定エディタで更新されたテーマを選択します。アップグレード・ステップの詳細は、「Visual BuilderのサンプルR13 SaaS LightBlueテーマのアップグレード」を参照してください。

アプリケーション設定のテーマは切り替えられません

テーマのドロップダウン・リストが使用できないか、正しく動作していないため、アプリケーション・テーマをアップグレードできない場合があります。

この状況を実行する場合、回避方法はアプリケーションをアップグレードすることです:

アプリケーション・バージョンを次の上位バージョンにアップグレードします(たとえば、バージョン21.07から21.10へ)。
アプリケーション・テーマをアップグレードします。

テキスト・モジュールを使用してJSONをロードすると、永続性ツールキットの動作が停止

次のコード・スニペットに示すように、アプリケーションにJSONリソースを追加すると、Oracleオフライン永続性ツールキットの動作が停止します。

// Add resource
define([
  'text!resources2/js/test.json'
], function(

// Where resources2 is defined as:
  "requirejs": {
        "paths": {
            "resources2": "{{ location.pathname + (window.vbInitConfig.BASE_URL_TOKEN ? 
                          window.vbInitConfig.BASE_URL_TOKEN + '/' : '') + 'resources'}}"
        }
    },

アプリケーションがOracleオフライン永続性ツールキットをロードしようとすると、次のエラーが発生します。

Failed to load offline handler from /ic/builder/rt/otf/2.0/webApps/foo/
version_279023731935549663/app-flow.js: Error: importScripts failed for /ic/builder/rt/otf/2.0/
webApps/foo/version_279023731935549663/app-flow.js at /ic/builder/rt/otf/2.0/webApps/foo/versio
n_279023731935549663/app-flow.js
https://requirejs.org/docs/errors.html#importscripts

この問題に対処するには、次の2つの回避策があります:

JSONファイルをJavaScriptファイルでラップし、JavaScriptファイルをロードします。
フェッチAPIを使用して、JSONファイルをオフライン・ハンドラにロードします。

OAuthユーザー・アサーション認証タイプのIDCS REST APIへの接続のテスト中にエラーが発生しました

テスト・タブでOAuth 2ユーザー・アサーション認証タイプのIDCS REST APIを表すサービス接続をテストしても機能しません。その際、次のようなエラーが表示されます:

{
"type": "abcs://proxy_problem/oauth/design_allowed_scope",
"title": "Invalid URI",
"detail": "Cannot process \"https://<idcs>.identity.oraclecloud.com/admin/v1/Me\"",
"status": 400,
"o:errorDetails": [
{ "type": "abcs://proxy_problem/auth/scope/update", "title": "Invalid service scope",
      "detail": "Cannot process service scope \"urn:opc:idm:t.user.me\" in IDCS, for URI \"
{1}
\"",
"status": 400
}
]
}

この制限は、サービス・テスター(テスト・タブ)にのみ存在します。 webアプリケーションを作成してWebアプリケーションから同じREST APIをコールすると、問題は発生しません。

匿名アクセスを使用したプロセス関連処理の実行中にエラーが発生しました

プロセス関連タスクは匿名アクセスではサポートされていません。匿名アクセスを持つwebまたはモバイル・アプリケーションからプロセス関連タスク(プロセスの開始/タスクの実行など)にアクセスしようとすると、このエラーになる可能性があります。

{ "type": "vbcs://process_service_problem", "title": "Process Service Error", "detail": "Authorization failed.", "status": 500, "o:errorCode": "authorizationFailed" }

これは、手動で匿名アクセスを許可し、匿名アクセス資格証明をプロセス・アプリケーション・バックエンドに付与した場合でも発生します。

自己署名証明書を使用したサービス接続が動作していません

ステージング済または公開済のアプリケーションは、自己署名証明書でサービス接続を使用し、証明書が失効している場合、機能しなくなる可能性があります。 2020-09-01T00:00の後に発行されたすべての証明書: 00.00 Zは、発行された398日後に自動的に失効します。アプリケーションが2020-09-01T00:00: 00.00 Zより前に発行された証明書を使用する場合、証明書は失効しませんが、新しい証明書で更新する必要があります。

中断を回避するには、自己署名証明書が期限切れになる前に(6か月ごとなど)定期的に更新するように計画する必要があります。本番アプリケーションでは自己署名証明書を使用することはお薦めしません。

OICサービス接続で認証に失敗しました

OIC統合REST APIへのサービス接続を作成する際、OIC統合RESTサービス設定によって許可されていない認証メカニズムを選択すると、サービスへの接続が失敗することがあります。

サービスへの接続が401 HTTPエラー・コードで失敗した場合、VBサービス接続の認証設定がOIC Restトリガー・セキュリティ設定と一致するかどうかを確認します:

VBサービス接続が認証に"Oracle Cloud Account"またはOAuth 2.0メソッドのいずれかを使用する場合、対応するOIC RESTトリガーを"OAuth 2.0"または"OAuth 2.0 OR Basic"オプションで構成する必要があります。
VBサービス接続が認証に「基本」を使用する場合、対応するOIC RESTトリガーを「基本」または「OAuth 2.0 OR基本」オプションで構成する必要があります。

ビジネス・オブジェクト・リソース・エディタで新規ビジネス・オブジェクトが選択されていません

ビジネス・オブジェクトのインポート・ウィザードを使用してファイル(CSV、zip、xls)から新しいビジネス・オブジェクトを作成する場合、エンドポイント・タブでビジネス・オブジェクト・リソース・エディタを開いたときにビジネス・オブジェクトが選択されないことがありますが、エディタを開くと、使用可能な新しいビジネス・オブジェクトがデフォルトで選択されます。

ビジネス・オブジェクトがデフォルトで選択されていない場合:

ブラウザをリロードします。ブラウザを再ロードした後、ビジネス・オブジェクト・リソース・エディタでビジネス・オブジェクトを選択する必要があります。
公開するビジネス・オブジェクトを選択します。
デフォルトを適用をクリックし、保存をクリックします。

ビジネス・オブジェクト図をイメージとして保存する際の問題

ビジネス・オブジェクト図をイメージとして保存しようとすると、次の問題が発生する可能性があります:

図をPNGイメージとして保存することはできません。
ダイアグラムをSVGファイルとして保存する場合、ビジネス・オブジェクトのフィールド・タイプを表すアイコンは、保存されたイメージに正しく表示されません。すべてのアイコンが壊れたイメージとしてレンダリングされます。

フィールド・アイコンが変更されていないダイアグラムを保存するための回避策は、ズーム・イン/ズーム・アウト・ツールを使用してダイアグラム全体を表示し、スクリーン・キャプチャ・アプリケーションを使用してダイアグラムのスクリーン・ショットを取得することです。

REST APIを使用して新規レコードを作成すると、レスポンスが空になります

Visual Builderインスタンスが別のOracle DBを使用するように構成されている場合、REST APIを使用して表に新しいレコードを挿入すると、挿入が成功し、コールが予想されるステータス(HTTP 201)を返す場合でも、データを含まないレスポンスが表示されることがあります。

これは、ビジネス・オブジェクトに<column name> NUMBER GENERATED BY DEFAULT ON NULL AS IDENTITY ...として定義された主キー・フィールドがある場合に発生する可能性があります。

回避策は、次のステップを実行して、ビジネス・オブジェクトの主キー・フィールドを変更することです:

Visual Builderでアプリケーションを開きます。
変更するビジネス・オブジェクトを開きます。
「フィールド」タブを開きます。
主キー・フィールドを選択します。
「順序名」ドロップダウン・リストで、表に新規レコードを作成するためにデータベースで使用される適切な内部順序を選択します。
データベース・スキーマにアイデンティティ列を含む表が1つのみある場合は、選択する順序をクリアする必要があります(順序には内部参照名が含まれます)。アイデンティティ列を含む表が複数ある場合は、次の問合せを使用して、その列に対してデータベースが作成した順序を検索できます:

select data_default from SYS.user_tab_columns where table_name = <table name used by the BO> and column_name = <primary key field>;

「順序名」プロパティが正しい順序に設定されると、Visual Builderはレコードを表に挿入する前にその順序からnextvalを選択し、その値を主キー列で使用します。

アプリケーションの新規バージョンの作成中にエラーが発生しました

アプリケーションの旧バージョンが多すぎる場合は、エラーが表示されるか、新しいバージョンのアプリケーションの作成時に問題が発生する可能性があります。 Visual Builderは、アプリケーションのバージョンの合計数を100に制限します。これには、開発、ステージングおよび廃止バージョンが含まれます。制限を超えてしまうような新しいバージョンを作成することはできません。

アプリの新しいバージョンを公開するたびに、以前のバージョンは廃止されます。 Visual Builderホーム・ページでは、現在のバージョンの数の横にある「バージョン」列でアプリケーション・バージョンの合計数を確認できます。

廃止されたアプリケーション・バージョンを削除するには、まずごみ箱に移動してから、完全に削除する必要があります。詳細は、「ビジュアル・アプリケーションの削除」を参照してください。

サービス接続の作成ウィザードでセキュア・ヘッダー設定を無視

セキュア・ヘッダーで構成されたバックエンドを使用しており、バックエンドにサービス接続を作成すると、接続のテスト時にエラーが表示される場合があります。エンドポイントおよび仕様からサービス接続を作成するためのウィザードでは、セキュリティ・ヘッダーが無視され、接続が失敗する可能性があります。

回避策として、エンドポイントからのサービス接続の作成ウィザードでレスポンス例を作成して保存します:

エンドポイントからのサービス接続の作成ウィザードを開きます。
エンドポイントおよびその他の接続の詳細を入力します。
「レスポンス」タブを開きます。
「例」テキスト領域で、サンプル・レスポンス({"test" : "abc"}など)を入力し、「例の保存」をクリックします。これにより、例のスキーマが作成されます。
「作成」をクリックして、サービス接続を作成します。

エンドポイントへの接続をテストすると、接続が成功し、レスポンスを保存できます。実際のレスポンスを保存できるようになりました。これにより、サービス接続のレスポンス・スキーマが正しく更新されます。