Déploiement de solutions destinées au client pour les solutions SharePoint Framework

Vous pouvez configurer vos composants SharePoint Framework (SPFx) de façon à ce qu’ils soient immédiatement disponibles sur le client une fois le package de solution installé dans le catalogue d’applications client. Cela peut être configuré à l’aide de l’attribut skipFeatureDeployment dans le fichier ./config/package-solution.json.

Lorsque cet attribut est activé pour la solution, l’administrateur client a la possibilité d’activer la solution de sorte qu’elle soit automatiquement disponible dans toutes les collections de sites et tous les sites du client, lors de l’installation du package de solution dans le catalogue d’applications client.

Vous pouvez également afficher une démonstration de l'option de déploiement à l'échelle du client en regardant la vidéo suivante sur la chaîne YouTube de Microsoft 365 Platform Community (PnP) :

Configuration spécifique requise pour la solution

Lorsque cette option est utilisée, toutes les définitions d’infrastructure de fonctionnalités dans la solution SharePoint Framework sont ignorées. Si la solution contient des définitions d’infrastructure de fonctionnalités, par exemple, pour créer une liste personnalisée, vous ne devez pas utiliser cette option spécifique à la solution.

Pour plus d’informations, reportez-vous à l’article Mise en service des composants SharePoint avec votre package de solution.

Configurer la solution de façon à ce qu’elle soit disponible sur le client

Le modèle Yeoman SharePoint Framework vous pose une question spécifique relative à cette option. Cette question concerne directement l’attribut skipFeatureDeployment dans le fichier package solution.json.

Dans l’exemple de configuration suivant, l’attribut skipFeatureDeployment est défini sur true, ce qui indique que la solution peut être déployée de manière centralisée sur le client.

{
  "solution": {
    "name": "tenant-deploy-client-side-solution",
    "id": "dd4feca4-6f7e-47f1-a0e2-97de8890e3fa",
    "version": "1.0.0.0",
    "skipFeatureDeployment": true,
    "features": [
      {
        "title": "Application Extension - Deployment of custom action.",
        "description": "Deploys a custom action with ClientSideComponentId association",
        "id": "54f0dc0e-c190-439d-933b-2dd2809ed3c3",
        "version": "1.0.0.0",
        "assets": {
          "elementManifests": [
            "elements.xml",
            "ClientSideInstance.xml"
          ]
        }
      }
    ]
  },
  "paths": {
    "zippedPackage": "solution/tenant-deploy-true.sppkg"
  }
}

Approbation du déploiement à l’échelle du client dans le catalogue d’applications

Lorsque la solution avec l’attribut skipFeatureDeployment défini sur true est déployée sur le catalogue d’applications client, l’administrateur a la possibilité de configurer la solution de sorte qu’elle soit déployée de manière centralisée sur le client.

Par défaut, la case à cocher Rendre cette solution disponible pour tous les sites dans l’organisation n’est pas sélectionnée. Si l’administrateur sélectionne la case à cocher, les composants figurant dans les solutions sont automatiquement visibles et disponibles sur le client.

Comme les actions de mise à niveau spécifiques de la solution et du site ne sont disponibles que lorsque vous utilisez l’infrastructure de fonctionnalité, il n’existe aucune option de mise à niveau spécifique pour les solutions déployées de façon centralisée. Vous pouvez mettre à jour ces solutions en mettant à jour les composants spécifiques de la solution dans le CDN, puis en mettant à jour et déployant le package dans le catalogue d’applications. Cela met à jour automatiquement toutes les instances du composant existant sur le client afin d’utiliser les dernières ressources de composant, telles que les fichiers JavaScript et les fichiers CSS mis à jour.

Visibilité du composant WebPart côté client sur les sites SharePoint

Les composants WebPart inclus dans les solutions qui ont été déployées de façon centralisée sont visibles immédiatement dans le sélecteur de composants WebPart sur les pages classiques et modernes.

Impact du paramètre skipFeatureDeployment sur les extensions

Les extensions de SharePoint Framework sont immédiatement disponibles pour utilisation sur des sites SharePoint. Cela signifie qu’elles peuvent être associées à des propriétés ClientSideComponentId dans les éléments SharePoint spécifiques, tels que des champs et des actions personnalisées utilisateur.

De plus, si un administrateur active la case à cocher Rendre cette solution disponible pour tous les sites de l’organisation pendant le déploiement, les automatisations dans le package de solution peuvent créer des entrées dans la liste Extensions à l’échelle du client dans le catalogue d’applications. Les entrées de cette liste gèrent l’activation à l’échelle du client des extensions de site. Les automatisations sont décrites par le fichier ClientSideInstance.xml, tel que référencé dans ./config/package-solution.json.

Pour plus d’informations, voir Déploiement d’Extensions SharePoint Framework à l’échelle du client.

Voir aussi

• Présentation de SharePoint Framework