Export (0) Print
Expand All

ContentApp complexType (app manifest schema v1.0)

apps for Office

Defines a content app that is placed in-line with document content to provide a richer web-based experience.

Last modified: December 23, 2013

Namespace

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

Schema file

offappmanifest.xsd

Extension base

OfficeApp

<xs:complexType name="ContentApp">
    <xs:complexContent>
        <xs:extension base="OfficeApp">
            <xs:sequence>
                <xs:element name="Capabilities" minOccurs="1" maxOccurs="1">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="Capability" type="ContentAppCapability" minOccurs="1" maxOccurs="1"></xs:element>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
                <xs:element name="DefaultSettings" type="ContentAppSettings" minOccurs="1" maxOccurs="1"></xs:element>
                <xs:element name="Permissions" minOccurs="1" maxOccurs="1">
                    <xs:simpleType>
                        <xs:restriction base="xs:string">
                            <xs:enumeration value="Restricted" />
                            <xs:enumeration value="ReadDocument" />
                            <xs:enumeration value="WriteDocument" />
                            <xs:enumeration value="ReadWriteDocument" />
                        </xs:restriction>
                    </xs:simpleType>
                </xs:element>
                <xs:element name="AllowSnapshot" type="xs:boolean" minOccurs="0" maxOccurs="1"></xs:element>
                <xs:any id="ContentAppSignature" namespace="http://www.w3.org/2000/09/xmldsig#" processContents="lax" minOccurs="0" maxOccurs="1"></xs:any>
            </xs:sequence>
        </xs:extension>
    </xs:complexContent>
</xs:complexType>

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

Child elements

Element

Type

Description

AllowSnapshot

xs:boolean

Specifies whether a snapshot image of this content app is saved when the hosting document is saved.

Capabilities

Not defined

Specifies the capabilities that are required by the content app; the app can be available to users on an application if the application supports at least one of these capabilities.

DefaultSettings

ContentAppSettings

Specifies control settings that are applied whenever the content app is used.

Permissions

xs:string

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

Attributes

None.

You can specify an optional element to support a digital signature to sign the manifest when you submit the app to the Office Store. The element is part of the namespace http://www.w3.org/2000/09/xmldsig#, and the schema for the element follows the processing rules and syntax as specified by XML Signature Syntax and Processing (Second Edition).

The following is an example of a signature.

  <Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
    <SignedInfo>
      <CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
      <SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
      <Reference URI="">
        <Transforms>
          <Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
          <Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
        </Transforms>
        <DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
        <DigestValue>0ZTx59WcgK4NKW4TKQNlQaHOYx8=</DigestValue>
      </Reference>
    </SignedInfo>
    <SignatureValue>Encrypted data</SignatureValue>
    <KeyInfo>
      <KeyValue>
        <RSAKeyValue>
          <Modulus>Encrypted data</Modulus>
          <Exponent>AQAB</Exponent>
        </RSAKeyValue>
      </KeyValue>
      <X509Data>
        <X509Certificate>Encrypted data</X509Certificate>
      </X509Data>
      <X509Data>
        <X509Certificate>Encrypted data</X509Certificate>
      </X509Data>
      <X509Data>
        <X509Certificate>Encrypted data</X509Certificate>
      </X509Data>
    </KeyInfo>
    <Object id="ts-countersig">
      <X509Data>
        <X509Certificate>Encrypted data</X509Certificate>
      </X509Data>
      <X509Data>
        <X509Certificate>Encrypted data</X509Certificate>
      </X509Data>
      <CounterSignature 
        xmlns="http://schemas.microsoft.com/xmldsig/timestamp/2003" 
        ts-format="cms-timestamp-message">Encrypted data</CounterSignature>
    </Object>
  </Signature>
Show:
© 2015 Microsoft