Referentie: kolommen opnieuw ordenen voor JSON-API's voor gemodelleerde en kubusbladdefinities

Alleen beschikbaar voor

/definition

when-queryparameter

reorderColumns

is waar.

Voorbeeldaanvraag

Aanvraag-URI:

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

Hoofdtekst van aanvraag maken	Update hoofdtekst aanvragen	Verwachte resultaten
{ "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" } } ] }	Als reorderColumns was false , hadden we deze volgorde verwacht na het bijwerken van de kolomlijst: Niveau TextOne TextTwo TekstDrie TextFour TextFive TextSix TextSeven TextEight Met reorderColumns ingesteld op: true , krijgen we in plaats daarvan deze volgorde: Niveau TextTwo TextFour TextSix TekstDrie TextSeven TextEight TextOne TextFive

Hoofdtekst van aanvraag maken

Update hoofdtekst aanvragen

Verwachte resultaten

{
    "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"
            }
        }
    ]
}

Als

reorderColumns

was

false

, hadden we deze volgorde verwacht na het bijwerken van de kolomlijst:

Niveau

TextOne

TextTwo

TekstDrie

TextFour

TextFive

TextSix

TextSeven

TextEight

Met

reorderColumns

ingesteld op:

true

, krijgen we in plaats daarvan deze volgorde:

Niveau

TextTwo

TextFour

TextSix

TekstDrie

TextSeven

TextEight

TextOne

TextFive

De markering voor het opnieuw ordenen van kolommen kan worden ingeschakeld wanneer u een nieuw blad maakt of een bestaand blad bijwerkt.

Doorgaans geeft het algoritme voor opnieuw ordenen prioriteit aan de volgorde van de kolommen in de API-aanvraag. Als er echter dubbelzinnigheid is of als het gaat om kolommen die niet in de aanvraag worden vermeld, geeft het algoritme prioriteit aan de volgorde van de kolommen omdat ze al op het blad aanwezig waren.

Met het algoritme voor de nieuwe volgorde worden kolommen naar achteren verplaatst in plaats van naar voren. Als twee kolommen van plaats verwisselen (C, B), wordt in de praktijk B na C verplaatst in plaats van C vóór B. Dit is van belang wanneer er bestaande kolommen tussen B en C zijn die niet in de aanvraag worden vermeld