本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定頁面的角色型可見性
<a name="app-level-roles"></a>

您可以在 App Studio 應用程式中建立角色，並根據這些角色設定頁面的可見性。例如，您可以根據使用者需求或存取層級建立角色，例如提供專案核准或宣告處理等功能的應用程式的管理員、管理員或使用者，並讓特定角色可以看到特定頁面。在此範例中，管理員可能具有完整存取權、管理員可能有權檢視報告儀表板，而使用者可能有權使用輸入表單存取任務頁面。

使用下列程序來設定 App Studio 應用程式中頁面的角色型可見性。

1. 如有必要，請導覽至您應用程式的應用程式工作室。從左側導覽功能表中，選擇**我的應用程式**，尋找您的應用程式，然後選擇**編輯**。

1. 在應用程式工作室中建立應用程式層級角色。

   1. 選擇應用程式工作室頂端的應用程式**設定**索引標籤。

   1. 選擇 **\+ 新增角色**

   1. 在**角色名稱**中，提供名稱以識別您的角色。我們建議您使用描述群組存取層級或職責的名稱，因為您會使用名稱來設定頁面可見性。

   1. 或者，在**描述**中新增角色的描述。

   1. 重複這些步驟，視需要建立任意數量的角色。

1. 設定頁面的可見度

   1. 選擇應用程式工作室頂端的**分頁**。

   1. 從左側**頁面**選單中，選擇要設定角色型可見性的頁面。

   1. 在右側功能表中，選擇**屬性**索引標籤。

   1. 在**可見性**中，停用**開放給所有最終使用者**。

   1. 保持選取**角色**，從您在上一個步驟中建立的角色清單中進行選擇。選擇**自訂**以撰寫 JavaScript 表達式，以取得更複雜的可見性組態。

      1. 選取**角色**後，勾選顯示頁面的應用程式角色方塊。

      1. 選取**自訂**後，輸入解析為 true 或 false 的 JavaScript 表達式。使用下列範例來檢查目前使用者是否具有 *manager* 的角色：`{{currentUser.roles.includes('manager')}}`。

1. 現在您的可見性已設定完成，您可以透過預覽您的應用程式來測試頁面可見度。

   1. 選擇**預覽**以開啟應用程式的預覽。

   1. 在預覽的右上角，選擇**預覽為**功能表，並勾選您要測試的角色方塊。可見頁面應反映選取的角色。

1. 現在，將群組指派給已發佈應用程式的應用程式角色。群組和角色指派必須針對每個環境分別設定。如需應用程式環境的詳細資訊，請參閱 [應用程式環境](applications-publish.md#application-environments)。
**注意**  
您的應用程式必須發佈至測試或生產環境，才能將 App Studio 群組指派給您已建立和設定的角色。如有必要，請發佈您的應用程式，將群組指派給角色。如需發佈的詳細資訊，請參閱 [發佈應用程式](applications-publish.md)。

   1. 在應用程式工作室的右上角，選擇**共用**。

   1. 選擇您要設定頁面可見性之環境的標籤。

   1. 選擇**搜尋群組**輸入方塊，然後選擇要與其共用應用程式版本的群組。您可以輸入文字來搜尋群組。

   1. 在下拉式選單中，選擇要指派給群組的角色。您可以選擇**無角色**來共用應用程式版本，而不是將角色指派給群組。只有沒有角色的群組可以看到所有使用者都可看見的頁面。

   1. 選擇**共用**。重複這些步驟，視需要新增任意數量的群組。