Andrew Hanna

Andrew Hanna

Unmanaged package in Salesforce: wat het is en hoe je overstapt

Unmanaged package in Salesforce: wat het is en hoe je overstapt

TL;DR: Een unmanaged package in Salesforce is een eerste-generatiebundel van metadata die je één keer installeert en daarna volledig bezit: elk component wordt aanpasbaar in de doel-org, er is geen namespace, geen IP-bescherming en geen upgradepad. Het is het juiste middel voor sjablonen, voorbeeldapps en eenmalige overdrachten. Voor alles wat je wilt onderhouden, stap je over op een unlocked package.

Wat is een unmanaged package in Salesforce?

Een unmanaged package is een eenmalig distributiemechanisme. Je verzamelt componenten zoals custom objects, velden, Apex-klassen, flows, layouts en rapporten, uploadt ze vanuit een packaging-org en deelt een installatielink. Bij installatie worden de onderdelen in de doel-org uitgepakt en gedragen ze zich alsof een admin ze daar zelf heeft gebouwd.

Dat is de hele afweging. De installateur krijgt volledige controle, en de uitgever geeft elke mogelijkheid op om later fixes te pushen. Voor een vergelijking van beide modellen, zie managed versus unmanaged packages in Salesforce.

Wanneer gebruik je een unmanaged package?

  • Sjablonen en starterkits die de installateur hoort te forken en aan te passen.
  • Voorbeeld- en open-source-apps, waar zichtbare code juist de bedoeling is.
  • Eenmalige overdrachten van een set metadata tussen orgs die niets met elkaar te maken hebben.
  • Consultancy-versnellers, zoals objecten, rapporten en permission sets die een klant op zijn eigen proces afstemt.

Komen de woorden versie, upgrade of subscriber ergens in je plan voor, dan is een unmanaged package de verkeerde keuze.

Hoe maak en installeer je een unmanaged package?

  1. Open in de bron-org Setup en zoek Package Manager via Quick Find.
  2. Maak een nieuw package aan met een duidelijke naam. Laat het zonder namespace.
  3. Voeg componenten toe via het tabblad Components. Salesforce voegt veel afhankelijke componenten zelf toe, dus controleer de lijst voor je uploadt.
  4. Klik op Upload. Als de upload slaagt, mailt Salesforce je een installatielink.
  5. Open die link terwijl je bent ingelogd in de doel-org (sandboxes gebruiken het testlogindomein), kies wie toegang krijgt en installeer.
  6. Test eerst in een sandbox. Geïnstalleerde componenten kunnen botsen met bestaande metadata met dezelfde naam.

Wat zijn de beperkingen van unmanaged packages?

  • Geen upgrades. Je kunt geen nieuwe versie over een oude installeren. Je deïnstalleert en installeert opnieuw.
  • Deïnstalleren verwijdert data. Het package verwijderen haalt ook de custom objects en velden weg, met de records erin.
  • Geen IP-bescherming. Alle Apex, formules en logica zijn zichtbaar en aanpasbaar in de installerende org.
  • Geen namespace. Componenten komen in de standaard-namespace terecht, dus naamconflicten met bestaande metadata zijn voor jouw rekening.
  • Org-limieten gelden. Geïnstalleerde custom objects, velden en tabbladen tellen mee voor de limieten van de editie van de installerende org.
  • Geen wijzigingshistorie. Na installatie koppelt niets de componenten nog aan een versie, dus drift blijft onzichtbaar tenzij je het in versiebeheer bijhoudt.

De regel deïnstalleren-om-te-upgraden is waar teams data verliezen. Leg een bekende goede staat vast voordat je een geïnstalleerd package verwijdert. In Serpent doet de Backups-weergave precies dat: ze herstelt ondersteunde org-metadata en records en houdt een Restore History bij. Dit vult rollback aan, en reeds verwijderde data blijft lastiger netjes terug te draaien, dus maak eerst een back-up. De stappen staan in de gids voor back-up en herstel.

Hoe migreer je een unmanaged package naar een unlocked package?

Dit deel laten de meeste gidsen weg. Er is geen conversie ter plekke, dus je bouwt het package opnieuw op vanuit source:

  1. Inventariseer de componenten. Noteer wat het unmanaged package heeft geïnstalleerd en wat er sindsdien is aangepast.
  2. Haal ze op naar source. Schrijf een package.xml voor die componenten en voer sf project retrieve start --manifest package.xml --target-org source uit. Onze gids voor Salesforce CLI behandelt de opzet.
  3. Commit naar Git. Vanaf nu is versiebeheer de bron van waarheid.
  4. Splits op afhankelijkheden. Combineert de bundel een gedeeld datamodel met features, scheid ze dan in een basispackage en featurepackages. De regels staan in cross-package dependency resolution.
  5. Maak het unlocked package. Voer sf package create --package-type Unlocked --path force-app uit tegen je Dev Hub en maak daarna een versie met sf package version create --code-coverage. Apex heeft minstens 75% dekking nodig voordat je kunt promoten.
  6. Oefen in een sandbox met realistische data voordat je productie aanraakt.

Voor stap 6 vult Serpent voorbeeld- of gemaskeerde data tijdens het opzetten van omgevingen en in releasepipelines, zodat scratch orgs en ververste sandboxes gevuld terugkomen zonder handmatig script. Bouw je voor AppExchange, dan is de bestemming een managed 2GP-package; lees dan eerst de geheimen van second-generation managed packages.

Unmanaged, unlocked of managed: wat past?

  • Unmanaged: eenmalige kopie, aanpasbaar, geen upgrades. Sjablonen en voorbeelden.
  • Unlocked (2GP): vanuit source, geversioneerd, upgradebaar, namespace optioneel. Interne apps.
  • Managed (2GP): met namespace, IP-beschermd, upgradebaar. Commerciële AppExchange-apps.

De ondersteuning voor package development in Serpent bouwt, versioneert en levert 1GP-, 2GP- en managed packages op elk plan, en brengt afhankelijkheden in kaart zodat versieconflicten opduiken voordat een doel-org ze ziet. Meer how-to's vind je in onze SF Guides.

FAQ

Kun je een unmanaged package upgraden?

Nee. Je moet de oude versie deïnstalleren en de nieuwe installeren, waarbij de data in de custom objects en velden verdwijnt.

Hebben unmanaged packages een namespace?

Nee. Componenten worden in de standaard-namespace geïnstalleerd, en daarom zijn naamconflicten mogelijk.

Kan ik een unmanaged package op AppExchange aanbieden?

Nee. Commerciële distributie via AppExchange gebruikt managed packages, met een namespace en een doorlopen security review.

Kan ik een unmanaged package omzetten naar een unlocked package?

Niet ter plekke. Haal de metadata op naar versiebeheer en maak daaruit een nieuw unlocked package.

Gerelateerde artikelen

Benieuwd naar sneller releasen voordat je instapt? Laten we praten

Vrijblijvend.