CSV 匯入檔案指導方針
透過建立含有使用者資訊的逗號分隔值 (CSV) 檔案,然後匯入該檔案,即可自動新增使用者。您可以在 CSV 檔案中包括屬性(例如授權層級和發佈存取權限),以便在匯入這些屬性的同時將它們應用於使用者。
若要匯入使用者,您可以使用站點管理頁面或 tabcmd
公用程式。使用 tabcmd
提供用於為 CSV 檔案中的所有使用者指派站點角色的選項。有關資訊,請參閱匯入使用者或createsiteusers filename.csv。
CSV 檔案格式要求
在建立用於匯入使用者的 CSV 檔案時,請確保檔滿足以下格式要求:
檔不包括列標題。Tableau Cloud假定檔案中的每一行代表一個使用者。
檔為 UTF-8 格式,並包括位元組順序標記 (BOM)。
諸如 BIG-5 等字元編碼已轉換為 UTF-8。可透過在文字編輯器中開啟檔並使用「另存新檔」命令來達到此目的。
如果使用者名包括的「@」字元不是表示域分隔符號,則您需要使用十六進位格式引用該符號:
\0x40
例如,
user@fremont@mycompany.com
應該為user\0x40fremont@mycompany.com
CSV 檔案中所需的列
每個使用者都需要以下欄位:
使用者名稱:使用者的電子郵件地址。
Password。Tableau Cloud 不使用此欄位,但您需要在每一列中劃定其界限,以正確地放置後面的欄位。
其他 CSV 欄選項
對於每個使用者,CSV 檔案除了必填欄之外還可以包含以下欄位。如果指明的話,則 Tableau Cloud 不使用該欄位,但必須在檔案中考慮該欄位。
站台 URI(僅限 Tableau Cloud Manager):站台的統一資源識別碼。若要將使用者匯入為雲端管理員,請包含「站台 URI」欄,但將其留空。
Display name。Tableau Cloud 不使用此欄位,但您需要在每一列中劃定其界限,以正確地放置後面的欄位。
License level。可以是「Creator」、「Explorer」、「Viewer」或「Unlicensed」。
管理員層級:值可以是「雲端」、「站台」或「無」。雲端 = 雲端管理員,站台 = 站台管理員,無 = 非管理員。
附註:雲端管理員值僅在將使用者匯入 Tableau Cloud Manager 時可用。它不適用於 Tableau Cloud 站台。有關詳細資訊,請參閱使用 Tableau Cloud Manager 管理使用者。
發佈能力。可接受的值為「Yes/True/1」或「No/False/0」。如果授權層級為 Creator,則發佈能力必須為 Yes/True/1。
驗證類型(僅限 Tableau Cloud Manager):用於存取站台或 Tableau Cloud Manager 的使用者驗證類型。
CSV 檔案範例條目
Tableau Cloud 站台
以下範例顯示一個使用者,該使用者將被授予「Explorer」網站角色、將不會是網站管理員,並且將能夠發佈其有適當內容權限的專案。
user1@domain.com,,,Explorer,None,true
透過變更 administrator-level 列,您將能以具有「網站管理員 Explorer」網站角色的網站管理員形式匯入以下使用者。
adminuser@domain.com,,,Explorer,Site,true
Tableau Cloud Manager
以下範例顯示了使用者在 Tableau Cloud Manager 中被授與雲端管理員角色,並使用具有 MFA 的 Tableau 進行驗證。
,cloudadminuser@domain.com,,,,Cloud,,Tableau with MFA
透過變更驗證欄,可以使用替代驗證類型(若已在 Tableau Cloud Manager 設定中設定)匯入下列使用者。
,cloudadminuser@domain.com,,,,Cloud,,Salesforce
說明
如果 CSV 檔案僅包含使用者名值(電子郵件地址),則使用者將會收到邀請其存取網站的電子郵件。使用者可以聯接網站以建立帳戶,但在管理員設定他們的帳戶(顯示名稱、授權層級等)之前,他們的帳戶會保持未授權狀態。
Tableau Cloud 不使用密碼(第二個值)和顯示名稱(第三個值)欄位。您為這兩個欄位指定的值將被忽略。
但是,如果想為使用者設定授權和發佈存取權限,則檔仍需要包含這兩個欄位的分隔符號,如前面的範例中所示。
新使用者在首次登入到 Tableau Cloud 時必須選取密碼和顯示名稱。如果使用者已經有 Tableau 帳戶(例如 Tableau 社群論壇的帳戶),則他們已有密碼。
CSV 檔案未包含用於設定驗證類型(Tableau、Google 或 SAML)的欄位。在匯入檔案時,請在 Tableau Cloud 中指定該類型。此設定適用於所有匯入的使用者,您可以在之後為個別使用者變更驗證類型。
附註:或者,您可以使用
tabcmd
來匯入使用者並設定驗證類型和適用於 CSV 檔案中所有使用者的網站角色。有關資訊,請參閱 createsiteusers filename.csv。
CSV 設定和網站角色
使用者的授權層級、管理員和發佈設定確定如何在匯入過程中設定使用者的網站角色。下表顯示這些設定如何轉換為網站角色。
CSV 設定 | 網站角色 |
---|---|
License level=Unlicensed Administrator=Cloud Publisher=false | 雲端管理員。只有在登入 Tableau Cloud Manager(即未登入特定站台)時匯入使用者的情況下,此設定才有效。 |
License level=Creator 或 Explorer Administrator=Site Publisher=true | 網站管理員 Creator 或網站管理員 Explorer。只有在登入到特定網站的同時匯入使用者,此設定才有效。 |
License level=Creator Administrator=None Publisher=true | Creator |
License level=Explorer Administrator=None Publisher=true | Explorer (可發佈) |
License level=Explorer Administrator=None Publisher=false | Explorer |
License level=Viewer Administrator=None Publisher=false | Viewer |
License level=Unlicensed Administrator=None Publisher=false | 未授權 |