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

未授權

感謝您的意見反應!已成功提交您的意見回饋。謝謝!