Andrew Hanna

Andrew Hanna

Unmanaged Package in Salesforce: was es ist und wie Sie umsteigen

Unmanaged Package in Salesforce: was es ist und wie Sie umsteigen

Kurz gesagt: Ein Unmanaged Package in Salesforce ist ein Metadatenbündel der ersten Generation, das Sie einmal installieren und danach vollständig besitzen: Jede Komponente wird in der Ziel-Org änderbar, es gibt keinen Namespace, keinen IP-Schutz und keinen Upgrade-Pfad. Für Vorlagen, Beispiel-Apps und einmalige Übertragungen ist es das richtige Werkzeug. Für alles, was Sie pflegen wollen, wechseln Sie zu einem Unlocked Package.

Was ist ein Unmanaged Package in Salesforce?

Ein Unmanaged Package ist ein Mechanismus zur einmaligen Verteilung. Sie sammeln Komponenten wie Custom Objects, Felder, Apex-Klassen, Flows, Layouts und Berichte, laden sie aus einer Packaging-Org hoch und teilen einen Installationslink. Bei der Installation werden die Inhalte in der Ziel-Org entpackt und verhalten sich, als hätte ein Admin sie dort selbst gebaut.

Das ist der ganze Kompromiss. Der Installierende erhält volle Kontrolle, und der Herausgeber gibt jede Möglichkeit auf, später Fixes auszuliefern. Einen direkten Vergleich beider Modelle finden Sie unter Managed vs. Unmanaged Packages in Salesforce.

Wann sollten Sie ein Unmanaged Package verwenden?

  • Vorlagen und Starter-Kits, die der Installierende übernehmen und anpassen soll.
  • Beispiel- und Open-Source-Apps, bei denen sichtbarer Code genau der Zweck ist.
  • Einmalige Übertragungen eines Metadatensatzes zwischen Orgs, die nichts miteinander zu tun haben.
  • Beratungsbeschleuniger, etwa Objekte, Berichte und Permission Sets, die ein Kunde an seinen eigenen Prozess anpasst.

Tauchen die Wörter Version, Upgrade oder Subscriber irgendwo in Ihrem Plan auf, ist ein Unmanaged Package die falsche Wahl.

Wie erstellen und installieren Sie ein Unmanaged Package?

  1. Öffnen Sie in der Quell-Org Setup und suchen Sie Package Manager über Quick Find.
  2. Legen Sie ein neues Paket mit einem klaren Namen an. Lassen Sie es ohne Namespace.
  3. Fügen Sie Komponenten über den Tab Components hinzu. Salesforce ergänzt viele abhängige Komponenten selbst, prüfen Sie die Liste also vor dem Hochladen.
  4. Klicken Sie auf Upload. Nach erfolgreichem Upload schickt Salesforce Ihnen eine E-Mail mit dem Installationslink.
  5. Öffnen Sie diesen Link, während Sie in der Ziel-Org angemeldet sind (Sandboxes nutzen die Test-Login-Domain), legen Sie fest, wer Zugriff erhält, und installieren Sie.
  6. Testen Sie zuerst in einer Sandbox. Installierte Komponenten können mit vorhandenen Metadaten gleichen Namens kollidieren.

Wo liegen die Grenzen von Unmanaged Packages?

  • Keine Upgrades. Eine neue Version lässt sich nicht über eine alte installieren. Sie deinstallieren und installieren neu.
  • Deinstallieren löscht Daten. Das Entfernen des Pakets entfernt seine Custom Objects und Felder samt den Datensätzen darin.
  • Kein IP-Schutz. Sämtliches Apex, alle Formeln und die gesamte Logik sind in der installierenden Org sichtbar und änderbar.
  • Kein Namespace. Komponenten landen im Standard-Namespace, Namenskonflikte mit vorhandenen Metadaten gehen also auf Ihre Rechnung.
  • Org-Limits gelten. Installierte Custom Objects, Felder und Tabs zählen gegen die Editions-Limits der installierenden Org.
  • Keine Änderungsverfolgung. Nach der Installation verbindet nichts die Komponenten mehr mit einer Version, Drift bleibt also unsichtbar, solange Sie sie nicht in der Versionskontrolle verfolgen.

