Before You Begin - 開始之前

在本教學課程中，您將瞭解如何安裝 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

1. 在此檔案上按一下滑鼠右鍵，然後下載至您的電腦。

   Personnel_Manager.zip 檔案包含具有 Employee 業務物件和範例資料的視覺應用程式。

2. 在 Web 瀏覽器中，登入 Oracle Visual Builder。
3. 在「視覺應用程式」頁面上，按一下匯入，然後選取檔案中的應用程式，然後瀏覽以選取 Personnel_Manager.zip 檔案。按一下匯入。
4. 在「視覺應用程式」頁面上，按一下「名稱」資料欄中的人事經理。
5. 按一下商業物件 ，然後按一下功能表 ，然後選取資料管理員。

   

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 工作簿以從 REST 服務下載資料

在此步驟中，您將會在 Excel 工作簿中建立一個表格，從與您剛匯入之視覺化應用程式關聯的 REST 服務下載員工資料。

1. 在 Oracle Visual Builder 的業務物件頁籤中，按一下員工，然後按一下端點。
2. 展開資源 API ，然後按一下「剪貼簿」圖示，即可複製描述資料資源 API 的整個 URL：

   

3. 在電腦的目錄中建立名為 employees-source.xlsx 的 Excel 工作簿，然後開啟它。
4. 按一下您要尋找資料表的儲存格。
5. 在 Excel 工作簿的 Oracle Visual Builder 頁籤中，按一下設計工具以啟動「新建版面配置設定」精靈。
6. 在精靈的第一個畫面中，輸入先前在「網址」欄位中複製的 URL，然後按一下下一步。

   

   將認證設定保留為「預設」。

   注意：如果您使用其他 REST 服務，請輸入該服務的 URL，並將 /describe 附加至 URL。

7. 在「登入」對話方塊中，輸入用來存取 Oracle Visual Builder 的使用者名稱和密碼，然後按一下登入。

   增益集會連線至您的 Oracle Visual Builder 執行處理，並擷取服務描述資料。作業的結果會顯示在精靈中。

8. 按一下下一步 (Next) 繼續。
9. 在下一個畫面中，選取員工，然後按一下下一步。

   

   下一個畫面會提示您選擇要建立的版面配置類型：「表格」或「表格置換」表格。

   

10. 選取表格版面配置，然後按下一步。

    下一個畫面會提示您為一或多個相依版面配置選擇其他業務物件。

    

11. 將此畫面留白，然後按一下下一步繼續。
12. 在最後一個畫面中，確認新版面配置的詳細資訊，然後按一下完成。

    Excel 工作簿中會顯示新表格。會顯示資料欄標頭，並在標頭下方顯示預留位置資料列。您也會看到右側的「版面配置設計工具」。

    

    注意：如果版面配置的來源儲存格位於前 10 個資料列中，則標頭資料列會凍結，讓您在工作表中向上或向下捲動時，永遠看到資料欄標頭。

13. 按一下下載資料以下載 Employee 業務物件參照的資料。

    圖解描述

公布前自訂 Excel 工作簿中的表格

您可以先自訂增益集在 Excel 工作簿中建立的表格，再將它發佈給使用者以輸入資料。例如，您可能想要變更欄的順序，讓「電子郵件」欄顯示在員工名字之前。您也可以新增搜尋查詢來篩選從服務下載的資料。例如，您可以將「員工」業務物件的「薪資」欄位新增為搜尋欄位，讓使用者輸入搜尋準則，使其僅下載符合該準則的員工記錄。

1. 在 Oracle Visual Builder 頁籤中，視需要按一下設計工具。然後按一下「版面配置設計工具」中的資料欄頁籤。
2. 拖放電子郵件項目左側顯示的圖示來重新排列資料欄，如下所示：

   提示：在資料欄上按一下滑鼠右鍵，即可查看更多重新排序的選項。

   

   注意：系統會自動產生「變更」、「狀態」和「索引鍵」資料欄。您無法自訂或移除這些資料欄。

3. 按一下下載頁籤，即可新增搜尋查詢。
4. 按一下「搜尋」旁邊的「編輯」圖示。

   

5. 在「可用的商業物件欄位編輯器」中選取薪資，然後按一下確定。
6. 在「搜尋編輯器」中，選取比較運算子清單中的大於，並將值保留空白。
7. 清除下載時啟用編輯器，以確保下載時會停用「搜尋」提示中的搜尋編輯器控制項。
8. 按一下確定，儲存搜尋設定值並關閉「搜尋編輯器」。
9. 按一下下載資料。
10. 在「搜尋」對話方塊中，輸入 10000，然後按一下確定。

    增益集只會下載薪資超過 10,000 的員工記錄。

    

發布 Excel 工作簿並將其分送給使用者

