api - 使用 VersionOne 的 RESTful API 重新排列故事

Question

如何通过 VersionOne 的 RESTful API 更改 Stories 的排名顺序？

Answer 1

如果你做一个数据查询http://YourVersionOne/rest-1.v1/Data/Story?sel=Order,ID&sort=Order ,
您将按降序获得故事的自然创作顺序。

有两种操作:1)在某个故事之前插入和2)在某个故事之后插入。

给定

I) 假设我正在检查按降序排列的故事列表。在这种情况下，“之前”一词的使用意味着更小的订单号。

II) 假设有一个碎片化的故事列表，形式为 [...-(x+c),-x, x+c...]，其中不能保证该列表中的顺序号是连续的。

III) 可能存在负订单号

IV)我将降序视为此解释的基础，“订单号越小越好”是任意的。升序框架
引用同样有效。

示例 1:在 之前插入

我想在我的故事:1234 之前插入我的故事:9999。做了一个查询后，我发现

故事:9999 有 454 个订单
故事:1234 有一个 2048 的订单

这是我在 VersionOne 中通过 REST 执行此订单更改所需的内容

VersionOne 网址:https://myVersionOne/rest-1.v1/Data/Story/1234
方法:POST

有效负载:<Asset>
<Attribute name="Order" act="set">454+</Attribute>
</Asset>
最终结果是
故事:1234有一个订购 < 故事:9999 .

我没有给你每一个的确切订单号的原因是因为我注意到了一些事情

a) 该操作可以强制 Story:1234 劫持原始订单 (454) 并将 Story:9999 碰撞到下一个可用插槽并碰撞其居民(Ala 插入排序在固定阵列场景中)

或者

b) 操作可以插入分配给 Story1234 一个未使用的订单号，满足未使用的订单号 < Story:9999.Order 的条件。这允许 Story:9999 保持其相同的订单号。
*注意:这些空槽来自删除。

示例 2:在 之后插入

我想在我的故事:1234 之后插入我的故事:9999。在做一个查询之后，我发现

故事:9999 有 454 个订单
故事:1234 有一个 2048 的订单

这是我在 VersionOne 中通过 REST 执行此订单更改所需的内容

VersionOne 网址:https://myVersionOne/rest-1.v1/Data/Story/1234
方法:POST

有效载荷:
<Asset>
<Attribute name="Order" act="set">454-</Attribute>
</Asset>
最终结果是
故事:9999 有 454 个订单
故事:1234 有 453 个订单

总之，OrderNum+ 插入一些 story 之前，而 OrderNum- 附加在一些 story 之后。