Élément StartPage (PropertiesDefinition, complexType)
(SharePoint manifeste du add-in)
S’applique à : SharePoint de | SharePoint Foundation 2013 | SharePoint Server 2013
En règle générale, l’URL de la page visitée lors du lancement du SharePoint est lancée. Toutefois, il peut également s’agit de l’URL d’une méthode de contrôleur ou d’une méthode de service web qui est invoquée lors du lancement du module.
Notes
La chaîne s’affiche sous la forme d’un élément, d’un attribut et d’un nom de fichier, ou de tous, car les SharePoint de fichiers étaient à l’origine appelés « applications pour app 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 demande.
Les types de fichiers courants qui sont généralement configurés dans les serveurs web pour prendre en charge post sont aspx, php et d’autres types qui prend en charge le code côté serveur. Les applications qui ont un principal de add-in interne n’utilisent pas OAuth. Par conséquent, la page de démarrage de ces modules peut être un type qui n’est pas configuré sur le serveur web cible pour prendre en charge POST. Les fichiers HTML, par exemple, ne sont 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 inconnues au moment du développement. L’exemple « {StandardTokens} » ci-dessus. Pour plus d'informations, voir Chaînes URL et jetons dans les compléments pour SharePoint.
Lorsque vous déboguer dans Visual Studio, les outils de développement Microsoft Office pour Visual Studio utilisent le jeton à la place du protocole et du domaine, comme dans l’exemple ~remoteWebUrl 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 module est empaqueté à l’aide de l’option Publier dans le menu contextique du projet de SharePoint Add-in 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 de mettre en package le SharePoint.
Si le add-in utilise OAuth, la partie domaine de la valeur StartPage doit correspondre exactement au domaine de la SharePoint spécifié lors de l’inscription du add-in auprès du service de contrôle d’accès Microsoft Azure (ACS). Pour plus d’informations, voir Inscrire SharePoint des modules complémentaires.
Important
Azure Access Control (ACS), a service of Azure Active Directory (Azure AD), will be retired on November 7, 2018. This retirement does not impact the SharePoint Add-in model, which uses the https://accounts.accesscontrol.windows.net hostname (which is not impacted by this retirement). For more information, see Impact of Azure Access Control retirement for SharePoint Add-ins.
Informations sur l’élément
| 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 séquence, minOccurs, maxOccurs et choix, voir la section de définition.
Éléments parents
Élément |
Type |
Description |
|---|---|---|
Contient des informations globales pour le module complémentaire. |
Éléments enfants
Aucun.
Attributs
Aucun.