DatistEQ之微服务变形记

WebAPI是对接各种客户端（浏览器，移动设备），构建http服务的框架，无状态，相对webservice更轻量级^[1]。数据专家中提供访问WebAPI的节点，名为“微服务”，您只要需要提供一个WebAPI的服务地址，剩下的事件就可以交给数据专家了。

一、节点的两种形态

微服务节点有两种形态，一种是数据源节点，固定参数方式，运行时根据界面参数，从WebAPI中获取运行结果，只运行一次；另一种是数据处理数据，需要一个前节点，运行时从数据流中取值作为参数，逐行访问WebAPI服务收集其运行结果。

微服务节点的两种形态

在节点编辑器节点形态栏中，可以设置微服务节点的形态。选中“数据源”，即指定为数据源节点形态。选中“数据处理”，即指定为数据处理节点形态。数据源形态下，不允许该节点有任何前节点，因而，当保存参数设置时，系统将自动清除它的前节点。

二、节点编辑器

数据专家获得一个服务地址URL后，会对URL中的参数进行解析，并创建参数界面。以获取地震推荐报告服务为例，服务URL地址为：https://earthstack-search.search.azure.cn/indexes/azuretable-index/docs?api-key=&api-version=2020-06-30&search=云南，将URL文本粘入API文本框之后，系统从地址中解析出api-key、api-version和search三个参数，并创建了三个参数文本框。

参数自动解析

三、节点运行

修改参数的值，运行节点，即可从WebAPI的服务器上获取运行结果。

地震推荐报告

案例中，服务返回的是JSON文本串，使用JSON解析节点可以从中抽提出各个属性的内容，将其转换成结构化的二维表格的格式。

地震推荐解析结果

数据处理形态与数据源形态使用方法基本相当，这里不再赘述。

四、几个注意事项

1、 微服务节点的两种形态，在数据专家的工具箱中是一个节点，只是通过设置让其变成两种形态。同时，两种形态在数据专家流程编辑区的节点样式、前节点的需求等行为是不一样的。

2、 WebAPI有get、post、put等多种类型，微服务节点只支持get的方式，也就是说可以直接通过浏览器地址直接访问的那种类型。

3、WebAPI通常是需要认证的，需要将认证的key以参数的形式拼到url地址去中，如本案例中的 api-key。同时，您还得必须获取正确的key才能访问服务。

4、 WebAPI返回的结果有json、xml等多种类型，通常可以指定类型去访问的。跟其返回的结果类型，在数据专家中可以使用不同的节点对它进行结构化处理。

五、总结

微服务节点旨在从网络服务中获取数据，它有两种形态，一种是固定参数访问，另一种依据前节点数据访问。结合其他解析类的节点，可以快速将网络服务中的数据引入数据流程之中，以便于分析与应用。