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 | 未许可 |