Referência: reordenar colunas para APIs JSON de definição de planilha modelada e de cubo

Disponível somente para

/definition

quando parâmetro de consulta

reorderColumns

é verdadeira.

Solicitação de exemplo

Solicitar URI:

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

Criação do corpo da solicitação	Solicitar atualização do corpo da solicitação	Resultados esperados
{ "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" } } ] }	Se reorderColumns foi false , seria esperada esta ordem após a atualização da lista de colunas: Nível TextOne TextTwo TextThree TextFour TextFive TextSix TextSeven TextEight Com reorderColumns definido como true , em vez disso, obtemos esta ordenação: Nível TextTwo TextFour TextSix TextThree TextSeven TextEight TextOne TextFive

Criação do corpo da solicitação

Solicitar atualização do corpo da solicitação

Resultados esperados

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

foi

false

, seria esperada esta ordem após a atualização da lista de colunas:

Nível

TextOne

TextTwo

TextThree

TextFour

TextFive

TextSix

TextSeven

TextEight

Com

reorderColumns

definido como

true

, em vez disso, obtemos esta ordenação:

Nível

TextTwo

TextFour

TextSix

TextThree

TextSeven

TextEight

TextOne

TextFive

O indicador de reordenação de colunas pode ser ativado quando você cria uma nova planilha ou atualiza uma existente.

Normalmente, o algoritmo de reordenação prioriza a ordenação das colunas na solicitação de API. No entanto, quando há ambiguidade ou quando se lida com colunas que não são mencionadas na solicitação, o algoritmo prioriza a ordem das colunas, pois já existem na planilha.

O algoritmo de reordenação move as colunas para trás em vez de avançá-las. Se duas colunas trocam de lugar (C, B), na prática, o algoritmo move B depois de C, em vez de mover C antes de B. Isso é importante quando há colunas existentes entre B e C que não são mencionadas na solicitação.