Erstellen Sie ein DevOpsToolintegration

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Um eine DevOps-Toolintegration zu erstellen, konfiguriert Ihr Integrationsentwickler DevOpsToolintegrationseinstellungen und ein Workflow-Studiosubflow zum Erfassen und Transformieren von Daten aus dem Quelltool. Dann Ihr DevOpsder administrator konfiguriert Ihren DevOpsToolverbindungen.

    Vorbereitungen

    Hinweis:
    Beim Erstellen einer Integration als bereichsbezogene App muss der Systemadministrator diese Rollen dem Integrationsentwickler zuweisen, damit der Integrationsentwickler Datensätze für Toolintegration und Integrationsfähigkeit für den spezifischen Bereich erstellen kann.
    • Entwicklerrolle für die bereichsbezogene App
    • DevOps administratorrolle

    Erforderliche Rolle: sn_devops.admin

    Warum und wann dieser Vorgang ausgeführt wird

    Wird erstellt DevOpsDas Tool-Integrationsverfahren umfasst die Konfiguration sowohl durch Ihren Integrationsentwickler als auch durch Ihren DevOpsadministrator.
    • Ihr Integrationsentwickler erstellt einen Toolintegrationsdatensatz in DevOps, A Workflow-Studio subflow , Eine Toolfähigkeitszuordnung und ein Integrationsfähigkeitsdatensatz in DevOpsZum Zuordnen der Fähigkeiten und Aktionen.
      Hinweis:
      Benachrichtigungs-, Connect- und Erkennungsfunktionen werden unterstützt.
    • Ihr DevOpsder administrator 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 von DevOpsToolintegration.

    Prozedur

    1. Integrationsentwickler:
      Konfigurieren Sie die Integrationsfähigkeiten und -Aktionen des Quelltools sowie einen Subflow.
      1. Navigieren zu DevOps > Integrationen > Toolintegrationen Und erstellen Sie einen Datensatz, um das Tool zu definieren, das Sie integrieren (Quelltool).
        Hinweis:
        Bearbeiten Sie die mit bereitgestellten Toolintegrationsdatensätze nicht DevOpsAnwendung.
        Tabelle : 1. DevOps-Toolintegration
        Toolbezeichnung Beispielcode-Tool
        Tabelle Code-Tool [sn_devops_Tool]
        Verwenden Sie paketfähige Integrationen Ausgewählt
        Integrationsversion 1,0
        Aktiv Ausgewählt
      2. Navigieren zu Flow Designer > Designer Und Erstellen Sie einen Subflow Dient zum Erfassen und Transformieren von Daten aus dem Tool, das Sie integrieren (Quelltool).
        Hinweis:
        Die Ausführen Als Feld muss auf Systemanwender und festgelegt werden Eingaben Bezeichnung muss auf aktuelle Variable festgelegt werden.
        Tabelle : 2. Eigenschaften des Benachrichtigungs-Subflows
        Name Code-Tool-Benachrichtigung
        Anwendung Beispiel Für Integrations-App
        Zugänglich von Alle Anwendungsbereiche
        Beschreibung Code-Tool 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 Toolfähigkeitszuordnung
        Toolintegration Beispieltool
        Tooltypfähigkeit Code
      4. Navigieren zu DevOps > Integrationen > Integrationsfunktionen Und erstellen Sie einen Datensatz, um die Aktion für die Toolfähigkeitszuordnung anzugeben.
        Hinweis:
        Bearbeiten Sie nicht die mit bereitgestellten Integrationsfähigkeitsdatensätze DevOpsAnwendung.
        Tabelle : 4. DevOps Integrationsfähigkeit
        Toolintegration Beispielcode-Tool
        Zuordnung der Fähigkeit

        Beispielcode-Toolcode

        Hinweis:
        Bearbeiten Sie keine Tooltyp-Fähigkeitsdatensä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.

        Wert ist in Millisekunden (ms). Der Standardwert ist 45.000 (45 Sekunden).

        Subflow-Name

        X_snc_sample_integ.code_tool_notification

        Dem Namen wird der Bereichsname und ein Punkt (.) vorangestellt. Vor dem tatsächlichen Subflow-Namen.

        Beispiel:
        • Connect_Code_Tool subflow
        • Mein_App_Umfang Umfang
        Der Wert für dieses Feld ist my_app_scope.connect_code_tool .
        Hinweis:
        Wenn Subflow-Name Das Feld ist für eine Benachrichtigungsfunktion leer. Benachrichtigungen werden standardmäßig verarbeitet.

        Siehe Benachrichtigungstool-Fähigkeitsaktion .

        Domäne global
    2. DevOps administrator:

      Konfigurieren Sie die Verbindung von DevOpsZum Quelltool.

      1. Der Tooldatensatz muss Folgendes enthalten:
        • Verweis auf den Toolintegrationsdatensatz, der vom Integrationsentwickler erstellt wurde (in Tool Feld)
        • Toolbezeichnung
        • Verbindungsalias (Verbindung und Anmeldeinformationen)
      2. Kopieren Sie die Benachrichtigung (Webhook), die auf erstellt wurde DevOpsPlanungstool zum Quell-Tool-Service-Hook des Benachrichtigungs-Endpunkts, und legen Sie die Anmeldeinformationen auf devops.integration.user fest.
      Sie können den Status von Integrationsereignissen in der Liste „eingehendes Ereignis“ (DevOps > Administration > Eingehende Ereignisse) an.

      Der Status des eingehenden Ereignisdatensatzes ist auf festgelegt Verarbeitet Sobald das Objekt in die DevOps-Core-Tabelle eingefügt wurde. ereignisstatus umfassen „Neu“, „in Bearbeitung“, „verarbeitet“, „nicht abgeglichen“ und „Fehler“.

    3. Wenn der Toolintegrationsdatensatz und der Subflow in einem anderen Umfang erstellt werden, wird DevOpsder administrator muss zwei neue bereichsübergreifende Berechtigungsdatensätze erstellen, damit die App auf die Tabelle „eingehende Ereignisse“ zugreifen kann.
      Navigieren zu Systemanwendungen > Anwendungsübergreifender Zugriff Und erstellen Sie bereichsübergreifende Lese- und Schreibberechtigungsdatensätze, damit Ihre App auf die Tabelle „eingehende 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
    DevOpsToolIntegration
    Abbildung : 2. Workflow-Studio subflow-Eigenschaften
    Subfloweigenschaften
    Abbildung : 3. Workflow-Studio subflow
    Subflow
    Abbildung : 4. Workflow-Studio DevOps Integration: Benachrichtigungs-Flow
    Benachrichtigungs-Flow
    Abbildung : 5. DevOps Toolfähigkeitszuordnung
    DevOps-Anwenderintegrationszuordnung
    Abbildung : 6. Integrationsfähigkeit
    Integrationsfähigkeit
    Abbildung : 7. Planungstool
    IntegrationPlanningTool
    Abbildung : 8. Bereichsübergreifende Zugriffsdatensätze (Lesen und Schreiben)
    Bereichsübergreifender Zugriff