请求地址

http://ip:port/bi/api?action=getMetricLineage

请求消息

请求参数

•token（必填）

•xmlData（必填）

<?xml version="1.0" encoding="UTF-8"?>

<info>      

<user></user>  

<getdata>      

<path>新建文件夹/血缘分析</path>    

<type>1</type>    

</getdata>

</info>

参数描述

参数为节点信息：

•user（选填）：想要查看的目标用户名。如果不填默认使用调用API的token用户的查看权限。

•path（必填）：指标的路径。

•type（必填）：指标类型。

4：cardDB，卡片。

示例

function getMetricLineage() {

       var xml = getXml();

       $.post("http://" + ip + ":" + port + "/" + project + "/api?action=getMetricLineage",

          {xmlData : xml},

          function(result) {

          writeXml(result);

       });

    }

响应消息

响应结果

•操作成功

<?xml version="1.0" encoding="UTF-8"?>

<lineage>

   <nodes>

       <node>

           <id>1</id>

           <root>true</root>

           <name>基础指标</name>

           <detailType>16649</detailType>

           <detailTypeString>基础指标</detailTypeString>

           <type>15</type>

           <path>基础指标</path>

           <assetPath>基础指标</assetPath>

           <isAsset>true</isAsset>

           <qryInDashboard>false</qryInDashboard>

       </node>

       <node>

           <id>2</id>

           <root>false</root>

           <name>Demo Data_zhCN</name>

           <detailType>16903</detailType>

           <detailTypeString>Derby</detailTypeString>

           <type>6</type>

           <path>数据源/Demo Data_zhCN</path>

           <assetPath>___CONNECTION___/Demo Data_zhCN</assetPath>

           <isAsset>true</isAsset>

           <qryInDashboard>false</qryInDashboard>

       </node>

       <node>

           <id>3</id>

           <root>false</root>

           <name>咖啡中国市场销售数据</name>

           <detailType>16897</detailType>

           <detailTypeString>SQL数据集</detailTypeString>

           <type>3</type>

           <path>咖啡中国市场销售数据</path>

           <assetPath>咖啡中国市场销售数据</assetPath>

           <isAsset>true</isAsset>

           <qryInDashboard>false</qryInDashboard>

       </node>

       <node>

           <id>4</id>

           <root>false</root>

           <name>自定义SQL语句</name>

           <path>Custom SQL Script</path>

           <detailType>1</detailType>

           <detailTypeString>SQL语句</detailTypeString>

           <type>5</type>

           <read>false</read>

           <qryPath>咖啡中国市场销售数据</qryPath>

           <qryType>16897</qryType>

           <script>SELECT * from 咖啡中国市场销售数据  </script>

       </node>

   </nodes>

   <relations>

       <relation>

           <source>1</source>

           <target>3</target>

       </relation>

       <relation>

           <source>3</source>

           <target>4</target>

       </relation>

       <relation>

           <source>4</source>

           <target>2</target>

       </relation>

   </relations>

</lineage>

•操作失败

<?xml version="1.0" encoding="UTF-8"?>

<results>

  <result>

      <level>6</level>

      <message>用户“user1”不存在。</message>

  </result>

</results>

结果描述

响应结果信息为xml，直接parse即可。

•nodes：节点列表。

•node：节点。

•id：节点id。

•dbid：如果节点类型是报告，将会返回该报告的资源ID。

•createTime：如果节点类型是报告，将会返回该报告的创建时间。

•root：节点是否是查询选中的起始节点。

•name：节点的名字。

•type：节点的类型，包含报告、组件数据集、数据表（Mongo集合）、自定义SQL、数据源，详情参考LINEAGE_RESOURCE表中的type。

•detailType：节点详细类型，适用于报告的组件类型、数据集的类型，详情参考LINEAGE_RESOURCE表中的detailType。

•detailTypeString：节点详细类型。

•path：如果节点是报告、数据集、数据源，显示其在bihome下的物理路径，如果是数据表或者Mongo集合，显示选择的层级路径。

•qryPath：数据集资源在bihome下的物理路径，适用于类型为自定义SQL的节点。

•qryType：数据集资源的类型（SQL数据集、Mongo数据集等），适用于类型为自定义SQL的节点。

•script：脚本，sql或者mongo管道语句，适用于SQL数据集、Mongo数据集。

•assetPath：资源在bihome下的物理路径。

•qryInDashboard：是否为制作报告中增加的内嵌数据集、组合数据集。

•files：文本文件信息，包含xls、xlsx、csv、txt、log。

•isAsset：节点是否表示一个资源。

•read：是否拥有资源的读权限，适用于表示资源的节点。

•relations：节点之间的关系。

•source：连线的起始节点。

•target：连线的目标节点。

•statistics：节点被其他节点依赖的统计信息。

•id：节点的ID。

•query：依赖该节点的数据集个数。

•dashboard：依赖该节点的报告的个数。

•level 返回类型，不同数值代表不同返回状态，1表示成功，6表示失败。