# 纯脚本服务定义
#### 操作场景
聚合服务编排支持创建纯脚本服务，开发人员可直接开发脚本服务。
图1创建纯脚本服务流程图   
![](https://support.huaweicloud.com/instg-idme/figure/zh-cn_image_0000001883150970.png)
#### 前提条件
已获取开发人员及以上权限用户的账号和密码。
#### 步骤1：定义基本信息
1. 登录LinkX-F系统首页。
2. 选择"数据服务 \> 聚合服务编排"，进入"聚合服务编排"页面。
3. 单击"创建"，弹出"创建聚合服务"界面。 
   默认进入"服务定义"页的"基本信息"阶段。
   
   
4. 根据界面提示，配置如下基本信息，如[表1]所示：
   
    表1服务定义基本信息 
   | 参数             | 说明                                                                                                                                                                                                    |
   |:---|:---|
   | API英文名称        | 根据API提供的功能，自定义API的英文名称。 必填，需以大写英文字母开头，只能包含英文字母、数字和_，长度不能超过256个字符。                                                                                        |
   | API中文名称        | 根据API提供的功能，自定义API的中文名称。 必填，只能包含中文、英文字母、数字、_、-，长度不能超过128个字符。                                                                                            |
   | API英文描述        | 输入API的英文描述，说明API的功能等信息。 必填，不能包含中文字符，长度不能超过1024个字符。                                                                                                    |
   | API中文描述        | 输入API的中文描述，说明API的功能等信息。 必填，长度不能超过1024个字符。                                                                                                             |
   | API责任人         | 必填，选择服务的责任人。                                                                                                                                                                                          |
   | 维护人            | 非必填，选择服务的维护人。                                                                                                                                                                                         |
   | 关联领域           | 非必填，选择聚合服务的关联领域，下拉可选值来源于"基础数据管理 \> 领域"的数据。                                                                                                                                                            |
   | 数据源            | 选择聚合服务实例数据所读取的实例数据库。 必填，仅可选在"基础数据管理 \> 数据源"中，数据源定义"是否用于聚合服务"值为"是"的图数据库和关系型数据库。 此处选择关系型数据库类型。            |
   | 是否纯脚本服务        | 根据已选数据源类型自动选择值，此处默认为"是"，暂不支持修改。                                                                                                                                                                       |
   | 脚本类型           | 根据已选数据源类型自动选择脚本类型，此处默认"SQL"，暂不支持修改。                                                                                                                                                                   |
   | 支持服务运行结果保存为数据集 | 将API运行结果保存为数据集，后续可直接查表获取服务运行结果，无需再去调用API。 必填，支持选择"是"或"否"。如果选"是"，API发布成功后，您还需完成[数据集配置](https://support.huaweicloud.com/instg-idme/idme_instg_0163.html)。 |
      
   
   
5. 填写完后单击"保存并下一步"。 
   进入[步骤2：新增入参]阶段。
   
   
 
 #### 步骤2：新增入参
设置入参是指调用API时，设置需要传入的参数。系统提供默认入参参数，您还可根据需要通过自定义入参方式新增入参。**请注意，** **设置入参前，请确认目标服务已进入编辑状态。**
表2默认入参参数说明 
| 参数         | 说明                     |
|:---|:---|
| pageSize   | 必填，每页条目数，即每页显示的数据条目数。  |
| pageNumber | 必填，分页页码，即返回指定页码的数据条目数。 |
   
以下步骤仅指导您如何通过自定义入参方式新增入参参数。如需了解更多设置入参的操作，详细请参考[表3](https://support.huaweicloud.com/instg-idme/idme_instg_0349.html#ZH-CN_TOPIC_0000001881237514__table85644332187)。
1. 选择"服务定义 \> 设置入参"阶段，进入设置入参页面。
2. 单击"新增入参"，填写参数如[表3]所示：
   
    表3参数说明 
   | 参数      | 说明                                               |
   |:---|:---|
   | 自定义入参名称 | 必填，长度不超过128个字符，名称必须以字母开头，只能包含字母、数字、下划线，不能重复。     |
   | 描述      | 必填，长度不超过1024个字符。                                 |
   | 数据类型    | 非必填，单选，下拉取值：文本、数值、布尔值、日期、人员、文件、URL。              |
   | 是否必填    | 非必填，手动选择。                                        |
   | 默认值     | 非必填，长度不超过128个字符，当数据类型为布尔值时，默认值为下拉框，可选true或false。 |
      
   
   
3. 单击"保存"。
4. 完成入参设置后，单击"下一步"。 
   进入[步骤3：新增出参]阶段。
   
   
 
 #### 步骤3：新增出参
出参是指调用API后返回给调用方的数据， 设置出参是指设置需要传出的参数。**请注意，** **设置出参前，请确认目标服务已进入编辑状态。**
以下步骤仅指导您如何通过自定义出参方式新增出参参数。如需了解更多设置出参的操作，详细请参考[表5](https://support.huaweicloud.com/instg-idme/idme_instg_0349.html#ZH-CN_TOPIC_0000001881237514__table14413516194)。
1. 选择"服务定义 \> 设置出参"阶段，进入设置出参页面。
2. 单击"新增出参"，填写参数如[表4]所示：
   
    表4新增出参 
   | 参数        | 说明                                                                                                                                                                               |
   |:---|:---|
   | 自定义出参名称   | 必填，长度不超过128个字符，名称必须以字母开头，只能包含字母、数字、下划线，不能重复。                                                                                                                                     |
   | 是否自定义密级   | 必填。取值"是"或"否"。 如果选"是" ：则该出参密级固定为用户定义的值。 如果选"否"：则该出参密级与对应数据实体属性密级保持一致，随数据实体属性密级刷新而变化。 |
   | 选择类型      | 必填。                                                                                                                                                                              |
   | 数据实体/关系实体 | 必填。                                                                                                                                                                              |
   | 属性名称      | 必填。                                                                                                                                                                              |
   | 出参密级      | 必填，在下拉框中可选"内部公开"、"秘密"、"机密"、"绝密"。                                                                                                                                                 |
   | 描述        | 必填，长度不超过1024个字符。                                                                                                                                                                 |
   | 数据类型      | 非必填，单选，下拉取值：文本、数值、布尔值、日期、人员、文件、URL。                                                                                                                                              |
      
   
   
3. 单击"保存"，配置出参成功。 
   继续参考[步骤6：生成API]。
   
   
 
 #### 步骤6：生成API
生成API是指完成服务定义后，保存服务定义信息并生成目标服务。**请注意，纯SQL脚本服务，可以不生成API直接进入服务开发阶段。**
1. 选择"服务定义 \> 设置出参"阶段，进入设置出参页面。
2. 生成API时需区分不同的操作场景，具体如下。 
   - 如果是新增场景，请单击"生成API"。
   
   - 如果是修改场景，请单击"部署"。
   
   
   
   
 
#### 后续操作
完成以上步骤后，您可进入[服务开发](https://support.huaweicloud.com/instg-idme/idme_instg_0151.html)阶段，继续执行编辑脚本、运行脚本等操作，快速调测服务。