10 統合Excelワークブックの外観
Oracle Visual Builder Add-in for Excelでは、組込みスタイルおよびデータ・フォーマット・タイプを使用して、統合Excelワークブックの外観が自動的に管理されます。
アドインは、ワークブックが最初に初期化されたときに一連の名前付きExcelスタイルを作成することで、ワークブック内のセルを自動的にフォーマットします。 アドインによって作成されるスタイルは、Oracle Alta UI標準およびOracleアクセシビリティ・ガイドラインと一貫性があります。 スタイルのフォーマット部分は、Windowsリージョン設定で定義されているユーザー・プリファレンスに依存します。 したがって、米国のユーザーには米国の日付が表示され、フランス語のユーザーにはフランス語の日付が表示されます。
スタイルが初期化されると、アドインは、フィールド・プロパティに従って、(データ・ダウンロード時などに)キー・ポイントでこれらのスタイルを統合セルに適用します。 通常、スタイルはワークブックに対して一度作成され、更新されることはありませんが、この章で説明するオプションを利用できます。
ワークブック・スタイルのリセット
新しいアドイン・バージョンでスタイル定義が更新され、古いワークブックでそれらのスタイルを使用する場合、またはユーザーがワークブックのスタイル定義を変更して現在の定義に戻す場合は、Excelワークブックのスタイルをリセットするオプションがあります。
ワークブック内のスタイル定義をリセットするには、詳細メニューから「スタイルのリセット」を選択します。
ノート:
「スタイルのリセット」コマンドは、デザイナ・ツールが有効になっている場合にのみ使用できます。
「図reset-styles.pngの説明」
確認を求められます。 確認後、アドインで使用される各スタイル定義が更新されます。 スタイルのリストには、現在のアドインによって作成されるスタイル(標準スタイルを含む)が含まれます。
フィールド・フォーマットの選択
Excelワークブックのセル・フォーマットは、フィールドのデータ型およびフィールドが編集可能かどうか(作成または更新)に基づいてアドインによって適用されます。 この動作はほとんどのシナリオで機能しますが、場合によってはフィールド書式設定オプションを拡張する必要があります。
IDフィールドと給与フィールド(どちらも整数)を含む従業員ワークブックの例を考えてみましょう。 給与フィールドの値10,000は、千単位のセパレータ(10,000対10000)で書式設定できます。 ただし、ID値が12300の場合、千単位の区切り文字(12,300)は奇数と思われます。 この場合、IDフィールドのデフォルト・フォーマットをオーバーライドして、千単位のセパレータのないフォーマットを選択できます。
- 「レイアウト・デザイナの列」タブで、更新するフィールドを選択し、編集アイコンをクリックします。
- 表示されるビジネス・オブジェクト・フィールド・エディタで、「フォーマット」ドロップダウンのオプションを選択します。 デフォルト値は
Defaultで、オーバーライドせずに通常の自動スタイルを適用するようアドインに指示します。表示される書式タイプは、フィールド・データ型に適したものに基づいていることに注意してください。 この従業員ワークブックのイメージでは、IDフィールドは整数データ型を使用し、使用可能なオプションを使用して、千単位のセパレータを使用するかどうかにかかわらずIDを書式設定できます。 このオプションは、Windowsリージョンの設定で定義されているユーザー・プリファレンスにも従うため、米国のユーザーには小数点(π= 3.14)が表示され、フランス語のユーザーには小数カンマ(π= 3,14)が表示されます。
「図field_format.pngの説明」 - 「完了」をクリックします。
- 「データのダウンロード」をクリックして変更を処理します。
ビジネス・オブジェクト・フィールドのデフォルト値の設定
ビジネス・ユーザーが新しい行を作成するときに、セルの値がこの値になるように、フィールドにデフォルト値を設定できます。 統合ワークブックにデフォルト値を構成すると、事前に設定された値をセルに自動的に移入することで、ビジネス・ユーザーの時間を節約できます。
販売オーダー・ビジネス・オブジェクトの表レイアウトを備えた統合ワークブックについて考えてみます。 このビジネス・オブジェクトには、販売オーダーが送信されたかどうかを示すブール・フィールド"SubmittedFlag"が含まれる場合があります。 新しいオーダー書はまだ送信されないため、Oracle Visual Builder Add-in for ExcelがSubmittedFlagセルに"False"という値で新しい行を作成することは理にかなっています。
営業担当が多数の受注を追加する必要がある場合、初期値を"False"にすると、多くの時間を節約できます。
整数、10進数、ブールおよび文字列のデータ型を持つビジネス・オブジェクト・フィールドのデフォルト値を設定できます。 デフォルト値には、定数または式を指定できます。 式は、アドインの式ルール、特にエスケープ({ })およびリテラル値ルールに従う必要があります。 予約語はサポートされていません。 「式について」を参照してください。
ノート:
この機能は、他のフィールド(カスタム処理ペイロード・フィールド、行ファインダ変数、値リスト・フィールド、祖先列フィールドなど)およびデータ型(日付/日時およびオブジェクト)には使用できません。ビジネス・オブジェクト・フィールドのデフォルト値を設定するには、目的のフィールドのビジネス・オブジェクト・フィールド・エディタを開き、「デフォルト値」フィールドに値を入力します。
この図は、ブール・フィールド"SubmittedFlag"のビジネス・オブジェクト・フィールド・エディタを示しています:
ノート:
デフォルト値は、構成済フィールドのデータ型と一致する必要があります。 たとえば、ブール・フィールドのデフォルト値は、"True"または"False"のいずれかである必要があります。
ワークブックへのヘルプ・テキストの追加
ワークブック内のフォームおよび表で使用するビジネス・オブジェクト・フィールドのヘルプ・テキストを追加して、ビジネス・ユーザーにヘルプを提供できます。 ユーザーがレイアウトでフォーム・フィールドまたは列ヘッダーを選択すると、このヘルプのポップアップが表示されます。
ヘルプを次に追加することもできます:
- カスタム処理
- カスタム・アクション・ペイロード・フィールド
- 行検索
- 行検索変数
そのフィールドのエディタを使用して、個々のフィールドのヘルプ・テキストを追加できます。 サービス説明ドキュメントに含まれている説明を関連するヘルプ・テキスト・プロパティにコピーすることもできます。 説明をヘルプ・テキストにコピーするステップは、「説明をヘルプ・テキストにコピー」を参照してください。
個々のフィールドのヘルプ・テキストを追加するには、次のように、フィールドのエディタを開き、一般タブのヘルプ・テキストフィールドにヘルプ・テキストを入力します:
「ヘルプ・テキスト」値および「タイトル」値をローカライズできます。 「ワークブック翻訳の管理」を参照してください。
構成すると、ユーザーがレイアウトでフォーム・フィールド・ラベルまたは表の列ヘッダーを選択すると、ビジネス・オブジェクトおよび品目レベルのカスタム処理ペイロード・フィールドのヘルプ・テキストが表示されます。
カスタム・アクションおよびビジネス・オブジェクト・レベルのペイロード・フィールドのヘルプ・テキストは、カスタム・アクションの「説明」フィールド、またはペイロード・フィールドの上にマウスを置くとポップアップで、カスタム・アクション・ウィザードに表示されます。 行ファインダおよび変数のヘルプ・テキストは、ファインダまたは変数ラベルの上にカーソルを置くと検索エディタに表示されます。
説明をヘルプ・テキストにコピー
必要に応じて、「説明」プロパティの値を特定のカタログの「ヘルプ・テキスト」プロパティにコピーできます。
Oracle Visual Builder Add-in for Excelは、カタログを作成するときに、サービスのメタデータから説明を収集し、ビジネス・オブジェクト・フィールド、カスタム・アクションとそのペイロード・フィールド、行ファインダとその変数などの様々な要素の説明プロパティを移入できます。
これらの説明は、本質的に技術的で、ビジネス・ユーザーには適していない場合があります。 その結果、これらの説明はビジネス・ユーザーには表示されず、"localizable"ではありません。
OpenAPI3では、"help text"に対応するプロパティは指定されません。 さらに、サポートされているどのRESTフレームワークも、たとえばxヒントを使用したヘルプ・テキストまたは"tooltips"を提供していません。 その結果、新しいカタログの「ヘルプ・テキスト」プロパティは空になります。
RESTサービスがメタデータにビジネス・ユーザー・フレンドリな説明を提供している場合は、これらの値をヘルプ・テキスト・プロパティに1回でコピーできます。
開始する前に、結果が気に入らない場合に備えて、ソース・ワークブックのバックアップ・コピーを作成します。
カタログの説明をヘルプ・テキストのプロパティにコピーするには:
- 「メニュー」アイコン(
)をクリックし、ポップアップ・メニューから「説明をヘルプ・テキストにコピー」を選択します。
説明をコピーし、ヘルプ・テキストの値を適切に調整したら、これらのテキスト文字列を他の言語に翻訳することを検討できます。 「ワークブック翻訳の管理」を参照してください。