OSID - osid.messaging Package Description

Package osid.messaging

Title Messaging Open Service Interface Definitions

Version 3.1.0

Description

Package	osid.messaging
Description	The Messaging OSID sends and receives messages. Messages `Messages` are structures that include a sender, recipients, and a timestamp. A `Message` is created using a `MessageAdminSession`. The text of the `Message` is displayable as text and may include a specific structure defined using a `MessageRecord`. Until a `Message` is sent, it is stored and may be edited as a draft. Once a `Message` is sent, the `Message` includes the sending `Agent` as well as the addressed recipients represented by a list of `Resources`. A `Message` is received by a receiving `Agent` which generally is related to one of the recipients. Sending Messages Once a Message has been created, it may be sent from the authenticated `Agent to a specified list of recipients` using the `MessagingSession`. The same `Message` may be sent to additional recipients by returning to the `MessagingSession` and using the same `Message` `Id`. Receiving Messages The `MessageLookupSession` can be used to retrieve incoming `Messages`. From the point of view of the receiving `Agent`, `Messages` from the `MessageLookupSession` indicate a foreign `Agent` as the sender and at least one recipient related to the authenticated `Agent` which generally, but may not always, be the receiving `Agent`. The same interfaces are used to receive `Messages` as well as examine created `Messages`. The `Messages` seen in the `MessageLookupSession` vary depending on the point of view implied by the `Mailbox` catalog. Message Receipts Once a `Message` has been received by a receiving `Agent`, a `Receipt` is be generated to include the time receive and the receiving `Agent`. A `Receipt` can be used to store additional data related to the received `Message`. `Receipts` may only be visible to the receiving `Agent` or a Messaging OSID Provider may authorize `Receipts` to be visible to the sender or other parties. Mailbox Catalogs `Messages` are cataloged using `Mailboxes`. Mailboxes be may used to store messages for different users, and may also be used to provide message folders for each user. Like all `OsidCatalogs`, a `Mailbox` may belong to a federated hierarchy to provide fedeated and filtering views among multiple mailboxes. On Resource & Agents The `Agent` is the identity of an authenticated actor while the `Resource` represents a real-world entity such as a person or organization. The mapping between `Agents` and `Resources` is managed by the Resource OSID. In the Messaging OSID, an `Agent` sends a `Message` to a `Resource`, However, aspects of the service also examine messages from the recipient's point of view where the sender appears as an object instead of an actor. The Messaging OSID references both a sender as a `Resource` and asending agent as an `Agent`. The Messaging OSID Provider orchestrates the mapping between `Agents` and `Resources` as a messaging application would access a local address book for looking up full names corresponding to incoming email addresses. Sub Packages The Messaging OSID contains a Messaging Batch OSID for managing `Messages` and `Mailboxes` in bulk.

The Messaging OSID sends and receives messages.

Messages

Messages are structures that include a sender, recipients, and a timestamp. A Message is created using a MessageAdminSession. The text of the Message is displayable as text and may include a specific structure defined using a MessageRecord.

Until a Message is sent, it is stored and may be edited as a draft. Once a Message is sent, the Message includes the sending Agent as well as the addressed recipients represented by a list of Resources. A Message is received by a receiving Agent which generally is related to one of the recipients.

Sending Messages

Once a Message has been created, it may be sent from the authenticated Agent to a specified list of recipients using the MessagingSession. The same Message may be sent to additional recipients by returning to the MessagingSession and using the same Message Id.

Receiving Messages

The MessageLookupSession can be used to retrieve incoming Messages. From the point of view of the receiving Agent, Messages from the MessageLookupSession indicate a foreign Agent as the sender and at least one recipient related to the authenticated Agent which generally, but may not always, be the receiving Agent.

The same interfaces are used to receive Messages as well as examine created Messages. The Messages seen in the MessageLookupSession vary depending on the point of view implied by the Mailbox catalog.

Message Receipts

Once a Message has been received by a receiving Agent, a Receipt is be generated to include the time receive and the receiving Agent. A Receipt can be used to store additional data related to the received Message.

Receipts may only be visible to the receiving Agent or a Messaging OSID Provider may authorize Receipts to be visible to the sender or other parties.

Mailbox Catalogs

Messages are cataloged using Mailboxes. Mailboxes be may used to store messages for different users, and may also be used to provide message folders for each user. Like all OsidCatalogs, a Mailbox may belong to a federated hierarchy to provide fedeated and filtering views among multiple mailboxes.

On Resource & Agents

The Agent is the identity of an authenticated actor while the Resource represents a real-world entity such as a person or organization. The mapping between Agents and Resources is managed by the Resource OSID. In the Messaging OSID, an Agent sends a Message to a Resource, However, aspects of the service also examine messages from the recipient's point of view where the sender appears as an object instead of an actor. The Messaging OSID references both a sender as a Resource and asending agent as an Agent. The Messaging OSID Provider orchestrates the mapping between Agents and Resources as a messaging application would access a local address book for looking up full names corresponding to incoming email addresses.

Sub Packages

The Messaging OSID contains a Messaging Batch OSID for managing Messages and Mailboxes in bulk.