--- schema_version: "1" id: b4d86730ac019d05bdf793581721c831af7eeb7491b88ccd2f9f1831863c617f title: CSV 匯入檔案指導方針 collection: tableau version: next locale: zh-tw portal_url: https://docs.salesforce.com/tableau/next/zh-tw/online/csvguidelines.md canonical_url: https://help.tableau.com/v0.0/online/zh-tw/csvguidelines.htm source_site: help.tableau.com content_type: documentation content_hash: 383eeadc199a16c65a9fe341abb4ec398a2391b43d0dd18d077a2c532c84b1b8 description: CSV file format guidelines for bulk importing users into Tableau Cloud and Tableau Cloud Manager, with required columns. --- [跳至主要內容](#main-content) # CSV 匯入檔案指導方針 透過建立含有使用者資訊的逗號分隔值 (CSV) 檔案，然後匯入該檔案，即可大量新增使用者。您可以在 CSV 檔案中包括屬性（例如授權層級和發佈存取權限），以便在匯入這些屬性的同時將它們應用於使用者。 此主題涵蓋 CSV 檔案本身詳情。要使用 CSV 匯入使用者，您可以： - 使用站台管理頁面。詳情請參閱[匯入使用者](https://help.tableau.com/v0.0/online/zh-tw/users_import.htm) - 使用 `tabcmd` 公用程式。有關資訊，請參閱 [createsiteusers filename.csv](https://help.tableau.com/v0.0/online/zh-tw/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)。 - 使用 Tableau Cloud Manager。有關詳細資訊，請參閱[使用 Tableau Cloud Manager 管理使用者](https://help.tableau.com/v0.0/online/zh-tw/cloud_manager_users.htm)。 ## CSV 檔案格式要求 用於匯入使用者的 CSV 檔案有以下格式要求： - 無欄標題。Tableau Cloud假定檔案中的每一行代表一個使用者。 - 僅在匯入到站台時才支援具有位元組順序標記 (BOM) 的 UTF-8 格式。若要匯入到 Tableau Cloud Manager，請使用 UTF-8 格式並從檔案中移除任何 BOM。 - 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 請參閱以下欄詳情部分了解每個欄可能值的更多資訊。 > [!WARNING] > > **重要提示：**欄的順序至關重要。將第一列視為使用者名，將第二列視為密碼，將第三列視為顯示名稱等等，而不考慮列中的內容。如果忽略欄位的值，您必須仍然包括欄位的逗號分隔符號。 ## 適用於 Tableau Cloud CSV 的欄詳情 若 CSV 檔案僅包含使用者名稱值（電子郵件地址），則使用者將收到站台的電子郵件邀請。使用者可以聯接網站以建立帳戶，但在管理員設定他們的帳戶（顯示名稱、授權層級等）之前，他們的帳戶會保持未授權狀態。使用者在站台上的電子郵件地址可能會以句點開頭（例如 `.user@domain.com`），直到使用者首次登入。 CSV 檔案的欄結構：_username, password, display name, license level, administrator level, publishing capability, email address_ ### 欄詳細資料 任何留為空白的欄仍必須使用逗號分隔以保留該欄結構。 **Username：**_必填_。該使用者的電子郵件地址。 **Password：**_已忽略_。最佳做法是將此欄留為空白。 - 新使用者在首次登入到 Tableau Cloud 時必須選取密碼和顯示名稱。如果使用者有 Tableau 帳戶，他們可能已經有了密碼。 **Display name：**_已忽略_。最佳做法是將此欄留為空白。 **License level：**可以為 **Creator**、**Explorer**、**Viewer** 或**Unlicensed**。若留為空白，則授權層級將為「Unlicensed」。 **Administrator level**：可以為是**「Site」**或者**「None」**。如果留為空白，則管理員層級將為「None」。 - Site = 站台管理員，None = 不是管理員。 - **Note**：使用 Tableau Cloud Manager 時，「Cloud」是唯一的相關值。有關詳細資訊，請參閱[使用 Tableau Cloud Manager 管理使用者](https://help.tableau.com/v0.0/online/zh-tw/cloud_manager_users.htm)。 **Publishing capability**：可以為**「Yes/True/1」**或**「No/False/0」**。若留為空白，則發佈功能將為「false」。 - 如果授權層級為 Creator，則發佈能力必須為 Yes/True/1 - 如果授權層級為 Explorer，則發佈功能值可以區分 Explorer (可發佈) 與 Explorer 站台角色 - 如果授權層級為 Viewer 或者 Unlicensed，則使用者將無法發佈，無論此欄的值是什麼。 **Email address：**從 2025 年 7 月（Tableau 2025.2）開始，可以指定電子郵件地址（若與使用者名稱不同）。電子郵件地址僅用於通知目的。若未提供電子郵件地址值，Tableau Cloud 會使用必填使用者名稱欄位中的值來傳送通知。出於安全性考慮，您只能指定只屬於一個站台成員的使用者的電子郵件地址。 ### 無 TCM 的驗證類型 如果不使用 Tableau Cloud Manager，則可在上傳過程中只設定單一預設驗證類型。之後可為單獨使用者變更驗證類型。 - 直接在 Tableau Cloud 中上傳 CSV 檔案時，請在匯入檔案時指定驗證類型，該類型會套用於所有匯入的使用者。 - 使用 `tabcmd` 匯入使用者時，請在上傳過程中設定適用於 CSV 檔案中所有使用者的驗證類型與站台角色。有關資訊，請參閱 [createsiteusers filename.csv](https://help.tableau.com/v0.0/online/zh-tw/tabcmd_cmd.htm#idd1b7729f-dd20-475a-96f6-17fcd2577894)。 要在上傳時為每位使用者設定具體驗證類型，則必須使用 Tableau Cloud Manager。有關詳細資訊，請參閱[使用 Tableau Cloud Manager 管理使用者](https://help.tableau.com/v0.0/online/zh-tw/cloud_manager_users.htm)。 ### Tableau Cloud CSV 範例結構 > [!TIP] > > **提示：**請記住，結構如下：`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` ### 欄詳細資料 **Tenant or site URI：**租用戶或站台的統一資源識別碼。 **Username：**_必填_。該使用者的電子郵件地址。 **Password：**_已忽略_。最佳做法是將此欄留為空白。 - 新使用者在首次登入到 Tableau Cloud 時必須選取密碼和顯示名稱。如果使用者有 Tableau 帳戶，他們可能已經有了密碼。 **Display name：**_已忽略_。最佳做法是將此欄留為空白。 **License level：**站台的授權層級可以為 **Creator**、**Explorer**、**Viewer** 或**Unlicensed**。若留為空白，則授權層級將為「Unlicensed」。 **Administrator level：**可以為**Site**、**Cloud**或**None**。如果留為空白，則管理員層級將為「None」。 - Site = 站台管理員，None = 不是管理員，Cloud = 雲端管理員。 **Publishing capability：**站台的發佈功能可以為 **True** 或 **False**。若留為空白，則發佈功能將為「false」。 - 若授權層級是 Creator，則發佈功能必須為 True - 如果授權層級為 Explorer，則發佈功能值可以區分 Explorer (可發佈) 與 Explorer 站台角色 - 如果授權層級為 Viewer 或者 Unlicensed，則使用者將無法發佈，無論此欄的值是什麼。 **Authentication type**：存取租用戶或站台的使用者驗證類型。可以為 **Google**、**OpenID**、**Salesforce**、**SAML**、**TableauIDWithMFA** 或 **DEFAULT**。 ### TCM CSV 範例結構 > [!TIP] > > **提示：**請記住，該結構為：`tenant or site URI, username, password, display name, license level, administrator level, publishing capability, authentication type`，若某欄留為空白，則逗號之間沒有任何內容。 以下範例顯示了使用者在 Tableau Cloud Manager 中被授與雲端管理員角色，並使用具有 MFA 的 Tableau 進行驗證。 TCM,cloudadminuser@domain.com,,,,Cloud,,TableauIDWithMFA 透過變更驗證欄，可以使用替代驗證類型（若已在 Tableau Cloud Manager 設定中設定）匯入下列使用者。 TCM,cloudadminuser@domain.com,,,,Cloud,,Salesforce 在以下範例中，可以匯入具有 Explorer 的使用者 - 可以使用具有 MFA 驗證的 Tableau 發佈站台角色。 MySite,user1@domain.com,,,Explorer,None,True,TableauIDWithMFA ## CSV 設定和網站角色 使用者的授權層級、管理員和發佈設定確定如何在匯入過程中設定使用者的網站角色。以下演示了如何在 CSV 中擷取站台角色。
站台角色License levelAdministrator levelPublishing capability

雲端管理員

只有在登入 Tableau Cloud Manager（即未登入具體站台）時匯入使用者的情況下，此角色才有效。

未授權CloudFalse

站台管理員 Creator 或 站台管理員 Explorer

只有在登入到具體站台的同時匯入使用者，這些角色才有效。

Creator 或者 Explorer站台True
CreatorCreator無True
Explorer (可發佈)Explorer無True
ExplorerExplorer無False
ViewerViewer無False
未授權未授權無False