目标

根据员工数据创建自动流程，及时更新员工数据。 它将使您能够在 Actimo 中使用人力资源或 IT 系统中的所有可用数据，并确保根据员工在公司内的工作历程来创建和删除他们。

该集成将充当数据副驾驶员，帮助您专注于与员工建立联系。

要求

要使用 CSV 集成，您需要满足以下要求。

• 购买集成选项（如果不确定，请联系我们的支持人员）

• 通过基本认证访问 sftp 服务器或网络服务器

• 能够将包含员工数据的 csv 文件转存到服务器上

• Actimo 中的管理访问

• 我们可以为每个客户提供一个 CSV 集成。

• 文件名必须保持不变，不得包含日期或类似内容。

• 该文件应包含所有员工。 创建、删除和更新均由我们处理。

• 第一行应该是解释不同栏目的标题行。

• 需要有一个唯一 ID，即使员工更换职位、姓名、电子邮件或类似信息也不会改变。 通常是源系统中的主标识。

• 姓名需要用 "名 "和 "姓 "分开。

• 国家代码可以是手机号码的一部分，也可以是单独的一列，但需要用来正确解析电话号码。

• 您可以使用唯一标识号创建员工关系，通常是一个包含经理唯一标识号的 manager_id 列。

• 您可以根据类型为不同的列添加验证。 如果验证失败，则不会将该员工转移到 Actimo；如果之前已经转移，则会删除该员工。

• 字符串"等于"、"空 "和 "非空"

• 编号：">"、">="、"<"和"<="

• 日期："现在之前或空 "和 "现在之后或空"。

案例

在本方案中，我们将使用一个案例来说明如何设置集成。 假设我们是零售商，希望为不同地区、职能和部门的 500 名员工运行一个员工应用程序。 我们还知道，尽管我们将运行一个本地应用程序，但人们还是希望能够发送短信和电子邮件。 我们的任务是整合并自动处理员工数据。 我们现在有以下工作：

• 导入相关数据，以便我们的宣传部门与员工联系，并使用 智能群组 和 供稿将员工区分开来

• 确保删除停止在公司工作的人员

• 确保自动添加新员工

• 补充：我们还被要求尝试看看能否通过集成将直接管理连接到员工 i Actimo

启动步骤

步骤 1：需要哪些数据？

您需要与您的团队沟通，并确保您有相关数据来实现您要达到的目标。 在本例中，我们将抓取以下数据：

• 名

• 姓氏

• 雇员 id（或雇员的其他唯一标识符）

• 标题

• 工作职能

• 店铺

• 地区

• 国家代码

• 手机号码

• 电子邮件

• 经理雇员 ID（显示雇员经理 ID 的列）

提示：向人力资源部门/IT 部门索取 CSV 文件的示例，并将其插入到 sftp 服务器中，这样您就能大致了解可以选择哪些数据。 以后在 Actimo 中将不同列映射到联系人的字段时，也需要这个文件。 

当您第一次使用 Actimo 中的示例数据测试集成时，也可以看到列名。

第 2 步：设置 Actimo 以接收员工数据

一旦决定了要拍摄的数据，就需要准备好正确的字段，以便在 Actimo 中抓取数据。 为此，我们使用了联系字段。

转到右上角的管理页面 --> 点击联系人

Actimo 自带默认字段，如国家、员工 ID、姓名等。 您需要确定是否有与当前设置不符的数据。 在我们的示例中，我们为商店和功能创建了一个新的自定义字段。 点击保存后，它们就可以使用了。

准备 Actimo 平台的另一个重要步骤是选择复制密钥设置。 这样就能确保平台中不会出现重复的员工。 它必须是员工 100%独有的。

使用集成时，需要将下拉菜单设为 "源数据"。

转到右上角的 "管理员" --> 单击 "联系人" --> 向下滚动到页面底部

提示：在某些情况下，您可能没有员工 ID，这时您可以使用电子邮件。 请写信到support@actimo.com 如果您有任何问题，请致电技术支持

第 3 步：让我们连接 Actimo 和您的 SFTP 服务器

在同步所有数据之前，我们需要将两个系统连接起来。

转到右上角的管理页面 --> 单击集成 --> 单击添加外部 CSV

您需要从 IT 部门或负责设置 SFTP 服务器的人员那里获得大量信息。 红色标记的字段为必填字段。 请参见下面的字段解释。

• CSV 文件的完整 URI 模式：sftp:// 或 https:// 实际文件的完整路径。 如果端口与标准端口不同（sftp 22、https 443），则需要将其包括在内。

• 字段分隔符：使用的分隔符类型，通常是分号、逗号或 ; -，但也可以是其他分隔符。

• 编码：通常为 utf8 或 latin1 - 默认为 utf8

• 文件没有标题行：在 CSV 中，第一行通常定义了列名。 如果文件中没有定义行，则必须勾选该复选框。

• 凭证（用户名、密码、口令、私人密钥）：

• 如果协议是 https，则总是用户名和密码

• 如果协议是 sftp，则可以是用户名和密码，或用户名和私钥，或用户名和私钥及口令，或用户名和密码及私钥及口令。

填写设置信息 --> 点击底部的保存 --> 点击测试

现在，您应该可以看到一条绿色的确认信息，告诉您已经连接，并显示 CSV 文件中的数据示例。

步骤 4：将 CSV 数据映射到 Actimo 中的联系人

我们必须确保将正确的数据映射到 Actimo 中联系人的正确字段上。 这将使您能够使用智能组对特定商店、地区、职能等的所有员工进行自动分组。

转到右上角的管理页面 --> 单击集成 --> 向下滚动并单击广告自定义字段。

这样做的目的是确保员工数据正确插入 Actimo 的联系人字段。 方法是为列标题创建一个字段，然后将其映射到 Actimo 中的正确字段。 

单击 + 添加自定义字段 --> 写入与 CSV 中标题相同的名称 --> 保存 --> 映射到 Actimo 中的字段。

然后，只需按照本指南中的步骤 1，确保将 CSV 中的所有 CSV 列映射到 Actimo 中的字段即可。

最后，您可以选择希望将数据插入哪个工作区。 我们建议将其导入到您的主工作区，除非您有特殊需要，否则只在您的账户上运行一个工作区。 如有需要，请联系我们的支持人员。

完成数据映射后点击保存。

步骤 5：同步到 Actimo

完成上述所有步骤后，就可以开始集成了。

转到右上角的管理页面 --> 单击集成 --> 单击立即同步

您会发现所有员工都会被插入 Actimo 的联系人中。 点击联系人即可查看数据。 它应该是这样的

sFTP 可以使用的支持密码有

Chacha20-poly1305@openssh.com、

aes128-ctr、

aes192-ctr、

aes256-ctr、

aes128-gcm@openssh.com、

aes256-gcm@openssh.com

如有必要，请致函我们的 IP 白名单支持部门 support@actimo.com，或者与您的集成专家（如果已为您分配了一名集成专家）沟通。

标签：自定义、字段、联系人、集成、SFTP、CSV、URI、密码