跳转到主要内容
登录

如何自动化作业导入?

工程
  • 更新

在设置自动导入之前，请先完成一个测试CSV导入。如果您有关于导入测试CSV的问题，请直接联系您的客户成功经理。

为了使用作业导入器，首先需要创建一个API Key。API键是允许应用程序访问数据子集的唯一令牌。您的API密钥应该像密码一样被对待，并保持安全。

创建API密钥

为了创建一个API密钥，请在将要运行MachineMetrics Job Importer服务的机器上执行以下步骤。首先,导航到https://app.machinemetrics.com/account/api-keys．在屏幕的右侧点击“创建API密钥”按钮。

Screen_Shot_2018-01-16_at_2.49.59_PM.png
在对话框中，给API密钥一个描述性的名称，例如“Job Importer”。你还需要勾选标签为“erp”的框，这给了关键的能力导入工作。点击“保存更改”按钮来创建您的密钥。


Screen_Shot_2018-05-07_at_11.26.15_AM.png

现在表单应该显示访问令牌了。请注意:在复制访问令牌之前不要关闭此表单，因为无法再次查看此值．如果您关闭此表单，您将需要删除您创建的API密钥，并创建一个新的。

下载作业导入服务安装程序

你可以在这里下载安装程序:https://bit.ly/mmjobimporter

安装作业导入服务

在Windows PC上运行作业导入器安装程序。按照提示操作，最终将提示您为作业导入器服务配置几个选项。“Jobs Folder”选项是服务将在其中查找要导入到MachineMetrics的作业文件的文件夹。如果这个位置是网络共享，它必须是完整的UNC路径，而不是映射的网络驱动器，因为它们是基于每个用户映射的。例如，我可能想要将文件放入“W:\ERP\JobExport”，其中“W:”是从“\\共享\集成”映射过来的，在本例中，完整路径将是“\\共享\集成\ERP\JobExport”。

Screen_Shot_2018-01-17_at_9.19.49_AM.png

“文件格式”选项指定作业文件是MachineMetrics CSV格式还是其他受支持的格式。最后，“API Key”字段是您将粘贴API访问令牌的地方。继续执行安装提示，直到安装完成。完成后，将作业文件的副本放到指定的文件夹中，作业将自动上传到MachineMetrics。

导入将在将导入文件放入正确文件夹后的30秒内启动。它的加载速度会根据文件的大小而定，但通常情况下，你可以期望它在将文件放入文件夹的一分钟内被上传。如果成功，它会进入一个名为完成，如果失败了，它会被放到一个名为隔离

如果已经存在与文件中作业同名的活动(非归档)作业，则将使用文件中提供的信息更新该作业。如果一个作业不存在或以前存档过，它将被创建;如果一个作业存在于MachineMetrics中，但没有出现在作业文件中，它将被存档。

故障排除

作业导入器将信息记录到“MachineMetrics”日志中的“应用程序和服务”部分的Windows事件查看器中。如果作业导入器有问题，请使用“Save All Events As…”从Windows事件查看器检索日志。按钮，将“另存为类型”更改为“csv”，并将文件连同申请支援的电子邮件一并收纳。

如果您看到与服务不能访问指定的文件夹有关的错误，或者该文件夹不存在，则该服务可能对网络位置没有适当的访问权限。如果网络位置需要身份验证，则需要以具有从该文件夹读取权限的用户身份运行该服务。您可以从Windows服务列表中执行此操作。在列表中找到MachineMetrics Job Imported，右键单击它，点击Properties，然后点击“Log on”选项卡。选择“此帐户”，输入用户名“域\用户名”，并确认密码。单击“OK”并重新启动服务以作为新用户运行。

通过脚本导入作业

如果您不使用Windows计算机，或者希望禁用作业导入器服务的自动归档功能，那么使用脚本导入作业可能是正确的选择。自动归档将归档所有未在您正在上传的最新csv中列出的作业。

重要提示:要使用此方法，建议您熟悉脚本或联系您的it以获得帮助。

要导入作业，我们将使用一个API请求，特别是/ /导入工作我们生产api的端点。关于此端点的更多文档请参见此处．

Linux和macOS

  1. 打开一个文本编辑器(BBEdit，终端编辑器，如nano或vim等)并粘贴下面的cURL
curl——location——request POST 'https://api.machinemetrics.com/jobs/import?fileFormat=mm“\
——header '授权:持有者APIKEYHERE' \
——形成“csvFile = @FILEPATHHERE '
  1. 替换文本APIKEYHERE使用您在上面一节中生成的API密钥
  2. 替换文本FILEPATHHERE要导入的.CSV文件的位置
  3. 将文件保存为.sh格式
  4. 通过您喜欢的任何方式自动运行您的脚本，最常用的方法是Cron Job。有关使用Cron的信息，看看这篇文章

请注意:您可能需要扩展您的脚本或目标CSV的权限!运行命令chmod + x filename.sh将使您的脚本可执行。

窗户

对于Windows版本，我们使用了一个略有不同的cURL脚本。这个版本创建了一个log.txt文件，您可以在导入时使用该文件。

  1. 打开一个文本编辑器，例如(notepad, notepad++等)，并粘贴下面的cURL
@echo掉
设置url = https://api.machinemetrics.com/jobs/import?fileFormat=mm
设置apiKey = APIKEYHERE
设置filePath =用户/卡伦/文件/ export.csv
curl——location -X POST -F "csvFile=@/%filePath%"——url% url% -H "授权:持有者%apikey%" -i > log.txt .txt
  1. 替换文本APIKEYHERE使用您在上面一节中生成的API密钥
  2. 将filePath替换为要导入的. csv文件的位置。我们在这里留下了一个文件路径作为示例
  3. 将文件保存为.bat格式
  4. 您可以根据自己的喜好自动运行批处理文件。一种方法是Windows任务调度程序。请参阅这篇文章以获得一些信息关于如何设置


如果您有任何问题，请随时联系您的客户支持经理或发送电子邮件至support@machinemetrics.com

    相关文章

    评论

    0评论

      文章停止评论。

      由Zendesk