Publier des compléments SharePoint à l’aide de Visual Studio

Découvrez comment publier votre Complément SharePoint à l'aide de Microsoft Visual Studio 2013 ou de Visual Studio 2012. Si le complément est associé à une application web, déployez-la d'abord.

Ensuite, comme pour tous les Compléments SharePoint, créez un package pour le Complément SharePoint, puis publiez-le. Vous pouvez également choisir d'envoyer votre complément en vue de son ajout dans l'Office Store.

Configuration requise

• Microsoft Visual Studio 2013 ou Visual Studio 2012 et outils de développement Office pour Visual Studio. Pour télécharger les outils, reportez-vous à la section « Outils » de la page de téléchargement. (Le nouveau Gestionnaire de publication n'est pas disponible dans Visual Studio 2012 ou versions antérieures.)
• Microsoft SharePoint

Publier à l’aide de Visual Studio 2013

Si votre Complément SharePoint hébergé par le fournisseur comporte une application Web, déployez d'abord les fichiers associés à cette dernière. Ensuite, comme pour tous les Compléments SharePoint, créez un package pour le Complément SharePoint et publiez-le.

Importante

Pour vous assurer que vos valeurs d’ID client sharePoint et de clé secrète client sont publiées avec votre projet web, ce qui permet à votre contenu web d’accéder aux données SharePoint, publiez votre projet de complément SharePoint à partir de la page Publier votre complément . Vous pouvez accéder à cette page en ouvrant le menu contextuel du Complément SharePoint, et non celui de l'application web, puis en sélectionnant la commande Publier.

Étape 1 : Déploiement de l’application web

Votre Complément SharePoint est généralement associé à une application web hôte que vous devez déployer sur un serveur web. Pour plus d’informations sur l’utilisation de l’Assistant Publication web, consultez Guide pratique pour déployer un projet web à l’aide de la publication en un clic dans Visual Studio.

Pour ouvrir la page Publier votre complément

• Dans l' Explorateur de solutions, ouvrez le menu contextuel du projet de Complément SharePoint, puis sélectionnez Publier.
• La page Publier votre complément s'ouvre.

Pour sélectionner ou créer un profil

Dans la liste Profil actuel , choisissez un profil à importer, ou choisissez <Nouveau ...> pour créer un profil.

Un profil de publication spécifie le serveur sur lequel vous déployez l'application web, les informations d'identification requises pour la connexion au serveur, les bases de données à déployer (le cas échéant), ainsi que d'autres options de déploiement. Vous pouvez créer différents profils de publication pour répondre à vos besoins. Par exemple, vous pouvez créer un profil à des fins de test et un autre pour la publication.

Si vous choisissez <Nouveau ...>, l’Assistant Création d’un profil de publication s’affiche. Celui-ci permet d'importer un profil de publication à partir d'un fournisseur hébergeur de sites web, tel que Azure, ou de créer un profil, puis d'ajouter manuellement le nom du serveur, les informations d'identification et les autres paramètres. Si vous avez créé un profil au lieu d'importer un profil existant, vous devrez fournir l'ID client et la clé secrète client, conformément à ce qui est indiqué dans les pages inscrire des compléments SharePoint et Création ou mise à jour d'ID et de clés secrètes client dans le service Mon tableau de bord vendeur.

Si vous prévoyez de soumettre votre Complément SharePoint à l'Office Store, veillez à utiliser l'ID et la clé secrète clients créés dans Mon tableau de bord vendeur. Vous pouvez utiliser les ID client et les valeurs de clé secrète client que vous générez à l’aide de la page appregnew.aspx pendant la phase de développement, mais les compléments que vous envoyez à l’Office Store doivent utiliser les ID client et les secrets client que vous obtenez à partir du mon tableau de bord vendeur. Vous devez également créer le profil de publication sur votre site Azure, puis l'importer dans Visual Studio au lieu de créer un profil dans l'Assistant Créer un profil de publication. Lorsque vous créez un profil dans Azure, tous les paramètres de l'onglet Connexion sont déjà définis dans Visual Studio. Pour plus d'informations sur l'importation ou la création d'un profil de publication, voir Création d'un profil de publication.

Conseil

Si vous ne pouvez pas publier de contenu Web directement, vous pouvez créer un package Web Deploy pouvant être déployé pour vous par un administrateur. Pour créer un package Web Deploy, créez un profil, sélectionnez l’onglet Connexion, puis cliquez sur Package Web Deploy dans la liste Méthode de publication.

Pour déployer votre projet d’application web

1. Sur la page Publier votre complément, cliquez sur le bouton Déployer votre projet web. La boîte de dialogue Publier le site web s'affiche.

2. Dans les onglets Connexion et Paramètres, indiquez les valeurs manquantes.

   Pour modifier la méthode utilisée pour publier les fichiers de votre Complément SharePoint ou si le complément utilise une base de données externe, sélectionnez l'onglet Paramètres. Consultez la section concernant la configuration de l'onglet Paramètres sur la page relative au déploiement d'un projet web à l'aide de la publication en un clic dans Visual Studio.

3. Pour vérifier les éléments qui seront modifiés lors du déploiement de l'application Web, sélectionnez Démarrer l'aperçu sous l'onglet Aperçu.

4. Sélectionnez Publier pour déployer le projet d’application Web.

Étape 2 : Création du package du complément

1. Sur la page Publier votre complément, cliquez sur le bouton Créer le package de complément. L'Assistant Publication de compléments Office et SharePoint s'affiche.

2. Dans la zone de texte Où votre site web est-il hébergé ?, entrez l'URL du site Web qui hébergera les fichiers de contenu de votre Complément SharePoint.

   Vous devez spécifier une adresse commençant par le préfixe « https ». Consultez Pourquoi mes compléments doivent-ils être sécurisés par SSL ?.

   Remarque

   Les sites web Azure fournissent automatiquement un point de terminaison HTTPS. Si vous publiez votre complément sur un site Office Store ou sur l’Office Store, l’adresse doit commencer par un préfixe https. Cependant, si vous publiez le complément sur un site local, vous pouvez utiliser un préfixe HTTP.

   L'ID client que vous avez entré dans le profil de publication devrait déjà apparaître dans la zone de texte Quel est l'ID client du complément ?.

   Si vous avez utilisé une valeur d'espace réservé pour l'ID client jusqu'à présent, vous devez maintenant ajouter un ID client réel. Cette information est incorporée dans le package de l'application et permet à votre contenu Web de communiquer avec SharePoint sur le site actif.

3. Cliquez sur le bouton Terminer.

   Visual Studio génère les fichiers nécessaires pour publier votre Complément SharePoint, puis ouvre le dossier de sortie de publication. Pour plus d’informations sur l’installation du complément, voir Installer et gérer les compléments SharePoint 2013.

Étape 3 : Publier votre Complément SharePoint sur l’Office Store

Pour envoyer votre Complément SharePoint à l'Office Store, suivez la procédure décrite ci-après.

1. Sur la page Publier votre complément, sélectionnez Visiter Mon tableau de bord vendeur, puis connectez-vous à votre compte Mon tableau de bord vendeur Microsoft.

   Consultez Utiliser le tableau de bord vendeur pour soumettre votre solution à AppSource.

2. Choisissez Ajouter une nouvelle application, renseignez les informations requises, puis soumettez le complément à l'Office Store. Pour plus d’informations, consultez Utiliser le tableau de bord vendeur pour soumettre votre solution à AppSource.

Publier à l’aide de Visual Studio 2012

Lorsque vous êtes prêt à créer un package de votre Complément SharePoint, ouvrez l'Assistant Publier des compléments Office, qui prépare les fichiers de votre Complément SharePoint en vue de sa publication.

Étape 1 : Créer un package de Complément SharePoint

1. Dans l' Explorateur de solutions, ouvrez le menu contextuel du projet de Complément SharePoint, puis sélectionnez Publier.

   L'Assistant Publier des compléments Office s'ouvre. Le type de Complément SharePoint pour lequel vous créez un package détermine les pages qui s'affichent dans l'Assistant. Si votre complément est hébergé par SharePoint, seule la page Résumé s'affiche. Si votre complément est hébergé par un fournisseur, les pages Profil et Hébergement s'ouvrent également.

2. Si votre Complément SharePoint est hébergé par un fournisseur, indiquez un nom de profil de publication dans la liste Quel profil souhaitez-vous publier ?, puis sélectionnez le bouton Suivant.

   Le profil de publication enregistre les informations que vous avez entrées sur la page Hébergement.

3. Dans la liste Où est hebergé votre site Web ?, indiquez l'URL de l'application web qui hébergera votre Complément SharePoint.

4. Dans les zones sous Quelle est l'identité de votre complément ?, indiquez l'ID client et la clé secrète client de votre complément, puis sélectionnez le bouton Suivant.

   Voir Autorisation et authentification des compléments SharePoint.

5. Pour tous les types de Compléments SharePoint, sélectionnez la case Ouvrir le dossier de sortie après l'empaquetage si cela n'est pas déjà fait, puis sélectionnez le bouton Terminer.

   Visual Studio génère tous les fichiers dont vous avez besoin pour publier votre Complément SharePoint. Vous trouverez ces fichiers dans le app.Publish dossier de votre dossier de sortie de projet (par exemple, %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publish). Ce dossier contient un fichier .app pour votre Complément SharePoint et plusieurs fichiers pour l'application web (si votre Complément SharePoint est basé sur le cloud). Tous les Compléments SharePoint comprennent un fichier .app, qui est le manifeste du complément destiné à publier le Complément SharePoint. Les Compléments SharePoint hébergés par un fournisseur comprennent également des fichiers pour la publication de l'application du site web hôte.

Étape 2 : Publication de l’application web

Si votre Complément SharePoint est hébergé par un fournisseur, il est généralement associé à une application web hôte que vous devez publier sur un serveur web. Visual Studio génère un package de déploiement et un script pour vous aider à effectuer cette tâche.

Le package de déploiement du projet d’application web est contenu dans un fichier compressé (.zip) dans le app.publish dossier . Outre le fichier .zip, le dossier app.publish contient les fichiers suivants :

Fichier	Description
NomProjet.deploy.cmd	Il s'agit d'un fichier de lignes de commande qui appelle Web Deploy pour vous permettre d'installer le package plus facilement à une invite de commande.
NomProjet.SetParameters.xml	Ce fichier contient les paramètres transférés à Web Deploy quand vous utilisez le fichier deploy.cmd afin d'installer le package. Les paramètres du package Visual Studio déterminent la valeur par défaut spécifiée pour chaque paramètre. Vous pouvez modifier ces valeurs si, par exemple, vous souhaitez installer l'application web sur plusieurs serveurs avec des paramètres différents pour chacun d'entre eux.
NomProjet.SourceManifest.xml	Ce fichier contient les paramètres que Visual Studio transfère à Web Deploy et que ce dernier utilise pour créer le package Web. Web Deploy n'a besoin de ce fichier que pour créer le package. Ce fichier n'est pas utilisé quand le package est installé.

Pour obtenir des instructions pas à pas, consultez Guide pratique pour installer un package de déploiement à l’aide du fichier deploy.cmd créé à l’aide de Visual Studio.

Étape 3 : Publier votre Complément SharePoint

Pour publier votre Complément SharePoint, téléchargez le fichier manifeste (.app) de votre complément sur l'Office Store, le catalogue de compléments Office, SharePoint, un partage de fichiers ou le catalogue Exchange. Le manifeste du complément se trouve dans le app.publish dossier , par %UserProfile%\Documents\Visual Studio 2012\Projects\MyApp\bin\Debug\app.publishexemple . Pour plus d’informations sur la publication de votre complément SharePoint, voir Autorisation et authentification des compléments SharePoint.

Voir aussi

• Publier vos compléments SharePoint
• Publier votre complément Office