Die Regel Deinstallieren-zum-Upgraden ist die Stelle, an der Teams Daten verlieren. Halten Sie einen bekannten guten Zustand fest, bevor Sie ein installiertes Paket entfernen. In Serpent erledigt die Backups-Ansicht genau das, stellt unterstützte Org-Metadaten und Datensätze wieder her und führt eine Restore History. Sie ergänzt das Rollback, und bereits gelöschte Daten lassen sich weiterhin schwerer sauber zurückholen, also sichern Sie zuerst. Die Schritte stehen im Leitfaden zu Backup und Wiederherstellung.

Wie migrieren Sie ein Unmanaged Package zu einem Unlocked Package?

Diesen Teil lassen die meisten Leitfäden weg. Eine Umwandlung an Ort und Stelle gibt es nicht, Sie bauen das Paket also aus dem Source neu auf:

  1. Komponenten inventarisieren. Erfassen Sie, was das Unmanaged Package installiert hat und was seitdem angepasst wurde.
  2. In den Source abrufen. Schreiben Sie eine package.xml für diese Komponenten und führen Sie sf project retrieve start --manifest package.xml --target-org source aus. Unser Leitfaden zu Salesforce CLI beschreibt die Einrichtung.
  3. In Git committen. Ab hier ist die Versionskontrolle die maßgebliche Quelle.
  4. Nach Abhängigkeiten aufteilen. Vermischt das Bündel ein gemeinsames Datenmodell mit Features, trennen Sie es in ein Basispaket und Feature-Pakete. Die Regeln stehen in Cross-Package Dependency Resolution.
  5. Unlocked Package erstellen. Führen Sie sf package create --package-type Unlocked --path force-app gegen Ihren Dev Hub aus und erstellen Sie dann eine Version mit sf package version create --code-coverage. Apex braucht mindestens 75 % Abdeckung, bevor Sie promoten können.
  6. In einer Sandbox proben, mit realistischen Daten, bevor Sie die Produktion anfassen.

Für Schritt 6 befüllt Serpent beim Einrichten von Umgebungen und in Release-Pipelines Beispiel- oder maskierte Daten, sodass Scratch Orgs und aktualisierte Sandboxes ohne manuelles Skript befüllt zurückkommen. Bauen Sie stattdessen für AppExchange, ist das Ziel ein Managed-2GP-Paket; lesen Sie vorher die Geheimnisse von Second-Generation Managed Packages.

Unmanaged, Unlocked oder Managed: was passt?

  • Unmanaged: einmalige Kopie, änderbar, keine Upgrades. Vorlagen und Beispiele.
  • Unlocked (2GP): Source-basiert, versioniert, aktualisierbar, Namespace optional. Interne Apps.
  • Managed (2GP): mit Namespace, IP-geschützt, aktualisierbar. Kommerzielle AppExchange-Apps.

Die Paketentwicklung in Serpent baut, versioniert und liefert 1GP-, 2GP- und Managed Packages in jedem Plan und bildet Abhängigkeiten ab, damit Versionskonflikte auffallen, bevor eine Ziel-Org sie sieht. Weitere Anleitungen finden Sie in unseren SF Guides.

FAQ

Lässt sich ein Unmanaged Package upgraden?

Nein. Sie müssen die alte Version deinstallieren und die neue installieren, wodurch die Daten in seinen Custom Objects und Feldern gelöscht werden.

Haben Unmanaged Packages einen Namespace?

Nein. Komponenten werden im Standard-Namespace installiert, deshalb sind Namenskonflikte möglich.

Kann ich ein Unmanaged Package auf AppExchange anbieten?

Nein. Die kommerzielle Verteilung über AppExchange nutzt Managed Packages, die einen Namespace tragen und das Security Review durchlaufen.

Kann ich ein Unmanaged Package in ein Unlocked Package umwandeln?

Nicht an Ort und Stelle. Rufen Sie die Metadaten in die Versionskontrolle ab und erstellen Sie daraus ein neues Unlocked Package.

Ähnliche Artikel

Neugierig auf schnelleres Shipping, bevor Sie einsteigen? Sprechen wir

Unverbindlich.