Aspects importants du contexte de développement et de l’architecture des compléments SharePointImportant aspects of the SharePoint Add-in architecture and development landscape

Cet article complète les informations de l’article Compléments SharePoint. This article supplements the information in the article SharePoint Add-ins.

Le modèle de complément SharePoint propose les solutions d’hébergement suivantes pour les composants d’un complément SharePoint :The SharePoint Add-in model provides the following ways to host the components of a SharePoint Add-in:

  • Hébergés par un fournisseur : compléments incluant au moins un composant distant et pouvant également inclure des composants SharePoint. Les autres composants sont déployés par votre logique sur votre matériel ou dans votre compte cloud. Il est aussi possible de les déployer sur le matériel ou sur le compte cloud du client à l'aide des instructions et des programmes d'installation que vous fournissez.Provider-hosted: Add-ins that include at least one remote component and may also include SharePoint components. The non-SharePoint components are deployed by your logic on your hardware or cloud account, or deployed on the customer's hardware or cloud account using installation programs and instructions that you provide.

  • Hébergé par SharePoint : compléments qui incluent uniquement les composants et la logique SharePoint qui s’exécute sur le client.SharePoint-hosted: Add-ins that include only SharePoint components and logic that runs on the client.

Pour obtenir des informations plus détaillées sur les options d’hébergement et des instructions pour faire votre choix, consultez la section Choisir les modèles de développement et d’hébergement d’un complément SharePoint.For more detailed information about hosting options and some guidance for how to choose between them, see Choose patterns for developing and hosting your SharePoint Add-in.

Sites web de complément, sites web hôtes, fonctionnalités et composants SharePoint dans des complémentsAdd-in webs, host webs, Features, and SharePoint components in add-ins

Le site web sur lequel le complément SharePoint est installé est nommé site web hôte.The website to which a SharePoint Add-in is installed is called the host web. Cependant, les composants importants du complément SharePoint, qu’ils soient des composants SharePoint ou externes, ne sont pas déployés sur le site web hôte.However, the significant parts of the SharePoint Add-in, whether they are SharePoint components or external components, are not deployed to the host web. Les composants externes sont déployés sur les serveurs externes ou sur des comptes sur le cloud.External parts are deployed to external servers or cloud accounts. Les composants SharePoint sont déployés sur un site web spécial qui dispose de son propre domaine.SharePoint components are deployed to a special website with its own domain. Ce site est appelé site web de complément.This is called the add-in web.

Seul un ensemble limité d’éléments de l’interface utilisateur donnant aux utilisateurs accès aux autres composants du complément sont déployés sur le site web hôte.Only a limited set of UI elements that give users access to the add-in's other components are deployed to the host web. Ces composants de l’interface utilisateur sur le site web hôte sont déployés en tant que composants d’une fonctionnalité du site web hôte, une fonctionnalité flexible dans le package de complément et non dans un fichier .wsp. These UI components in the host web are deployed as part of a host web Feature—a Feature that is loose in the add-in package instead of inside a .wsp file. Les composants déployés sur le site web de complément sont toujours dans les fonctionnalités dans un fichier .wsp. The components that are deployed to the add-in web are always in Features that are inside a .wsp file. Les deux types de fonctionnalités doivent avoir une étendue Web.Both kinds of Features must have Web scope. Aucune autre étendue n’est possible pour les fonctionnalités dans les compléments SharePoint.No other scope is possible for Features in SharePoint Add-ins.

En règle générale, tout composant SharePoint qui ne comprend pas de code personnalisé fonctionnant sur les serveurs SharePoint peut être inclus dans un complément SharePoint (et être déployé sur le site web de complément).As a general rule, any SharePoint component that does not include custom code that runs on the SharePoint servers can be included in a SharePoint Add-in (and be deployed to the add-in web). Cependant, il existe des exceptions et des nuances concernant la manière et l’emplacement de déploiement des composants.There are, however, some exceptions and some nuances to how and where the components are deployed. Pour plus d’informations sur ces nuances et sur les sites web hôtes, les sites web de complément isolés et les fonctionnalités des compléments, consultez la section Héberger des sites web, des sites web de complément et des composants SharePoint dans SharePoint.For more information about these nuances and about host webs, the isolated add-in webs, and Features in add-ins, see Host webs, add-in webs, and SharePoint components in SharePoint.

