Installing the SBM Web Services API

For SBM On-Premise users, the SBM Application Engine Web Services API is installed in the following location on the server that hosts SBM Application Engine:

installDirectory\Application Engine\webservices

On-Demand users can access the SBM Web services here:

https://sbm.serena.com/gsoap/sbmappservices72.wsdl

The latest Web services are available from the sbmappservices72 and sbmadminservices72 WSDLs. Prior versions including ttwebservices, aewebservices70, and aewebservices71 are still compatible and can be used in tandem with SBM Web services version 7.2.

If you are using these earlier versions, consider upgrading in order to take advantage of the expanded identifiers, options, and tighter processing control. To upgrade, update your existing endpoints with the new WSDL name and change the arguments in your existing call list.

Note: If you upgrade to SBM Web services version 7.2, note that Multi-Selection, Multi-User, and Multi-Relational fields no longer accept a comma-separated list of internal (tableid:internal-item-id) values on update. Instead, you must specify values individually in an array of values to update the field. For example:

<urn:extendedField>
   <urn:id>
      <urn:displayName>MULTI-RELATIONAL</urn:displayName>
      <urn:id></urn:id>
      <urn:uuid></urn:uuid>
      <urn:dbName></urn:dbName>
   </urn:id>
   <urn:setValueBy>DISPLAY-VALUE</urn:setValueBy>
   <urn:setValueMethod>APPEND-VALUES</urn:setValueMethod>
   <urn:value>
      <urn:displayValue>Value1</urn:displayValue>
      <urn:internalName></urn:internalName>
      <urn:internalValue></urn:internalValue>
      <urn:uuid></urn:uuid>
   </urn:value>
   <urn:value>
      <urn:displayValue>Value2</urn:displayValue>
      <urn:internalName></urn:internalName>
      <urn:internalValue></urn:internalValue>
      <urn:uuid></urn:uuid>
   </urn:value>
</urn:extendedField>

SBM provides sample programs written in C# that interact with the SBM Web services API. These samples are discussed in more detail in Sample Programs.