Référence : colonnes de réorganisation pour les API JSON modélisées et de définition de feuille cube

Disponible uniquement pour

/definition

paramètre d'interrogation lorsque

reorderColumns

est vraie.

Exemple de demande

URI de la demande :

HTTPS://api.adaptiveplanning.com/api/rest/modeling/<version>/<tenant>/sheet/modeled/definition/?name=APIColumnsReorderTwo1660598383&reorderColumns=true

Création d'un corps de demande	Demander mise à jour du corps	Résultats attendus
{ "properties": { "prefix": "APIColumnsReorderTwo1660598383" }, "columns": [ { "properties": { "name": "Level", "type": "LEVEL" } }, { "properties": { "name": "TextOne", "code": "TextOne", "type": "TEXT" } }, { "properties": { "name": "TextTwo", "code": "TextTwo", "type": "TEXT" } }, { "properties": { "name": "TextThree", "code": "TextThree", "type": "TEXT" } }, { "properties": { "name": "TextFour", "code": "TextFour", "type": "TEXT" } }, { "properties": { "name": "TextFive", "code": "TextFive", "type": "TEXT" } } ] }	{ "properties": { "prefix": "APIColumnsReorderTwo1660598383" }, "columns": [ { "properties": { "name": "TextFour", "code": "TextFour", "type": "TEXT" } }, { "properties": { "name": "TextSix", "code": "TextSix", "type": "TEXT" } }, { "properties": { "name": "TextThree", "code": "TextThree", "type": "TEXT" } }, { "properties": { "name": "TextSeven", "code": "TextSeven", "type": "TEXT" } }, { "properties": { "name": "TextEight", "code": "TextEight", "type": "TEXT" } }, { "properties": { "name": "TextOne", "code": "TextOne", "type": "TEXT" } } ] }	Si reorderColumns a été false , nous nous attendions à cet ordre après la mise à jour de la liste des colonnes : Niveau TextOne TextTwo TextThree TextFour TextFive TextSix TextSeven TextEight Avec reorderColumns défini à true , nous appliquons plutôt l’ordre suivant : Niveau TextTwo TextFour TextSix TextThree TextSeven TextEight TextOne TextFive

Création d'un corps de demande

Demander mise à jour du corps

Résultats attendus

{
    "properties": {
        "prefix": "APIColumnsReorderTwo1660598383"
    },
    "columns": [
        {
            "properties": {
                "name": "Level",
                "type": "LEVEL"
            }
        },
        {
            "properties": {
                "name": "TextOne",
                "code": "TextOne",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextTwo",
                "code": "TextTwo",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextThree",
                "code": "TextThree",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextFour",
                "code": "TextFour",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextFive",
                "code": "TextFive",
                "type": "TEXT"
            }
        }
    ]
}

{
    "properties": {
        "prefix": "APIColumnsReorderTwo1660598383"
    },
    "columns": [
        {
            "properties": {
                "name": "TextFour",
                "code": "TextFour",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextSix",
                "code": "TextSix",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextThree",
                "code": "TextThree",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextSeven",
                "code": "TextSeven",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextEight",
                "code": "TextEight",
                "type": "TEXT"
            }
        },
        {
            "properties": {
                "name": "TextOne",
                "code": "TextOne",
                "type": "TEXT"
            }
        }
    ]
}

reorderColumns

a été

false

, nous nous attendions à cet ordre après la mise à jour de la liste des colonnes :

Niveau

TextOne

TextTwo

TextThree

TextFour

TextFive

TextSix

TextSeven

TextEight

Avec

reorderColumns

défini à

true

, nous appliquons plutôt l’ordre suivant :

Niveau

TextTwo

TextFour

TextSix

TextThree

TextSeven

TextEight

TextOne

TextFive

L’indicateur de réorganisation des colonnes peut être activé lors de la création d’une nouvelle feuille ou de la mise à jour d’une feuille existante.

En général, l’algorithme de réorganisation priorisera l’ordre des colonnes dans la demande d’API. Toutefois, en cas d’exigibilité ou lors du traitement de colonnes qui ne sont pas mentionnées dans la demande, l’algorithme priorisera l’ordre des colonnes telles qu’elles existaient déjà sur la feuille.

L’algorithme de réorganisation déplacera les colonnes vers l’arrière plutôt que vers l’avant. Si deux colonnes sont échangées (C, B), en pratique, l’algorithme déplace B après C, plutôt que de déplacer C avant B. Cela compte lorsqu’il existe des colonnes entre B et C qui ne sont pas mentionnées dans la demande.