Accéder au complément à partir de l’interface utilisateurAccessing the add-in from the UI

Quand un Complément SharePoint est installé sur un site web, le complément est répertorié sur la page Contenu du site du site web hôte. Les utilisateurs peuvent démarrer le complément à partir de cette page. Ouvert de cette manière, le complément fonctionne en mode plein écran.When a SharePoint Add-in is installed on a website, the add-in is listed on the Site Contents page of the host web. Users can start the add-in from that page. When opened in this way, the add-in runs in full-screen mode.

Une autre manière d’exposer un complément SharePoint est par l’intermédiaire d’un composant de complément, un type de composant WebPart représenté par la classe ClientWebPart.Another way that a SharePoint Add-in can be surfaced is through an add-in part, a type of web part that is represented by the ClientWebPart class. Ce type de composant WebPart est essentiellement un wrapper d’IFrame qui héberge une page du complément.This kind of web part is essentially a wrapper for an IFrame that would host a page of the add-in. Dans le cas le plus simple, la seule propriété importante du composant WebPart est une URL qui pointe vers la page.In the simplest case, the only significant property of the web part is a URL that points to the page.

Néanmoins, les composants WebPart peuvent disposer de propriétés personnalisées que les utilisateurs peuvent définir dans le composant ToolPart.But web parts can have custom properties that users can set in a Tool Part. Ces propriétés pourraient par exemple servir à définir des informations contextuelles, telles que le code postal de l’utilisateur.Such properties could be used, for example, to set context information such as the user's ZIP Code or Postal Code. Pour inclure un tel composant de complément dans votre complément, vous créez une fonctionnalité de site web hôte dans le complément et ajoutez un balisage de composant WebPart déclaratif. To include such an add-in part in your add-in, you create a host web Feature in the add-in and add declarative web part markup. Comme tout autre composant WebPart, il apparaît dans l’interface utilisateur SharePoint à partir de laquelle les utilisateurs ajoutent des composants WebPart.Like any other web part, it appears in the SharePoint UI from which users add web parts. Vous pouvez disposer de plusieurs composants de complément déployés avec votre complément si vous avez besoin de davantage de variabilité. You can have more than one add-in part deployed with your add-in if you need even more variability. Par exemple, un complément météo peut disposer d’un composant de complément indiquant la météo actuelle et d’un second composant de complément indiquant les prévisions météorologiques hebdomadaires.For example, a weather add-in can have an add-in part that shows current weather and a second add-in part that shows a weekly forecast. Les deux composants disposent de tailles et de fonctionnalités différentes.The two parts can have different sizes and functionality.

Notes

Vous pouvez également déployer les composants de complément sur le site web de complément. Pour implémenter cela, le balisage du composant WebPart sera un composant de fonctionnalité dans un fichier .wsp dans le package de complément, pas dans la fonctionnalité du site web hôte.You can also deploy add-in parts to the add-in web. To implement this, the markup for the web part would be part of a Feature inside a .wsp file in the add-in package, not in the host web Feature.

Nous vous recommandons d’essayer de donner à vos compléments une apparence SharePoint autant que possible, bien que cela ne soit pas obligatoire et parfois pas la meilleure solution. We recommend that you try to give your add-ins a SharePoint appearance to the extent possible, although that is not mandatory and may not always be the best choice. Pour plus d’informations sur les instructions concernant l’expérience utilisateur, consultez la section Conception de l’expérience utilisateur pour les compléments dans SharePoint.For more information about the user experience guidelines, see UX design for SharePoint Add-ins.

Il existe par exemple un page maître spéciale appelée app.master. Cette page est optimisée pour être utilisée par les pages des compléments. La page app.master fait partie d'une nouvelle définition de site incluse dans SharePoint.There is, for example, a special master page called app.master. This page is optimized for use by the pages of add-ins. The app.master page is part of a new site definition that is included in SharePoint.

