Oracle by ExampleブランドRESTサービスからデータを管理するための統合Excelワークブックの作成

セクション0始める前に

このチュートリアルでは、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を完了する必要があります。開始する前に、「ダウンロード」ページからインストーラをダウンロードします。


セクション1Oracle Visual Builder Add-in for Excelのインストール

  1. このファイルを右クリックし、コンピュータにダウンロードします。

    Personnel_Manager.zipファイルには、Employeesビジネス・オブジェクトとサンプル・データを含むビジュアル・アプリケーションが含まれています。

  2. Webブラウザで、Oracle Visual Builderにサインインします。
  3. 「ビジュアル・アプリケーション」ページで、「インポート」「ファイルからアプリケーション」の順に選択し、参照してPersonnel_Manager.zip ファイルを選択します。「インポート」をクリックします。
  4. 「ビジュアル・アプリケーション」ページで、「名前」列の「Personnel Manager」をクリックします。
  5. 「ビジネス・オブジェクト」 「ビジネス・オブジェクト」アイコンをクリックし、「メニュー」 メニュー・アイコンをクリックして「データ・マネージャ」を選択します。
    「データ・マネージャ」メニュー項目
    図vb_data_manager.pngの説明
  6. 「データ・マネージャ」ページで、「Excelでのデータの編集」をクリックしてインストーラをダウンロードします。

    ヒント: 「ダウンロード」ページで新しいバージョンを確認します。

  7. インストーラを実行する前にExcelを終了します。
  8. ダウンロードしたインストーラ・ファイルをダブルクリックしてインストールを開始し、アドインのインストール後に「次へ」「閉じる」の順にクリックします。Oracle Visual Builder Add-in for Excelを使用した統合スプレッドシートの開発Oracle Visual Builder Add-in for Excelのインストールを参照してください。

    正常にインストールされると、Excelでアドインが有効になり、Excelの起動時に新しいOracle Visual Builderタブが表示されます。

    アドインのインストール後にExcelに表示される「Oracle Visual Builder」タブ
    図excel-configure.pngの説明

セクション2RESTサービスからデータをダウンロードするためのExcelワークブックの構成

このステップでは、Excelワークブックに、インポートしたビジュアル・アプリケーションに関連付けられたRESTサービスから従業員データをダウンロードする表を作成します。

  1. Oracle Visual Builderの「ビジネス・オブジェクト」タブで、「従業員」「エンドポイント」の順にクリックします。
  2. 「リソースAPI」を展開し、「クリップボード」アイコンをクリックして、メタデータ・リソースAPIのURL全体をコピーします。
    Oracle Visual BuilderでコピーするメタデータURL
    図vb-URL-endpoint.pngの説明
  3. employees-source.xlsxという名前のExcelワークブックをコンピュータのディレクトリに作成して開きます。
  4. データ表を検索するセルをクリックします。
  5. Excelワークブックの「Oracle Visual Builder」タブで、「デザイナ」をクリックして新規レイアウト設定ウィザードを起動します。
  6. ウィザードの最初の画面で、以前にコピーしたURLを「Webアドレス」フィールドに入力し、「次へ」をクリックします。
    新規レイアウト設定ウィザードの最初の画面
    図vb_wizard_screen1.pngの説明

    認証設定は「デフォルト」のままにします。

    ノート:別のRESTサービスを使用している場合は、そのサービスのURLを入力し、URLに/describeを追加します。

  7. 「サインイン」ダイアログで、Oracle Visual Builderへのアクセスに使用するユーザー名とパスワードを入力し、「サインイン」をクリックします。

    アドインはOracle Visual Builderインスタンスに接続し、サービス・メタデータを取得します。操作の結果は、ウィザードに表示されます。

  8. 「次へ」をクリックして次に進みます。
  9. 次の画面で、「従業員」を選択し、「次へ」をクリックします。
    新規レイアウト設定ウィザードの3番目の画面
    図vb_wizard_screen2.pngの説明

    次の画面では、作成するレイアウトのタイプ(表またはフォーム・オーバー表)を選択するように求められます。

    新規レイアウト設定ウィザードの4番目の画面
    図vb_wizard_screen3.pngの説明

  10. 「表レイアウト」を選択し、「次へ」をクリックします。

    次の画面では、1つ以上の依存レイアウトに追加のビジネス・オブジェクトを選択するように求められます。

    新規レイアウト設定ウィザードの5番目の画面
    図vb_wizard_screen4.pngの説明

  11. この画面は空白のままにして、「次へ」をクリックして続行します。
  12. 最後の画面で、新しいレイアウトの詳細を確認し、「終了」をクリックします。

    Excelワークブックに新しい表が表示されます。列ヘッダーが表示され、ヘッダーの下にプレースホルダ・データ行があります。右側にレイアウト・デザイナも表示されます。

    データのダウンロード元のビジネス・オブジェクトを指定した後にExcelワークブックに表示されるデータ表およびレイアウト・デザイナ。
    図excel-layout-designer.pngの説明

    ノート: レイアウトのオリジン・セルが最初の10行にある場合、ヘッダー行は固定され、ワークシートで上下にスクロールすると常に列ヘッダーが表示されます。

  13. 「データのダウンロード」をクリックして、従業員ビジネス・オブジェクトが参照するデータをダウンロードします。
    画像は、ExcelワークブックのOracle VBCSタブおよび初期データ表を示しています。
    図excel-download-data-author.pngの説明

