Branch PreDeploy Fix verwenden

PreDeploy Fix erkennt und behebt fehlende Abhängigkeiten proaktiv vor der Bereitstellung.

Geschrieben für die alte Benutzeroberfläche

Dieser Artikel wurde für die alte Benutzeroberfläche geschrieben. Die Anweisungen sind weiterhin verwendbar, aber die Screenshots sind veraltet. In einigen Fällen wurden die in den Anweisungen genannten Elemente verschoben oder geändert. Wenn Sie ein Element nicht finden können, siehe den Wo ist es hin Artikel.

Überblick

Der PreDeploy Fix ist ein Validierungsprozess, der Ihren Branch vor der Bereitstellung auf potenzielle Probleme überprüft, wie zum Beispiel:

• Nicht übereinstimmende API-Versionen
• Fehlende Komponenten
• Beschädigte Verweise
• Nicht erfüllte Abhängigkeiten

Wenn Probleme erkannt werden, werden sie mit Optionen zur Behebung aufgelistet. Dieser Prozess hilft, Bereitstellungsfehler zu verhindern, indem er:

• Überprüfen und Aktualisieren der API-Versionen von Komponenten
• Abrufen fehlender Metadaten
• Entfernen oder Aktualisieren von Verweisen auf problematische Komponenten

Indem Sie diese Aspekte beheben, wird Ihre Bereitstellung sauberer und weniger fehleranfällig.

Best Practices

• Führen Sie immer einen PreDeploy Fix aus, bevor Validieren oder Bereitstellen um die Wahrscheinlichkeit von Fehlern zu verringern.
• Bei fehlenden Abhängigkeiten verwenden Sie Abrufen wenn möglich, um sicherzustellen, dass alle Abhängigkeiten korrekt enthalten sind. Verwenden Sie Entfernen nur, wenn Sie sicher sind, dass der Verweis veraltet oder nicht erforderlich ist.
• Geben Sie klare und aussagekräftige Commit-Nachrichtenein. Diese werden zur späteren Nachverfolgung im Tab „Commits“ angezeigt.
• Führen Sie den PreDeploy Fix nach der Behebung der Probleme erneut aus, bis die Listen leer sind.
• Verwenden Sie Filter (Status, Typ, Datumsbereich) in Aktivitäten um Ihre PreDeploy-Fix-Jobs schnell zu verfolgen.
• Überprüfen Sie die Protokolle immer, wenn ein Job endet mit Ausnahme oder Aktion erforderlich um zu verstehen, was behoben werden muss.

Branch-PreDeploy-Fix ausführen

1

Branch auswählen und PreDeploy Fix ausführen

1. Klicken Sie auf Code im linken Seitenleistenmenü.
2. Wählen Sie einen Branch aus der Liste aus.

   
3. Klicken Sie auf das Drei vertikale Punkte ⋮ Dropdown-Menü neben „Bereitstellen“.
4. Klicken Sie auf PreDeploy-Fix.

   

2

Verbindung auswählen

1. Klicken Sie auf Wählen Sie für die Salesforce-Org-Verbindung aus, für die der PreDeploy Fix ausgeführt werden soll.
2. Klicken Sie auf Ausführen.

   
3. Nachdem der PreDeploy-Fix-Job gestartet wurde, wird er auf dem Aktivitäten Tab angezeigt.

   

PreDeploy-Fix-Ergebnisse

1

Ergebnisse anzeigen

1. Klicken Sie auf das Aktivitäten Tab angezeigt.
2. Prüfen Sie, ob der Pre Deploy Fix Search Jobstatus Abgeschlossen.
3. Klicken Sie auf das Pre Deploy Fix Search ist.

   

Um einen PreDeploy-Fix-Job zu finden, können Sie auf das Alle Typen Dropdown-Filtermenü klicken und Pre Deploy Fix Searchauswählen. Dadurch werden die Jobs gefiltert, sodass nur PreDeploy-Fix-Jobs angezeigt werden.

2

API-Versionsfehler

Wenn der PreDeploy Fix API-Versionsfehler erkennt, werden sie in der API-Versionsfehler Tabelle angezeigt. Diese Tabelle zeigt jede Komponente mit einem API-Versionsfehler. Rechts neben jeder Komponente stehen zwei API-Versionen: die Komponenten-API-Version und die Organisations-API-Version. Die Komponenten-API-Version ist die Version, die die Komponente im Branch verwendet, und die Organisations-API-Version ist die Version, die sie in der Salesforce-Org verwendet, die als Verbindung für diesen PreDeploy Fix genutzt wird.

Siehe den Branch PreDeploy Fix verwenden Abschnitt unten, um zu erfahren, wie diese Fehler behoben werden können.

1. Klicken Sie auf das API-Versionsfehler Tab angezeigt.

   

3

Fehlende Abhängigkeiten

Wenn der PreDeploy Fix fehlende Abhängigkeiten erkennt, werden sie in der Fehlende Komponenten Tabelle angezeigt. Diese Tabelle zeigt jede fehlende Metadatenabhängigkeit zusammen mit der Komponente, die darauf verweist. Um fehlende Komponenten zu beheben, können Sie zwischen zwei Optionen wählen und diese je nach Bedarf auf jede Komponente anwenden.

