Élément StartPage (PropertiesDefinition complexType)

(Manifeste de complément SharePoint)

S’applique à : Compléments SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

En règle générale, l’URL de la page consultée lors du lancement du complément SharePoint. Toutefois, il peut également s’agir de l’URL d’une méthode de contrôleur ou d’une méthode de service web appelée lors du lancement du complément.

Remarque

La chaîne app s’affiche en tant que partie ou en tant que partie de certains noms d’éléments, d’attributs et de fichiers, car les compléments SharePoint étaient initialement appelés « applications pour SharePoint ». Pour garantir la compatibilité descendante, les schémas n’ont pas été modifiés.

Lorsque l’élément enfant de l’élément AppPrincipal n’est pas Internal, la page spécifiée dans l’élément StartPage doit être d’un type de fichier qui prend en charge le verbe POST (en plus de GET) afin que le jeton de contexte OAuth puisse être envoyé sur le corps de la requête.

Les types de fichiers courants qui sont généralement configurés sur les serveurs web pour prendre en charge POST sont aspx, php et d’autres types qui prennent en charge le code côté serveur. Les compléments qui ont un principal de complément interne n’utilisent pas OAuth et, par conséquent, la page de démarrage de ces compléments peut être un type qui n’est pas configuré sur le serveur web cible pour prendre en charge POST. Par exemple, les fichiers HTML ne prennent souvent pas en charge POST.

    <StartPage>http://domain_of_remote_component/Home.aspx?{StandardTokens}</StartPage>

Si le serveur web distant lie le composant distant à un port autre que 80 lorsque le protocole est HTTP ou 443 lorsque le protocole est HTTPS, le port doit être inclus explicitement comme dans l’exemple suivant.

    <StartPage>http://domain_of_remote_component:3333/Home.aspx?{StandardTokens}</StartPage>

La valeur de cet élément peut contenir certains jetons pour représenter des informations qui ne sont pas connues au moment du développement. Le « {StandardTokens} » ci-dessus est un exemple. Pour plus d'informations, voir Chaînes URL et jetons dans les compléments pour SharePoint.

Lorsque vous déboguez dans Visual Studio, les outils de développement Microsoft Office pour Visual Studio utilisent le jeton ~remoteWebUrlà la place du protocole et du domaine, comme dans l’exemple suivant.

    <StartPage>~remoteWebUrl/Home.aspx?{StandardTokens}</StartPage>

Le jeton est automatiquement remplacé par le protocole et le domaine réels (et le port, si nécessaire) par les Outils de développement Office pour Visual Studio lorsque le complément est empaqueté à l’aide de l’option Publier dans le menu contextuel du projet de complément SharePoint dans Visual Studio. Si vous n’utilisez pas l’Assistant Publication (ou si vous le faites, mais que le composant distant est déployé sur Azure), vous devez remplacer manuellement le jeton avant d’empaqueter le complément SharePoint.

Si le complément utilise OAuth, la partie domaine de la valeur StartPage doit correspondre exactement au domaine de complément spécifié lorsque le complément SharePoint a été inscrit auprès de Microsoft Azure Access Control Service (ACS). Pour plus d’informations, voir Inscrire des compléments SharePoint.

Importante

Le contrôle d’accès Azure (ACS), un service d’Azure Active Directory (Azure AD), ne sera plus disponible à partir du 7 novembre 2018. Ce retrait n?a aucune incidence sur le mod?le de compl?ments SharePoint, qui utilise lehttps://accounts.accesscontrol.windows.net nom d?h?te (qui n?est pas affect? par ce retrait). Pour plus d’informations, voir Conséquences du retrait du contrôle d’accès Azure pour les compléments SharePoint.

Informations sur l'élément

Informations	Emplacement
Type d’élément	UrlElementDefinition
Namespace	http://schemas.microsoft.com/sharepoint/2012/app/manifest
Fichier de schéma	appmanifest.xsd

Définition

    <xs:element name="StartPage" type="UrlElementDefinition" minOccurs="1" maxOccurs="1" >
         </xs:element>

Éléments et attributs

Si le schéma définit des exigences spécifiques, telles que sequence, minOccurs, maxOccurs et choice, consultez la section définition.

Éléments parents

Élément	Type	Description
Properties	PropertiesDefinition	Contient des informations globales pour le complément.

Éléments enfants

Aucun.

Attributs

Aucun.