Mustervorgänge anpassen

  • Freigeben Version: Washingtondc
  • Aktualisiert 10. Januar 2026
  • 2 Minuten Lesedauer

    • Beim Erstellen oder Ändern eines Discovery-Musters, ändern Sie vorhandene benutzerdefinierte Vorgänge, die Teil des Basissystems sind, oder fügen Sie neue hinzu.

    Vorbereitungen

    Erforderliche Rolle: pd_admin

    Praktische Kenntnisse in Skripting mit Java sind erforderlich.

    Warum und wann dieser Vorgang ausgeführt wird

    Für Standardmustervorgänge können Sie nur Eingabeparameter definieren. Es gibt jedoch benutzerdefinierte Vorgänge, für die Sie neben den Eingabeparametern die Geschäftslogik und den Mechanismus des Vorgangs selbst definieren können. Beispielsweise können Sie einen Parameter als obligatorisch festlegen oder definieren, welche Eingabeparameter verwendet werden sollen.

    Die folgenden benutzerdefinierten Vorgänge sind verfügbar:
    Cloud-REST-Aufruf
    Extrahiert Informationen aus Konfigurationselementen vom Typ PaaS (Platform-as-a-Service), z. B. Microsoft Azure oder Amazon Web Services. Dieser Java-basierte benutzerdefinierte Vorgang ist Teil des Basissystems.
    HTTP Get-Aufruf
    Extrahiert Informationen aus Configuration Items (CIs), die das HTTP-Protokoll verwenden. Dieser benutzerdefinierte Vorgang ist Teil des Basissystems.
    Cloud-REST-Abfrage
    Extrahiert Informationen aus Konfigurationselementen vom Typ PaaS (Platform-as-a-Service), z. B. Microsoft Azure oder Amazon Web Services. Dieser auf Java-Skript basierende benutzerdefinierte Vorgang ist nur verfügbar, nachdem Musterversion 1.0.24 oder höher aus dem ServiceNow Store heruntergeladen wurde. Verwenden Sie diesen Vorgang anstelle des Cloud REST Aufruf-Vorgangs.

    Zusätzlich zu diesen benutzerdefinierten Vorgängen können Sie eigene Vorgänge erstellen, um die Anforderungen Ihres Erkennungsprozesses zu erfüllen. Von Ihnen erstellte benutzerdefinierte Vorgänge werden in der Liste der Vorgänge zusammen mit Vorgängen angezeigt, die Teil des Basissystems sind.

    Prozedur

    1. Navigieren zu Alle > Musterdesigner > Benutzerdefinierte Vorgänge.
    2. Klicken Sie auf Neu, um einen benutzerdefinierten Vorgang hinzuzufügen.
      Oder
    3. Zum Ändern eines vorhandenen benutzerdefinierten Vorgangs klicken Sie in der Tabelle auf seinen Namen.
    4. Geben Sie für den neuen benutzerdefinierten Vorgang im Feld Name einen Namen für den neuen Vorgang ein.
      Beispiel: Wenn der Vorgang zum Extrahieren von Informationen mithilfe eines bestimmten Protokolls dient, können Sie ihn NetApp-Protokollabfrage nennen.
    5. Geben Sie den Vorgangszweck oder die Beschreibung in das Feld Beschreibung ein bzw. ändern Sie ihn.
    6. Schreiben Sie das Java-Skript im Bereich Skript, um die Geschäftslogik des Vorgangs zu definieren.
      Das Skript muss den folgenden Richtlinien entsprechen:
      • Erstellen Sie Variablen für Vorgangsparameter, indem Sie das Dollarzeichen vor dem Variablennamen verwenden, z. B. $fileName.
      • CTX ist ein Objekt, das alle Informationen enthält, die aus einer Musterausführung resultieren.
      • Verwenden Sie rtrn, um die Zeichenfolge anzugeben, die das Ergebnis Ihres benutzerdefinierten Vorgangs ist.
      Beispiel: 
      ms.info('message from Custom operation MIDLogWrite ' + $logMessage);

      Dabei ist ms.info das MID-Server-Protokoll. Die Variable $logMessage verweist auf die Nachricht, die in diesem MID-Server-Protokoll erstellt wird.

    7. Definieren Sie in der zugehörigen Liste Benutzerdefinierte Vorgangsparameter die Eingabeparameter, die Sie im Java-Skript verwendet haben.

      Wenn Sie beispielsweise eine Variable für die Protokollnachrichtendatei im Java-Skript verwendet haben, müssen Sie auch den Parameter für diese Variable definieren:


      Definieren Sie Parameter für Variablen, die im Skript verwendet werden.
      Feld Beschreibung
      Bezeichnung Geben Sie eine kurze und beschreibende Bezeichnung für den Parameter ein. Die Bezeichnung wird in der Tabelle angezeigt. Beispiel: netapp_query.
      Name Geben Sie einen kurzen und eindeutigen Namen für den Parameter ohne Leerzeichen ein, z. B. „NetAppquery“. Dieser Name wird in der Liste der Vorgänge auf der Musterschrittseite angezeigt.
      Standardwert Geben Sie ggf. den Standardwert ein. Beispiel: POST.
      Obligatorisch Legen Sie dies als „true“ fest, wenn dieser Parameter für diesen Vorgang obligatorisch ist.

      Andernfalls setzen Sie ihn auf „false“.
      Reihenfolge Definieren Sie die Reihenfolge, in der Parameter auf der Vorgangsseite angezeigt werden. Verwenden Sie natürliche Zahlen, wobei 1 bedeutet, dass dieser Parameter ganz oben auf der Vorgangseite angezeigt wird.
      Domäne Geben Sie für Umgebungen mit Domänentrennung den Namen der Domäne an, für die dieser Parameter relevant ist.
      Regulärer Ausdruck zur Validierung Geben Sie einen regulären Java-Ausdruck an, mit dem der Parameter validiert werden soll. Während des Erkennungsprozesses validiert der MID-Server das Ergebnis des Vorgangs. Das Modul „Musterdesigner“ führt auch eine Validierung aus, wenn Sie auf der Musterschrittseite auf Testen klicken.