3.10 Stored Objects
A variety of data objects are stored in the EasyLink system as "stored objects". A StoredObjectId represents the data necessary to identify a particular stored object.
StoredObjectIdType
Tag Name & type | # | Description |
---|
StoredObjectIdType | | |
| @objKind xs:string | 1 | The type of object. These are not case-sensitive. Legal values are:
- bannerfx
- cancellationNotice
- coversheet
- coversheet_classic
- emailBody
- emaildisclaimerblock
- emailSubject
- letterhead
- logo
- mmcover
- rmBlock
- rpttmplt_col
- sos_tts
- systemData
- textBlock
- vscript
Not all of these values may be usable for specific functions, or may actually appear in results. There are other kinds of stored objects in the system which are not accessible through the Cloud Fax and Notifications API. |
| @ownership StoredObjectLevelType | 0-1 | Indicates the ownership level (and therefore the visibility) of the stored object. Legal values are:
user |
group |
customer |
system |
If ownership is not specified, user ownership is usually presumed. |
| @groupName xs:string | 0-1 | Specifies the user's primary Fax2Mail group name. |
| @groupNo xs:long | 0-1 | Specifies the user's primary Fax2Mail group number. |
| @b64charset xs:string | 0-1 | In order to transmit a StoredObjectId value that is in a character set incompatible with the XML document, the data can be sent in base64-encoded form, and the character set (ISO name) put in this attribute. If this attribute is present, the system will expect base64-encoded data as the value. |
Stored Object Functions
The Cloud Fax and Notifications API currently supports these operations on stored objects, subject in some cases to ownership level restrictions:
Stored Object Type | Cloud Fax and Notifications API Functions |
Create | List | Retrieve | Delete |
TextBlock | TextBlockCreate | StoredObjectList | TextBlockRetrieve | StoredObjectDelete |
RmBlock | TextBlockCreate | StoredObjectList | TextBlockRetrieve | StoredObjectDelete |
EmailBody | TextBlockCreate | StoredObjectList | TextBlockRetrieve | StoredObjectDelete |
EmailSubject | TextBlockCreate | StoredObjectList | TextBlockRetrieve | StoredObjectDelete |
CancellationNotice | TextBlockCreate | StoredObjectList | TextBlockRetrieve | StoredObjectDelete |
Letterhead | | StoredObjectList | | |
BannerFx | | StoredObjectList | | |
Logo | | StoredObjectList | | |
Report Templates | | StoredObjectList | | |
Text-to-speech templates | TTSObjectCreate | StoredObjectList | TTSRetrieve | StoredObjectDelete |
VoiceScripts | VoiceScriptCreate | StoredObjectList | VoiceScriptRetrieve | StoredObjectDelete |
MailMerge cover sheets | MMCoverSheetCreate | StoredObjectList | MMCoverSheetRetrieve | StoredObjectDelete |
EmailDisclaimer | TextBlockCreate | StoredObjectList | TextBlockRetrieve | StoredObjectDelete |
F2M Email Filtering Rules | F2MFilteringRulesCreate | | F2MFilteringRulesRetrieve | StoredObjectDelete |
In addition, TTSObjectPreview and MMCoverSheetPreview functions allow for the generation of a preview of text-to-speech templates or mailmerge coversheets - either stored in the system or based on data in the request. |