Un autre outil que vous pouvez utiliser pour que vos compléments conservent une convivialité cohérente avec SharePoint est le contrôle de chrome fourni avec SharePoint.Another tool you can use to help your add-ins maintain a consistent look and feel with SharePoint is the chrome control that ships with SharePoint. Ce contrôle vous permet d’ajouter la zone d’en-tête de navigation SharePoint à vos pages de complément, y compris les pages hébergées de façon externe.This control enables you to add the SharePoint navigation header area to your add-in pages, including pages hosted externally. Pour plus d’informations sur la conception de l’expérience utilisateur dans les compléments SharePoint, consultez la section Conception de l’expérience utilisateur pour les compléments dans SharePoint. Pour plus d’informations sur le contrôle de chrome, consultez la section Utiliser le contrôle de chrome client dans les compléments SharePoint.For more information about UX design in SharePoint Add-ins, see UX design for SharePoint Add-ins. For more information about the chrome control, see Use the client chrome control in SharePoint Add-ins.

Structure d’un package de complémentAdd-in package structure

Un package de complément SharePoint est un fichier doté d’une extension « .app » et qui est conforme aux conventions Open Packaging Conventions (OPC).A SharePoint Add-in package is a file that has an ".app" extension and that complies with the Open Packaging Conventions (OPC). (Vous pouvez ouvrir le fichier en ajoutant « .zip » en tant qu’extension supplémentaire du nom de fichier, puis l’ouvrir dans Windows Explorer.) Il contient un manifeste de complément spécifiant certaines propriétés du complément et des instructions pour l’infrastructure d’installation SharePoint.(You can open the file by adding ".zip" as an extra extension on the filename and then opening it in Windows Explorer.) It contains an add-in manifest that specifies certain properties of the add-in and instructions to the SharePoint installation infrastructure. Pour plus d’informations sur le manifeste et le package de complément, reportez-vous à la rubrique Explorer la structure du manifeste de l’application et le package d’un complément SharePoint.For more information about the add-in manifest and package, see Explore the app manifest structure and the package of a SharePoint Add-in.

Autorisations, authentification et autorisation de compléments SharePointPermissions, authentication, and authorization for SharePoint add-ins

SharePoint présente un nouveau système d’autorisation et de sécurité pour les compléments.SharePoint introduces a new add-in permissions and security system.

Autorisations pour les complémentsAdd-in permissions

Les Compléments SharePoint disposent d'autorisations, tout comme les utilisateurs et les groupes. Un complément peut posséder un ensemble d'autorisations différentes de celles dont dispose l'utilisateur qui exécute le complément.SharePoint Add-ins have permissions just as users and groups do. This enables an add-in to have a set of permissions that are different from the permissions of the user who is executing the add-in.

Dans le fichier manifeste du complément, vous devez demander les autorisations qu'un complément doit exécuter. L'utilisateur qui ajoute le complément doit accorder ces requêtes et l'utilisateur ne peut accorder que les autorisations dont il dispose en tant qu'utilisateur. Afin de simplifier la gestion des autorisations pour les utilisateurs et les développeurs, toutes les autorisations demandées doivent être accordées, ou aucune. Le principal de complément dispose toujours du contrôle total sur le site web de complément, ainsi il doit seulement demander des autorisations aux ressources SharePoint dans le site web hôte ou d'autres emplacements hors du site web de complément.You must request, in the add-in manifest file, the permissions that an add-in needs to run. The user who adds the add-in must grant these requests, and the user can only grant permissions that he or she has as a user. The grant must be for all the requested permissions or none of them to simplify the management of permissions for users and developers. (The add-in principal always has full control rights to the add-in web, so it only needs to request permissions to SharePoint resources in the host web or other locations outside the add-in web.)

Pour plus d’informations sur les autorisations de complément, voir Autorisations de compléments dans SharePoint.For more information about add-in permissions, see Add-in permissions in SharePoint.

Autorisation et délégation sélectiveSelective delegation and authorization

Les utilisateurs lançant un complément et les propriétaires de ressources accordant une autorisation de complément pour accéder à une ressource ne doivent pas fournir leurs informations d’identification ou un mot de passe au complément.Neither users who are launching an add-in, nor resource owners who are granting an add-in permission to access a resource, need to provide the add-in their credentials or password. En revanche, SharePoint permet aux utilisateurs et aux propriétaires de ressources de n’accorder que les autorisations spécifiques demandées par le complément.Instead, SharePoint enables users and resource owners to grant only the specific permissions that the add-in requests. Cela est rendu possible par l’utilisation par SharePoint du protocole de transaction OAuth 2.0.What makes this possible is the use by SharePoint of the transaction protocol OAuth 2.0. Pour plus d’informations sur OAuth dans SharePoint, consultez la section Flux OAuth de jeton de contexte pour les compléments SharePoint.For more information about OAuth in SharePoint, see Context Token OAuth flow for SharePoint Add-ins.

