Interface MessageBox

XML Namespace

urn:icsy:venice:wsdl:communication

XSD Data Types

basic:  http://www.v-grid.info/types/basic.xsd

comm:  http://www.v-grid.info/types/communication.xsd

domain:  http://www.v-grid.info/types/domain.xsd

faults:  http://www.v-grid.info/types/faults.xsd

Operations

 basic:UUID sendMessage (domain:SSOInformation sso, comm:Message message) throws faults:AuthorizationFault
This operation sends a message to other users. If the message has been accepted by the MessageBox Service, the sender has been authorized and the message has been permanently stored by the receiving MessageBox service. The message will be processed now by the MessageBox Service, i.e. forwarded to the ultimate receiver’s Message Service which might be located in another domain.

 basic:UUIDArray getMessageIDs (domain:SSOInformation sso) throws faults:AuthorizationFault
This operation returns a list of all message UUIDs that are currently available to the user. If there are too many messages waiting for the user, the service might decide to only return the most recent message UUIDs.

 comm:Message getMessage (domain:SSOInformation sso, basic:UUID messageID) throws faults:AuthorizationFault
This operation gets the message with the specified UUID from the MessageBox service. This UUID has usually been retrieved by a notification or by listing all messages directly.

 xsd:boolean deleteMessage (domain:SSOInformation sso, basic:UUID messageID) throws faults:AuthorizationFault
This operation deletes the message with the specified UUID from the message service.

 comm:MessageHeader getMessageHeader (domain:SSOInformation sso, basic:UUID messageID) throws faults:AuthorizationFault
This operation returns only the message header of the message with the specified UUID. This message should be called prior to receiving the complete message because it avoids transmitting the complete body or the attachments.

 comm:MessageHeaderArray getMessageHeaders (domain:SSOInformation sso) throws faults:AuthorizationFault
This operation returns the message headers of all messages currently available to the user. If there are too many messages waiting for the user, the service might decide to only return the header information of the most recent messages.

 xsd:int getMessageCount (domain:SSOInformation sso) throws faults:AuthorizationFault
This operation returns the number of messages currently available to the user.

 basic:UUIDArray search (domain:SSOInformation sso, basic:String searchPattern, xsd:boolean searchInSubject, xsd:boolean searchInText, xsd:boolean searchInAttachments) throws faults:AuthorizationFault
This operation searches for a pattern in the currently available messages. It is possible to search in subjects, message bodies and/or attachments). Searching the attachments depends on the attachment types, i.e. it is not possible to search in all file types.