CSV 导入文件准则
- 版本 :2022.1 及更高版本
通过创建含有用户信息的逗号分隔值 (CSV) 文件,然后导入该文件,即可自动添加用户。您可以在 CSV 文件中包括属性(例如许可级别和发布访问权限),以便在导入这些属性的同时将它们应用于用户。 若要导入用户,您可以使用站点管理页面或 tabcmd 实用工具。使用 tabcmd 提供用于为 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。可以是 Site 或 None。
发布能力。可接受的值为“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 | 未许可 |