Andrew Hanna

Andrew Hanna

Package non géré Salesforce : définition, usages et migration

Package non géré Salesforce : définition, usages et migration

En bref : un package non géré (unmanaged package) Salesforce est un ensemble de métadonnées de première génération que vous installez une fois puis possédez entièrement : chaque composant devient modifiable dans l'org cible, sans namespace, sans protection de la propriété intellectuelle et sans chemin de mise à niveau. C'est le bon outil pour les modèles, les applications d'exemple et les transferts ponctuels. Pour tout ce que vous comptez maintenir, passez à un package déverrouillé.

Qu'est-ce qu'un package non géré Salesforce ?

Un package non géré est un mécanisme de distribution ponctuelle. Vous rassemblez des composants comme des objets personnalisés, des champs, des classes Apex, des flows, des présentations et des rapports, vous les téléchargez depuis une org de packaging et vous partagez un lien d'installation. À l'installation, le contenu est déballé dans l'org cible et se comporte comme si un administrateur l'y avait construit.

Tout le compromis est là. L'installateur obtient le contrôle total, et l'éditeur renonce à tout moyen de pousser des correctifs plus tard. Pour comparer les deux modèles, consultez packages gérés et non gérés dans Salesforce.

Quand utiliser un package non géré ?

  • Modèles et kits de démarrage que l'installateur est censé reprendre et personnaliser.
  • Applications d'exemple et open source, où la visibilité du code est justement le but.
  • Transferts ponctuels d'un ensemble de métadonnées entre des orgs sans lien.
  • Accélérateurs de conseil, comme des objets, rapports et ensembles d'autorisations qu'un client adapte à son propre processus.

Si les mots version, mise à niveau ou abonné figurent quelque part dans votre plan, le package non géré n'est pas le bon choix.

Comment créer et installer un package non géré ?

  1. Dans l'org source, ouvrez Setup et cherchez Package Manager dans Quick Find.
  2. Créez un nouveau package avec un nom clair. Laissez-le sans namespace.
  3. Ajoutez les composants depuis l'onglet Components. Salesforce ajoute lui-même de nombreux composants dépendants, vérifiez donc la liste avant le téléchargement.
  4. Cliquez sur Upload. Une fois le téléchargement réussi, Salesforce vous envoie un e-mail avec le lien d'installation.
  5. Ouvrez ce lien en étant connecté à l'org cible (les sandboxes utilisent le domaine de connexion de test), choisissez qui obtient l'accès et installez.
  6. Testez d'abord dans une sandbox. Les composants installés peuvent entrer en conflit avec des métadonnées existantes du même nom.

Quelles sont les limites des packages non gérés ?

  • Pas de mise à niveau. Impossible d'installer une nouvelle version par-dessus l'ancienne. Il faut désinstaller puis réinstaller.
  • La désinstallation supprime les données. Retirer le package supprime ses objets et champs personnalisés, ainsi que les enregistrements qu'ils contiennent.
  • Pas de protection de la propriété intellectuelle. Tout l'Apex, les formules et la logique sont visibles et modifiables dans l'org d'installation.
  • Pas de namespace. Les composants arrivent dans le namespace par défaut, donc les conflits de noms avec l'existant sont à votre charge.
  • Les limites de l'org s'appliquent. Les objets, champs et onglets installés comptent dans les limites de l'édition de l'org d'installation.
  • Aucun suivi des changements. Une fois installés, rien ne relie les composants à une version, donc la dérive reste invisible si vous ne la suivez pas dans le contrôle de version.

La règle désinstaller pour mettre à niveau est celle qui fait perdre des données aux équipes. Avant de retirer un package installé, capturez un état sain connu. Dans Serpent, la vue Backups fait exactement cela, restaure les métadonnées et enregistrements pris en charge de l'org et conserve un historique Restore History. Elle complète le rollback, et les données déjà supprimées restent plus difficiles à restaurer proprement : sauvegardez d'abord. Les étapes figurent dans le guide de sauvegarde et restauration.

Comment migrer un package non géré vers un package déverrouillé ?

C'est la partie que la plupart des guides omettent. Il n'existe pas de conversion sur place, vous reconstruisez donc le package à partir de la source :

  1. Inventoriez les composants. Listez ce que le package non géré a installé et ce qui a été personnalisé depuis.
  2. Récupérez-les en source. Rédigez un package.xml pour ces composants et lancez sf project retrieve start --manifest package.xml --target-org source. Notre guide Salesforce CLI couvre la configuration.
  3. Commitez dans Git. À partir de là, le contrôle de version est la source de vérité.
  4. Découpez par dépendance. Si l'ensemble mélange un modèle de données partagé et des fonctionnalités, séparez-les en un package de base et des packages de fonctionnalités. Les règles sont dans la résolution des dépendances entre packages.
  5. Créez le package déverrouillé. Lancez sf package create --package-type Unlocked --path force-app sur votre Dev Hub, puis créez une version avec sf package version create --code-coverage. L'Apex doit atteindre au moins 75 % de couverture avant la promotion.
  6. Répétez dans une sandbox avec des données réalistes avant de toucher à la production.

Pour l'étape 6, Serpent alimente des données d'exemple ou masquées lors de la mise en place des environnements et dans les pipelines de release, si bien que les scratch orgs et les sandboxes actualisées reviennent remplies sans script manuel. Si vous construisez pour AppExchange, la destination est un package géré 2GP ; lisez d'abord les secrets des packages gérés de deuxième génération.

Non géré, déverrouillé ou géré : lequel choisir ?

  • Non géré : copie ponctuelle, modifiable, sans mise à niveau. Modèles et exemples.
  • Déverrouillé (2GP) : piloté par la source, versionné, évolutif, namespace facultatif. Applications internes.
  • Géré (2GP) : avec namespace, protégé, évolutif. Applications commerciales AppExchange.

La prise en charge du développement de packages dans Serpent construit, versionne et livre des packages 1GP, 2GP et gérés sur chaque offre, et cartographie les dépendances pour que les conflits de versions apparaissent avant qu'une org cible ne les voie. D'autres guides pratiques vous attendent dans nos SF Guides.

FAQ

Peut-on mettre à niveau un package non géré ?

Non. Il faut désinstaller l'ancienne version et installer la nouvelle, ce qui supprime les données de ses objets et champs personnalisés.

Les packages non gérés ont-ils un namespace ?

Non. Les composants s'installent dans le namespace par défaut, d'où les conflits de noms possibles.

Puis-je publier un package non géré sur AppExchange ?

Non. La distribution commerciale sur AppExchange passe par des packages gérés, dotés d'un namespace et soumis à la revue de sécurité.

Puis-je convertir un package non géré en package déverrouillé ?

Pas sur place. Récupérez les métadonnées dans le contrôle de version, puis créez à partir d'elles un nouveau package déverrouillé.

Articles similaires

Curieux de livrer plus vite avant de vous lancer ? Parlons-en

Sans engagement.