Déployer et installer un complément SharePoint hébergé sur SharePointDeploy and install a SharePoint-hosted SharePoint Add-in

Cet article est le deuxième d’une série d’articles sur les notions de base du développement de compléments SharePoint hébergés par SharePoint. Vous devez d’abord avoir pris connaissance de la rubrique Compléments SharePoint et de l’article de vue d’ensemble de cette série :This is the second in a series of articles about the basics of developing SharePoint-hosted SharePoint Add-ins. You should first be familiar with the topic SharePoint Add-ins and the overview article in this series:

Note

Si vous avez consulté les articles sur les compléments hébergés par SharePoint, votre solution Visual Studio vous sera utile pour continuer à parcourir cette rubrique.If you have been working through this series about SharePoint-hosted add-ins, you have a Visual Studio solution that you can use to continue with this topic. Vous pouvez également télécharger le référentiel sur SharePoint_SP-hosted_Add-Ins_Tutorials et ouvrir le fichier BeforeColumns.sln.You can also download the repository at SharePoint_SP-hosted_Add-Ins_Tutorials and open the BeforeColumns.sln file.

Il sera beaucoup plus facile pour vous de développer des Compléments SharePoint hébergés par SharePoint si vous savez comment les utilisateurs déploient et installent vos compléments. En conséquence, dans cet article, nous allons brièvement nous éloigner du codage pour créer et utiliser un catalogue de compléments, puis installer le complément sur lequel vous avez travaillé.You'll find it a lot easier to develop SharePoint-hosted SharePoint Add-ins if you are familiar with how users deploy and install your add-ins. So, in this article, we'll take a brief break from coding to create and use an add-in catalog, and then install the add-in you've been working on.

