Inserting New Element: the SetRdsElements Operation

Below is the example of using the SetRdsElements operation to insert a new element into an MDM dictionary. The new element is added to the root of the elements tree. To insert an element, specify the tArg.op and tArg.data fields. The tArg.data property contains element information. The response contains key of the inserted element.

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

</tRds>

<op>Insert</op>

<key>

<key />

</key>

<data>

<n>Element 1</n>

<k />

<h>false</h>

</data>

</tArg>

</SetRdsElements>

</s:Body>

</s:Envelope>

SOAP response:

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

<soapenv:Body>

</id>

</key>

</SetRdsElementsResult>

</soapenv:Body>

</soapenv:Envelope>

JSON request:

{
 "SetRdsElements" : 
  {
   "tRds" : 
    {
     "id" : "S1!M!S!N3"
    },
   "tArg" : 
    {
     "op" : "Insert",
     "key" : 
      {
       "key" : ""
      },
     "data" : 
      {
       "n" : "Item 1",
       "k" : "",
       "h" : "false",
       "o" : "0"
      }
    }
  }
}

JSON response:

{
 "SetRdsElementsResult" : 
  {
   "id" : 
    {
     "id" : "S1!M!S!N3"
    },
   "key" : 
    {
     "key" : "563"
    }
  }
}

    public static SetRdsElementsResult InsertRdsElement(RdsId moniker, string elementName)
    {
        var somClient = new SomPortTypeClient(); //Proxy object for executing operation
        //Operation execution parameter
        var tSet = new SetRdsElements()
        {
            tArg = new SetRdsElementsArg()
            {
                op = RdsElementOperation.Insert,
                key = new ElKey()
                {
                    key = string.Empty
                },
                //Information about added element. Key is not specified, it generates on adding
                data = new ElData()
                { 
                    k = string.Empty,
                    n = elementName
                }
            },
            tRds = moniker
        };
        //Add an element
        var tResult = somClient.SetRdsElements(tSet);
        return tResult;
    }