Accès inter-domainesCross-domain access

Un complément SharePoint incluant une application web distante qui utilise JavaScript pour sa logique d’accès aux données peut utiliser une bibliothèque inter-domaines JavaScript pour obtenir l’accès aux données SharePoint dans la location d’installation du complément.A SharePoint Add-in that includes a remote web application that uses JavaScript for its data access logic can use a JavaScript cross domain library to get authorized access to SharePoint data within the tenancy where the add-in is installed. Pour plus d’informations, voir Accéder à des données SharePoint à partir de compléments à l’aide de la bibliothèque inter-domaines.For more information, see Access SharePoint data from add-ins using the cross-domain library.

Cycle de vie de complémentAdd-in lifecycle

Le cycle de vie d’un complément SharePoint inclut la publication, l’installation, la mise à niveau et la désinstallation.The lifecycle for a SharePoint Add-in includes publishing, installing, upgrading, and uninstalling. Pour plus d’informations sur ces sujets, reportez-vous aux sections Publier des compléments SharePoint, Déploiement et installation de compléments SharePoint : méthodes et options et Processus de mise à jour des compléments SharePoint.For more information about these subjects, see Publish SharePoint Add-ins, Deploying and installing SharePoint Add-ins: methods and options and SharePoint Add-ins update process.

Veuillez noter qu’il existe un mécanisme permettant aux administrateurs locataires d’installer par lot un complément SharePoint sur plusieurs sites web.Note also that there is a mechanism by which tenant administrators can batch install a SharePoint Add-in to multiple websites. Pour plus d’informations, consultez la section Locations et étendues de déploiement des compléments SharePoint.For more information, see Tenancies and deployment scopes for SharePoint Add-ins.

Options de stockage de données dans les compléments SharePointData storage in SharePoint Add-ins

Les Compléments SharePoint peuvent créer tout type de données et y accéder, y compris les données structurées, les documents et les fichiers multimédias. Ces données peuvent être stockées dans SharePoint ou à un emplacement externe.SharePoint Add-ins can create and access any kind of data, including structured data, documents, and multimedia files. This data can be stored in SharePoint or in an external location.

Options de stockage des données structuréesStructured data storage options

Un complément SharePoint peut utiliser presque tout type de stockage de données structurées, à l’intérieur ou à l’extérieur de SharePoint, ainsi que sur les plateformes Microsoft et non-Microsoft.A SharePoint Add-in can use almost any kind of structured data storage, both inside and out of SharePoint and on Microsoft and non-Microsoft platforms. Voici quelques emplacements dans lesquels vous pouvez stocker des données structurées pour un complément SharePoint :The following are some locations where you can store structured data for a SharePoint Add-in:

  • Listes SharePoint dans un site web de complémentSharePoint lists in an add-in web
  • SQL AzureSQL Azure
  • Sources de données externes connectées à SharePoint avec Microsoft Business Connectivity Services (BCS)External data sources connected to SharePoint with Microsoft Business Connectivity Services (BCS)
  • Service de nuage non MicrosoftA non-Microsoft cloud service
  • Une base de données sur votre propre serveurA database on your own server

Conseil

Vous devrez probablement mettre à niveau votre complément SharePoint à un moment donné.You will probably upgrade your SharePoint Add-in at some point. Lorsqu’un complément SharePoint inclut des composants SharePoint sur un site web de complément, le processus de mise à niveau procède à une copie complète du site web de complément.When a SharePoint Add-in includes SharePoint components on an add-in web, the upgrade process makes a complete copy of the add-in web. Pour cette raison, la présence de longues listes SharePoint sur le site web de complément allonge le processus de mise à niveau et entraîne une utilisation intensive du processeur sur le serveur de base de données de contenu. For this reason, very large SharePoint lists on the add-in web make the upgrade process time-consuming and processor intensive on the content database server. Vous devez éviter de placer des « données volumineuses » dans les listes SharePoint sur le site web de complément.You should avoid putting "big data" in SharePoint lists on the add-in web.

Options de stockage de données non structuréesUnstructured data storage options

