API de conversion

Modifier en ligne

Conversions générales

Il existe une fonctionnalité étonnante qui vous permet de connaître les entités converties ainsi que leur type d'entité précédent juste avant la conversion. Les conversions d'entités sont effectuées à l'aide de l'interface utilisateur Targetprocess. Vous pouvez convertir n'importe quelle entité en n'importe quel type d'entité, comme indiqué ci-dessous.

entité de conversion

Pour obtenir des informations sur les entités converties et leur type d'entité précédent, vous pouvez utiliser un appel API Get comme suit :

v1: de l'API

GET /api/v1/generalconversions/
Le résultat est le suivant :
<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>
v2: de l'API
GET /api/v2/generalconversions/?select={Resourcetype,id,FromGeneralType ,FromGeneralID,Actualgeneral}
Le résultat est le suivant :
"items": [
        {
            "resourceType": "GeneralConversion",
            "id": 1,
            "fromGeneralType": {
                "resourceType": "EntityType",
                "id": 4,
                "name": "UserStory"
            },
            "fromGeneralID": 130791,
            "actualGeneral": {
                "resourceType": "General",
                "id": 191181,
                "name": "[UI] Add \"deleted\" filter"
            }
        },
…]
Remarque : Remarque : ActualGeneral correspond au type actuel créé à la suite d'une ou plusieurs conversions. Si le général a été converti plus d'une fois, tous les enregistrements renvoient au dernier général converti. FromGeneralType correspond au type général qu'il avait avant la conversion.

Trouver l'ID d'une nouvelle entité créée à la suite d'une conversion, en connaissant l'ID de l'ancienne entité :

v1: de l'API
GET /api/v1/generalconversions/?where=(FromGeneralID eq 191180)&include=[ActualGeneral[id]]
Le résultat est le suivant :
<GeneralConversions>
    <GeneralConversion ResourceType="GeneralConversion" Id="927">
        <ActualGeneral ResourceType="General" Id="191181" />
    </GeneralConversion>
</GeneralConversions>
v2 de l'API
GET /api/v2/generalconversions/?where=(Fromgeneralid = 191180)&select={actualgeneral.id}
Le résultat est le suivant :
{
    "items": [
        {
            "id": 191181
        }
    ]
}

Trouver l'ID d'une ancienne entité qui a été convertie, en connaissant l'ID de la nouvelle entité :

v1 de l'API
GET api/v1/generalconversions/?where=(actualgeneral.id eq 191181)&include=[Fromgeneralid,fromgeneraltype]
Le résultat est le suivant :
<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>
v2: de l'API
GET /api/v2/generalconversions/?where=(actualgeneral.id = 191181)&select={Fromgeneralid}
Le résultat est le suivant :
{
    "items": [
        {
            "fromGeneralID": 130791
        },
        {
            "fromGeneralID": 130800
        },
        {
            "fromGeneralID": 191180
        }
    ]
}