Export (0) Print
Expand All
Expand Minimize

Permissions element (MailApp complexType) (app manifest schema v1.1)

Controls the subset of the API that may be available to this mail app at runtime; the developer should request permissions based on "least privilege".

Last modified: January 28, 2014

Mail app

Element type

xs:string

Namespace

http://schemas.microsoft.com/office/appforoffice/1.0

Schema file

offappmanifest.xsd

<xs:element name="Permissions" minOccurs="1" maxOccurs="1">
    <xs:simpleType>
        <xs:restriction base="xs:string">
            <xs:enumeration value="Restricted" />
            <xs:enumeration value="ReadItem" />
            <xs:enumeration value="ReadWriteMailbox" />
        </xs:restriction>
    </xs:simpleType>
</xs:element>

If the schema defines specific requirements, such as sequence, minOccurs, maxOccurs, and choice, see the definition section.

Parent elements

None.

Child elements

None.

Attributes

None.

Value

Description

Restricted

Permission that applies to all mail apps, enables the ItemIs and ItemHasKnownEntity activation rules, enables use of the RoamingSettings object and a subset of the JavaScript API for Office.

ReadItem

Applies to the selected item, includes the Restricted permission, and enables the mail app to use all the well-known entities and regular expression activation rules, to read all properties and write custom properties.

ReadWriteMailbox

Includes all of the ReadItem permission and also enables the mail app to use the makeEWSRequestAsync method to read and write all properties of any item in the user's mailbox.

ReadWriteItem

Applies to the selected item and includes the ReadItem permission and enables the mail app to use all the well-known entities and regular expression activation rules, to read all properties, to write properties in compose forms, and to write custom properties.

  • A mail app should request the level of permission based on the APIs it uses. Because the end user or IT administrator has to explicitly grant the permission before installing an app, requesting higher permission than needed may affect the chance of installation. Requesting insufficient permission can result in the host application blocking the use of specific APIs in the app and generating errors at runtime.

Community Additions

ADD
Show:
© 2014 Microsoft