CSV 导入文件准则

若要导入用户，您可以使用服务器或站点管理页面或 tabcmd 实用工具。使用 tabcmd 提供用于为 CSV 文件中的所有用户分配站点角色的选项。有关信息，请参见导入用户或createsiteusers filename.csv。

您可以在站点或服务器级别导入用户。如果将用户导入到服务器（而不是导入特定站点），则不会将用户分配到站点，并且会以“未许可”方式导入用户。

注意：除非另有说明，否则本主题中指定的准则适用于配置或未配置身份池(链接在新窗口中打开)的 Tableau Server。

其他导入文件选项

CSV 文件可按以下顺序包含以下字段：

• User name。用户名。如果服务器配置为使用 Active Directory，则此值必须与 Active Directory 中定义的用户匹配。如果用户名在域之间不唯一，则必须包括域作为用户名的一部分（例如，example\Adam 或 adam@example）。这是唯一需要的字段。

  如果将用户添加到身份池(链接在新窗口中打开)，请确保以下内容：

  • 如果将用户添加到使用 AD 作为其身份存储的身份池，请确保使用 AD sAMAccountName 值作为用户名。
  • 如果将用户添加到使用 LDAP 作为其身份存储的身份池，请确保使用 LDAP 用户名值作为用户名。

• Password。用户的密码。如果服务器配置为使用 Active Directory，则不使用此值。

• Display name。显示名称是用于在服务器上标识用户的信息的一部分。如果用户的显示名称已在使用，Tableau Server 将使用 CSV 文件中的设置更新现有用户信息。如果服务器配置为使用 Active Directory，则不使用此值。

• License level。可以是“Creator”、“Explorer”、“Viewer（查看者）”或“Unlicensed”。

• 管理员级别（System、Site 或 None）。此设置确定是否以管理员形式导入用户。

  如果使用 Web UI 导入用户，则只有在服务器（所有站点）级别导入文件时，您才能将管理员站点角色设置为“System”。如果登录到特定站点，并且 CSV 文件中用户的管理员列设置为“System”，则 Tableau Server 将以站点管理员形式导入用户。

• 发布能力（yes/true/1 或 no/false/0）。如果使用 Web UI，则只有在登录到特定站点的同时进行导入才会使用发布者设置。如果在服务器（所有站点）级别导入用户，则不使用此值。

• 电子邮件地址。电子邮件地址是用于在服务器上识别用户的信息的一部分。如果电子邮件地址已在使用，Tableau Server 将使用 CSV 文件中的设置更新现有用户信息。

如果将用户添加到身份池，除了上述值之外，还需要以下值：

• 身份池名称。您要将用户添加到其中的身份池的名称。

• 标识符。您要添加的用户的标识符。标识符仅用于身份匹配目的。有关详细信息，请参见Tableau 中的用户名和标识符。

  注意：

  • 如果您要将用户添加到身份池并且未指定身份池名称，则会将用户添加到初始池（TSM 配置），这是 Tableau Server 设置期间在 TSM 中预置的用户集。

  • 对于用户名值，请确保以下内容：

    • 如果将用户添加到使用 AD 作为其身份存储的身份池，请确保使用 AD sAMAccountName 值作为用户名。
    • 如果将用户添加到使用 LDAP 作为其身份存储的身份池，请确保使用 LDAP 用户名值作为用户名。

重要信息：列的顺序非常重要。将第一列视为用户名，将第二列视为密码，将第三列视为显示名称等等，而不考虑列中的内容。如果忽略字段的值，您必须仍然包括字段的逗号分隔符。

说明

• 如果未登录到特定站点，并且在服务器级别导入用户，则只能分配“服务器管理员”和“未许可”站点角色。

• 如果有基于用户的服务器安装，并且添加用户会超出许可证允许的用户数，则会以未许可用户形式添加用户。

• 如果使用 tabcmd 并指定许可证，但导入用户会超出许可证限制，则会以“未许可”方式导入用户。

Tableau Server 的 CSV 导入示例

以下示例显示了一个包含若干用户的信息的 CSV 文件。

如果在管理站点的同时导入此文件，则会向该站点中添加四个用户。用户 Michelle 的 Administrator 设置为 System。但是，由于您在将用户导入站点，Tableau Server 会为 Michelle 授予“站点管理员 Creator”站点角色。其中三个用户允许进行发布。

如果在管理服务器的同时导入此文件，则会向服务器中添加四个用户，但不会将它们添加到任何站点。只会导入一个用户作为服务器管理员；其余用户设置为“未许可”。

以下示例显示了一个 CSV 文件，其中包含添加到身份池的两个用户的信息。