CSV 匯入檔案指導方針

透過建立含有使用者資訊的逗號分隔值 (CSV) 檔案,然後匯入該檔案,即可自動新增使用者。您可以在 CSV 檔案中包括屬性(例如授權層級和發佈存取權限),以便在匯入這些屬性的同時將它們應用於使用者。

若要匯入使用者,您可以使用站點管理頁面或 tabcmd 公用程式。使用 tabcmd 提供用於為 CSV 檔案中的所有使用者指派站點角色的選項。有關資訊,請參閱匯入使用者createsiteusers filename.csv

CSV 檔案格式要求

在建立用於匯入使用者的 CSV 檔案時,請確保檔滿足以下格式要求:

  • 檔不包括列標題。Tableau Online假定檔案中的每一行代表一個使用者。

  • 檔為 UTF-8 格式,並包括位元組順序標記 (BOM)。

  • 諸如 BIG-5 等字元編碼已轉換為 UTF-8。可透過在文字編輯器中開啟檔並使用「另存新檔」命令來達到此目的。

  • 如果使用者名包括的「@」字元不是表示域分隔符號,則您需要使用十六進位格式引用該符號:\0x40

    例如,user@fremont@mycompany.com 應該為 user\0x40fremont@mycompany.com

CSV 檔案中所需的列

需要為每個使用者提供以下值:

  • 使用者名:使用者的電子郵件地址。

其他 CSV 欄選項

對於每個使用者,CSV 檔案可以包含以下欄位。如果指明的話,則 Tableau Online 不使用該欄位,但必須在檔案中考慮該欄位。

  • User name。使用者的電子郵件地址。這是唯一需要的欄。

  • Password。Tableau Online 不使用此欄位,但您需要在每一列中劃定其界限,以正確地放置後面的欄位。

  • Display name。Tableau Online 不使用此欄位,但您需要在每一列中劃定其界限,以正確地放置後面的欄位。

  • License level。可以是「Creator」「Explorer」「Viewer」「Unlicensed」

  • Administrator level。可以是 SiteNone

  • 發佈能力。可接受的值為「Yes/True/1」「No/False/0」

CSV 檔案範例條目

以下範例顯示一個使用者,該使用者將被授予「Explorer」網站角色、將不會是網站管理員,並且將能夠發佈其有適當內容權限的專案。

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

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

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

說明

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

  • Tableau Online 不使用密碼(第二個值)和顯示名稱(第三個值)欄位。您為這兩個欄位指定的值將被忽略。

    但是,如果想為使用者設定授權和發佈存取權限,則檔仍需要包含這兩個欄位的分隔符號,如前面的範例中所示。

  • 新使用者在首次登入到 Tableau Online 時必須選取密碼和顯示名稱。如果使用者已經有 Tableau 帳戶(例如 Tableau 社群論壇的帳戶),則他們已有密碼。

  • CSV 檔案未包含用於設定驗證類型(Tableau、Google 或 SAML)的欄位。在匯入檔案時,請在 Tableau Online 中指定該類型。此設定適用於所有匯入的使用者,您可以在之後為個別使用者變更驗證類型。

    附註:或者,您可以使用 tabcmd 來匯入使用者並設定驗證類型和適用於 CSV 檔案中所有使用者的網站角色。有關資訊,請參閱 createsiteusers filename.csv

CSV 設定和網站角色

使用者的授權層級、管理員和發佈設定確定如何在匯入過程中設定使用者的網站角色。下表顯示這些設定如何轉換為網站角色。

CSV 設定 網站角色

授權層級 =(任意)

Administrator=System

Publisher=true

伺服器管理員。此設定僅適用於 Tableau Server only,並且只有在管理伺服器(即,未登入到特定網站)的同時匯入使用者才有效。

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

未授權

感謝您的意見回饋!