Erstellen Sie eine DevOps -Toolintegration

Zum Erstellen einer DevOps-Toolintegration konfiguriert Ihr Integrationsentwickler DevOps Toolintegrationseinstellungen und einen Workflow-Studio -Subflow zum Sammeln und Transformieren von Daten aus dem Quelltool. Anschließend konfiguriert der DevOps -Administrator Ihre DevOps -Tool-Verbindungen.

Vorbereitungen

Hinweis:

Beim Erstellen einer Integration als bereichsbezogene App muss der Systemadministrator dem Integrationsentwickler diese Rollen zuweisen, damit der Integrationsentwickler Toolintegrations- und Integrationsfähigkeitsdatensätze für den spezifischen Umfang erstellen kann.

• Entwicklerrolle für die bereichsbezogene App
• DevOps Administratorrolle

Erforderliche Rolle: sn_devops.admin

Warum und wann dieser Vorgang ausgeführt wird

Das Erstellen eines Verfahrens zur Integration des Tools DevOps erfordert die Konfiguration durch Ihren Integrationsentwickler und Ihren DevOps -Administrator.

• Ihr Integrationsentwickler erstellt einen Toolintegrationsdatensatz in DevOps, einen Workflow-Studio Subflow, eine Toolfähigkeitenzuordnung und einen Integrationsfähigkeitsdatensatz in DevOps, um die Fähigkeiten und Aktionen zuzuordnen.
  Hinweis:

  Benachrichtigungs-, Verbindungs- und Erkennungsfunktionen werden unterstützt.
• Der Administrator DevOps richtet DevOps-Verbindungen (Planungs- oder Codierungstool) ein und konfiguriert das Quelltool mit dem Webhook und den Anmeldeinformationen.

Dieses Verfahren enthält detaillierte Schritte zum Erstellen Ihrer DevOps Toolintegration.

Prozedur

1. Integrationsentwickler:
   Konfigurieren Sie die Fähigkeiten und Aktionen der Quell-Toolintegration sowie einen Subflow.
   1. Navigieren zu DevOps > Integrationen > Toolintegrationen und erstellen Sie einen Datensatz, um das zu integrierende Tool (Quelltool) zu definieren.
      Hinweis:

      Bearbeiten Sie nicht die Toolintegrationsdatensätze, die mit der Anwendung DevOps bereitgestellt wurden.

      Tabelle : 1. Integration des DevOps-Tools

      Toolbezeichnung	Beispielcodetool
      Tabelle	Codetool [sn_devops_tool]
      Verwenden Sie Paketintegrationen	Ausgewählt
      Integrationsversion	1.0
      Aktiv	Ausgewählt

   2. Navigieren zu Flow Designer > Designer und erstellen Sie einen Subflow zum Sammeln und Transformieren von Daten aus dem zu integrierenden Tool (Quelltool).
      Hinweis:

      Das Feld Ausführen als muss auf Systemanwender festgelegt werden, und die Bezeichnung für Eingaben muss auf Aktuelle Variable festgelegt werden.

      Tabelle : 2. Eigenschaften des Subflows für Benachrichtigungen

      Name	Codetool-Benachrichtigung
      Anwendung	Beispiel für eine Integrations-App
      Zugänglich von	Nur dieser Applikationsumfang
      Beschreibung	Codetool für Integrations-App
      Ausführen als	Systemanwender

      Der Subflow muss „Weitere Daten über API-Aufrufe abrufen“ enthalten und/oder die ursprüngliche Nutzlast transformieren. Kopieren Sie die transformierte Nutzlast in den Datensatz für eingehende Ereignisse.

      Hinweis:

      Bearbeiten Sie den DevOps-Haupt-Flow nicht.
   3. Navigieren zu DevOps > Integrationen > Toolfähigkeiten-Zuordnungen und erstellen Sie einen Datensatz, um den Toolintegrationsdatensatz der Tooltypfähigkeit zuzuordnen.

      Tabelle : 3. DevOps Zuordnung der Toolfähigkeiten

      Toolintegration	Beispieltool
      Tooltypfähigkeit	Code

   4. Navigieren zu DevOps > Integrationen > Integrationsfunktionen und erstellen Sie einen Datensatz, um die Aktion für die Toolfähigkeiten-Zuordnung anzugeben.
      Hinweis:

      Bearbeiten Sie nicht die Integrationsfähigkeitsdatensätze, die mit der Anwendung DevOps bereitgestellt wurden.

      Tabelle : 4. DevOps Integrationsfähigkeit

      Toolintegration	Beispielcodetool
      Zuordnung der Fähigkeit	Beispielcode für Toolcode Hinweis: Bearbeiten Sie keine Tooltyp-Fähigkeitendatensätze.
      Aktion	Benachrichtigung Hinweis: Bearbeiten Sie keine Toolaktionsdatensätze.
      Aktiv	Ausgewählt
      Zeitüberschreitung (ms)	Zeitüberschreitung für den entsprechenden Subflow. Wenn die Ausführung des Subflows diesen Wert überschreitet, tritt eine Zeitüberschreitungsausnahme auf. Der Wert wird in Millisekunden (ms) angegeben. Der Standardwert ist 45.000 (45 Sekunden).
      Subflow-Name	x_snc_sample_integ.code_tool_notification Dem Namen wird der Bereichsname und ein Punkt (.) vor dem tatsächlichen Subflow-Namen vorangestellt. Beispiel: Subflow„connect_code_tool“. Umfangmy_app_scope Der Wert für dieses Feld ist my_app_scope.connect_code_tool. Hinweis: Wenn das Feld Subflow-Name für eine Benachrichtigungsfunktion leer gelassen wird, werden Benachrichtigungen standardmäßig verarbeitet. Siehe Fähigkeitsaktion des Benachrichtigungstools.
      Domäne	global

