Explorer la structure du manifeste de l’application et le package d’un complément SharePoint
Complément pour la structure d’un package SharePoint
Un package de complément SharePoint est un fichier qui a une extension « .app » et qui est conforme à la Open Packaging Conventions (OPC). Le package contient les éléments suivants :
Fichier manifeste du complément : ce fichier, nommé appmanifest.xml, est obligatoire. Il indique à SharePoint certaines propriétés importantes du complément, notamment son titre et les autorisations à exécuter. Pour en savoir plus sur le contenu de ce fichier, consultez la section Complément pour le fichier manifeste SharePoint de cet article.
Packages de solution SharePoint : le complément peut éventuellement inclure un package de solutions SharePoint (fichier .wsp) contenant les composants du site web de complément. Ces composants peuvent être des pages, des instances de liste, des vues, des documents, des fonctionnalités d’étendue web et d’autres composants SharePoint. (Pour en savoir plus sur les composants SharePoint pouvant être inclus dans un complément SharePoint, consultez la section Types de composants SharePoint pouvant figurer dans un complément SharePoint.) Le fichier .wsp peut également contenir des compléments Office. Les composants figurant dans le fichier .wsp sont déployés sur le site web de complément. Pour obtenir un exemple de package de compléments contenant un package de solutions SharePoint, consultez l’article Créer un complément hébergé par un fournisseur comportant un type personnalisé de liste et de contenu SharePoint.
Fonctionnalités du site web hôte avec les actions personnalisées ou les composants de complément : en plus des composants SharePoint déployés sur le site web de complément, un complément SharePoint peut également déployer une ou plusieurs actions personnalisées (éléments de menu contextuel ou extensions du ruban) sur le site web hôte. Pour cela, il faut intégrer au package de compléments une fonctionnalité qui ne figure pas dans le fichier .wsp du package, qui déploie les composants destinés au site web hôte. Cette fonctionnalité souple est appelée « fonctionnalité du site web hôte ».
Les composants du complément sont déployés sur le site web hôte de la même façon. La fonctionnalité du site web hôte comprend un fichier SharePoint standard feature.xml et un ou plusieurs fichiers associés elements.xml. Par exemple, un fichier elements.xml pour une action personnalisée contient les balises CustomAction de l’action personnalisée. Il peut également contenir les balises des composants du complément. Seuls ces deux types de composants peuvent figurer dans la fonctionnalité du site web hôte. Ces fonctionnalités ne sont pas détaillées dans le fichier manifeste du complément. Cependant, elles correspondent à des « composants » dans le contexte d’OPC et il existe une relation OPC explicite entre le fichier manifeste du complément et chacun de ces fichiers. Pour obtenir un exemple de package de compléments contenant une fonctionnalité du site web hôte, consultez l’article Créer des actions personnalisées à déployer avec les compléments SharePoint.
Notes
Les administrateurs clients peuvent installer par lots un complément SharePoint sur plusieurs sites web. Lorsqu’un complément est installé de cette façon, on dit qu’il a une étendue client. Si le complément n’a pas été installé par lots, mais sur chaque site web séparément, il a une étendue web. Si la fonctionnalité du site web hôte comporte les extensions du ruban ou les composants du complément, ils ne sont pas déployés sur les sites web hôtes si le complément est installé par lots. Ainsi, seuls les éléments de menu contextuel sont déployés avec les compléments d’étendue client.
Ne pas confondre l’étendue de complément avec l’étendue de la fonctionnalité. L’étendue de la fonctionnalité indique où sont déployés les éléments d’une fonctionnalité. Il peut s’agir de la batterie, de l’application web, du site (c’est-à-dire de la collection de sites) et du site web. Seul le site web peut être choisi pour déployer les fonctionnalités des compléments SharePoint (les deux hébergent des fonctionnalités et des fonctionnalités web hôtes à l’intérieur d’un fichier .wsp dans un package de compléments).
L’étendue du complément fait référence à l’étendue à laquelle un complément est installé. Les possibilités sont web, auquel cas le complément a été installé sur un ou plusieurs sites web site à site, et Client, auquel cas le complément a été installé par lots sur tout ou partie des sites web dans la location d’un client.
Pour en savoir plus sur les étendues client et web, consultez la rubrique Locations et étendues de déploiement des compléments pour SharePoint.
fichiers de ressources de localisation (.resx): ils permettent de localiser des aspects du manifeste de complément qui incluent le titre du complément et les aspects des fonctionnalités web hôtes dans le package de complément. (Les parties individuelles du package de complément qui se trouvent à l’intérieur de leur propre package, telles que les fichiers .wsp, les packages de sites web Azure et les manifestes de complément, ont chacune leurs propres processus de localisation qui sont appliqués exactement comme si les éléments en question ne faisaient pas partie d’un complément SharePoint.) Pour obtenir un exemple de package de complément qui inclut des fichiers .resx pour une fonctionnalité web hôte, consultez Localiser les compléments SharePoint.
Manifestes de compléments Office : un complément Office peut se trouver dans un ou plusieurs manifestes de compléments Office. Ce composant peut figurer dans le package de compléments uniquement si le complément est chargé vers un catalogue de compléments d’entreprise SharePoint, et non vers l’espace public. Pour en savoir plus, consultez l’article Publier des compléments SharePoint.
Complément pour le fichier manifeste SharePoint
Chaque Complément SharePoint comprend un fichier appmanifest.xml. Ce fichier donne à SharePoint les informations nécessaires sur le complément et en définit les propriétés les plus importantes. Voici plusieurs des éléments indiqués dans le manifeste :
Le nom interne, l'ID de produit et la version du complément.
L'URL de la page d'accueil, c'est-à-dire de la page qui s'affiche au lancement du complément. Cela peut être une page du site web de complément, une page basée sur le cloud ou une page située sur un serveur web ISV.
Notes
Dans certains cas, des restrictions peuvent s’appliquer au type de fichier à spécifier dans l’élément StartPage. Pour en savoir plus, consultez l’article sur l’élément StartPage. Quand vous associez plusieurs paramètres de requête dans la valeur StartPage, vous devez utiliser l’esperluette encodée
&, plutôt que&ou un point-virgule pour les ajouter ensemble.D'autres propriétés du complément. Il s'agit du titre et des paramètres régionaux pris en charge par le complément (les deux sont obligatoires), des URL des services traitant les événements avant l'installation, après la mise à niveau et avant la désinstallation, ainsi que du modèle web à utiliser quand le site web de complément est créé.
Les demandes d'autorisation dont le complément a besoin pour les ressources SharePoint hors du site web de complément.
Une identification, à des fins d'authentification et d'autorisation, du principal de complément. Il s'agit du principal qui reçoit les autorisations. Cela n'est pas obligatoire pour les compléments hébergés sur SharePoint.
Une liste des conditions préalables, le cas échéant, devant être disponibles pour le complément afin d’installer celui-ci. Par exemple, il peut être nécessaire d’installer et d’activer certaines fonctionnalités, et de concéder sous licence et d’installer certains services.
Notes
Le fichier manifeste du complément est le seul élément obligatoire dans le package du complément, mais tous les éléments de la liste précédente ne sont pas des composants obligatoires du fichier.
Pour en savoir plus sur les balises du manifeste du complément, consultez les informations de référence sur le schéma des manifestes des compléments SharePoint. Le contenu de cet article ne remplace pas les informations figurant dans ce nœud, notamment les informations concernant les éléments et les attributs requis. Notez également que le schéma des manifestes de complément SharePoint est différent du schéma des manifestes de complément Office. Vous trouverez des informations sur ce dernier dans les informations de référence sur le schéma des manifestes des compléments Office (v1.1).
L’exemple suivant présente un fichier appmanifest.xml. Dans cet exemple, la page de démarrage du complément est une page ASP.NET située sur un serveur distant, et non une page située sur le site SharePoint. L’URL de la page comprend une chaîne de requête qui transmet l’URL du site web hôte à l’application web distante. Le composant {HostUrl} de la chaîne correspond à un jeton, qui est résolu au lancement du complément. Le complément demande une autorisation d’accès en écriture à toutes les listes du site web hôte. Le principal de complément devant obtenir cette autorisation est l’application web distante.
Utilisez l’élément SupportedLocales ou SupportedLanguages dans votre manifeste de complément. Nous vous recommandons d’utiliser SupportedLocales plutôt que SupportedLanguages. L’élément SupportedLanguages fonctionnera encore même après publication. Toutefois, évitez de l’utiliser. Pour en savoir plus, consultez les articles sur l’élément SupportedLocales et l’élément SupportedLanguages.
Notes
Même si les valeurs de l’attribut Scope de l’élément AppPermissionRequest ont la même structure qu’une URI, ce sont bien des chaînes littérales. La valeur Scope de l’exemple ne contient aucun espace réservé. Pour en savoir plus sur les autorisations, consultez l’article Autorisations des compléments dans SharePoint.
<?xml version="1.0" encoding="utf-8" ?>
<App xmlns="http://schemas.microsoft.com/sharepoint/2012/app/manifest"
ProductID="{4a07f3bd-803d-45f2-a710-b9e944c3396e}"
Version="1.0.0.0"
SharePointMinVersion="15.0.0.0"
Name="MySampleApp"
>
<Properties>
<Title>My Sample App</Title>
<StartPage>http://MyRemoteWebApplicationServer/default.aspx/?SPHostUrl={HostUrl}</StartPage>
<SupportedLocales>
<SupportedLocale CultureName="en-US" />
</SupportedLocales>
</Properties>
<AppPermissionRequests>
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web/list" Right="Write"/>
</AppPermissionRequests>
<AppPrincipal>
<RemoteWebApplication ClientId="1ee82b34-7c1b-471b-b27e-ff272accd564" />
</AppPrincipal>
</App>
Jetons d’URL dans le manifeste de complément
SharePoint fournit plusieurs jetons à utiliser dans l’élément StartPage et d’autres emplacements dans les compléments et les composants des compléments pour représenter des informations inconnues jusqu’à l’exécution du complément. L’infrastructure SharePoint résout ces jetons. Certains d’entre eux sont utilisés au début de l’URL, alors que d’autres peuvent être utilisés au milieu d’une URL (par exemple, la valeur d’un paramètre de requête). Ces jetons et d’autres peuvent également servir dans différents contextes de développement SharePoint.
Pour en savoir plus sur tous ces jetons et les emplacements où ils peuvent être utilisés, consultez l’article Chaînes URL et jetons dans les compléments pour SharePoint. Pour obtenir des informations plus générales sur les autres jetons et les URL dans SharePoint, consultez l’article URL et jetons dans SharePoint.
Notes
Ces jetons ne sont pas utilisés dans l’attribut Scope d’un élément AppPermissionRequest.