在设置自动导入之前,请先完成一个测试CSV导入。如果您有关于导入测试CSV的问题,请直接联系您的客户成功经理。
为了使用作业导入器,首先需要创建一个API Key。API键是允许应用程序访问数据子集的唯一令牌。你的API密钥应该像密码一样对待,并保持安全。
创建API密钥
要创建API密钥,请在运行MachineMetrics Job Importer服务的机器上执行以下步骤。首先,导航到https://app.machinemetrics.com/account/api-keys.在屏幕的右侧点击“创建API Key”按钮。
在对话框中,给API Key一个描述性的名称,例如“Job Importer”。您还需要选中标签为“erp”的框,该框赋予键导入作业的能力。点击“保存更改”按钮来创建您的密钥。
现在表单应该显示您的访问令牌。请注意:在复制访问令牌之前不要关闭此表单,因为您无法再次查看此值.如果您关闭此表单,您将需要删除您创建的API密钥,并创建一个新的。
下载作业导入服务安装程序
你可在此下载安装程式:https://bit.ly/mmjobimporter
安装作业导入服务
在Windows PC上运行作业导入器安装程序。按照提示进行操作,最终将提示您配置Job Importer Service的几个选项。“Jobs Folder”选项是服务将在其中查找要导入到MachineMetrics中的作业文件的文件夹。如果此位置是一个网络共享,则它必须是完整的UNC路径,而不是映射的网络驱动器,因为这些位置是按每个用户映射的。例如,我可能想把文件放在“W:\ERP\JobExport”,其中“W:”是从“\\共享\集成”映射的,在这种情况下,完整的路径将是“\\共享\集成\ERP\JobExport”。
“文件格式”选项指定作业文件是MachineMetrics CSV格式还是其他受支持的格式。最后,“API Key”字段是您将粘贴API访问令牌的地方。继续执行安装提示,直到安装完成。完成后,将作业文件的副本放在指定的文件夹中,作业将自动上传到MachineMetrics中。
导入将在将导入文件放入正确文件夹后的30秒内开始。它的加载速度取决于文件的大小,但通常情况下,您可以期望在将文件放入文件夹后的一分钟内将其上传。如果成功,它会进入一个名为完成
,如果失败,它将进入一个名为隔离
如果与文件中的作业同名的活动(非归档)作业已经存在,则该作业将使用文件中提供的信息进行更新。如果一个作业不存在或以前存档过,则将创建它,如果一个作业在MachineMetrics中存在,但在作业文件中不存在,则将对其进行存档。
故障排除
Job Importer将信息记录到“MachineMetrics”日志中的“应用程序和服务”部分中的Windows事件查看器中。如果作业导入器出现问题,请使用“将所有事件保存为…”从Windows事件查看器检索日志。按钮,并将“另存为类型”更改为“csv”,并将该文件包含在您的支持请求电子邮件中。
如果您看到与服务无法访问指定的文件夹或文件夹不存在相关的错误,则可能是该服务对网络位置没有适当的访问权限。如果网络位置需要身份验证,则需要以具有从该文件夹读取权限的用户身份运行服务。您可以从Windows服务列表中执行此操作。在列表中找到导入的MachineMetrics Job,右键单击它,单击Properties,然后单击“Log on”标签。选择“此帐户”,输入用户名“域\用户名”和密码并确认。单击“OK”并重新启动服务,以新用户的身份运行。
通过脚本导入作业
如果您不使用Windows计算机,或者希望禁用Job Importer Service的自动归档功能,使用脚本导入作业可能是正确的选择。自动归档将归档所有未在您上传的最新. csv文件中列出的作业。
重要提示:要使用此方法,建议您熟悉脚本或联系it部门以获得帮助。
为了导入作业,我们将使用一个API请求,具体来说就是/ /导入工作
我们生产api的端点。关于这个端点的更多文档在这里.
Linux和macOS
- 打开一个文本编辑器(BBEdit,终端编辑器,如nano或vim等),粘贴下面的cURL
curl——location——请求POST 'https://api.machinemetrics.com/jobs/import?fileFormat=mm“\
——header '授权:承载APIKEYHERE' \
——形成“csvFile = @FILEPATHHERE '
- 替换文本
APIKEYHERE
使用上面一节中生成的API键 - 替换文本
FILEPATHHERE
与你想要导入的.CSV文件的位置 - 将文件保存为.sh
- 通过您喜欢的任何方式自动化脚本的运行,最常见的方法是Cron Job。有关使用Cron的信息,看看这篇文章
请注意:您可能需要扩展您的脚本或目标CSV的权限!运行命令chmod + x filename.sh
将使您的脚本可执行。
窗户
对于Windows版本,我们使用了稍微不同的cURL脚本。这个版本创建了一个log.txt文件,您可以在导入过程中使用该文件。
- 打开一个文本编辑器,例如(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 "Authorization:承载%apikey%" -i > log.txt
- 替换文本
APIKEYHERE
使用上面一节中生成的API键 - 将filePath替换为要导入的. csv文件的位置。我们在这里留了一个文件路径作为示例
- 将文件保存为.bat
- 自动运行您的批处理文件,但您喜欢。一种方法是Windows任务计划程序。有关一些信息,请参阅本文如何设置它
如果您有任何问题,请随时联系您的客户支持经理或发送电子邮件给我们support@machinemetrics.com
评论
0评论
文章不接受评论。