Vom Benutzer erstellte Integrationen in DevOps Change-Geschwindigkeit
Vom Anwender erstellte Integrationen dienen der Integration zusätzlicher Planungs-, Codierungs- und Testtools, die in der Anwendung DevOps Change-Geschwindigkeit nicht standardmäßig verfügbar sind.
Die Anwendung DevOps Change-Geschwindigkeit enthält Tooldefinitionen für die Integration einiger allgemeiner Planungs-, Codierungs- und DevOps Toolintegration testen-Instanzen. Sie können jedoch auch vom Anwender erstellte Integrationen für zusätzliche Tools in Ihrer DevOps-Umgebung einrichten.
Integrationsobjekte
DevOps Die Toolintegration besteht aus diesen Objekten.
Toolfähigkeitsaktionen
- Connect -Aktion:
Beim Herstellen der Verbindung wird der Subflow für das spezifische Tool aufgerufen und der Verbindungsstatus aktualisiert. Die Verbindungsstatusnachricht wird im Formular angezeigt.
Unter Subflow der Connect-Fähigkeit finden Sie weitere Details.
- Aktion „Erkennen “:
Bei der Discovery von wird ein Importanforderungsdatensatz erstellt und der Subflow für das spezifische Tool aufgerufen (wie im Integrationsfunktionalitäts-Datensatz definiert). Die Felder„Detail“ und „Status“ im Datensatz „Importanforderung“ werden mit der Anzahl der erkannten, aktualisierten und fehlgeschlagenen Elemente aktualisiert.
Die transformierte Nutzlast besteht aus einem Array von Objekten als JSON-Zeichenfolge. Die Elemente variieren je nach Tooltyp.
Unter Subflow zum Erkennen der Fähigkeit finden Sie weitere Details.
- Importaktion :
Die Importaktion unterstützt keine Verlaufsimportfunktion.
- Suchaktion :
Der Haupt-Flow „Suchen“ wird bereitgestellt, um den Artefakt-Tooltyp in einem von Ihrem Integrationsentwickler erstellten Subflow zu unterstützen.
- Benachrichtigungsaktion (Webhook-Aktion):
Das Quelltool wird manuell (von Ihrem Integrationsentwickler) so konfiguriert, dass Rohdaten an die Instanz ServiceNow gesendet werden. Die Rohnutzlast wird dann mit einem Subflow in ein Standard-JSON-Objekt umgewandelt.
Weitere Informationen finden Sie unter Subflow der Benachrichtigungsfähigkeit und unter dem Endpunkt DevOps – POST /devops/tool/{capability} der DevOps-API.
Hinweis:Wenn kein Subflow angegeben ist, erfolgt die Standardverarbeitung von Benachrichtigungen (die ursprüngliche Nutzlast wird automatisch in die transformierte Nutzlastkopiert).Dieses Verhalten ist nützlich, wenn die Transaktionsdaten des Tools von ServiceNow DevOps unverändert unterstützt werden.
Weitere Informationen finden Sie unter den erwarteten Standardnutzlasten in Subflow der Benachrichtigungsfähigkeit.
DevOps Übersicht über die Integrationskonfiguration
Die Konfiguration der Toolintegration kann von Ihrem Integrationsentwickler und Ihrem DevOps -Administrator durchgeführt werden.
- Integration Developer
- Erstellen Sie einen Toolintegrationsdatensatz in DevOps, um das zu integrierende Tool (Quelltool) zu definieren.
- Erstellen Sie einen Workflow-Studio Subflow zum Sammeln und Transformieren von Daten aus dem zu integrierenden Tool (Quelltool).
- Erstellen Sie einen Toolfähigkeiten-Zuordnungsdatensatz in DevOps, um den Toolintegrationsdatensatz der Tooltypfähigkeit zuzuordnen.Hinweis:Die Funktion für Benachrichtigungen (Webhook) wird unterstützt. Die Connect-and-Discovery-Funktionen werden ebenfalls unterstützt.
- Erstellen Sie einen Integrationsfähigkeitsdatensatz in DevOps, um die Aktion für die Tooltypfähigkeit anzugeben.
- DevOps-Administrator
- Erstellen Sie einen Tooldatensatz (Planung, Codierung oder Test) in DevOps, um eine Verbindung zu dem zu integrierenden Tool (Quelltool) herzustellen.Hinweis:Der Toolintegrationsdatensatz muss im Feld Tool des Tooldatensatzes angegeben werden.
- Konfigurieren Sie das Quelltool mit dem Webhook und den Anmeldeinformationen.
- Erstellen Sie einen Tooldatensatz (Planung, Codierung oder Test) in DevOps, um eine Verbindung zu dem zu integrierenden Tool (Quelltool) herzustellen.
Eingehende Ereignisse
Ein eingehendes Ereignis dient als Bereitstellungsbereich für den Benachrichtigungs-Flow, der die erneute Verarbeitung fehlgeschlagener Nutzlasten unterstützt. Das heißt, ein Datensatz in einem Fehlerstatus aus einer fehlgeschlagenen Integration oder Transformation kann wiederholt werden.
Wenn sich ein Datensatz für ein eingehendes Ereignis im Status „Fehler“ befindet, konnte der Flow den Datensatz nicht erfolgreich in die Core-Tabellen DevOps einfügen.
Häufige Fehler können mit den folgenden Aktionen behoben werden.
| Fehler | Aktion |
|---|---|
| Pflichtfelder fehlen | Die transformierte Nutzlast stimmt nicht mit der Standardnutzlast überein. Weitere Informationen finden Sie in den bereitgestellten Standard- und JSON-Nutzlasten. |
| Repository nicht für die Nachverfolgung markiert | Der Commit kann nicht eingefügt werden. Der Administrator DevOps muss das Repository nachverfolgen. |
| [Subflow] wurde nicht im Anwendungsbereich [app_scope] veröffentlicht | Der Subflow wurde erstellt, aber noch nicht veröffentlicht. |
| Zeitüberschreitungsausnahme | Der Subflow benötigt mehr Zeit als der in der Eigenschaft festgelegte Wert: com.glide.hub.flow_api.default_execution_time Weitere Informationen finden Sie unter „FlowAPI – executeSubflowQuick(String name, Map inputs, Number timeout)“. Hinweis: Die Ausführung des Subflows überschreitet den Wert, der im Feld „Zeitüberschreitung“ im Integrationsfähigkeits-Datensatz festgelegt ist. |
| Es wurde kein passender Subflow für die Benachrichtigungsfunktionalität und die Integration des Tools [tool_integration_sys_id] gefunden | Der Flow konnte den übereinstimmenden Subflow nicht finden. Überprüfen Sie das Setup-Verfahren für die Integration. |
| Nutzlast stimmt nicht mit der erwarteten Fähigkeit überein. | Die ursprüngliche Nutzlast (die gesendete Nutzlast) ist ein anderer Fähigkeitstyp als die Tooltyp-Fähigkeit, die in Ihrer Toolfähigkeiten-Zuordnung konfiguriert ist. Der Nutzlasttyp muss mit der in Ihrer Toolintegration konfigurierten Tooltypfähigkeit übereinstimmen. |
- Das Quelltool hat die Tool-ID nicht als Abfrageparameter übergeben.
- Das Quelltool hat eine Tool-ID übergeben, es gibt jedoch keine übereinstimmende Tool-ID in der Instanz.
Toolzuordnungen
Ein Tool kann mehreren Fähigkeiten zugeordnet werden.
| Toolintegration | Tooltypfähigkeit | Zuordnung der Toolfunktionalität | |
|---|---|---|---|
|
|
Planen
Code
Orchestration
Test
|
|
Eine Zuordnung der Toolfähigkeiten kann mehreren Aktionen zugeordnet werden.
| Zuordnung der Toolfunktionalität | Toolaktion | Integrationsfähigkeit | |
|---|---|---|---|
|
|
Agile Development 2.0
Azure DevOps
Bitbucket
GitHub
GitHub Enterprise
GitLab
Jenkins
Jira
Rally
|
|
Jeder -Toolintegration können mehrere Testtypen zugeordnet werden.
| Testtyp | Toolintegration | Testtyp-Zuordnung |
|---|---|---|
Einheit: JUnit, XUnit, NUnit, Komponententest Funktional:
Leistung: Laden |
|
Azure DevOps
Jenkins
GitLab
GitHub und GitHub Enterprise
|