Routing Interface

Using Routing

The following frame shows a summary of the slots you can include in the item
frame. Note that some of the slots shown are specific to a particular transport, and
you should include them only if you are sending to that transport. Also, don't include
any additional slots in the item frame unless they are specific to a particular transport.

itemFrame := {
appSymbol:

, // appSymbol of sender

destAppSymbol:

, // receiving app, if different

body:

, // the data to send

title:

, // item title, e-mail subject

toRef:

, // array of name refs for recipients

cc:

, // array of name refs for copied recipients

bcc:

, // array of name refs for blind copies

currentFormat:

, // routing format to use

connect:

, // try to connect immediately?

hidden:

, // hide in Out Box?

covert:

, // not logged or saved in Out Box?

completionScript:

, // notify app of state change?

needsResolve:

, // body slot contains an alias?

// transport-specific slots
printer:

, // the printer to use for printing

coverPage:

, // use a cover page for fax?

faxResolution:

, // 'fine or 'normal fax resolution

phoneNumber:

, // phone number, for call transport

name:

, // name, for call transport

serviceProvider:

, // call; 'modem, 'speaker, or nil

saveAsLog:

, // log call in Calls app?

}

Note that you can set any of the Boolean slots in the

SetupItem

method of the

routing format.

Applications implementing their own custom sending functionality apart from the
Action button may need to open the transport routing slip view for the user. If you
need to do this, you can use the global function

OpenRoutingSlip

, as described

in the section "Opening a Routing Slip Programmatically" beginning on page 21-29.

Creating a Name Reference

21

For the built-in fax and call transports, and for e-mail and other transports that use
addresses, addressing information for an item to send is stored in the

toRef

slot of

the item frame, and certain other slots such as

cc

,

bcc

, and so on. These slots

contain arrays of one or more name reference objects. A name reference is simply a
frame that serves as a wrapper for a soup entry (often from the Names soup, thus
the term "name reference"). The name reference may contain an alias to a soup