2. DevOps Administrator:

   Konfigurieren Sie die Verbindung von DevOps mit dem Quelltool.

   1. Der Tooldatensatz muss Folgendes enthalten:
      • Verweis auf den vom Integrationsentwickler erstellten Toolintegrationsdatensatz (im Feld „Tool“ )
      • Toolbezeichnung
      • Verbindungsalias (Verbindung und Anmeldeinformationen)
   2. Kopieren Sie die im Planungstool DevOps erstellte Benachrichtigung (Webhook) in den Service-Hook des Quelltools des Benachrichtigungsendpunkts, und legen Sie die Anmeldeinformationen auf devops.integration.user fest.
   Sie können den Status von Integrationsereignissen in der Liste „Eingehendes Ereignis“ anzeigen (DevOps > Administration > Eingehende Ereignisse) an.

   Der Status des eingehenden Ereignisdatensatzes wird auf Verarbeitet festgelegt, sobald das Objekt in die Tabelle „DevOps Core“ eingefügt wurde. Ereignisstatus sind „Neu“, „In Bearbeitung“, „Verarbeitet“, „Nicht abgeglichen“ und „Fehler“.

3. Wenn der Datensatz für die Toolintegration und der Subflow in einem anderen Bereich erstellt werden, muss der Administrator DevOps zwei neue Datensätze für bereichsübergreifende Berechtigungen erstellen, damit die App auf die Tabelle für eingehende Ereignisse zugreifen kann.
   Navigieren zu Systemanwendungen > Anwendungsübergreifender Zugriff und erstellen Sie Datensätze mit bereichsübergreifenden Lese- und Schreibberechtigungen, damit Ihre App auf die Tabelle der eingehenden Ereignisse zugreifen kann.

   Feld	Lesen	Schreiben
   Quellbereich	Wird basierend auf der aktuellen Anwendung automatisch ausgefüllt
   Zielbereich	DevOps
   Zielname	sn_devops_inbound_event
   Zieltyp	Tabelle
   Vorgang	Lesen	Schreiben
   Status	Zulässig

Beispiel

Abbildung : 1. DevOps Toolintegration

Abbildung : 2. Workflow-Studio Subflow-Eigenschaften

Abbildung : 3. Workflow-Studio Subflow

Abbildung : 4. Workflow-Studio DevOps Integration – Benachrichtigungs-Flow

Abbildung : 5. DevOps Zuordnung der Toolfähigkeiten

Abbildung : 6. Integrationsfähigkeit

Abbildung : 7. Planungstool

Abbildung : 8. Bereichsübergreifende Zugriffsdatensätze (Lesen und Schreiben)