セクション3公開前のExcelワークブックの表のカスタマイズ

データ入力用に公開してユーザーに配布する前に、Excelワークブックでアドインが作成する表をカスタマイズできます。たとえば、従業員の名の前に[電子メール]カラムが表示されるように、カラムの順序を変更できます。検索問合せを追加して、サービスからダウンロードされるデータをフィルタすることもできます。たとえば、「従業員」ビジネス・オブジェクトから「給与」フィールドを検索フィールドとして追加すると、ユーザーは検索基準を入力して、その基準に一致する従業員のレコードのみをダウンロードできます。

  1. 「Oracle Visual Builder」タブで、必要に応じて「デザイナ」をクリックします。次に、レイアウト・デザイナで「列」タブをクリックします。
  2. 次に示すように、Eメール・エントリの左側に表示されるアイコンをドラッグ・アンド・ドロップして、列の順序を変更します。

    ヒント:列を右クリックして、順序を変更するためのその他のオプションを表示します。

    画像は、Excelワークブックの初期データ表と、データ表を構成するレイアウト・デザイナを示しています。
    図excel-layout-designer02.pngの説明

    ノート:「変更」、「ステータス」および「キー」列が自動的に生成されます。これらの列はカスタマイズまたは削除できません。

  3. 「ダウンロード」タブをクリックして、検索問合せを追加します。
  4. 「検索」の横にある「編集」アイコンをクリックします。
    この図は、「編集」アイコンにフォーカスがあるレイアウト・デザイナの「問合せ」タブを示しています。
    図excel_query_search.pngの説明
  5. 「使用可能なビジネス・オブジェクト」フィールド・エディタで「給与」を選択し、「OK」をクリックします。
  6. 検索エディタで、コンパレータ・リストで「より大きい」を選択し、値を空のままにします。
  7. 「ダウンロード時にエディタを有効にする」をクリアして、ダウンロード時に検索プロンプトの検索エディタ・コントロールが無効になっていることを確認します。
  8. OK」をクリックすると、検索設定が保存され、検索エディタが閉じます。
  9. 「データのダウンロード」をクリックします。
  10. 「検索」ダイアログ・ボックスで、10000と入力し、「OK」をクリックします。

    このアドインでは、給与が10,000を超える従業員のレコードのみがダウンロードされます。

    この図は、「編集」アイコンにフォーカスがあるレイアウト・デザイナの「問合せ」タブを示しています。
    図excel_query_search_download.pngの説明

セクション4Excelワークブックの公開およびユーザーへの配布

Excelワークブックを作成し、RESTサービスからデータをダウンロードするように構成したので、公開できます。このオプション・ステップは、データ入力のために他のユーザーに配布できるワークブックのコピーを作成する場合に便利です。また、設計ツール(デザイナ、レイアウトの削除および公開)を削除し、ワークシート保護を有効にすることもできます。ただし、ソースExcelワークブックを公開せずに配布できます。

  1. 「Oracle Visual Builder」タブで、「公開」をクリックします。
    この図は、「公開」コマンドにフォーカスがあるOracle Visual Builderタブを示しています。
    図excel-publish.pngの説明
  2. 「ワークブックの公開」ウィンドウで、ワークブックの場所とファイル名を受け入れます。元のワークブックの名前が-sourceで終わる場合(この例ではemployees-source.xlsx)、アドインは-sourceなしで同じ名前を提供します。
    この図は、「ワークブックの公開」ダイアログを示しています。
    図excel-publish-workbook.pngの説明
  3. 「各カタログからサービス・ホストを削除」チェック・ボックスの選択を解除しますが、他の公開オプションは変更しません。
  4. 「公開」をクリックします。Oracle Visual Builder Add-in for Excelを使用した統合スプレッドシートの開発統合Excelワークブックの公開を参照してください。

    「ステータス」ペインに確認が表示されます。

    ワークブックが正常に公開されたことを示すメッセージが表示された「ワークブックの情報の公開」ダイアログ。
    図excel-publishworkbook.pngの説明
  5. Excelワークブックの公開に使用したソースExcelワークブックを保存して閉じます。

    公開されたワークブックを他のユーザーに配布してデータを入力できるようになりました。各ユーザーには、Excelワークブックの作成時に入力したRESTサービスへのアクセスを可能にするユーザー名とパスワードが必要です。

    このチュートリアルの次のステップでは、ユーザーが公開したExcelワークブックを使用してデータ入力タスクを完了する方法を示します。


