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

# Amazon Quick 品牌自訂
<a name="brand-customization"></a>

Amazon Quick 可讓帳戶管理員自訂其應用程式的品牌和視覺化佈景主題，以符合其組織的指導方針。此自訂包含下列視覺化元素，可在所有非管理的 Amazon Quick 主控台頁面、排程、提醒和電子郵件報告之間建立有凝聚力的外觀和風格。
+ 標誌
+ 網頁圖示
+ 視覺化資產的關聯替代文字

下方清單顯示可自訂佈景主題顏色分組的不同區域。

**品牌顏色**
+ **全域導覽列**顏色會套用至 Amazon Quick UI 中最上方的列，並包含標準和內嵌 Amazon Quick 主控台中顯示的公司標誌。
+ **應用程式列**顏色會套用至包含關聯式動作的次要導覽列。

**互動顏色**
+ **輔色**會套用至互動元素，例如按鈕、邊界和圖示。

**表面顏色**
+ **主要**顏色會套用至高強調度表面，例如首頁背景和文字。
+ **次要**顏色會套用至實際表面，例如邊界、背景和表單欄位。次要顏色與主要顏色一起使用。

**狀態顏色**
+ **成功**顏色會套用至成功訊息。
+ **危險**顏色會套用至錯誤訊息。
+ **警告**顏色會套用至警告訊息。
+ **資訊**顏色會套用至資訊性訊息。

**資料視覺化顏色**
+ **維度**顏色用於識別共用相同角色的資料欄之間的關聯。
+ **量值**顏色用於識別指標或衡量值。

**功能**
+ **視覺化**顏色會套用至**視覺化**圖示。
+ **Insight** 顏色會套用至 **Insight** 圖示。
+ **連線**顏色會套用至**連線**圖示。
+ **自動化**顏色會套用至**自動化**圖示。

使用下列各節開始在 Amazon Quick 中自訂品牌。

