Tableau Cloud 說明

此主題涵蓋 CSV 檔案本身詳情。要使用 CSV 匯入使用者，您可以：

• 使用站台管理頁面。詳情請參閱匯入使用者
• 使用 tabcmd 公用程式。有關資訊，請參閱 createsiteusers filename.csv。
• 使用 Tableau Cloud Manager。有關詳細資訊，請參閱使用 Tableau Cloud Manager 管理使用者。

CSV 檔案格式要求

用於匯入使用者的 CSV 檔案有以下格式要求：

• 無欄標題。Tableau Cloud假定檔案中的每一行代表一個使用者。
• 含位元組順序標記 (BOM) 的 UTF-8 格式。
  • 諸如 BIG-5 等字元編碼必須轉換為 UTF-8。可透過在文字編輯器中開啟檔並使用「另存新檔」命令來達到此目的。
  • 如果 @ 出現在 username 欄位，但不是網域分隔符，則必須使用十六進位格式：\0x40。例如，user@fremont@mycompany.com 應為 user\0x40fremont@mycompany.com。

CSV 檔案中所需的欄結構

該檔案不應包含標題列。不需要填寫所有欄，但必須保留必填欄結構，即包含所有預期的逗號分隔符。

不同產品以及匯入工具的欄結構各異。請確保為您的環境使用適當的結構：

• Tableau Cloud：使用者名稱、密碼、顯示名稱、授權層級、管理員層級、發佈功能、電子郵件地址
• 具有 Tableau Cloud Manager (TCM) 的 Tableau Cloud：租用戶或站台 URI、使用者名稱、密碼、顯示名稱、授權層級、管理員層級、發佈功能、電子郵件地址、驗證類型
• Tableau Server：username, password, display name, license level, admin level, publishing capability, email address
• 使用身分集區的 Tableau Server：username, password, display name, license level, admin level, publishing capability, email address, identity pool name, identifier

請參閱以下欄詳情部分了解每個欄可能值的更多資訊。

重要提示：欄的順序至關重要。將第一列視為使用者名，將第二列視為密碼，將第三列視為顯示名稱等等，而不考慮列中的內容。如果忽略欄位的值，您必須仍然包括欄位的逗號分隔符號。

適用於 Tableau Cloud CSV 的欄詳情

若 CSV 檔案僅包含使用者名稱值（電子郵件地址），則使用者將收到站台的電子郵件邀請。使用者可以聯接網站以建立帳戶，但在管理員設定他們的帳戶（顯示名稱、授權層級等）之前，他們的帳戶會保持未授權狀態。使用者在站台上的電子郵件地址可能會以句點開頭（例如 .user@domain.com），直到使用者首次登入。

CSV 檔案的欄結構：使用者名稱、密碼、顯示名稱、授權層級、管理員層級、發佈功能、電子郵件地址

欄詳細資料：

使用者名稱：必填。該使用者的電子郵件地址。

密碼：已忽略。最佳做法是將此欄留為空白。

• 新使用者在首次登入到 Tableau Cloud 時必須選取密碼和顯示名稱。如果使用者有 Tableau 帳戶，他們可能已經有了密碼。

顯示名稱：已忽略。最佳做法是將此欄留為空白。

授權層級：可以為 Creator、Explorer、Viewer 或未授權。若留為空白，則授權層級將為「未授權」。

管理員層級：可以為是「站台」或者「無」。如果留為空白，則管理員層級將為「None」。

• Site = 站台管理員，None = 不是管理員。
• 附註：使用 Tableau Cloud Manager 時，「Cloud」是唯一的相關值。有關詳細資訊，請參閱使用 Tableau Cloud Manager 管理使用者。

發佈功能：可以為「Yes/True/1」或「No/False/0」。若留為空白，則發佈功能將為「false」。

• 如果授權層級為 Creator，則發佈能力必須為 Yes/True/1
• 如果授權層級為 Explorer，則發佈功能值可以區分 Explorer (可發佈) 與 Explorer 的站台角色值。
• 如果授權層級為 Viewer 或者 Unlicensed，則使用者將無法發佈，無論此欄的值是什麼。