現在您已建立 Excel 工作簿並將其設定為從 REST 服務下載資料，您可能想要發布該工作簿。如果您要建立工作簿的複本，而您可以將該複本分送給其他使用者來輸入資料，此選擇性步驟非常實用。它還可讓您移除設計工具 (「設計工具」、「刪除配置」和「發佈」) 並開啟工作表保護。也就是說，您可以分送來源 Excel 工作簿而不進行公布。

1. 在 Oracle Visual Builder 頁籤中，按一下發布。

   

2. 在「發佈工作簿」視窗中，接受工作簿的位置和檔案名稱。當原始工作簿的名稱以 -source 結尾時 (如範例 employees-source.xlsx)，增益集會提供相同的名稱，但不會提供 -source。

   

3. 清除從每個目錄移除服務主機核取方塊，但讓其他發佈選項維持不變。
4. 按一下發布。請參閱使用 Oracle Visual Builder Add-in for Excel 開發整合的試算表中的發佈整合的 Excel 工作簿。

   「狀態」窗格中會顯示確認。

   

5. 儲存並關閉您用來發布 Excel 工作簿的來源 Excel 工作簿。

   現在，您可以將已發布的工作簿分送給其他使用者以輸入資料。每個使用者都必須要有使用者名稱和密碼，才能存取您在建立 Excel 工作簿時輸入的 REST 服務。

   本教學課程的下一個步驟顯示使用者如何使用剛剛公布的 Excel 工作簿完成資料輸入工作。

在公布的 Excel 工作簿中建立、讀取、更新及刪除資料

接收您發布之 Excel 工作簿副本的業務使用者必須安裝增益集，才能從 REST 服務下載資料。(他們可以直接從下載項目頁面下載安裝程式。)安裝增益集之後，他們就可以在將變更上傳至服務之前，先在工作簿中建立、讀取、更新及刪除下載的資料。

1. 從您儲存的目錄開啟已發佈的 Excel 工作簿。

   

   「設計」區段不會顯示在 Oracle Visual Builder 頁籤中，因為您已停用「設計」工具，讓已發布工作簿的使用者無法存取設計工具、刪除版面配置及公布命令 (作為工作簿開發人員)。表格會顯示資料欄標頭，但不會顯示資料，因為您選擇在發布 Excel 工作簿時清除所有版面配置。

2. 按一下下載資料，即可下載工作簿設定為擷取的資料。
3. 在「登入」對話方塊中輸入使用者名稱和密碼，並按一下確定。
4. 由於您設定搜尋查詢以根據員工薪資來限制資料下載，因此系統會提示您輸入查詢值。將值保留空白，然後按一下確定。

   增益集會下載所有員工資料。

   

5. 進行下列變更：
   • 在第 1 列中，將 Sophia 變更為 Sophie。
   • 按一下儲存格 G2，然後從值清單中選取管理員，以變更 Dave Brown 的職稱。
   • 選取 John Sieve (Row 4) 的列，例如按一下他的電子郵件地址 。在 Oracle Visual Builder 頁籤中，按一下表格資料列變更，然後按一下標示為刪除。
   • 選取整個資料列 5，按一下滑鼠右鍵，然後從相關內容功能表中選擇插入。為新插入的資料列輸入此資料：電子郵件 = jmcgahern@example.com、名字 = John、姓氏 = McGahern、僱用日期 = 2018-01-30、職稱 = Accountant、薪資 = 19,000，以及部門 = Accounting。

     注意：在表格中新增資料列的另一種方式是選取緊接在表格中上次下載資料列下方的資料列，然後按一下表格資料列變更和插入資料列。增益集會在表格中建立一個新資料列，供您編輯。

   • 選取 Ken Ster 在表格結尾 (列 102) 的列，例如選取他的電子郵件地址。在 Oracle Visual Builder 頁籤中，按一下表格資料列變更，然後按一下標示為刪除。

     進行這些變更之後，您的表格與下圖所示的表格類似。亦即，Update、Delete 或 Create 訊息會顯示在您進行變更之每個資料列的已變更資料欄中。

     

6. 在 Oracle Visual Builder 頁籤中，按一下上傳變更。

   提示輸入表格有擱置刪除的訊息時，請按一下是確認。上傳完成後，表格會重新整理狀態資料欄，以描述每個已上傳之修改資料列的變更。

   您建立的新資料列會在集合中建立 John McGahern 的新記錄。

   您標示要刪除的資料列、John Sieve 和 Ken Ster 的記錄已不再顯示，因為 REST 服務已將其從其集合中刪除。

   

   注意：所有資料在上傳至 REST 服務之前都會先經過驗證。如果發生錯誤，您可以隨時修正錯誤並再次上傳變更。例如，若更新與刪除列成功但建立列失敗，則您只需要修正失敗建立列的資料。

   若要驗證 Excel 工作簿的變更是否已順利上傳，請前往視覺化應用程式中「業務物件」頁面的資料頁籤。

   圖解描述

想要進一步瞭解嗎？

• 使用 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 管理資料。本指南可協助您讓業務使用者順利使用整合的工作簿。