转换API

通用转换

有一个很棒的功能，它能让你查看到转换后的实体及其在转换前的实体类型。实体转换通过Targetprocess用户界面完成。你可以将任何实体转换为任何实体类型，如下所示。

要获取转换实体及其先前实体类型的信息，可使用如下 Get API 调用：

API v1:

GET /api/v1/generalconversions/

结果如下：

<GeneralConversion ResourceType="GeneralConversion" Id="1">
        <FromGeneralID>130791</FromGeneralID>
        <FromGeneralType ResourceType="EntityType" Id="4" Name="UserStory" />
        <ActualGeneral ResourceType="General" Id="191181" Name="[UI] Add "deleted" filter" />
</GeneralConversion>

API v2:

GET /api/v2/generalconversions/?select={Resourcetype,id,FromGeneralType ,FromGeneralID,Actualgeneral}

结果如下：

"items": [
        {
            "resourceType": "GeneralConversion",
            "id": 1,
            "fromGeneralType": {
                "resourceType": "EntityType",
                "id": 4,
                "name": "UserStory"
            },
            "fromGeneralID": 130791,
            "actualGeneral": {
                "resourceType": "General",
                "id": 191181,
                "name": "[UI] Add \"deleted\" filter"
            }
        },
…]

注：

ActualGeneral 对应于通过一次或多次转换生成的当前类型。若通用字段转换超过一次，所有记录均指向最后一次转换的通用字段。

FromGeneralType 与转换前的通用类型相对应。

根据旧实体的ID，查找因转换而创建的新实体的ID：

API v1:

GET /api/v1/generalconversions/?where=(FromGeneralID eq 191180)&include=[ActualGeneral[id]]

结果如下：

<GeneralConversions>
    <GeneralConversion ResourceType="GeneralConversion" Id="927">
        <ActualGeneral ResourceType="General" Id="191181" />
    </GeneralConversion>
</GeneralConversions>

API v2

GET /api/v2/generalconversions/?where=(Fromgeneralid = 191180)&select={actualgeneral.id}

结果如下：

{
    "items": [
        {
            "id": 191181
        }
    ]
}

根据已知的旧实体ID，查找其转换后的新实体ID：

API v1

GET api/v1/generalconversions/?where=(actualgeneral.id eq 191181)&include=[Fromgeneralid,fromgeneraltype]

结果如下：

<GeneralConversions>
    <GeneralConversion ResourceType="GeneralConversion" Id="1">
        <FromGeneralID>130791</FromGeneralID>
        <FromGeneralType ResourceType="EntityType" Id="4" Name="UserStory" />
    </GeneralConversion>
    <GeneralConversion ResourceType="GeneralConversion" Id="926">
        <FromGeneralID>130800</FromGeneralID>
        <FromGeneralType ResourceType="EntityType" Id="5" Name="Task" />
    </GeneralConversion>
    <GeneralConversion ResourceType="GeneralConversion" Id="927">
        <FromGeneralID>191180</FromGeneralID>
        <FromGeneralType ResourceType="EntityType" Id="9" Name="Feature" />
    </GeneralConversion>
</GeneralConversions>

API v2:

GET /api/v2/generalconversions/?where=(actualgeneral.id = 191181)&select={Fromgeneralid}

结果如下：

{
    "items": [
        {
            "fromGeneralID": 130791
        },
        {
            "fromGeneralID": 130800
        },
        {
            "fromGeneralID": 191180
        }
    ]
}