本主題描述可供用於開發視覺化 Plug-in 並將其部署至您安裝之 Oracle Analytics Desktop 的軟體開發套件 (SDK)。
您的安裝包括命令檔,供您用來建立開發環境及建立架構視覺化 Plug-in。
命令檔在以下目錄中:<your_installation_directory>\Oracle Analytics Desktop\tools\bin
。
C:\Program Files\Oracle Analytics Desktop\tools\bin
請注意以下的命令檔名稱與描述:
bicreateenv - 執行此命令檔即可建立供開發 Plug-in 的開發環境。
bicreateplugin - 執行此命令檔即可建立架構視覺化,以快速開始進行自訂 Plug-in 的開發。
bideleteplugin - 執行此命令檔即可刪除開發環境中的 Plug-in。
bivalidate - 使用 gradlew validate
命令呼叫並執行 bivalidate 命令檔。bivalidate 命令檔會驗證 JSON 組態檔的格式是否正確,以及當中是否包含適當的視覺化組態。
您可以使用命令檔以外的資源開發自訂的視覺化 Plug-in。
請記下以下的可用資源:
circlePack 範例 - 您的開發環境中包含了一個 circlePack 範例。您可以立即部署並使用此範例。不過,本範例僅供搭配提供的教學課程使用,目的為讓您瞭解如何開發視覺化 Plug-in。您也可以複製此範例,作為建立視覺化 Plug-in 的樣板。
circlePack 範例位於 <your_development_directory>\src\sampleviz\sample-circlepack
例如,C:\OracleDVDev\src\sampleviz\sample-circlepack
其他視覺化 Plug-in 範例 - 您可以從 Oracle Analytics Library 下載 Plug-in 範例。
JS API 文件 - 本文件包含開發視覺化 Plug-in 所需的 JavaScript 參考資訊。請參閱Oracle Analytics Desktop SDK JavaScript 參照。
在開發環境中建立架構視覺化 Plug-in 之後,要接著繼續進行開發使其成為健全的視覺化 Plug-in,然後將它部署到您的 Oracle Analytics Desktop 環境中。
bicreateplugin -viz
命令時,系統會在以下位置建立 customviz 目錄:<your_development_environment>\src\customviz
您建立的所有自訂視覺化開發目錄都會加到此目錄中。
例如,C:\OracleDVDev\src\customviz\com-company-basicviz
bicreateplugin -unclassified
命令會以 plugin.xml、區域化組合建立一個空白的 Plug-in。bicreateplugin -skin
命令則會建立架構外觀 Plug-in。
建立架構視覺化 Plug-in 之後,您可以使用 Oracle 提供的資源協助您開發 Plug-in。
dataviz 和 embeddableDataviz 類型的目錄包含 datamodelhandler.js 檔案,其中包含實體與邏輯的資料對應格式。此檔案同時會決定 Oracle Analytics Desktop 如何呈現並將使用者互動傳送至伺服器。
參考 .JS API 文件瞭解如何新增相依性。請參閱 Oracle Analytics Desktop SDK JavaScript 參照。
您在開發視覺化 Plug-in 或想要測試視覺化 Plug-in 時,可以在瀏覽器中以 SDK 模式執行 Oracle Analytics Desktop。
驗證視覺化 Plug-in 之後,您必須組建並封裝 Plug-in,然後將產生的分送項目複製到您的安裝目錄中。