• Abrufen: Diese Option ruft die fehlende Komponente ab und schreibt sie als Commit in den Branch.
• Entfernen: Diese Option entfernt den Verweis auf die fehlende Komponente und sollte nur verwendet werden, wenn bestätigt ist, dass die Bereitstellung ohne die Komponente im Branch sicher ist.

Siehe den Branch PreDeploy Fix verwenden Abschnitt unten, um zu erfahren, wie diese Fehler behoben werden können.

1. Klicken Sie auf das Fehlende Abhängigkeiten Tab angezeigt.

   

Wenn der Fehlende Abhängigkeiten Tab nicht sichtbar ist, bedeutet das, dass keine fehlenden Abhängigkeiten vorhanden sind.

4

Job-Protokolle anzeigen

Sie können die Protokolle des PreDeploy-Fix-Jobs anzeigen, um etwaige Probleme bei der Jobverarbeitung zu prüfen und zu verifizieren, mit welcher Salesforce-Org der Job ausgeführt wurde.

1. Klicken Sie auf Protokolle anzeigen.

   
2. Zeigen Sie den Jobstatus und das Protokoll an.

   

5

PreDeploy Fix erneut ausführen

Sobald Sie alle API-Versionsfehler behoben und fehlende Abhängigkeiten aufgelöst haben, führen Sie den PreDeploy-Fix-Job erneut aus, um sicherzustellen, dass keine Probleme mehr bestehen. Die folgenden Screenshots zeigen einen PreDeploy-Fix-Job, der ohne gefundene Probleme abgeschlossen wurde.

Beide API-Versionsfehler und die Fehlende Abhängigkeiten Tabellen zeigen Keine Komponenten.

API-Versionsfehler beheben

Wenn der PreDeploy Fix hat API-Versionsfehler gefunden, können Sie diese beheben, indem Sie auf die richtige Version aktualisieren.

1

Versionen aktualisieren

1. Klicken Sie auf Versionen aktualisieren.

   
2. Klicken Sie auf Hinzufügen für jede Komponente, um die API-Version zu aktualisieren.
3. Klicken Sie auf Aktualisieren.

   
4. Geben Sie eine Commit-Nachricht für die Änderungen am Branch ein.
5. Klicken Sie auf Beheben.

   
6. Nachdem der API-Aktualisierungsjob gestartet wurde, wird er auf dem Aktivitäten Tab als ein Pre Deploy Fix Update ist.

   

2

Ergebnisse anzeigen

1. Klicken Sie auf das Pre Deploy Fix Update ist.

   
2. Zeigen Sie den Jobstatus und das Protokoll an.

   

Fehlende Abhängigkeiten beheben

1

Fehlende Komponenten abrufen

Die ausgewählten Metadaten werden in Ihren Branch abgerufen und als Commit hinzugefügt.

Wenn Sie Abhängigkeitskomponenten bereits entfernt haben, wählen Sie sie nicht zum Abrufen aus. Wenn Sie unsicher sind, können Sie den PreDeploy-Fix-Job erneut ausführen.

1. Klicken Sie auf Abrufen.

   
2. Klicken Sie auf Hinzufügen für jede abzurufende Abhängigkeitskomponente.
3. Klicken Sie auf Abrufen.

   
4. Geben Sie eine Commit-Nachricht für die Änderungen am Branch ein.
5. Klicken Sie auf das Verbindung Dropdown-Menü.
6. Wählen Sie die Salesforce-Org aus, aus der die abhängigen Komponenten abgerufen werden sollen.

   
7. Klicken Sie auf Ausführen.

   
8. Nachdem der Job „Fehlende Abhängigkeiten abrufen“ gestartet wurde, wird er auf dem Aktivitäten Tab als ein Pre Deploy Fix Update ist.

   

2

Fehlende Komponenten entfernen

Die Verweise auf diese Komponenten werden aus Ihrem Branch entfernt, wodurch Bereitstellungsfehler verhindert werden.

Wenn Sie Abhängigkeitskomponenten bereits abgerufen haben, wählen Sie sie nicht zum Entfernen aus. Wenn Sie unsicher sind, können Sie den PreDeploy-Fix-Job erneut ausführen.

1. Klicken Sie auf Entfernen.

   
2. Klicken Sie auf Hinzufügen für jede abzurufende Abhängigkeitskomponente.
3. Klicken Sie auf Entfernen.

   
4. Geben Sie eine Commit-Nachricht für die Änderungen am Branch ein.
5. Klicken Sie auf Ausführen.

   
6. Nachdem der Job „Fehlende Abhängigkeiten entfernen“ gestartet wurde, wird er auf dem Aktivitäten Tab als ein Pre Deploy Fix Remove ist.

   

3

Ergebnisse anzeigen

1. Klicken Sie auf das Pre Deploy Fix Retrieve Job zum Abrufen von Komponenten oder Pre Deploy Fix Remove Job zum Entfernen von Komponenten.

   
2. Zeigen Sie den Jobstatus und das Protokoll an.