<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE concept

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-B015C4A3-469E-5AC4-B9B9-A24AF7444E65" xml:lang="en"><title>SendAs

Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<p>This section describes the overview and functions provided by the SendAs

component. </p>

<section><title>Purpose</title> <p>The SendAs component provides a high-level

APIs for client applications that wish to include a <b>SendAs</b> menu to

allow users to send content through any of the supported message types. It

acts as a wrapper that allows access to the common functionality of email,

SMS, and OBEX components. </p> <p>For example, SendAs allows a word processor

document to be sent as an email, or a contact as a vCard (either attached

to an email or as an SMS). </p> </section>

<section><title>Key terms</title> <dl>

<dlentry>

<dt>SendAs Server</dt>

<dd><p>The server that maintains and controls access to all the SendAs entries. </p> </dd>

</dlentry>

<dlentry>

<dt>Message Type Module (MTM)</dt>

<dd><p>A group of components that together provide message handling functionality

for a particular protocol. </p> </dd>

</dlentry>

</dl> </section>

<section><title>Architecture</title> <p>The main client-side API is the <xref href="GUID-E1699CAB-423D-3AFA-BE77-3AFF38886EA3.dita"><apiname>RSendAs</apiname></xref> class.

Client applications use this to connect to the SendAs Server. </p> <p>Client

applications create messages using the <xref href="GUID-4499491F-FA1A-38E1-BB13-1AB184A31DA6.dita"><apiname>RSendAsMessage</apiname></xref> API.

Opening an <xref href="GUID-4499491F-FA1A-38E1-BB13-1AB184A31DA6.dita"><apiname>RSendAsMessage</apiname></xref> object on SendAs Server session

creates a SendAs message in the SendAs Server. This allows client applications

to create multiple messages concurrently. </p> <p> <b>Important:</b> There

is no exposure to Message Server APIs on the client-side. The SendAs Server

encapsulates the Message Server completely. </p> <fig id="GUID-4B2E7B20-8C11-5E21-ABA1-AA01129A32DC">

<title>              SendAs architecture            </title>

<image href="GUID-27EC3C5B-175C-5D27-874C-43D46AA44C08_d0e287704_href.png" placement="inline"/>

</fig> </section>

<section id="GUID-24801AA6-6CDE-584F-A233-F7B68C1C59E3"><title>SendAs Server</title> <p>The <xref href="GUID-BA7B9BA6-B840-5182-90B0-A4914592A40D.dita">SendAs Server</xref> maintains

all SendAs entries and controls the access to a Message Store. It allows client

applications to create messages in the Drafts folder of a Message Store. The

SendAs APIs also allow a client application to launch an appropriate message

editor for a given message type. They support two methods of sending messages:

confirmed or unconfirmed send. A confirmed send requires a confirmation by

the UI MTM; typically it queries the phone user. An unconfirmed send does

not require confirmation by the UI MTM. </p> <p>The following are the key

functions of SendAs Server : </p> <ul>

<li id="GUID-8235CD94-6D3E-5728-850D-4153386263F6"><p>Get a list of the names

of the MTMs that have the required capabilities. </p> </li>

<li id="GUID-946F453E-BAEA-5035-AA6D-2B4AE7C2BCB0"><p>Get a list of the services

that can be used with the chosen MTM. </p> </li>

<li id="GUID-A1E21B0F-AAA7-57B3-850D-BB52CEDD74C4"><p>Create a message, define

the body and attachments for that message, without forcing the client application

to start any message-specific user interface. </p> </li>

<li id="GUID-FE2A9EC0-4442-5294-A4FC-F8D2036353C1"><p>Store the message so

that it is ready for sending from the device next time it is connected to

the appropriate service. </p> </li>

<li id="GUID-0E735F08-EAA7-5FBF-A50A-F1FDEB8347AA"><p>Send the message. </p> </li>

<li id="GUID-7D0587B2-CCD8-54FE-B3D3-F8D74334B292"><p>Start the editor for

the message type. </p> </li>

<li id="GUID-F638D1BC-E4D1-5FF7-9142-95EA38E55CBD"><p>Allow client applications

to query the message type. </p> </li>

</ul> </section>

<section><title>API summary</title> <p>The following are the two main SendAs

Server classes: </p> <ul>

<li id="GUID-7C72A929-BE6C-557F-A1BB-5923F97573AE"><p>The <xref href="GUID-E1699CAB-423D-3AFA-BE77-3AFF38886EA3.dita"><apiname>RSendAs</apiname></xref> class

is the main interface to the SendAs Server. </p> </li>

<li id="GUID-52BF638C-7C93-5F44-A0DB-4EB7651EF837"><p>The <xref href="GUID-4499491F-FA1A-38E1-BB13-1AB184A31DA6.dita"><apiname>RSendAsMessage</apiname></xref> class

encapsulates creating and sending a message. It requires a connected <xref href="GUID-E1699CAB-423D-3AFA-BE77-3AFF38886EA3.dita"><apiname>RSendAs</apiname></xref> session. </p> </li>

</ul> </section>

<section><title>Typical use cases</title> <p>The <xref href="GUID-E1699CAB-423D-3AFA-BE77-3AFF38886EA3.dita"><apiname>RSendAs</apiname></xref> class

is used for the following tasks: </p> <ul>

<li id="GUID-0A747A06-DF16-53D2-9B36-A5C0CC9BB538"><p>Connecting to and disconnecting

from the SendAs Server </p> </li>

<li id="GUID-D5969E75-99AC-5ED1-A05A-719E60782FC3"><p>Querying the message

type registry </p> </li>

</ul> <p>The <xref href="GUID-4499491F-FA1A-38E1-BB13-1AB184A31DA6.dita"><apiname>RSendAsMessage</apiname></xref> class is used for the following

tasks: </p> <ul>

<li id="GUID-E9F965AB-9B58-5EF0-950D-5AA56FE38927"><p>Creating and managing

a SendAs message </p> </li>

<li id="GUID-E343398A-7261-5D21-BADF-96D676A41F81"><p>Launching a message

editor for the created SendAs message </p> </li>

<li id="GUID-15195205-3175-5597-9CF0-E70B50F674DD"><p>Modifying a SendAs message </p> </li>

<li id="GUID-9EED6F4B-83F8-524F-896A-808725A0A729"><p>Sending a SendAs message </p> </li>

</ul> </section>

</conbody><related-links>

<link href="GUID-BA7B9BA6-B840-5182-90B0-A4914592A40D.dita"><linktext>SendAs Server</linktext>

</link>

<link href="GUID-382B8A9D-9D10-54CD-91A6-B9E7A2477662.dita"><linktext>SendAs Example

Code</linktext></link>