Vom Anwender erstellte Integrationen in DevOps Change-Geschwindigkeit
Vom Anwender erstellte Integrationen dienen der Integration zusätzlicher Planungs-, Codierungs- und Testtools, die standardmäßig nicht in verfügbar sind DevOps Change-Geschwindigkeit Anwendung.
Die DevOps Change-Geschwindigkeit Die Anwendung enthält Tooldefinitionen für die Integration einiger gängiger Planungen, Codierungen und DevOps Test-Tool-Integration, Sie können aber auch von Anwendern erstellte Integrationen für zusätzliche Tools in Ihrer DevOps-Umgebung einrichten.
Integrationsobjekte
DevOps Die Toolintegration besteht aus diesen Objekten.
Toolfähigkeitsaktionen
- Verbinden Aktion:
Beim Herstellen einer Verbindung wird der Subflow für das spezifische Tool aufgerufen, und der Verbindungsstatus wird aktualisiert. Die Verbindungsstatusnachricht wird im Formular angezeigt.
Unter Subflow der Verbindungsfähigkeit finden Sie weitere Details.
- Erkennen Aktion:
Bei der Erkennung wird ein Importanforderungsdatensatz erstellt, und der Subflow für das spezifische Tool wird aufgerufen (wie im Datensatz der Integrationsfähigkeit definiert). Detail Und Status Felder 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. Elemente variieren je nach Tooltyp.
Unter Fähigkeits-Subflow erkennen finden Sie weitere Details.
- Importieren Aktion:
Die Importaktion unterstützt keine Verlaufsimportfunktion.
- Suchen Aktion:
Der Haupt-Flow „Suche“ wird bereitgestellt, um den Artefakt-Tooltyp in einem Subflow zu unterstützen, der von Ihrem Integrationsentwickler erstellt wurde.
- Benachrichtigung (Webhook) Aktion:
Das Quelltool wird manuell (von Ihrem Integrationsentwickler) konfiguriert, um Rohdaten an zu senden ServiceNow Instanz. Die Rohnutzlast wird dann mithilfe eines Subflows in ein Standard-JSON-Objekt umgewandelt.
Siehe Subflow der Benachrichtigungsfähigkeit Und DevOps – POST /devops/Tool/{ability} Endpunkt von DevOps-API Für weitere Details.
Hinweis:Wenn kein Subflow angegeben ist, werden Benachrichtigungen standardmäßig verarbeitet ( Ursprüngliche Nutzlast Wird automatisch nach kopiert Transformierte Nutzlast ).Dieses Verhalten ist nützlich, wenn die Transaktionsdaten des Tools von unterstützt werden ServiceNow DevOps Unverändert.
Sehen Sie sich die erwarteten Standardnutzlasten in an Subflow der Benachrichtigungsfähigkeit Für weitere Details.
DevOps Übersicht über die Integrationskonfiguration
Die Konfiguration der Toolintegration kann von Ihrem Integrationsentwickler und Ihrem abgeschlossen werden DevOps administrator.
- Integrationsentwickler
- Erstellen Sie einen Toolintegrationsdatensatz in DevOps Zum Definieren des Tools, das Sie integrieren (Quelltool).
- Erstellen Sie einen Workflow-Studio subflow Dient zum Sammeln und Transformieren von Daten aus dem Tool, das Sie integrieren (Quelltool).
- Erstellen Sie in einen Datensatz für die Toolfähigkeitszuordnung DevOps Um den Toolintegrationsdatensatz der Tooltypfähigkeit zuzuordnen.Hinweis:Die Benachrichtigungsfunktion (Webhook) wird unterstützt. Funktionen zum Verbinden und Erkennen werden ebenfalls unterstützt.
- Erstellen Sie in einen Datensatz für die Integrationsfähigkeit DevOps Zum Festlegen der Aktion für die Tooltypfähigkeit.
- DevOps-Administrator
- Erstellen Sie in einen Tooldatensatz (Planung, Codierung oder Test) DevOps Um eine Verbindung mit dem Tool herzustellen, das Sie integrieren (Quelltool).Hinweis:Der Toolintegrationsdatensatz muss in angegeben werden Tool Feld des Tooldatensatzes.
- Konfigurieren Sie das Quelltool mit dem Webhook und den Anmeldeinformationen.
- Erstellen Sie in einen Tooldatensatz (Planung, Codierung oder Test) DevOps Um eine Verbindung mit dem Tool herzustellen, das Sie integrieren (Quelltool).
Eingehende Ereignisse
Ein eingehendes Ereignis dient als Bereitstellungsbereich für den Benachrichtigungs-Flow, der die erneute Verarbeitung fehlgeschlagener Nutzlasten unterstützt. Das bedeutet, dass ein Datensatz in einem Fehlerstatus aus einer fehlgeschlagenen Integration oder Transformation wiederholt werden kann.
Wenn sich ein eingehender Ereignisdatensatz in befindet Fehler status, der Flow konnte den Datensatz nicht erfolgreich in den Kern einfügen DevOps Tabellen.
Allgemeine Fehler können mit diesen Aktionen gelöst 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 zur Nachverfolgung markiert | Der Commit kann nicht eingefügt werden. Die DevOps der administrator 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 Siehe FlowAPI – executeSubflowQuick (Zeichenfolgenname, Zuordnungseingaben, Zahlenzeitüberschreitung) Für weitere Details. Hinweis: Die Ausführung des Subflows überschreitet den in festgelegten Wert Zeitüberschreitung Feld im Datensatz der Integrationsfähigkeit. |
| Es wurde kein übereinstimmender Subflow für die Benachrichtigungsfähigkeit und die Toolintegration [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 (Nutzlast wird gesendet) ist ein anderer Fähigkeit Geben Sie als die Tooltypfähigkeit ein, die in Ihrer Toolfähigkeitszuordnung konfiguriert ist. Der Nutzlasttyp muss mit der Tooltypfähigkeit übereinstimmen, die in Ihrer Toolintegration konfiguriert ist. |
- Das Quelltool hat die Tool-ID nicht als Abfrageparameter übergeben.
- Das Quelltool hat eine Tool-ID übergeben, in der Instanz ist jedoch keine übereinstimmende Tool-ID vorhanden.
Toolzuordnungen
Ein Tool kann mehreren Fähigkeiten zugeordnet werden.
| Toolintegration | Tooltypfähigkeit | Toolfähigkeitszuordnung | |
|---|---|---|---|
|
|
Planen
Code
Orchestration
Test
|
|
Eine Toolfähigkeitszuordnung kann mehreren Aktionen zugeordnet werden.
| Toolfähigkeitszuordnung | 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, Einheitentest Funktionsfähig:
Leistung: Wird Geladen |
|
Azure DevOps
Jenkins
GitLab
GitHub und GitHub Enterprise
|