Deprecated as of API version 6.0. Instead use introspectResourcesTask.

Update the introspect state for child resources within a data source. This causes resources in the namespace to be added or removed as appropriate.

The childInfo paths are paths relative to the data source. The introspect state IGNORED causes the resource to be removed (or stay removed); SELF causes the resource to be added (or stay added); and SELF_AND_CHILDREN causes the resource to be added along with all of its children.

The changes made with this operation are applied when the transaction is committed, or when it is discarded on transaction rollback.

Accessing data source childInfo is relatively expensive. If multiple calls to this operation and/or getDataSourceChildResources are going to be made, making them all on one transaction improves performance.

Also see getDataSourceChildResources and reintrospectDataSource.

/services/webservices/system/admin/resource/operations/

path: A path to the data source

childInfos: List of dataSourceChildInfos to be updated.

path: The path within the data source.

type: The type of resource within the data source. Legal values are CONTAINER, DATA_SOURCE, DEFINITION_SET, LINK, PROCEDURE, TABLE, TREE, TRIGGER.

introspectState: The new state to set. Legal values are IGNORED, SELF, and SELF_AND_CHILDREN.

attributes (optional): Optional values to be used for the resource. These might be required to specify login information if such information is not persisted with the data source definition. See Attributes Element.

N/A

DataSourceError: If a data source connection cannot be established or if a data source request returns an error.

IllegalArgument: If the path element or any path in a childInfo is malformed, or if any type or introspect state on childInfo is illegal.

NotFound: If the data source or any portion of path do not exist.

NotFound: If any of the childInfo paths do not exist and the introspect state is not being set to IGNORED.

Security: If the user does not have READ access on all items in path other than the last one.

Security: If the user does not have WRITE access to the last item in path.

Security: If the user does not have the ACCESS_TOOLS right.

Introspect the table orders: run the webservice and set parameters as follows.