创建JavaScript服务编排

操作场景

当您需要编排复杂的联表查询的SQL语句，或者工业数字模型驱动引擎-数据建模引擎（xDM Foundation，简称xDM-F）提供的标准接口无法满足您实际业务场景时，您可以通过JavaScript服务编排实现。本文为您介绍如何使用JavaScript服务编排。

前提条件

• 已登录应用运行态。
• 登录应用运行态的用户，首次使用“服务编排管理 > 高代码编排”功能前，必须完成《服务编排安全承诺书》的阅读与提交。

操作步骤

1. 在左侧导航栏中，选择“服务编排管理 > 高代码编排”，进入“高代码编排”页面。
2. 单击“创建”。
3. 根据页面提示，配置如下信息。
   图1 服务定义
   

   表1 服务定义-基本信息

   参数	参数说明
   API英文名称	填写服务编排的英文名称。
   API中文名称	填写服务编排的中文名称。
   API英文描述	填写服务编排的英文描述。
   API中文描述	填写服务编排的中文描述。
   责任人	填写服务编排的责任人。
   API类型	支持Java和JavaScript两种类型，此处选择“JavaScript”类型。
   是否支持分页	是：返回结果会进行分页拉取数据。 否：只返回1000条数据。
   标签	如果您有可使用的标签，可选择“添加标签”。 如果您没有可使用的标签，可选择“自定义”。

4. 单击“保存”。
5. 在“脚本显示”页签的代码编辑框中，编写JavaScript服务编排的SQL脚本。
   图2 JavaScript服务编排脚本
   

6. 完成脚本编排后，单击左上方的“保存”，保存脚本。系统每隔30秒会自动保存脚本内容。
   • 如果脚本代码错误，会在代码编辑框中出现报错提示，请根据页面提示处理。
     图3 报错提示
     
   • 如果您想重新对脚本代码进行排版，您可以单击右上方的“代码格式化”，一键格式化SQL脚本。
     图4 代码格式化
     
   • 如果您想查看脚本生成的SQL在对应数据库的执行计划，您可以先在“模拟API-输入参数”中输入参数，然后单击“查看执行计划”即可查看。
     图5 查看执行计划
     
   • 如果您想查看执行脚本实际会执行的SQL语句，您可以先在“模拟API-输入参数”中输入参数，然后单击“查看SQL”，查看最终执行的SQL。
     图6 查看SQL
     
   • 如果您想验证脚本的正确性或者验证脚本是否符合预期，您可以在“模拟API-输入参数”中通过“Json”和“Table”两种输入方式输入参数，单击“运行并保存”进行验证。

     系统将在“输出结果”中返回运行结果，便于确认脚本是否符合预期。

     图7 输出结果
     

     当脚本执行出现异常时，切换至“日志”页签，系统自动展示系统错误堆栈（如异常类型、错误行等）或是用户自定义的日志信息（如通过XdmJsLog.log("mylog")等方法输出的业务标记信息）。

     图8 日志信息
     

7. 确认脚本编写完成后，单击“发布”，生成服务编排API。

   此时，您可以选择“服务预览”页签，通过可视化页面预览生产环境的运行效果。

   您也可以前往“数据服务管理 > 全量数据服务”的“服务编排”，获取该服务编排的API信息，通过API方式调用此服务编排。