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 文件中所需的列

需要为每个用户提供以下字段:

  • Username:用户的电子邮件地址。

  • Password。Tableau Cloud 不使用此字段,但您需要在每一行中划定其界限,以正确地放置后面的字段。

其他 CSV 列选项

对于每个用户,除了必需的列之外,CSV 文件可以包含以下字段。如果指明的话,则 Tableau Cloud 不使用该字段,但必须在文件中考虑该字段。

  • 站点 URI(仅限 Tableau Cloud Manager):站点的统一资源标识符。若要将用户导入为云管理员,请包含站点 URI 列,但将其留空。

  • Display name。Tableau Cloud 不使用此字段,但您需要在每一行中划定其界限,以正确地放置后面的字段。

  • License level。可以是“Creator”“Explorer”“Viewer(查看者)”“Unlicensed”

  • 管理员级别:值可以是“Cloud”“Site”“None”。Cloud = 云管理员,Site = 站点管理员,None = 非管理员。

    注意:仅当将用户导入 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

通过更改 authentication 列,您可以使用备用身份验证类型导入以下用户(如果在 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

未许可

感谢您的反馈!您的反馈已成功提交。谢谢!