Sie befinden sich hier:
Ausschließen von Metadaten mit der .forceignore-Datei
Verwenden Sie die .forceignore-Datei, um Dateien oder Metadatentypen auszuschließen, die Sie nicht in die Quellcodeverwaltung übernehmen oder in Ihrer Versions-Pipeline in der Zielorganisation bereitstellen möchten. Diese Datei stellt sicher, dass DX Inspector und DevOps Center keine nicht benötigten Dateien wie IDE-Konfigurationsdateien, lokalen Testdaten oder bestimmten Profile aus der Entwicklungsumgebung übertragen oder abrufen.
Erforderliche Editionen
| Verfügbarkeit: Lightning Experience in der Professional (API-Zugriff erforderlich), Enterprise, Performance, Unlimited und Developer Edition |
| Nicht verfügbar in: Government Cloud Plus. Wenden Sie sich für weitere Details an Ihren Salesforce-Kundenbeauftragten. |
| Nicht verfügbar in: Einsatzbereich EU "Einsatzbereich EU" ist ein spezielles zahlungspflichtiges Angebot, das eine stärkere Verpflichtung zur Datenresidenz bereitstellt. Das DevOps-Center wird gemäß den standardmäßigen Produktbedingungen in Organisationen in der EU unterstützt, die nicht Teil des Einsatzbereichs EU sind. |
Während des Commit-Prozesses liest DX Inspector die .forceignore-Datei und schließt übereinstimmende Dateien und Metadaten aus dem Quellcodeverwaltungs-Repository und dem Arbeitselement aus. DevOps Center liest die Datei während der Höherstufung, um die Metadatentypen und Dateien zu identifizieren und auszuschließen und so ihre Bereitstellung zu verhindern.
Überlegungen zum Erstellen der .forceignore-Datei
- Wenn Sie unsere Vorlage zum Erstellen des Repositorys verwendet haben, aktualisieren Sie die .forceignore-Datei entsprechend Ihren Projektanforderungen.
- Wenn Sie die .forceignore-Datei einem vorhandenen Repository hinzufügen, platzieren Sie die Datei im Stammordner Ihres Salesforce DX-Projektverzeichnisses.
- Sie können die .forceignore-Datei zwar jederzeit erstellen, es wird jedoch empfohlen, sie zu erstellen, wenn Sie Ihre Pipeline erstellen, damit sie von Anfang an vorhanden ist.
- Konfigurieren Sie die Datei im Hauptzweig, der Ihrer Versionsumgebung zugeordnet ist, bevor Sie Ihre Pipeline aktivieren. Dieser Schritt kopiert die Dateien in neue Verzweigungen.
- Wenn DevOps Center beim Erstellen Ihrer Pipeline das Repository und die Verzweigungen erstellt, übernimmt jede Phasenverzweigung die .forceignore-Datei aus der Hauptverzweigung. Wenn Sie ein vorhandenes Repository verbinden oder vorhandene Verzweigungen wiederverwenden, fügen Sie eine .forceignore-Datei manuell hinzu, wenn sie nicht verfügbar ist.
- Arbeitselement-Funktionsverzweigungen verwenden die Dateiversion aus der ersten Pipeline-Phasenverzweigung.
- Nachdem Sie die Pipeline aktiviert haben, wendet DevOps Center die Dateiregeln an, wenn Änderungen abgerufen oder höhergestuft werden.
Beispiel einer .forceignore-Syntax
Die Dateistruktur .forceignore ähnelt der Struktur .gitignore. Jede Zeile in der Datei enthält ein Muster, das den auszuschließenden Dateien entspricht, beispielsweise LWC-Konfigurationsdateien, JSON-Dateien oder Tests.
Diese Beispieldatei enthält allgemeine Dateien und Ordner, die Entwickler zum Zeitpunkt eines Commits oder Sonderangebots ausschließen möchten. Die Syntax ist für die Vorgänge zum Höherstufen (Bereitstellen) und Abrufen (Abrufen) unterschiedlich. Verwenden Sie beispielsweise **/profiles/**, um beim Höherstufen von Änderungen alle Profile auszuschließen. Verwenden Sie *.profile, um alle Profile beim Abrufen von Änderungen auszuschließen. Entsprechende Informationen finden Sie unter Ausschließen der Quelle beim Synchronisieren.
# List files or folders below to ignore them when deploying and retrieving changes
# Standard metadata
package.xml
# These metadata files are ignored when promoting (deploying)
**/appMenus/**
**/appSwitcher/**
**/fieldRestrictionRules/**
**/objectTranslations/**
**/profiles/**
**/profilePasswordPolicy/**
**/profileSessionSetting/**
**/settings/**
**/sharingRules/**
**/AuthProvider/**
# These metadata files are ignored when pulling (retrieving)
*.settings
*.appMenu
*.appSwitcher
*.rule
*.objectTranslation
*.profile
*.profilePasswordPolicy
*.profileSessionSetting
*.sharingRules
*.AuthProvider
# LWC configuration files
**/jsconfig.json
**/.eslintrc.json
# LWC Jest
**/__tests__/**Überlegungen zum Aktualisieren der .forceignore-Datei
- Aktualisieren Sie die .forceignore-Datei im Hauptzweig Ihres Pipeline-Repositorys.
- Wenn Sie über mehrere DevOps Center-Pipelines verfügen, aktualisieren Sie die Datei in jedem Pipeline-Repository.
- Wenn die Pipeline bereits verwendet wird, werden Änderungen nicht automatisch auf vorhandene Zweige angewendet. Wenn Sie sie überall anwenden möchten, nehmen Sie die Änderung an einem Arbeitselement vor und befördern Sie dieses Arbeitselement. Auf diese Weise wendet das DevOps Center die aktualisierte .forceignore-Datei während der Höherstufung auf die Pipeline-Verzweigungen an.
