API de conversión

Conversiones generales

Hay una característica asombrosa por la cual usted podría descubrir las entidades convertidas junto con su tipo anterior de la entidad apenas antes de la conversión. Las conversiones de entidades se realizan con Targetprocess UI. Puede convertir cualquier entidad en cualquier tipo de entidad como se muestra a continuación.

Para obtener la información sobre las entidades convertidas y su tipo de entidad anterior, puede utilizar una llamada a la API Get como se indica a continuación:
API v1:

GET /api/v1/generalconversions/

El resultado es el siguiente:

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

API v2:

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

El resultado es el siguiente:

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

📘 Nota:

**ActualGeneral **corresponde al tipo actual creado como resultado de una o varias conversiones. Si el General se ha convertido más de una vez, todos los registros apuntan al último General convertido.

**FromGeneralType **corresponde al tipo general que tenía antes de la conversión.

Buscar el ID de una nueva entidad creada como resultado de la conversión, conociendo el ID de la entidad antigua:

API v1:

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

El resultado es el siguiente:

<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}

El resultado es el siguiente:

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

Encontrar el ID de una entidad antigua que fue convertida, conociendo el ID de la nueva entidad:

API v1

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

El resultado es el siguiente:

<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}

El resultado es el siguiente:

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