始める前に
このチュートリアルでは、Oracle Visual Builder Add-in for Excelのインストール方法、RESTサービスからデータを取得するMicrosoft Excelワークブックの作成方法、およびビジネス・ユーザーがデータ入力タスクを実行できるようにワークブックを公開する方法を学習します。このチュートリアルを完了するのに要する時間は約10分です。
バックグラウンド
Oracle Visual Builder Add-in for Excelは、RESTサービスからExcelワークブックの表にデータをダウンロードするのに役立ちます。このブックでは、ユーザーが変更内容をサービスに戻す前にデータを変更、作成または削除できます。アドインをインストールしたら、サービスのエンドポイントを入力して、サービスからExcelワークブックにデータをダウンロードします。ダウンロードしたデータの管理に役立つコマンドを含む新しいOracle Visual Builderリボン・タブも表示されます。
必要事項
- Microsoft Excel 365またはその他のサポートされているバージョンがインストールされているWindows 10または11オペレーティング・システム
(Oracle Visual Builder Add-in for Excelを使用した統合スプレッドシートの開発のサポートされているプラットフォームを参照してください。)
- Oracle Visual Builderインスタンスへのアクセス
ノート:選択したRESTサービスを使用して、チュートリアルを完了できる場合があります。ターゲット・サービスのOpenAPIサービス・メタデータがあることを確認します(一部のOracleサービスでは、URLに
/describe
を追加してそのような説明を提供します)。このルートに移動すると、このチュートリアルの一部のステップがサービスで異なる場合があります。たとえば、ステップ1のサブステップ1から6はスキップできますが、アドインをインストールするにはサブステップ7と8を完了する必要があります。開始する前に、「ダウンロード」ページからインストーラをダウンロードします。
Oracle Visual Builder Add-in for Excelのインストール
- このファイルを右クリックし、コンピュータにダウンロードします。
Personnel_Manager.zip
ファイルには、Employeesビジネス・オブジェクトとサンプル・データを含むビジュアル・アプリケーションが含まれています。 - Webブラウザで、Oracle Visual Builderにサインインします。
- 「ビジュアル・アプリケーション」ページで、「インポート」、「ファイルからアプリケーション」の順に選択し、参照して
Personnel_Manager.zip
ファイルを選択します。「インポート」をクリックします。 - 「ビジュアル・アプリケーション」ページで、「名前」列の「Personnel Manager」をクリックします。
- 「ビジネス・オブジェクト」
をクリックし、「メニュー」
をクリックして「データ・マネージャ」を選択します。
図vb_data_manager.pngの説明 - 「データ・マネージャ」ページで、「Excelでのデータの編集」をクリックしてインストーラをダウンロードします。
ヒント: 「ダウンロード」ページで新しいバージョンを確認します。
- インストーラを実行する前にExcelを終了します。
- ダウンロードしたインストーラ・ファイルをダブルクリックしてインストールを開始し、アドインのインストール後に「次へ」、「閉じる」の順にクリックします。Oracle Visual Builder Add-in for Excelを使用した統合スプレッドシートの開発のOracle Visual Builder Add-in for Excelのインストールを参照してください。
正常にインストールされると、Excelでアドインが有効になり、Excelの起動時に新しいOracle Visual Builderタブが表示されます。
図excel-configure.pngの説明
RESTサービスからデータをダウンロードするためのExcelワークブックの構成
このステップでは、Excelワークブックに、インポートしたビジュアル・アプリケーションに関連付けられたRESTサービスから従業員データをダウンロードする表を作成します。
- Oracle Visual Builderの「ビジネス・オブジェクト」タブで、「従業員」、「エンドポイント」の順にクリックします。
- 「リソースAPI」を展開し、「クリップボード」アイコンをクリックして、メタデータ・リソースAPIのURL全体をコピーします。
図vb-URL-endpoint.pngの説明 employees-source.xlsx
という名前のExcelワークブックをコンピュータのディレクトリに作成して開きます。- データ表を検索するセルをクリックします。
- Excelワークブックの「Oracle Visual Builder」タブで、「デザイナ」をクリックして新規レイアウト設定ウィザードを起動します。
- ウィザードの最初の画面で、以前にコピーしたURLを「Webアドレス」フィールドに入力し、「次へ」をクリックします。
図vb_wizard_screen1.pngの説明 認証設定は「デフォルト」のままにします。
ノート:別のRESTサービスを使用している場合は、そのサービスのURLを入力し、URLに
/describe
を追加します。 - 「サインイン」ダイアログで、Oracle Visual Builderへのアクセスに使用するユーザー名とパスワードを入力し、「サインイン」をクリックします。
アドインはOracle Visual Builderインスタンスに接続し、サービス・メタデータを取得します。操作の結果は、ウィザードに表示されます。
- 「次へ」をクリックして次に進みます。
- 次の画面で、「従業員」を選択し、「次へ」をクリックします。
図vb_wizard_screen2.pngの説明 次の画面では、作成するレイアウトのタイプ(表またはフォーム・オーバー表)を選択するように求められます。
図vb_wizard_screen3.pngの説明 - 「表レイアウト」を選択し、「次へ」をクリックします。
次の画面では、1つ以上の依存レイアウトに追加のビジネス・オブジェクトを選択するように求められます。
図vb_wizard_screen4.pngの説明 - この画面は空白のままにして、「次へ」をクリックして続行します。
- 最後の画面で、新しいレイアウトの詳細を確認し、「終了」をクリックします。
Excelワークブックに新しい表が表示されます。列ヘッダーが表示され、ヘッダーの下にプレースホルダ・データ行があります。右側にレイアウト・デザイナも表示されます。
図excel-layout-designer.pngの説明 ノート: レイアウトのオリジン・セルが最初の10行にある場合、ヘッダー行は固定され、ワークシートで上下にスクロールすると常に列ヘッダーが表示されます。
- 「データのダウンロード」をクリックして、従業員ビジネス・オブジェクトが参照するデータをダウンロードします。
図excel-download-data-author.pngの説明
公開前のExcelワークブックの表のカスタマイズ
データ入力用に公開してユーザーに配布する前に、Excelワークブックでアドインが作成する表をカスタマイズできます。たとえば、従業員の名の前に[電子メール]カラムが表示されるように、カラムの順序を変更できます。検索問合せを追加して、サービスからダウンロードされるデータをフィルタすることもできます。たとえば、「従業員」ビジネス・オブジェクトから「給与」フィールドを検索フィールドとして追加すると、ユーザーは検索基準を入力して、その基準に一致する従業員のレコードのみをダウンロードできます。
- 「Oracle Visual Builder」タブで、必要に応じて「デザイナ」をクリックします。次に、レイアウト・デザイナで「列」タブをクリックします。
- 次に示すように、Eメール・エントリの左側に表示されるアイコンをドラッグ・アンド・ドロップして、列の順序を変更します。
ヒント:列を右クリックして、順序を変更するためのその他のオプションを表示します。
図excel-layout-designer02.pngの説明 ノート:「変更」、「ステータス」および「キー」列が自動的に生成されます。これらの列はカスタマイズまたは削除できません。
- 「ダウンロード」タブをクリックして、検索問合せを追加します。
- 「検索」の横にある「編集」アイコンをクリックします。
図excel_query_search.pngの説明 - 「使用可能なビジネス・オブジェクト」フィールド・エディタで「給与」を選択し、「OK」をクリックします。
- 検索エディタで、コンパレータ・リストで「より大きい」を選択し、値を空のままにします。
- 「ダウンロード時にエディタを有効にする」をクリアして、ダウンロード時に検索プロンプトの検索エディタ・コントロールが無効になっていることを確認します。
- 「OK」をクリックすると、検索設定が保存され、検索エディタが閉じます。
- 「データのダウンロード」をクリックします。
- 「検索」ダイアログ・ボックスで、
10000
と入力し、「OK」をクリックします。このアドインでは、給与が10,000を超える従業員のレコードのみがダウンロードされます。
図excel_query_search_download.pngの説明
Excelワークブックの公開およびユーザーへの配布
Excelワークブックを作成し、RESTサービスからデータをダウンロードするように構成したので、公開できます。このオプション・ステップは、データ入力のために他のユーザーに配布できるワークブックのコピーを作成する場合に便利です。また、設計ツール(デザイナ、レイアウトの削除および公開)を削除し、ワークシート保護を有効にすることもできます。ただし、ソースExcelワークブックを公開せずに配布できます。
- 「Oracle Visual Builder」タブで、「公開」をクリックします。
図excel-publish.pngの説明 - 「ワークブックの公開」ウィンドウで、ワークブックの場所とファイル名を受け入れます。元のワークブックの名前が
-source
で終わる場合(この例ではemployees-source.xlsx
)、アドインは-source
なしで同じ名前を提供します。図excel-publish-workbook.pngの説明 - 「各カタログからサービス・ホストを削除」チェック・ボックスの選択を解除しますが、他の公開オプションは変更しません。
- 「公開」をクリックします。Oracle Visual Builder Add-in for Excelを使用した統合スプレッドシートの開発の統合Excelワークブックの公開を参照してください。
「ステータス」ペインに確認が表示されます。
図excel-publishworkbook.pngの説明 - Excelワークブックの公開に使用したソースExcelワークブックを保存して閉じます。
公開されたワークブックを他のユーザーに配布してデータを入力できるようになりました。各ユーザーには、Excelワークブックの作成時に入力したRESTサービスへのアクセスを可能にするユーザー名とパスワードが必要です。
このチュートリアルの次のステップでは、ユーザーが公開したExcelワークブックを使用してデータ入力タスクを完了する方法を示します。
公開済Excelワークブックでのデータの作成、読取り、更新および削除
公開したExcelワークブックのコピーを受け取るビジネス・ユーザーは、RESTサービスからデータをダウンロードするためにアドインをインストールする必要があります。(「ダウンロード」ページからインストーラを直接ダウンロードできます。)アドインをインストールすると、サービスに変更をアップロードする前に、ワークブックでダウンロードしたデータを作成、読取り、更新および削除できます。
- 保存先のディレクトリから、公開されたExcelワークブックを開きます。
図excel-publish-user.pngの説明 「デザイン」セクションは「Oracle Visual Builder」タブに表示されません。これは、ワークブック開発者としてアクセスできる「デザイナ」、「レイアウトの削除」および「公開」コマンドに公開済ワークブックのユーザーがアクセスできないようにするためです。Excelワークブックを公開するときにすべてのレイアウトをクリアすることを選択したため、表には列ヘッダーが表示されますが、データは表示されません。
- 「データのダウンロード」をクリックして、ワークブックが取得するように構成されているデータをダウンロードします。
- 「サインイン」ダイアログにユーザー名とパスワードを入力し、「OK」をクリックします。
- 従業員の給与に基づいてデータのダウンロードを制限するように検索問合せを設定するため、問合せの値を入力するよう求められます。値は空のままにして、「OK」をクリックします。
アドインは、すべての従業員データをダウンロードします。
図excel-publish-crud1.pngの説明 - 次の変更を加えます。
- 行1で、
Sophia
をSophie
に変更します。 - セルG2をクリックし、値リストから「マネージャ」を選択して、Dave Brownのジョブ・タイトルを変更します。
- John Sieve (行4)の行を選択します。たとえば、自分のEメール・アドレスをクリックします。「Oracle Visual Builder」タブで、「表の行の変更」をクリックし、「削除のマーク」をクリックします。
- 行5全体を選択し、右クリックして、コンテキスト・メニューから「挿入」を選択します。新しく挿入された行について、次のデータを入力します。Eメール=
jmcgahern@example.com
、名=John
、姓=McGahern
、採用日=2018-01-30
、役職=Accountant
、給与=19,000
、部門=Accounting
。ノート:表に新しい行を追加するもう1つの方法は、表内で最後にダウンロードした行のすぐ下にある行を選択し、「表の行の変更」および「行の挿入」をクリックすることです。アドインによって表内に新しい行が作成され、編集できます。
- 表の最後にあるKen Sterの行(行102)を選択します。たとえば、Eメール・アドレスを選択します。「Oracle Visual Builder」タブで、「表の行の変更」をクリックし、「削除のマーク」をクリックします。
これらの変更を行うと、表は次の図のようになります。つまり、変更を行った行ごとに、
Update
、Delete
またはCreate
メッセージが「変更済」列に表示されます。図excel-publish-crud2.pngの説明
- 行1で、
- 「Oracle Visual Builder」タブで、「変更のアップロード」をクリックします。
表に保留中の削除があることを示すメッセージが表示されたら、「はい」をクリックして確認します。アップロードが完了すると、表によって「ステータス」列がリフレッシュされ、アップロードされた各変更行の変更が説明されます。
作成した新しい行により、コレクションにJohn McGahernの新しいレコードが作成されます。
削除用にマークした行(John SieveおよびKen Sterのレコード)は、RESTサービスによってコレクションから削除されたため表示されなくなりました。
図excel-publish-crud3.pngの説明 ノート: すべてのデータは、RESTサービスにアップロードする前に検証されます。エラーが発生した場合は、いつでもエラーを修正し、変更を再度アップロードできます。たとえば、行の更新と削除が成功したが行の作成が失敗した場合など、部分的なエラーが発生した場合は、失敗した作成行のデータのみを修正する必要があります。
Excelワークブックへの変更が正常にアップロードされたことを確認するには、ビジュアル・アプリケーションの「ビジネス・オブジェクト」ページの「データ」タブに移動します。図excel-publish-crud3-web.pngの説明
さらに学習しますか。
- Oracle Visual Builder Add-in for Excelを使用した統合スプレッドシートの開発のOracle Visual Builder Add-in for Excelの概要
- Oracle Visual Builder Add-in for Excelを使用した統合スプレッドシートの開発のダウンロード用の検索オプションの構成
- Oracle Visual Builder Add-in for Excelを使用したデータの管理このガイドは、ビジネス・ユーザーが統合ワークブックを使用して成功するのに役立ちます。