Changing Selection of Specified Elements: the ChangeDimSelection Operation

Below is the example of using the ChangeDimSelection operation to change selection of the specified elements. The request contains moniker of opened dictionary instance, the list of the element keys and their selection parameters. The response contains summary information on the selected elements.

SOAP request:

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">

<s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

</tDim>

<elSelectOp>Select</elSelectOp>

<elRelative>Current</elRelative>

<it>

</it>

<it>

</it>

</elKeys>

</tArg>

</ChangeDimSelection>

</s:Body>

</s:Envelope>

SOAP response:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

<n>First element</n>

</firstSelected>

<n>Second element</n>

</lastSelected>

</selectionInfo>

</ChangeDimSelectionResult>

</soapenv:Body>

</soapenv:Envelope>

JSON request:

{
 "ChangeDimSelection" : 
  {
   "tDim" : 
    {
     "id" : "S1!M!S!S1"
    },
   "tArg" : 
    {

     "newInstance" : "true",
     "elSelectOp" : "Select",
     "elRelative" : "Current",
     "elKeys" : 
      {
       "it" : 
        [
          {
           "key" : "1"
          },

          {
           "key" : "2"
          },
          {
           "key" : "3"
          }
        ]
      }
    }
  }
}

JSON response:

{
 "ChangeDimSelectionResult" : 
  {
   "id" : "S1!M!S!S4",
   "selectionInfo" : 
    {
     "firstSelected" :

      {
       "n" : "Item 1",
       "a" : 
        {
         "it" : 
          [
            "Item 1",
            "1",
            "1",
            "0",

            "A000123"
          ]
        },
       "ea" : 
        {
         "it" : 
          [
            {
             "@v" : "Item 1"
            },

             "@v" : "A000123"
            }
          ]
        },
       "k" : "1",
       "h" : "0",
       "o" : "0"
      },
     "lastSelected" : 
      {

       "n" : "Item 3",
       "a" : 
        {
         "it" : 
          [
            "Item 3",
            "3",
            "3",
            "2",
            "A000125"

          ]
        },
       "ea" : 
        {
         "it" : 
          [
            {
             "@v" : "Item 3"
            },
            {

             "@v" : "3"
            },
            {
             "@v" : "3"
            },
            {
             "@v" : "2"
            },
            {
             "@v" : "A000125"

            }
          ]
        },
       "k" : "3",
       "h" : "0",
       "o" : "0"
      },
     "selectedCount" : "3"
    }
  }
}

The specified ChangeSelection function changes the selection of dictionary elements. The dictionary instance moniker and the collection of element keys that must be selected are sent as input parameters. The selection parameters are specified in the function body. The result of the function is the result of the operation.

    public static ChangeDimSelectionResult ChangeSelection(DmId moniker, ElKey[] selectedElements)
    {
        var somClient = new SomPortTypeClient(); //Proxy object for operation execution
        //Operation execution parameters
        var tSel = new ChangeDimSelection()
        {
            tArg = new DmSelectionArg()
            {
                newInstance = true,
                elKeys = selectedElements,
                elRelative = DmElRelative.Current,
                elSelectOp = DmElSelectOp.Select
            },
            tDim = moniker
        };
        //Selection of specified elements
        var result = somClient.ChangeDimSelection(tSel);
        return result;
    }