在本文中,你會學習如何在 canvas 應用程式中使用資料來源環境變數。 您可以使用預先存在的資料來源環境變數,或在連線資料時,自動建立資料來源環境變數。
使用既有的資料來源環境變數
你可以在其他應用程式甚至不同類型的資源(如雲端流程)中重複使用環境變數。 您可能會想先在解決方案中建立這些變數,之後再於製作畫布應用程式和雲端流程時使用。 以下步驟以 SharePoint Online 為例。
- 按照步驟在解決方案中手動建立環境變數。
- 從您的解決方案中編輯或建立畫布應用程式。
- 為 SharePoint Online 新增新的資料來源。
- 選擇 進階 標籤。你會看到一個篩選過的可用環境變數清單,這些變數是你能存取且與設定參數相符的。 例如,當你選擇 SharePoint 站點時,清單包含資料來源環境變數,Connector 為 SharePoint,參數型別為 Site。 為指定網站選取 SharePoint 清單時,也是如此。 如果現有變數未出現,請參閱 限制與故障排除。
- 選取所需的環境變數,然後選取連線。
這很重要
- 如果選取其他解決方案中的環境變數,則包含該環境變數的解決方案將存在相依性。 因此,務必選擇以下其中一種方法:
- 匯出之前,將環境變數新增至目前的解決方案中。
- 在匯入目前的解決方案前,請確保將包含環境變數的解決方案匯入目標環境。
連接資料時自動建立資料來源環境變數
此選項簡化,並確保環境變數始終用於資料來源,例如 SharePoint Online。 但是,部分客戶喜歡提供自己的結構描述名稱,因此應從解決方案中建立。
備註
既有的畫布應用程式不會自動使用資料來源環境變數。 從應用程式中移除資料來源,然後使用上述步驟將它們新增回去,以升級這些應用程式來使用環境變數。
從您的解決方案中編輯或建立畫布應用程式。
選取設定>一般,並啟用新增資料來源時自動建立環境變數的設定。
為 SharePoint Online 新增新的資料來源。
選取 SharePoint 網站,一個或多個清單,然後選取連線。
備註
為了避免產生重複的環境變數,當識別到重複時,系統會提示你使用現有的環境變數。 如果需要建立重複的環境變數,可以取消選擇使用現有環境變數的選項。
選取 [儲存]。
限制與故障排除
環境變數可能存在於你的環境中,卻不會出現在 Canvas Studio 的資料來源選擇器中。 當你找不到變數時,請檢查以下限制。
Canvas Studio 選擇器的限制
此限制適用於為支援的連接器選取資料來源環境變數,包括 SharePoint 和 SQL Server。 對於 SQL Server,它適用於支援資料來源環境變數的連線類型,例如 Microsoft Entra 連線。
Canvas Studio 的資料來源選擇器只會取得與所選連接器及參數類型相符的環境變數定義與值的第一頁。 它不會讀取後續的頁面。 每個 Dataverse 請求最多回傳 5,000 筆匹配紀錄,因此有些變數可能不會出現在 進階 標籤或搜尋結果中。 搜尋遺漏的變數時,不會從後續頁面擷取該變數。
這個限制是針對選擇者,而非 Dataverse 中 5,000 個環境變數的限制。 相關的計數是每個請求匹配定義或值的數量,而非環境中所有連接器的變數總數。
為了減輕此限制,請重用現有變數,並在檢查其依賴性後移除過時變數。 不要刪除應用程式或流程仍在使用的變數。 如果你無法減少變數數量,可以考慮一個較小的環境,包含你需要的變數和應用程式。 在同一環境中將變數移入不同解,並不會減少該環境中的變數數量。
SharePoint 專屬設定檢查
除了跨支援連接器的分頁限制外,SharePoint 變數還必須符合以下設定要求:
- 站點變數需要一個非空的 Current Value 或 Default 值,且包含 SharePoint 站點 URL。 選擇器不會列出兩個值都空的站點變數。
- 清單變數的值必須與所選站點與連線所回傳清單的唯一識別碼(GUID)相符,而非清單的顯示名稱。 確認連線是否能存取該清單,且變數是否包含其識別碼。
也請參閱
使用 Dataverse 從頭開始建立畫布應用程式。
在 Power Automate 解決方案雲端流程中使用環境變數
環境變數概觀