Referencia: reordenación de columnas para API JSON de definición de hoja modelada y de cubo

Solo disponible para

/definition

cuando parámetro de consulta

reorderColumns

es verdadero.

Solicitud de ejemplo

URI de solicitud:

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

Creación de cuerpo de solicitud	Actualización de cuerpo de solicitud	Resultados previstos
{ "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 era false , hubiéramos esperado este orden después de actualizar la lista de columnas: Nivel TextOne TextTwo TextThree TextFour TextFive TextSix TextSeven TextoOcho Con reorderColumns establecido en true , en su lugar obtenemos este orden: Nivel TextTwo TextFour TextSix TextThree TextSeven TextoOcho TextOne TextFive

Creación de cuerpo de solicitud

Actualización de cuerpo de solicitud

Resultados previstos

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

era

false

, hubiéramos esperado este orden después de actualizar la lista de columnas:

Nivel

TextOne

TextTwo

TextThree

TextFour

TextFive

TextSix

TextSeven

TextoOcho

Con

reorderColumns

establecido en

true

, en su lugar obtenemos este orden:

Nivel

TextTwo

TextFour

TextSix

TextThree

TextSeven

TextoOcho

TextOne

TextFive

El indicador de reordenación de columnas se puede activar al crear una nueva hoja o al actualizar una existente.

Normalmente, el algoritmo de reordenación priorizará el orden de las columnas en la solicitud de API. Sin embargo, cuando hay ambigüedad o cuando se trata de columnas que no se mencionan en la solicitud, el algoritmo priorizará el orden de las columnas tal y como ya existían en la hoja.

El algoritmo de reordenación moverá las columnas hacia atrás, en lugar de avanzarlas. Si dos columnas se intercambian (C, B), en la práctica, el algoritmo mueve B después de C, en lugar de mover C antes de B. Esto es importante cuando hay columnas existentes entre B y C que no se mencionan en la solicitud