電子郵件地址：從 2025 年 7 月 (Tableau 2025.2) 開始，若電子郵件地址與使用者名稱不同，請指定電子郵件地址。電子郵件地址僅用於通知目的。若未提供電子郵件地址值，Tableau Cloud 會使用必填的使用者名稱欄位中的值傳送通知

任何留為空白的欄仍必須使用逗號分隔以保留該欄結構。

無 TCM 的驗證類型

如果不使用 Tableau Cloud Manager，則可在上傳過程中只設定單一預設驗證類型。之後可為單獨使用者變更驗證類型。

• 直接在 Tableau Cloud 中上傳 CSV 檔案時，請在匯入檔案時指定驗證類型，該類型會套用於所有匯入的使用者。
• 使用 tabcmd 匯入使用者時，請在上傳過程中設定適用於 CSV 檔案中所有使用者的驗證類型與站台角色。有關資訊，請參閱 createsiteusers filename.csv。

要在上傳時為每位使用者設定具體驗證類型，則必須使用 Tableau Cloud Manager。有關詳細資訊，請參閱使用 Tableau Cloud Manager 管理使用者。

Tableau Cloud CSV 範例結構

提示：請記住，結構如下：username, password, display name, license level, administrator level, publishing capability, email address，若某欄留為空白，則逗號之間沒有任何內容。

以下範例顯示被授與 Explorer 站台角色的使用者不是站台管理員，但能夠向其具有適當內容權限的專案發佈內容。

user1@domain.com,,,Explorer,None,true,user1@domain2.com

透過變更 administrator-level 列，您將能以具有「網站管理員 Explorer」網站角色的網站管理員形式匯入以下使用者。

adminuser@domain.com,,,Explorer,Site,true,adminuser@domain2.com

TCM CSV 的欄詳細資料

如果 CSV 檔案僅包含使用者名稱（電子郵件地址）值，則使用者將會收到邀請其存取該站台的電子郵件。使用者可以聯接網站以建立帳戶，但在管理員設定他們的帳戶（顯示名稱、授權層級等）之前，他們的帳戶會保持未授權狀態。

請記住，任何留為空白的欄仍必須使用逗號分隔以保留該欄結構。

CSV 檔案的欄結構：tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type

欄詳細資料： 

租用戶或站台 URI：租用戶或站台的統一資源識別碼。

使用者名稱：必填。該使用者的電子郵件地址。

密碼：已忽略。最佳做法是將此欄留為空白。

• 新使用者在首次登入到 Tableau Cloud 時必須選取密碼和顯示名稱。如果使用者有 Tableau 帳戶，他們可能已經有了密碼。

顯示名稱：已忽略。最佳做法是將此欄留為空白。

授權層級：站台的授權層級可以為 Creator、Explorer、Viewer 或未授權。若留為空白，則授權層級將為「未授權」。

管理員層級：可以為站台、雲端或無。如果留為空白，則管理員層級將為「None」。

• Site = 站台管理員，None = 不是管理員。

發佈功能：站台的發佈功能可以為 True 或 False。若留為空白，則發佈功能將為「false」。

• 若授權層級是 Creator，則發佈功能必須為 True
• 如果授權層級為 Explorer，則發佈功能值可以區分 Explorer (可發佈) 與 Explorer 站台角色
• 如果授權層級為 Viewer 或者 Unlicensed，則使用者將無法發佈，無論此欄的值是什麼。

驗證類型：存取租用戶或站台的使用者驗證類型。可以為 Google、OpenID、Salesforce、SAML、TableauIDWithMFA 或 DEFAULT。

TCM CSV 範例結構

提示：請記住，結構如下：tenant or site URI, username, password, display name, license level, administrator level, publishing capability, email address, authentication type，若某欄留為空白，則逗號之間沒有任何內容。

以下範例顯示了使用者在 Tableau Cloud Manager 中被授與雲端管理員角色，並使用具有 MFA 的 Tableau 進行驗證。

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,TableauIDWithMFA

透過變更驗證欄，可以使用替代驗證類型（若已在 Tableau Cloud Manager 設定中設定）匯入下列使用者。

MyTCM,cloudadminuser@domain.com,,,,Cloud,,,Salesforce

在以下範例中，可以匯入具有 Explorer 的使用者 - 可以使用具有 MFA 驗證的 Tableau 發佈站台角色。

MySite,user1@domain.com,,,Explorer,None,True,,TableauIDWithMFA