Page instructions for page lists

Page instructions for page lists include listIndex, which you use to specify the index of the page list that you want to modify. For example, your application contains myPageList(1) and myPageList(2). When you specify “listIndex” : 2, you are indicating that myPageList(2) should be modified.

myPageList(1)
.Prop1 – “value1”
.Prop2 – “value2”
myPageList(2)
.Prop1 – “value3”
.Prop2 – “value4”

UPDATE

You use UPDATE to modify the value of an existing property in a page list, for example, when a user edits a row.

“pageInstructions” : [{
         “instruction” : “UPDATE”,
         “target” : “myPageList”,
         “listIndex” : 2,
          content : {
            “Prop1” : “value5”,
        }
     }]

.Prop1 - "value3" in myPageList(2) is updated with "value5."

myPageList(1)
.Prop1 – “value1”
.Prop2 – “value2”
myPageList(2)
.Prop1 – “value5”
.Prop2 – “value4”

REPLACE

You use REPLACE to overwrite an existing row in a page list.

The following is an example of the post body when the REPLACE page instruction is added.

“pageInstructions” : [{
         “instruction” : “REPLACE”,
         “target” : “myPageList”,
         “listIndex” : 2,
          content : {
              “Prop1” : “value5”,
        }
    }]

.Prop1 – "value3" in myPageList(2) is replaced with "value5." .Prop2 – “value4” is overwritten.

myPageList(1)
.Prop1 – “value1”
.Prop2 – “value2”
myPageList(2)
.Prop1 – “value5”

DELETE

You use DELETE to delete a row in a page list.

The following is an example of the post body when the DELETE page instruction is added. The listIndex value indicates that myPageList(1) is to be deleted. You do not need to send a content element when you use DELETE.

“pageInstructions” : [{
         “instruction” : “DELETE”,
         “target” : “myPageList”,
         “listIndex” : 1,
       }]

In the following example, the original myPageList(1) was deleted, and myPageList(2) becomes myPageList(1).

myPageList(1)
.Prop1 – “value3”
.Prop2 – “value4”

APPEND

You use APPEND to add a new row after an existing row. The properties indicated in the page instruction are automatically added after the last existing row. listIndex is not used with an APPEND.

“pageInstructions” : [{
         “instruction” : “APPEND”,
         “target” : “myPageList”,
          content : {
             “Prop1” : “value5”,
             “Prop2” : “value6”
         }
      }]

In the following example, a third page list with “Prop1” : “value5” and “Prop2” : “value6” is created below the existing page lists.

myPageList(1)
.Prop1 – “value1”
.Prop2 – “value2”
myPageList(2)
.Prop1 – “value3”
.Prop2 – “value4”
myPageList(3)
.Prop1 – “value5”
.Prop2 – “value6”

INSERT

You use INSERT to insert a new row before an existing row. The following example indicates that a new page list with properties “Prop1” : “value5” and “Prop2” : “value6” is to be inserted as the second row.

“pageInstructions” : [{
         “instruction” : “INSERT”,
         “target” : “myPageList”,
         “listIndex” : 2,
          content : {
             “Prop1” : “value5”,
             “Prop2” : “value6”
        }
    }]

The new page list is inserted as myPageList(2). The page list that was previously myPageList(2) becomes myPageList(3).

myPageList(1)
.Prop1 – “value1”
.Prop2 – “value2”
myPageList(2)
.Prop1 – “value5”
.Prop2 – “value6”
myPageList(3)
.Prop1 – “value3”
.Prop2 – “value4”

MOVE

You use MOVE when a user drags and drops a row. listIndex indicates the previous position of the row, and listMoveToIndex indicates the row's new position.

In the following example, the user is moving myPageList(2) to the myPageList(1) position.

“pageInstructions” : [{
         “instruction” : “MOVE”,
         “target” : “myPageList”,
         “listIndex” : 2,
         “listMoveToIndex” : 1
    }]

myPageList(2) becomes myPageList(1), and the original myPageList(1) becomes myPageList(2).

myPageList(1)
.Prop1 – “value3”
.Prop2 – “value4”
myPageList(2)
.Prop1 – “value1”
.Prop2 – “value2”