**Topics**
+ [Amazon Quick 品牌自訂的權限](#brand-customization-permissions)
+ [在 Amazon Quick 中建立自訂品牌](#brand-customization-create)
+ [使用 Amazon Quick APIs 設定 Amazon Quick 分析的預設佈景主題](customizing-quicksight-default-theme.md)

## Amazon Quick 品牌自訂的權限
<a name="brand-customization-permissions"></a>

若要設定品牌，您必須透過 IAM Identity Center 或 IAM 獲得管理員角色。在 Amazon Quick 中向其授予角色的管理員無法建立品牌。若要進一步了解如何整合您的帳戶與 IAM Identity Center，請參閱[使用 IAM Identity Center 設定 Amazon Quick 帳戶](https://docs.aws.amazon.com/quicksight/latest/user/sec-identity-management-identity-center.html)。如需管理員角色和功能的資訊，請參閱[了解 Amazon Quick 訂閱和角色](https://docs.aws.amazon.com/quicksight/latest/user/user-types.html#subscription-role-mapping)。

管理員使用者只能管理與其 Amazon Quick 帳戶位於相同容量區域中的品牌。

您在 Amazon Quick 中用來建立品牌的 IAM 角色必須包含`quicksight:*`或精細動作許可，以在管理員主控台中管理品牌。管理員需要下列精細許可，才能使用 Amazon Quick 品牌：
+ `quicksight:CreateBrand`
+ `quicksight:UpdateBrand`
+ `quicksight:DescribeBrand`
+ `quicksight:DescribeBrandPublishedVersion`
+ `quicksight:UpdateBrandPublishedVersion`
+ `quicksight:DeleteBrand`
+ `quicksight:ListBrands`
+ `quicksight:UpdateBrandAssignment`
+ `quicksight:DescribeBrandAssignment`
+ `quicksight:DeleteBrandAssignment`

確認您的管理員角色包含必要的許可後，您可以在 Amazon Quick admin 主控台中[建立自訂品牌](https://docs.aws.amazon.com/quicksight/latest/user/brand-customization-create.html)。

## 在 Amazon Quick 中建立自訂品牌
<a name="brand-customization-create"></a>

使用下列程序在 Amazon Quick 中建立自訂品牌。

1. 開啟 [Quick 主控台](https://quicksight.aws.amazon.com/)。

1. 選擇右上角的使用者圖示，然後選擇**管理快速**。

1. 選擇**自訂應用程式**。

1. 在開啟的**自訂應用程式**頁面上，選擇**新增品牌**。**品牌設定**頁面隨即開啟。

1. 導覽至**品牌資訊**區段。

1. 對於**品牌名稱**，輸入品牌的名稱。品牌名稱可包含最多 512 個字元。

1. （選用） 針對**品牌描述**，輸入自訂品牌的說明。品牌描述可包含最多 512 個字元。

1. 導覽至**標誌**區段。  
![\[品牌資訊頁面的標誌區段。\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/logo.png)

1. 針對**主要**圖示，選擇主要圖示旁的省略符號 （三個點），然後選擇**取代影像**。

1. 在開啟的**選擇影像**快顯視窗中，執行下列其中一個動作：

   1. 將影像拖放到**將影像拖曳到此處**方塊中。

   1. 選擇**選取檔案**，以從您的電腦選取檔案。

   1. 在文字列中輸入公共 URL 或 Amazon S3 URI。

   您選擇的影像必須是 `.jpeg`、`.png` 或 `.svg` 格式，且不得超過 1 MB。

   完成影像選擇後，選擇**套用**。

1. 對於**最愛圖示**，選擇最愛圖示旁的省略符號 (三個點)，然後選擇**取代影像**。

1. 在開啟的**選擇影像**快顯視窗中，執行下列其中一個動作：

   1. 將影像拖放到**將影像拖曳到此處**方塊中。

   1. 選擇**選取檔案**，以從您的電腦選取檔案。

   1. 在文字列中輸入公共 URL 或 Amazon S3 URI。

   您選擇的影像必須是 `.jpeg`、`.png` 或 `.svg` 格式，且不得超過 1 MB。

   完成影像選擇後，選擇**套用**。

1. （選用） 對於 **Alt 文字**，輸入要與標誌一起顯示的 alt 文字。替代文字可包含最多 512 個字元。

1. 若要變更品牌的佈景主題顏色，請導覽至左側的**外觀**窗格，然後選擇**佈景主題**。

1. 佈景**主題設定**頁面隨即出現，並顯示可自訂的 Amazon Quick 佈景主題的所有部分。下方影像顯示全域導覽列的組態設定。  
![\[全域導覽列的組態設定。使用背景和前景貼圖來自訂佈景主題設定頁面上列出的每個佈景主題項目的顏色。\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/navigation-bar.png)

1. 若要變更區域的背景顏色，請導覽至您想要變更的項目，然後選擇**背景**顏色樣本。

1. 在顯示的**自訂顏色**快顯視窗中，從顏色漸層中選擇顏色，或在**十六進位**列中輸入十六進位代碼值，然後選擇**套用**。

1. 若要變更區域的前景顏色，請導覽至您想要變更的項目，然後選擇**前景**顏色樣本。

1. 在顯示的**自訂顏色**快顯視窗中，從顏色漸層中選擇顏色，或在**十六進位**列中輸入十六進位代碼值，然後選擇**套用**。

1. 當您完成設定自訂品牌時，請選擇 **PUBLISH** 以發佈並套用品牌自訂到所有 Amazon Quick 使用者帳戶。如果您不想發佈品牌，請選擇**儲存**以儲存品牌以供稍後使用。

當您在 Amazon Quick 中完成建立品牌時，新品牌會出現在 Quick admin 主控台**自訂應用程式**頁面上的品牌資料表中。品牌資料表**的狀態**欄指出目前發佈至快速帳戶的品牌。若要變更自訂品牌，請在品牌資料表中找到您想要變更的品牌，選擇**動作**欄中的省略符號 (三個點) 圖示，然後選擇**發布**、**編輯**或**刪除**。

發佈品牌後，新品牌在所有使用者之間傳播最多可能需要 10 分鐘。

# 使用 Amazon Quick APIs 設定 Amazon Quick 分析的預設佈景主題
<a name="customizing-quicksight-default-theme"></a>

**若要使用 API 設定預設佈景主題**

1. 確定要用作預設值的自訂佈景主題，並找到其佈景主題 ID。如果想要使用 QuickSight 入門佈景主題之一，請略過此步驟。

   若要取得自訂佈景主題的佈景主題 ID，請使用佈景主題所在區域的 [ListThemes](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListThemes.html) API 作業。確保佈景主題與需要使用該佈景主題的使用者或群組位於同一區域。

   下列範例顯示使用 AWS CLI中之 `list-themes` 命令的 Shell 指令碼。它會將 AWS 帳戶 ID 和 AWS 區域 設定為變數。如果您之前曾經用 `aws configure` 來設定預設區域，則將 `--region` 變數新增至命令會覆寫您的預設設定。

   ```
   #declare variables
   awsacct1='111122223333'
   region='us-west-2'
   
   aws quicksight list-themes \
   --region $region \
   --aws-account-id $awsacct1 \
   --type 'CUSTOM'
   ```

   

1. 使用 [ListUsers](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListUsers.html) 或 [ListGroups](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_ListGroups.html) API 作業，收集需要使用佈景主題作為預設值的使用者或群組的 Amazon Resource Name (ARN)。您只需要頂層 ARN。如果您的所有使用者都屬於同一群組，請使用群組 ARN。

   如需 Amazon Quick ARNs的詳細資訊，請參閱《快速 API 參考》中的 [ARN 格式](https://docs.aws.amazon.com//quicksight/latest/APIReference/qs-arn-format.html)。 **

1. 如果使用的是自訂佈景主題，請授予您在上一個步驟中收集之 ARN 的佈景主題存取權。如果使用的是入門佈景主題，請略過此步驟，因為所有使用者都可以存取入門佈景主題。

   下列範例顯示的是使用 [update-theme-permissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateThemePermissions.html) 命令的 Shell 指令碼。`grant-permissions` 參數使用速記語法顯示。您可以改用 JSON 或 YAML。如需詳細資訊，請參閱《AWS Command Line Interface 使用者指南》**中的[指定參數值](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters.html)。

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639' #Find this with list-themes
   
   aws quicksight update-theme-permissions \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --theme-id $theme-id \
   --grant-permissions Principal="arn:aws:quicksight:$region:$awsacct1:group/$namespace/QuickSight_Group_Name",Actions="quicksight:DescribeTheme","quicksight:ListThemeVersions","quicksight:ListThemeAliases","quicksight:DescribeThemeAlias"
   ```

1. 將佈景主題指派為同一個或同一組 ARN 的預設值。

   ```
   #declare variables
   awsacct1='111122223333'
   namespace='default'
   region='us-west-2'
   theme-id='bdb844d0-0fe9-4d9d-b520-0fe602d93639'
   
   aws quicksight create-account-customization \
   #Specify region if necessary: --region $region \
   --aws-account-id $awsacct1 \
   --namespace $namespace \
   --account-customization DefaultTheme="arn:aws:quicksight:$region:$awsacct1:theme/$theme-id"
   ```

目前，有三個入門佈景主題：經典、午夜和海濱。它們的 ARN 是其佈景主題名稱的大寫拼字。如果您使用的是入門佈景主題而非自訂佈景主題，請使用下列佈景主題 ARN 之一：
+ `arn:aws:quicksight::aws:theme/CLASSIC`
+ `arn:aws:quicksight::aws:theme/MIDNIGHT`
+ `arn:aws:quicksight::aws:theme/SEASIDE`
+ `arn:aws:quicksight::aws:theme/RAINIER`