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

未许可

感谢您的反馈!