Operations Reference
This section describes all TDV/Studio operations in alphabetical order, along with their resource tree location, request elements, response elements, and faults.
In Studio, optional request or response elements are displayed in italic on the Parameters tab. In this documentation, as on the Info tab, these elements are followed by “optional” in parentheses.
Locations are shown as /system/admin/<branch> or /system/util/<branch>. In the resource tree, operations appear in these branches under both Desktop and localhost.
Input Values
To enter the input values for an operation, open the operation and click the Execute button in the upper left corner of its pane (on any tab, even Info). An Input Values window opens, with the operation name listed under Parameter. The Value area contains a hierarchical series of lines in which to type values for the request elements.
For example, if you click the Execute button for the updateResourcePrivileges operation, this window appears.
To assign READ and WRITE privileges to groupABC on datasource NZ 6.0, find the question marks in the syntax and type the values shown in bold, and then click OK:
<resource:updateResourcePrivileges xmlns:resource="http://www.compositesw.com/services/system/admin/resource">
<resource:updateRecursively>false</resource:updateRecursively>
<resource:updateDependenciesRecursively>false</resource:updateDependenciesRecursively>
<resource:updateDependentsRecursively>false</resource:updateDependentsRecursively>
<resource:privilegeEntries>
<resource:privilegeEntry>
<resource:path>/shared/NZload/NZ 6.0</resource:path>
<resource:type>DATA_SOURCE</resource:type>
<resource:privileges>
<resource:privilege>
<resource:domain>composite</resource:domain>
<resource:name>groupABC</resource:name>
<resource:nameType>GROUP</resource:nameType>
<resource:privs>read write</resource:privs>
<resource:combinedPrivs>0</resource:combinedPrivs>
<resource:inheritedPrivs>0</resource:inheritedPrivs>
</resource:privilege>
</resource:privileges>
</resource:privilegeEntry>
</resource:privilegeEntries>
<resource:mode>SET_EXACTLY</resource:mode>
</resource:updateResourcePrivileges>
Note: If you open the Input Values window and do not replace the question marks with actual values, and then click OK, you get an “internal error” message (in this example, ‘Cause: “?” is not a valid resource type.’