セクション5公開済Excelワークブックでのデータの作成、読取り、更新および削除

公開したExcelワークブックのコピーを受け取るビジネス・ユーザーは、RESTサービスからデータをダウンロードするためにアドインをインストールする必要があります。(「ダウンロード」ページからインストーラを直接ダウンロードできます。)アドインをインストールすると、サービスに変更をアップロードする前に、ワークブックでダウンロードしたデータを作成、読取り、更新および削除できます。

  1. 保存先のディレクトリから、公開されたExcelワークブックを開きます。
    アドインを使用するように構成されているExcelワークブックを表示します。
    図excel-publish-user.pngの説明

    「デザイン」セクションは「Oracle Visual Builder」タブに表示されません。これは、ワークブック開発者としてアクセスできる「デザイナ」「レイアウトの削除」および「公開」コマンドに公開済ワークブックのユーザーがアクセスできないようにするためです。Excelワークブックを公開するときにすべてのレイアウトをクリアすることを選択したため、表には列ヘッダーが表示されますが、データは表示されません。

  2. 「データのダウンロード」をクリックして、ワークブックが取得するように構成されているデータをダウンロードします。
  3. 「サインイン」ダイアログにユーザー名とパスワードを入力し、「OK」をクリックします。
  4. 従業員の給与に基づいてデータのダウンロードを制限するように検索問合せを設定するため、問合せの値を入力するよう求められます。値は空のままにして、「OK」をクリックします。

    アドインは、すべての従業員データをダウンロードします。

    Excelワークブックに、名前、Eメール、部門、入社日などの従業員データを含むデータ表が表示されます。
    図excel-publish-crud1.pngの説明
  5. 次の変更を加えます。
    • 行1で、SophiaSophieに変更します。
    • セル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」タブで、「表の行の変更」をクリックし、「削除のマーク」をクリックします。

      これらの変更を行うと、表は次の図のようになります。つまり、変更を行った行ごとに、UpdateDeleteまたはCreateメッセージが「変更済」列に表示されます。

      名前、Eメール、部門、入社日などの従業員データを含むExcelワークブック内のデータ表。
      図excel-publish-crud2.pngの説明
  6. 「Oracle Visual Builder」タブで、「変更のアップロード」をクリックします。

    表に保留中の削除があることを示すメッセージが表示されたら、「はい」をクリックして確認します。アップロードが完了すると、表によって「ステータス」列がリフレッシュされ、アップロードされた各変更行の変更が説明されます。

    作成した新しい行により、コレクションにJohn McGahernの新しいレコードが作成されます。

    削除用にマークした行(John SieveおよびKen Sterのレコード)は、RESTサービスによってコレクションから削除されたため表示されなくなりました。

    名前、Eメール、部門、入社日などの従業員データを含むExcelワークブック内のデータ表。
    図excel-publish-crud3.pngの説明

    ノート: すべてのデータは、RESTサービスにアップロードする前に検証されます。エラーが発生した場合は、いつでもエラーを修正し、変更を再度アップロードできます。たとえば、行の更新と削除が成功したが行の作成が失敗した場合など、部分的なエラーが発生した場合は、失敗した作成行のデータのみを修正する必要があります。

    Excelワークブックへの変更が正常にアップロードされたことを確認するには、ビジュアル・アプリケーションの「ビジネス・オブジェクト」ページの「データ」タブに移動します。
    名前、Eメール、部門、入社日などの従業員データを含むExcelワークブック内のデータ表。
    図excel-publish-crud3-web.pngの説明

詳細情報さらに学習しますか。