Création d’un catalogue de complémentsCreate an add-in catalog

  1. Connectez-vous à votre abonnement Office 365 en tant qu’administrateur.Sign in to your Office 365 subscription as an administrator. Sélectionnez l’icône du lanceur de compléments, puis le complément Administrateur.Select the add-in launcher icon, and then select the Admin add-in.

    Figure 1. Lanceur de compléments Office 365Figure 1. Office 365 add-in launcher

    Lanceur d’applications Office 365

  2. Dans le Centre d’administration, développez le nœud Centres d’administration dans le volet Office, puis sélectionnezSharePoint.In the Admin Center, expand the Admin node in the task pane, and then select SharePoint.

  3. Dans le Centre d’administration SharePoint, sélectionnez applications dans le volet Office.In the SharePoint Admin Center, select add-ins in the task pane.

  4. Sur la page applications, sélectionnez Catalogue d'applications.On the apps page, select App Catalog. (Si une collection de sites de catalogue de compléments existe déjà dans l’abonnement, elle s’ouvre et vous avez terminé.(If there is already an add-in catalog site collection in the subscription, it opens and you are finished. Vous ne pouvez pas créer plusieurs catalogues de compléments dans un abonnement.)You cannot create more than one add-in catalog in a subscription.)

  5. Sur la page Site de catalogue d’applications, cliquez sur OK pour accepter l’option par défaut et créer un site de catalogue d’applications.On the App Catalog Site page, choose OK to accept the default option and create a new app catalog site.

  6. Dans la boîte de dialogue Créer une collection de sites de catalogue d'applications, indiquez le titre et l’adresse web de votre site de catalogue d'applications.In the Create Add-in Catalog Site Collection dialog, specify the title and website address of your add-in catalog site. Nous vous recommandons d’inclure « catalogue » dans le titre et l’URL pour qu’ils soient faciles à mémoriser et à distinguer dans le Centre d’administration SharePoint.We recommend that you include "catalog" in the title and URL to make it memorable and distinguishable in the SharePoint Admin Center.

  7. Spécifiez un fuseau horaire et définissez-vous en tant qu’administrateur.Specify a Time Zone and set yourself as the Administrator.

  8. Définissez le quota de stockage à la valeur la plus faible possible (actuellement 110, mais cette valeur peut changer), car les packages que vous téléchargez dans cette collection de sites sont de très petite taille.Set the Storage Quota to the lowest possible value (currently 110, but that can change), because the add-in packages you upload to this site collection are very small.

  9. Définissez le quota de ressources du serveur à 0 (zéro), puis sélectionnez OK.Set the Server Resource Quota to 0 (zero), and then select OK. (Le quota de ressources du serveur est lié à la limitation des solutions bac à sable (sandbox) dont les performances sont médiocres, mais vous n’installerez aucune solution bac à sable (sandbox) sur votre site de catalogue de compléments.)(The server resource quota is related to throttling poorly performing sandboxed solutions, but you won't be installing any sandboxed solutions on your add-in catalog site.)

Pendant la création de la collection de sites, SharePoint vous redirige vers le Centre d’administration SharePoint.As the site collection is being created, SharePoint takes you back to the SharePoint Admin Center. Quelques minutes plus tard, la collection de sites est créée.After a few minutes, you'll see that the collection has been created.

Création du package du complément et téléchargement dans le cataloguePackage the add-in and upload it to the catalog

  1. Ouvrez la solution Visual Studio, puis cliquez avec le bouton droit de la souris sur le nœud du projet dans l’Explorateur de solutions, puis sélectionnez Publier.Open the Visual Studio solution, right-click the project node in Solution Explorer, and then select Publish.

  2. Dans le volet Publier, sélectionnez Empaqueter le complément.In the Publish pane, select Package the add-in. Le complément est empaqueté et enregistré sous un fichier *.app dans le dossier \bin\debug\web.publish\1.0.0.0 de la solution.The add-in is packaged and saved as an *.app file in the solution's \bin\debug\web.publish\1.0.0.0 folder.

  3. Ouvrez le site de votre catalogue de compléments dans un navigateur et sélectionnez Compléments SharePoint dans la barre de navigation.Open your add-in catalog site in a browser, and then select SharePoint Add-ins in the navigation bar.

  4. Le catalogue Compléments SharePoint est une bibliothèque de composants SharePoint standard.The SharePoint Add-ins catalog is a standard SharePoint asset library. Chargez-y le package du complément à l’aide de l’une des méthodes de chargement de fichiers vers les bibliothèques SharePoint.Upload the add-in package to it using any of the methods of uploading files to SharePoint libraries.

Installation du complément de la même manière que les utilisateurs finauxInstall the add-in as end users do

  1. Accédez à n’importe quel site web dans l’abonnement SharePoint Online et ouvrez la page Contenu du site.Navigate to any website in the SharePoint Online subscription and open the Site Contents page.

  2. Sélectionnez Ajouter un complément pour ouvrir la page Vos compléments.Select add an add-in to open the Your Add-ins page.

  3. Recherchez le complément Orientation de l’employé dans la section Compléments que vous pouvez ajouter et sélectionnez sa vignette.Find the Employee Orientation add-in in the Add-ins you can add section, and select its tile.

  4. Sélectionnez Approuver dans la boîte de dialogue de consentement.Select Trust It in the consent dialog. La page Contenu du site s’ouvre automatiquement et le complément s’affiche avec un message indiquant que l’installation est en cours.The Site Contents page automatically opens and the add-in appears with a notation that it is installing. Une fois l’installation terminée, les utilisateurs peuvent sélectionner la vignette pour l’exécuter.After it installs, users can select the tile to run the add-in.

Suppressio du complémentRemove the add-in

Pour continuer à améliorer le même complément SharePoint dans Visual Studio (reportez-vous à la section Étapes suivantes), supprimez le complément en suivant ces étapes :To continue enhancing the same SharePoint Add-in in Visual Studio (see Next steps), remove the add-in with these steps:

  1. Sur la page Contenu du site, placez le curseur sur le complément pour que le bouton de légende ... s’affiche.In the Site Contents page, move the cursor over the add-in so that the callout button ... appears.

  2. Sélectionnez le bouton de légende, puis SUPPRIMER dans la légende.Select the callout button, and then select REMOVE on the callout.

  3. Revenez vers votre site de catalogue de compléments et sélectionnez Compléments SharePoint dans la barre de navigation.Navigate back to your add-in catalog site and select SharePoint Add-ins in the navigation bar.

  4. Mettez en surbrillance le complément et sélectionnez Gérer dans la barre des tâches, juste au-dessus de la liste, puis sélectionnez Supprimer dans le menu de gestion.Highlight the add-in and select manage on the task bar just above the list, and then select Delete on the manage menu.

Étapes suivantesNext steps

Nous vous recommandons vivement de continuer à parcourir cette série d’articles sur les compléments hébergés par SharePoint avant de consulter les rubriques plus pointues.We strongly recommend that you continue with this series about SharePoint-hosted add-ins before you go on to the more advanced topics. Nous allons ensuite reprendre l’utilisation du code dans la rubrique Ajout de colonnes personnalisées à un complément SharePoint hébergé sur SharePoint.Next, we get back to coding in Add custom columns to a SharePoint-hosted SharePoint Add-in.