参考信息：对模型化工作表和多维工作表定义的列重新排序 JSON API

仅适用于

/definition

查询参数

reorderColumns

为 true。

请求示例

请求 URI：

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

创建请求正文	更新请求正文	预期结果
{ "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 曾 false ，则更新列列表后的预期顺序为： Level TextOne TextTwo TextThree TextFour TextFive TextSix TextSeven TextEight 具有 reorderColumns 设置为 true 时，我们会得到以下顺序： Level TextTwo TextFour TextSix TextThree TextSeven TextEight TextOne TextFive

创建请求正文

更新请求正文

预期结果

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

曾

false

，则更新列列表后的预期顺序为：

Level

TextOne

TextTwo

TextThree

TextFour

TextFive

TextSix

TextSeven

TextEight

具有

reorderColumns

设置为

true

时，我们会得到以下顺序：

Level

TextTwo

TextFour

TextSix

TextThree

TextSeven

TextEight

TextOne

TextFive

创建新工作表或更新现有工作表时，可以开启“对列重新排序”标志。

通常，重新排序算法会优先对 API 请求中的列进行排序。但是，当存在歧义时，或者在处理请求中未提及的列时，算法将优先按工作表上已存在的列进行排序。

重新排序算法会将列向后移动，而不是向前移动。如果两列交换位置（C，B），实际上，算法会将 B 移至 C 之后，而不是将 C 移至 B 之前。当 B 与 C 之间存在未在请求中提及的列时，这一点很重要。