背景

在上篇內容中，我們從SaaS各種功能的角度為大家介紹了在資料處理中SaaS的巨大價值，而本次我們將用範例將為大家展示SaaS與BI間的碰撞又會產生怎樣的火花。

BI與SaaS整合範例

通常BI分析工具都提供了對於資料庫的豐富介面，用以更加快捷高效地處理資料。此處我們以一具體工具範例作為演示內容，它提供基於GraphQL的豐富的API介面，可以通過API和動態引數來根據使用者上下文資訊獲取相應的資料和生成檔案。具體嵌入方式可以根據SaaS系統情況進行合理調整。

1、建立資料來源

對於多租戶的場合，通常會基於使用者進行分庫處理，這種情況可以通過使用者上下文資訊，建立動態資料來源:

1.1 新增擴充套件引數，增加使用者上下文的資料庫資訊

1.2 建立使用者時，繫結上該使用者的資料庫資訊

1.3 建立資料來源時，使用動態引數設定

2、建立角色和使用者 (使用內建使用者)

2.1建立角色名:

POST /api/graphql?token=8908645b0958662d66731038944c7d236d3d7c1ee98e3e2de3c5268453965a8a
Content-Type: application/json

{"query":"mutation { addRole( roleName: \"2\" ) { name } }"}

2.2 POST提交:

POST /admin/api/accountmanagement/api/v1/roles?token=8908645b0958662d66731038944c7d236d3d7c1ee98e3e2de3c5268453965a8a
Content-Type: application/json

{"Name":"2"}

2.3為角色分配許可權:

POST
/admin/api/accountmanagement/api/v1/roles/3f497dc1-66a6-45cb-a999-6c7f4b1bb15f/permissions?token=8908645b0958662d66731038944c7d236d3d7c1ee98e3e2de3c5268453965a8a
Content-Type: application/json

{"Permissions":["create-data-source","create-semantic-model","create-dataset","create-dashboard","view-dashboard","create-report","view-report","schedule-reports","create-input-form","view-revision","allow-sharing"]}

2.4 建立使用者，並分配角色

POST /admin/api/accountmanagement/api/v1/users/?token=8908645b0958662d66731038944c7d236d3d7c1ee98e3e2de3c5268453965a8a
Content-Type: application/json

{"username":"2","email":"[email protected]","mobile":"","firstName":"","lastName":"","fullName":null,"password":"2","confirmPassword":"2","roles":["2"],"customizePropertyInfo":{"DBName":["Test"],"Password":["mAbQ5mlMDWck_xysj3rQ"],"Port":["3306"],"ServerIP":["192.168.32.100"],"Uid":["root"]}}

3、API生成Token

生成Token的API介面，除此之外所有的API呼叫都需要Token引數才能正確存取

POST /connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=password&username=admin&password=admin&client_id=integration&client_secret=eunGKas3Pqd6FMwx9eUpdS7xmz&access-token-lifetime=86400

* 注意申請token時應使用access-token-lifetime引數限制token的有效時長，單位為秒，長期無限制地使用永久Token，將可能由於Token堆積而影響登入效能 (永久Token可通過清理wynis資料庫中grants表中的資料進行處理)

4、建立門戶目錄

4.1 獲取最大分類ID

POST /api/graphql?token=8908645b0958662d66731038944c7d236d3d7c1ee98e3e2de3c5268453965a8a
Content-Type: application/json

{"query":"query { tags (type: \"system\") { id, parentId, order, name, url, color, iconCssClass, isFavorites } }"}

4.2 新建門戶分類（order等於第一步返回值的最大值+1）

var order = Math.max(...res.data.tags.map((item) => item.order)) + 1;
POST
/api/graphql?token=8908645b0958662d66731038944c7d236d3d7c1ee98e3e2de3c5268453965a8a
Content-Type: application/json

{"query":"mutation { addTag(name:\"2\", urlName:\"2\", order: 1961, iconCssClass: \"mdi mdi-folder\", grant: [ {role:\"Everyone\", ops:[Read]} ] , color: \"null\", parentId: \"null\" ) { id } }"}

5、複製檔案並上傳(可選)

根據實際的業務場景，如果需要給每個使用者增加 可單獨編輯儲存的 預設檔案

可以通過以下2種方式進行處理:

利用Wyn Tools或其他工具複製檔案並按租戶重新命名
批次上傳檔案(手動上傳)

* 也可以通過角色許可權分配的方式，將某個檔案共用給某角色下的所有使用者進行瀏覽

6、API分類

6.1 獲取分類ID

POST /api/graphql?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7
Content-Type: application/json

{"query":"query { tags { id, name}}"}

6.2獲取檔案ID

POST /api/graphql?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7
Content-Type: application/json

{"query": "query { documenttypes(key:\"rdl\") { documents { id, title, type} } }"}

6.3給檔案設定分類(請求引數的分類id和檔案id來自前兩步)

POST /api/graphql?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7
Content-Type: application/json

{"query":"mutation { tagDocument(tagId: \"eafd31d7-7aad-40b7-9206-f4866127a853\", documentId: \"f30ce97b-7369-424e-8b39-8ffa6b305838\") }"}

7、API檔案授權

7.1 獲取檔案ID

POST /api/graphql?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7
Content-Type: application/json

{"query": "query { documenttypes(key:\"rdl\") { documents { id, title, type} } }"}

7.2獲取角色名稱

GET /admin/api/accountmanagement/api/v1/roles?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7

7.3給檔案分享角色許可權

（引數用到第一步返回的報表ID，以及第二步要分享的角色名稱）

POST /api/graphql?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7
Content-Type: application/json

{"query":"mutation {\n\t\t\tupdatePermissions( documentId: \"f30ce97b-7369-424e-8b39-8ffa6b305838\" , grant: [ { role:\"1\", ops: [ Read, Update ]}]  )\n\t\t}"}

如需通過帶Token的URL進行整合，可繼續參考以下步驟。

8、拼接URL

8.1 獲取檔案ID

POST /api/graphql?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7
Content-Type: application/json

{"query": "query { documenttypes(key:\"rdl\") { documents { id, title, type} } }"}

8.2 生成Token (參考3 生成Token的內容中關於引數的定義)

POST /connect/token?token=77c9bfccf16659f2ab62cf7796b640156f13cea35bc30cde1597ddb4457720c7
Content-Type: application/x-www-form-urlencoded

grant_type=password&username=admin&password=admin&client_id=integration&client_secret=eunGKas3Pqd6FMwx9eUpdS7xmz&access-token-lifetime=86400