GUID List Syntax

Description

A GUID list is a list of GUID separated by a comma (',' character). The syntax gives to the user many ways to explain what he wants.

Special values

No value

If the user does not provide anything for the parameter, the list is considered as empty. For a creation the list will be empty. For an update the current values for the list will be unchanged.

Null value

If the user provides the String "null", the list is considered as explicitly empty. For a creation the list will be empty. For an update the current values for the list will be replaced by an empty list.

Syntax

The list is composed by a list of GUID separated by a coma. There are two modes to provide GUID:

  • Full list (do not take into account values of the current list).
  • Relative list (update the current list by adding or removing values).

Full list

Example:

14,17,59,1006

In that case we provide 4 values:

  • 14
  • 17
  • 59
  • 1006

The new list will contains that 4 values.

Relative list

Example:

+14,17,59,-1006

This kind of list always start with a '+' or a '-'. In the example it will add to the actual list the values 14, 17 and 59; and it will remove the value 1006.

Example

Here are some example of GUID list usage.

Example 1

no value
  • Create operation: create an empty list.
  • Update operation: not change on actual list.

Example 2

"null"
  • Create operation: create an empty list.
  • Update operation: clear the actual list.

Example 3

17
  • Create operation: create a list with value 17.
  • Update operation: create a list with value 17; previous values of the list are lost.

Example 3

17,5,107
  • Create operation: create a list with values 17, 5 and 107.
  • Update operation: create a list with values 17, 5 and 107; previous values of the list are lost.

Example 4

+17
  • Create operation: create a list with value 17.
  • Update operation: add to the actual list the value 17.

Example 5

+17,+5,+107 or +17,5,107
  • Create operation: create a list with values 17, 5 and 107.
  • Update operation: add to the actual list the values 17, 5 and 107.

Example 6

-17,-5,-107 or -17,5,107
  • Create operation: create an empty list
  • Update operation: remove from the actual list the values 17, 5 and 107.

Example 7

+17,+5,+107,-62,-48 or +17,5,107,-62,48
  • Create operation: create a list with value 17, 5 and 107.
  • Update operation: add to the actual list values 17, 5 and 107 and remove from the actual list the values 62 and 48.

Example 8

+17,+5,+107,-62,-48,+2,+98,-92,-14 or +17,5,107,-62,48,+2,98,-92,14
  • Create operation: create a list with value 17, 5, 107, 2 and 98.
  • Update operation: add to the actual list values 17, 5, 107, 2 and 98 and remove from the actual list the values 62, 48, 92 and 14.

Example 9

17,+5 or 17,-5

Invalid syntax, both kind of list cannot be mixed.