Les documents, images, vidéos, fichiers audio et autres types de données non structurées qui sont produits ou utilisés par un Complément SharePoint peuvent être stockés à l'intérieur ou à l'extérieur de SharePoint. Les bibliothèques de documents sont un bon choix pour des documents et sont consultables par le biais d'une recherche SharePoint. Une bibliothèque d'éléments de site est souvent un choix approprié pour les fichiers multimédias.Documents, images, videos, audio files, and other kinds of unstructured data that is produced or used by a SharePoint Add-in can be stored in or outside SharePoint. Document libraries are a good choice for documents and are searchable via SharePoint search. A site asset library is often a good choice for multimedia files.

Les autres options incluent le stockage de données blob sur votre compte Microsoft Azure ou sur vos propres serveurs. Vous pouvez également stocker des fichiers sur certaines plateformes non Microsoft ou sur certains services basés sur le nuage.Other options include Blob storage in your Microsoft Azure account or on your own servers. You can also store files in some non-Microsoft platforms or cloud services.

Paramètres des compléments et autres options de stockage de métadonnéesAdd-in settings and other metadata storage options

Les métadonnées pour un complément SharePoint, telles que les préférences des utilisateurs, les informations d’emplacement et d’autres paramètres, peuvent être stockées à plusieurs endroits. Metadata for a SharePoint Add-in, such as user preferences, location information, and other settings can be stored in several places. Une liste SharePoint masquée peut parfois être une bonne solution.A hidden SharePoint list is sometimes a good choice. Vous pouvez également utiliser le conteneur de propriétés du site web du complément.You can also use the property bag of the add-in web. Une autre possibilité, pour un complément hébergé par un fournisseur, consiste à utiliser le stockage de table Microsoft Azure.Another option, for a provider-hosted add-in, is to use Azure Table storage.

Options d’accès sécurisé aux donnéesSecure data access options

Vos options en matière d’accès aux données sécurisées dépendent bien entendu de vos possibilités de stockage. L’accès aux données et la façon de les consulter sont décrits en détails dans plusieurs autres articles. Pour plus d’informations, voir Secure data access and client object models for SharePoint Add-ins.Your options for secure data access, of course, depend on your choice of storage. Data access and search are discussed in detail in several other articles. For more information, see Secure data access and client object models for SharePoint Add-ins.

Gestion des complémentsManaging add-ins

Les administrateurs de collection de sites et les administrateurs locataires peuvent surveiller les compléments et modifier les ressources qui leur sont attribuées. De plus, le personnel Microsoft du magasin de compléments peut signaler les compléments et les désactiver.Site collection administrators and tenant administrators can monitor add-ins and change the resources allocated to them. In addition, Microsoft personnel for the add-in store can flag add-ins and disable them.

Pour plus d’informations sur la gestion des compléments, consultez la section Installer et gérer les compléments SharePoint sur TechNet.For more information about managing add-ins, see Install and manage SharePoint Add-ins on TechNet.

Surveillance des complémentsMonitoring add-ins

SharePoint propose la surveillance de l’intégrité des compléments et publie ces informations sur l’interface utilisateur à destination des propriétaires de sites web, des administrateurs clients et des administrateurs de batterie.SharePoint provides health monitoring of add-ins and makes this information available in the UI to website owners, tenant administrators, and farm administrators. La plupart de la documentation du système de surveillance se trouve sur TechNet. Par exemple Surveiller les compléments SharePoint. Cette section ne représente qu’une brève introduction afin d’expliquer comment les compléments que vous vendez sont surveillés.Most documentation for the monitoring system is on TechNet; for example Monitor SharePoint Add-ins. This section is just a quick introduction to explain how add-ins that you sell are monitored.

Certains types de données sont signalés par application et d'autres, par instance d'application. Les éléments principaux signalés par la structure de surveillance sont les suivants :Some kinds of data are reported per-app and other kinds are reported per-app-instance. The primary items that the monitoring framework reports are as follows:

  • Utilisation du complément, par exemple, le nombre d'installations (création d'une nouvelle instance).Use of the add-in, such as the number of times it has been installed (creating a new instance).
  • Consommation des ressources du serveur de chaque instance de complément.Server resource consumption of each add-in instance.
  • Installation, mise à niveau et erreurs d'exécution de chaque instance de complément.Installation, upgrade, and run-time errors of each add-in instance.
  • Un indicateur d’intégrité global pour chaque instance de complément de couleur verte, jaune et rouge.An overall health indicator for each add-in instance of green, yellow, and red.

