com.collabnet.ce.soap60.webservices.integrationdata

Interface IIntegrationDataAppSoap

All Known Implementing Classes:

IntegrationDataAppSoap

public interface IIntegrationDataAppSoap

Provides SOAP web service for the integration data application.

Change History

Version 6.1

• setData: Removed, use putData, instead.
• setDataByKey: Removed, use putDataByKey, instead.

Version 4.4: No changes.

Since:

4.1

Method Summary

Modifier and Type	Method and Description
SoapNamedValues	getData(java.lang.String sessionId, java.lang.String namespaceId, java.lang.String objectId) Gets data for an object from the integration data service
java.lang.String	getDataByKey(java.lang.String sessionId, java.lang.String namespaceId, java.lang.String objectId, java.lang.String key) Gets data for an object from the integration data service
java.lang.String	getNamespaceId(java.lang.String sessionId, java.lang.String name) Gets the key to an existing namespace.
void	putData(java.lang.String sessionId, java.lang.String namespaceId, java.lang.String objectId, SoapNamedValues namedValues) Adds or replaces a set of integration data values for the specified object.
void	putDataByKey(java.lang.String sessionId, java.lang.String namespaceId, java.lang.String objectId, java.lang.String key, java.lang.String value) Adds or replaces a single integration data value for the specified object.
java.lang.String	registerNamespace(java.lang.String sessionId, java.lang.String name) Registers a new namespace
void	removeData(java.lang.String sessionId, java.lang.String namespaceId, java.lang.String objectId, java.lang.String[] keys) Removes a set of integration data values from the specified object.
void	removeDataByKey(java.lang.String sessionId, java.lang.String namespaceId, java.lang.String objectId, java.lang.String key) Removes a single integration data value from the specified object.

Method Detail

registerNamespace

java.lang.String registerNamespace(java.lang.String sessionId,
                                   java.lang.String name)
                            throws java.rmi.RemoteException

Registers a new namespace

Parameters:

sessionId - SOAP session id.

name - The name of the namespace to register

Returns:

Integration data namespace id

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - when the specified name already exists

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

java.rmi.RemoteException

Since:

4.1

getNamespaceId

java.lang.String getNamespaceId(java.lang.String sessionId,
                                java.lang.String name)
                         throws java.rmi.RemoteException

Gets the key to an existing namespace.

Parameters:

sessionId - SOAP session id.

name - The name of the namespace to get

Returns:

Integration data namespace id

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified name doesn't exist.

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

java.rmi.RemoteException

Since:

4.1

putData

void putData(java.lang.String sessionId,
             java.lang.String namespaceId,
             java.lang.String objectId,
             SoapNamedValues namedValues)
      throws java.rmi.RemoteException

Adds or replaces a set of integration data values for the specified object.

Parameters:

sessionId - SOAP session id.

namespaceId - The namespace to store data under

objectId - The object to associate the data with

namedValues - Key value pairs of data to associate

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the object id doesn't exist

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user doesn't have permission to store data on the object

java.rmi.RemoteException

Since:

4.3-HOTFIX1

putDataByKey

void putDataByKey(java.lang.String sessionId,
                  java.lang.String namespaceId,
                  java.lang.String objectId,
                  java.lang.String key,
                  java.lang.String value)
           throws java.rmi.RemoteException

Adds or replaces a single integration data value for the specified object.

Parameters:

sessionId - SOAP session id.

namespaceId - The namespace to store data under

objectId - The object to associate the data with

key - The key of the piece of data to store

value - The value to store

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the object id doesn't exist

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user doesn't have permission to store data on the object

java.rmi.RemoteException

Since:

4.3-HOTFIX1

removeData

void removeData(java.lang.String sessionId,
                java.lang.String namespaceId,
                java.lang.String objectId,
                java.lang.String[] keys)
         throws java.rmi.RemoteException

Removes a set of integration data values from the specified object.

Parameters:

sessionId - SOAP session id.

namespaceId - The namespace to store data under

objectId - The object to associate the data with

keys - Integration data keys (and associated values) to remove.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the object id doesn't exist

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user doesn't have permission to store data on the object

java.rmi.RemoteException

Since:

4.3-HOTFIX1

removeDataByKey

void removeDataByKey(java.lang.String sessionId,
                     java.lang.String namespaceId,
                     java.lang.String objectId,
                     java.lang.String key)
              throws java.rmi.RemoteException

Removes a single integration data value from the specified object.

Parameters:

sessionId - SOAP session id.

namespaceId - The namespace to store data under

objectId - The object to associate the data with

key - Integration data key (and associated value) to remove.

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the object id doesn't exist

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user doesn't have permission to store data on the object

java.rmi.RemoteException

Since:

4.3-HOTFIX1

getData

SoapNamedValues getData(java.lang.String sessionId,
                        java.lang.String namespaceId,
                        java.lang.String objectId)
                 throws java.rmi.RemoteException

Gets data for an object from the integration data service

Parameters:

sessionId - SOAP session id.

namespaceId - The namespace to get data under

objectId - The object to get the data for

Returns:

A SoapNamedValues collection of key/value pair stored data

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the object id doesn't exist

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user doesn't have permission to get data on the object

java.rmi.RemoteException

Since:

4.1

getDataByKey

java.lang.String getDataByKey(java.lang.String sessionId,
                              java.lang.String namespaceId,
                              java.lang.String objectId,
                              java.lang.String key)
                       throws java.rmi.RemoteException

Gets data for an object from the integration data service

Parameters:

sessionId - SOAP session id.

namespaceId - The namespace to get data under

objectId - The object to get the data for

key - The key of the piece of data to retrieve

Returns:

The value of the stored piece of data

Throws:

com.collabnet.ce.soap60.fault.InvalidSessionFault - when the sessionId is invalid.

com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the object id doesn't exist

com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system error occurs.

com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user doesn't have permission to get data on the object

java.rmi.RemoteException

Since:

4.3