GrooveMessages.CreateForward Operation
Applies to: SharePoint Workspace 2010 | Visual Studio 2008
In this article
HTTP Post URL
Input Message Header
Input Message Parameters
Output Message Header
Return Value
The CreateForward operation forwards a message, including any attachments, to recipients specified in a message header. You can optionally add additional content and attachments to the forwarded message.
HTTP Post URL
The HTTP Post URL targets the message to be forwarded. This URI is returned by the Read operation and other operations.
Input Message Header
GrooveRequestHeader specifies information common to all Groove Web Services, including the Groove Identity URL and the Groove Request key.
Input Message Parameters
<CreateForward>
<AdditionalHeaderData />
<AdditionalContent />
</CreateForward>
Element |
Data type |
Description |
|---|---|---|
AdditionalHeaderData |
Provides the recipients for the forwarded message. |
|
AdditionalContent |
Provides additional content to be included with the content of the original message. |
Output Message Header
GrooveResponseHeader specifies the Response key.
Return Value
<CreateForwardResult />
Element |
Data type |
Description |
|---|---|---|
CreateForwardResult |
xs:anyURI |
A URI identifying the sent message. |
Remarks
Additional content may be prepended to the message and attachments may be added to the message by specifying them in the AdditionalContent input parameter. The URI of the resulting forwarded message is returned.
If the original message that is being forwarded has a voice memo, the voice memo is converted to a file attachment. A title is generated for the attachment of the form "Voice memo from original-sender". The attachment type is set to File.
You specify a recipient of the forwarded message with the Groove Identity URL of the contact in a MessageContact in the Recipients element of the AdditionalHeaderDataMessageHeader.
You can send messages only to contacts that are accessible to the account. The following kinds of contacts are accessible:
Contacts in the account Contact list.
Members of workspaces that the account belongs to.
Contacts who have been the sender or a recipient of a message in the account message history.
If a call to the Create, CreateForward, or CreateReply operation specifies a recipient that is not accessible to the account, a SOAP fault will be returned and the entire operation will fail. The SOAP exception does not provide any information about which contact caused the operation to fail.
See Also
Reference
GrooveMessages.Create Operation
GrooveMessages.CreateReply Operation