C H A P T E R 2 2
Transport Interface
22-4
About Transports
completionScript
A Boolean; if
true
, the transport sends the
ItemCompletionScript
message to the application when
the item's state changes or when errors occur. For more
details on this mechanism, see the section "Completion and
Logging" beginning on page 22-16.
details on this mechanism, see the section "Completion and
Logging" beginning on page 22-16.
needsResolve
A Boolean that is set to
true
if the
body
slot contains an
alias, rather than the actual data. This means that the format
method
method
ResolveBody
must be called before the item is sent.
For transports that need addressing information, this is usually encapsulated in
name references. A name reference is a frame that contains a soup entry or an
alias to one, usually from the Names soup, hence the term name reference. The
system includes built-in data definitions that can access name references, along
with associated view definitions to display the information stored in or referenced
by a name reference. For more information about using name references for
addressing information, see the section "Creating a Name Reference" beginning on
page 21-27. For more on name references in general, see "Name References"
(page 5-1) in Newton Programmer's Reference.
name references. A name reference is a frame that contains a soup entry or an
alias to one, usually from the Names soup, hence the term name reference. The
system includes built-in data definitions that can access name references, along
with associated view definitions to display the information stored in or referenced
by a name reference. For more information about using name references for
addressing information, see the section "Creating a Name Reference" beginning on
page 21-27. For more on name references in general, see "Name References"
(page 5-1) in Newton Programmer's Reference.
The following slots in the item frame define the recipient and sender addresses:
toRef
An array containing one or more name references used to
identify the recipient(s) of the item.
identify the recipient(s) of the item.
fromRef
A frame containing a name reference that identifies the
sender. This information is usually extracted from the
sender's current owner card, or current persona. The transport
normally sets this slot in its
sender. This information is usually extracted from the
sender's current owner card, or current persona. The transport
normally sets this slot in its
NewItem
method. For more
information, see the section "Obtaining an Item Frame"
beginning on page 22-13.
beginning on page 22-13.
cc
An array containing one or more name references used to
identify recipients of copies of the item. Typically, this slot is
used by e-mail transports.
identify recipients of copies of the item. Typically, this slot is
used by e-mail transports.
bcc
An array containing one or more name references used to
identify recipients of blind copies of the item. Typically, this
slot is used by e-mail transports.
identify recipients of blind copies of the item. Typically, this
slot is used by e-mail transports.
In addition, there may be other address slots used by some transports.
For a detailed description of all the item frame slots that are important to the Routing
interface, see "Item Frame" (page 18-1) in Newton Programmer's Reference.
interface, see "Item Frame" (page 18-1) in Newton Programmer's Reference.