Si le complément comprend des composants Site web Azure, la structure de surveillance interroge également Microsoft Azure toutes les heures pour obtenir des données d’erreurs et signale les erreurs critiques et les données de quotas de stockage dans l’interface utilisateur SharePoint.If the add-in includes Azure website components, the monitoring framework also polls Azure hourly for its error data and reports critical errors and storage quota data in the SharePoint UI. Les erreurs Base de données SQL Microsoft Azure ne sont pas signalées.Azure SQL Database errors are not reported.

Les informations fournies par la structure de surveillance permettent aux administrateurs de déterminer si leur budget d'achat de compléments est dépensé de manière judicieuse, s'ils doivent déployer davantage de ressources sur les compléments et s'ils doivent désactiver un complément qui ne fonctionne pas correctement.The information that is provided by the monitoring framework enables administrators to determine whether their add-in purchase budget is being wisely spent, whether they have to deploy more resources to add-ins, and whether they have to disable an add-in that is not working correctly.

Enregistrement des dépendances de complémentsRegistering add-in dependencies

Si votre Complément SharePoint dépend d'une fonctionnalité SharePoint qui n'est pas disponible et ne peut être mise à disposition sur le site web de complément, il ne fonctionnera pas bien et vos clients s'en plaindront. Vous pouvez veiller à ce que votre complément ne soit pas installé lorsque les services et fonctionnalités requis ne sont pas disponibles en inscrivant les dépendances du complément dans le manifeste du complément. L'infrastructure d'installation des Compléments SharePoint vérifiera cette condition préalable et bloquera l'installation de votre complément si aucun d'eux n'est disponible.If your SharePoint Add-in depends on a SharePoint capability that is not available and cannot be made available on the add-in web, then it will not work properly and your customers will complain. You can ensure that your add-in is not installed where the requisite services and Features are not available by registering the dependencies of the add-in in add-in manifest. The installation infrastructure for SharePoint Add-ins will check for these prerequisites and it will block installation of you add-in if any of them is not available.

Pour des services (par exemple, Excel, Access ou Visio Services), l’infrastructure vérifiera que le service est installé et fonctionne sous licence.For services, such as Excel, Access, or Visio services, the infrastructure will verify that the service is installed and licensed.

Pour les fonctionnalités, par exemple une liste des tâches, l’infrastructure vérifie que la fonctionnalité est déployée et :For Features, such as a Task list, the infrastructure verifies that the Feature is deployed and either:

  • activée dans l’étendue Farm, WebApplication ou Site (collection de sites)activated at the Farm, WebApplication, or Site (site collection) scope

ouor

  • activable avec l’étendue Web dans le site web de complément qui est créé au moment de l’installation du complément.activatable, with Web scope, on the add-in web that is created when the add-in is installed.

Notes

L’infrastructure d’installation du complément activera automatiquement ces fonctionnalités dans le site web de complément dès sa création.The add-in installation infrastructure will automatically activate such Features on the add-in web when it is created.

Les sections suivantes fournissent les détails dont vous avez besoin pour enregistrer vos prérequis.The following sections provide the details you need to register your prerequisites.

Inscrire implicitement les dépendances avec des demandes d’autorisationImplicitly register dependencies with permission requests

Lorsque votre complément a besoin d'accéder à des composants SharePoint en dehors du site web de complément, il doit demander l'autorisation d'accès à ces ressources dans la section AppPermissionRequests du manifeste du complément. Ces demandes d'autorisation font également office d'enregistrements préalables puisque SharePoint déduira à partir de ces autorisations que votre complément exige que certaines fonctionnalités SharePoint soient disponibles. Dans de nombreux cas, SharePoint peut déduire que toutes les fonctionnalités indispensables à votre complément, ainsi que les sections restantes de cette rubrique, ne sont pas nécessaires. Néanmoins, des enregistrements de dépendances redondants ne sont pas inutiles.When your add-in needs access to SharePoint components outside of the add-in web, it must request permission for these resources in the AppPermissionRequests section of the add-in manifest. These permission requests also serve as prerequisite registrations because SharePoint will infer from the permissions that your add-in requests that it the add-in needs certain SharePoint capabilities to be available. In many situations, SharePoint can infer all the capabilities that your add-in needs and the remaining sections of this topic are not needed. However, redundant dependency registrations are not harmful.

