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 文件中所需的列
需要为每个用户提供以下值:
用户名:用户的电子邮件地址。
其他 CSV 列选项
对于每个用户,CSV 文件可以包含以下字段。如果指明的话,则 Tableau Cloud 不使用该字段,但必须在文件中考虑该字段。
User name。用户的电子邮件地址。这是唯一需要的列。
Password。Tableau Cloud 不使用此字段,但您需要在每一行中划定其界限,以正确地放置后面的字段。
Display name。Tableau Cloud 不使用此字段,但您需要在每一行中划定其界限,以正确地放置后面的字段。
License level。可以是“Creator”、“Explorer”、“Viewer(查看者)”或“Unlicensed”。
Administrator level。可以是 Site 或 None。
发布能力。可接受的值为“Yes/True/1”或“No/False/0”。如果许可证级别为 Creator,则发布能力必须为 Yes/True/1。
CSV 文件示例条目
以下示例显示一个用户,该用户将被授予“Explorer”站点角色、将不会是站点管理员,并且将能够发布其有适当内容权限的项目。
user1@domain.com,,,Explorer,None,true
通过更改 administrator-level 列,您将能以具有“站点管理员 Explorer”站点角色的站点管理员形式导入以下用户。
adminuser@domain.com,,,Explorer,Site,true
说明
如果 CSV 文件仅包含用户名值(电子邮件地址),则用户将会收到邀请其访问站点的电子邮件。用户可以联接站点以创建帐户,但在管理员配置他们的帐户(显示名称、许可级别等)之前,他们的帐户会保持未许可状态。
Tableau Cloud 不使用密码(第二个值)和显示名称(第三个值)字段。您为这两个字段指定的值将被忽略。
但是,如果想为用户设置许可证和发布访问权限,则文件仍需要包含这两个字段的分隔符,如前面的示例中所示。
新用户在首次登录到 Tableau Cloud 时必须选择密码和显示名称。如果用户已经有 Tableau 帐户(例如 Tableau 社区论坛的帐户),则他们已有密码。
CSV 文件未包含用于设置身份验证类型(Tableau、Google 或 SAML)的字段。在导入文件时,请在 Tableau Cloud 中指定该类型。此设置适用于所有导入的用户,您可以在之后为个别用户更改身份验证类型。
注意:或者,您可以使用
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 | 未许可 |