Getting List of Objects by Class: the GetObjects Operation

Below is the example of using the GetObjects operation to get the list of objects of the specified classes in the specified repository folder. Before the list is obtained, the repository tree is updated and the cache is cleared. Keys, identifiers, class and creation date identifiers are extracted for the objects. The list of objects is sorted by the object creation date in ascending order.

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

</tParent>

<hideAllFolders>false</hideAllFolders>

<it>

</it>

<it>

</it>

</classes>

</tFilter>

<sd>false</sd>

<n>false</n>

true

<ts>false</ts>

<ds>false</ds>

<isShortcut>false</isShortcut>

</pattern>

</refresh>

<attribute>Timestamp</attribute>

</orderBy>

</tArg>

</GetObjects>

</s:Body>

</s:Envelope>

SOAP response:

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

<soapenv:Body>

</id>

<its>

OBJ66

<n />

4294967295

</d>

OBJ90

<n />

4294967295

</d>

NEWFORM1

<n />

4294967295

</d>

NEWFORM2

<n />

4294967295

</d>

</its>

</objects>

</GetObjectsResult>

</soapenv:Body>

</soapenv:Envelope>

JSON request:

{
 "GetObjects" : 
  {
   "tParent" : 
    {
     "id" : "S1!M!65"
    },
   "tFilter" :

    {
     "levels" : "-1",
     "hideEmptyFolders" : "true",
     "hideAllFolders" : "false",
     "limit" : "-1",
     "classes" : 
      {
       "it" : 
        [
          {

           "k" : "1537"
          },
          {
           "k" : "1538"
          }
        ]
      }
    },
   "tArg" : 
    {

     "pattern" : 
      {
       "sd" : "false",
       "n" : "false",
       "i" : "true",
       "ts" : "false",
       "ds" : "false",
       "isShortcut" : "false"
      },
     "refresh" :

      {
       "all" : "true"
      },
     "orderBy" : 
      {
       "asc" : "true",
       "attribute" : "Timestamp"
      }
    }
  }
}

JSON response:

{
 "GetObjectsResult" : 
  {
   "id" : 
    {
     "id" : "S1!M!65"
    },
   "objects" : 
    {
     "its" : 
      {

       "d" : 
        [
          {
           "@ts" : "2012-01-19T17:18:43.000",
           "@isLink" : "0",
           "@hf" : "0",
           "i" : "OBJ66",
           "n" : "",
           "k" : "66",
           "c" : "1537",

           "p" : "4294967295",
           "h" : "0"
          },
          {
           "@ts" : "2012-01-19T18:36:56.000",
           "@isLink" : "0",
           "@hf" : "0",
           "i" : "OBJ90",
           "n" : "",
           "k" : "90",

           "c" : "1538",
           "p" : "4294967295",
           "h" : "0"
          },
          {
           "@ts" : "2013-12-05T17:36:26.000",
           "@isLink" : "0",
           "@hf" : "0",
           "i" : "NEWFORM1",
           "n" : "",

           "k" : "8081",
           "c" : "1538",
           "p" : "4294967295",
           "h" : "0"
          },
          {
           "@ts" : "2013-12-05T17:36:28.000",
           "@isLink" : "0",
           "@hf" : "0",
           "i" : "NEWFORM2",

           "n" : "",
           "k" : "8082",
           "c" : "1538",
           "p" : "4294967295",
           "h" : "0"
          }
        ]
      }
    }
  }
}

The GetObjectsByClass function specified below selects all the objects of the specified classes within the specified parent object. Hidden folders and various container objects are not searched. The repository connection moniker, parent object identifier and classes of the searched objects are sent as input parameters of the function. The result of the function is the collection of descriptions of the selected objects.

The example uses the FindObjectById function, which code is given in the Getting Object Description by Its Identifier example.

    public static Ods GetObjectsByClass(MbId mb, string parent, OdClass[] classes)
    {
        var somClient = new SomPortTypeClient(); //Proxy object for operation execution
        //Operation execution parameters
        var tObject = new GetObjects()
        {
            //Specify extracted information

            tArg = new GetObjectsArg()
            {
                //Extract: keys, identifiers and class identifiers
                //Sort by ascending creation date
                orderBy = new OdsOrderBy()
                {
                    asc = true,
                    attribute = OdAttribute.Timestamp
                },
                pattern = new OdsPattern()

                {
                    ds = false,
                    i = true,
                    isShortcut = false,
                    n = false,
                    sd = false,
                    ts = false
                },
                refresh = new MbRefresh()
                {

                    all = true,
                },
            },
            tFilter = new OdsFilt()
            {
                classes = classes,
                limit = -1,
                levels = -1,
                hideAllFolders = false,
                hideEmptyFolders = true

            },
            //Specify identifier of object, which child objects are used in search
            tParent = new OdId()
            {
                id = mb.id + "!" + FindObjectById(mb, parent).k
            }
        };
        //Get list of objects according to specified selection parameters
        var result = somClient.GetObjects(tObject);
        return result.objects;
    }