Inscrire explicitement les dépendances avec AppPrerequisitesExplicitly register dependencies with AppPrerequisites

Lorsque votre complément affiche une dépendance qui n’est pas implicitement définie par ses demandes d’autorisation, vous devez enregistrer chaque dépendance avec un élément AppPrerequisite dans le manifeste de complément.When your add-in has a dependency that is not implied by its permission requests, you register each dependency with an AppPrerequisite element in the add-in manifest. Il y a trois attributs dans cet élément ; Type, ID et MinimumVersion. (facultatif).There are three attributes in this element: Type, ID, and (optionally) MinimumVersion.

Il existe trois valeurs potentiellement requises pour l’attribut Type : Feature, Capablility et AutoProvisioning. There are three possible prerequisite values for Type: Feature, Capablility, and AutoProvisioning. Une valeur « Feature » requise est simplement une fonctionnalité SharePoint que vous devez déployer et activer sur le site web de complément ou une étendue plus large qui inclut le site web de complément.A Feature prerequisite is simply a SharePoint Feature that must be deployed and activated on the add-in web or a broader scope that includes the add-in web. Une valeur « Capability » (capacité) est un ensemble de fonctionnalités et de services qui doivent être disponibles sur le site web de complément.A capability is a set of related Features and services that must be available on the add-in web. (La valeur AutoProvisioning est abordée dans la section suivante.)(AutoProvisioning is discussed in the next section.)

L'attribut facultatif MinimumVersion spécifie la version la plus faible de la fonctionnalité ou de la capacité qu'exige votre complément. Les valeurs des attributs adoptent la forme n.n.n.n (par exemple, 15.0.0.0).The optional MinimumVersion specifies the lowest version of the Feature or capability that your add-in requires. The attribute values are of the form n.n.n.n; for example 15.0.0.0.

L’attribut ID précise quelle fonctionnalité ou capacité est requise.The ID specifies which Feature or capability is required. Si l’attribut Type a la valeur Feature, l’attribut ID correspond au GUID entre crochets et séparé par des tirets de la fonctionnalité (par exemple, {151D22D9-95A8-4904-A0A3-22E4DB85D1E0}). If Type is Feature, the ID is the bracketed, hyphenated GUID of the Feature; for example {151D22D9-95A8-4904-A0A3-22E4DB85D1E0}. Si l’attribut Type a la valeur Capability, l’attribut ID désigne le GUID de la capacité.If Type is Capability, the ID is the GUID of the capability. Les capacités sont répertoriées ci-dessous.The capabilities are listed below. Pour retrouver le GUID d’une capacité, reportez-vous à l’élément AppPrerequisite (AppPrerequisiteCollection complexType) (manifeste de complément SharePoint).To get the find the GUID of a capability, see AppPrerequisite element (AppPrerequisiteCollection complexType) (SharePoint Add-in Manifest).

  • Access Services 2010Access Services 2010
  • Services d'accèsAccess Services
  • Service web de métadonnées géréesManaged Metadata Web Service
  • Services PowerPointPowerPoint Services
  • Services Banque d'informations sécurisésSecure Store Services
  • Service de traduction automatiqueMachine Translation Service
  • Service de profil utilisateurUser Profile Service
  • Service Graphiques VisioVisio Graphics Service
  • Service Gestion du travailWork Management Service
  • DuetDuet
  • Flux de travailWorkflow
  • RechercheSearch
  • EDUEDU

Voici un exemple de balisage brut AppPrerequisites qui enregistre la capacité Flux de travail. Si vous utilisez Visual Studio, vous devez modifier le manifeste du complément dans un outil de conception.The following is an example of raw AppPrerequisites markup that registers the Workflow capability. If you are using Visual Studio, you edit the add-in manifest in a designer tool.

<AppPrerequisites>
  <AppPrerequisite Type="Capability" ID="{CDD8F991-B459-4512-8048-03D5A03FF27E}" MinimumVersion="15.0.0.0" />
</ AppPrerequisites>

Dans cette sectionIn this section

Voir aussiSee also