---
sourceDocument: Yokohama Now Platform-Fähigkeiten
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama Now Platform-Fähigkeiten

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Erstellen Sie eine Probe-Aktivität

# Erstellen Sie eine Probe-Aktivität {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Erstellen Sie eine Aktivität, die eine Probe auf dem Zielhost ausführt, der so konfiguriert ist, dass bestimmte Informationen zurückgegeben werden.

## Vorbereitungen

Erforderliche Rolle: Activity_Creator oder Workflow_admin

## Warum und wann dieser Vorgang ausgeführt wird

Anweisungen zur Verwendung des Aktivitätsvorlagen-Prozess-Flows finden Sie unter [Erstellen Sie anwenderdefinierte Aktivitäten](https://www.servicenow.com/docs/FmCtYTSeHrZqiRgyQ0gqhQ "Sie können verschiedene Arten von anwenderdefinierten Aktivitäten im Workflow-Editor mithilfe einer anwenderdefinierten Vorlage erstellen und aktualisieren.").

## Prozedur

1. Erstellen Sie ein [Anwenderdefinierte Aktivität](https://www.servicenow.com/docs/access?context=create-custom-activities&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).  
   Mit dieser Aktion wird eine anwenderdefinierte Aktivität mithilfe einer Vorlage erstellt.
2. Nach dem Einrichten [Allgemeine Eigenschaften](https://www.servicenow.com/docs/8Cpdry0JcigvvNih0vX2DQ "Die folgenden Felder für allgemeine Eigenschaften sind allen Aktivitätendesigner-Vorlagen gemeinsam.")Und [Eingabevariablen werden erstellt](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#CreateInputVariables "Erstellen Sie die Variablen, die an die Aktivität in übergeben werden sollen Eingaben Formular des Aktivitätendesigners."), Konfigurieren Sie den Befehl „Probeausführung".

   | Option | Bezeichnung |
   | [Ordnen Sie die Eingabevariablen zu](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#t_MapAnInputVariable "Nachdem Sie die Eingabevariablen erstellt haben, ordnen Sie sie den Feldern im Formular „Ausführungsbefehl“ zu.") | Verwenden Sie die von Ihnen erstellten Variablen, um den Befehl zu konfigurieren, den Orchestration ausführt. |
   | Probe | Probe, die mit dieser Aktivität ausgeführt werden soll, aus der Liste der Probes im System |
   | Ziel-Host | Hostname oder IP-Adresse des Zielservers für diese Aktivität. |
   | Parameter | Zu verwendender MID-Server nach Fähigkeiten. |
   | Erforderliche MID-Serverfähigkeiten | Name-Wert-Paare, die mit dieser Probe an den Host übergeben werden sollen. Sie können diese Parameter manuell erstellen oder Eingabevariablen per Drag-and-Drop in die Parameterfelder ziehen und einen Wert zuweisen. |
   |-|-|

   {#t_CreateAProbeActivity__choicetable_bf3_bpv_vz}  
   Hinweis:  
   Sie können Parameterwerte in einer Testnutzlast Variablen in zuordnen Ausgaben Automatisch Registerkarte. Siehe [Ausgabevariablen automatisch zuordnen](https://www.servicenow.com/docs/fbiAVF1nogc9VkrQ4~1qxg "Sie können Parameterwerte in einer Testnutzlast Variablen in zuordnen Ausgaben Automatisch Registerkarte.").

## Nächste Maßnahme

* Verwenden [automatische Zuordnung](https://www.servicenow.com/docs/fbiAVF1nogc9VkrQ4~1qxg "Sie können Parameterwerte in einer Testnutzlast Variablen in zuordnen Ausgaben Automatisch Registerkarte.")Dient zum Generieren von Ausgaben und Analyseregeln
* Wenn Sie keine automatische Zuordnung verwenden, können Sie manuell [Erstellen Sie Ausgabevariablen](https://www.servicenow.com/docs/myRMeyEjy_Cb2DMZXui10w#t_CreateAnOutputVariable "Die Ausgaben Das Formular im Designer enthält einen Variablengenerator zum Erstellen von Datenstrukturen von Objekten und Arrays.")Und [Erstellen Sie Analyseregeln](https://www.servicenow.com/docs/R24VxietU8S3QGRZ7e0GWw#t_CreateAParsingRule "Füllen Sie Ausgabevariablen, die in einer anwenderdefinierten Aktivität definiert sind, mit Nutzlastdaten aus, die von einem Eingabetest auf einem externen Host oder Endpunkt zurückgegeben werden.")
{#t_CreateAProbeActivity__ul_u45_vbq_xz}

## Ausführungsparameter der Probe-Vorlage {#ariaid-title2}

Sie verwenden Ausführungsparameter, um das Eingabeprozessskript in zu erstellen Vorverarbeitung Formular.
Beschreibungen der Befehlsfelder finden Sie unter [Konfigurieren Sie den Testausführungsbefehl](https://www.servicenow.com/docs/o8u1eXdnxe4oYmw3XgjsFg#t_MapProbeVariablesToExecutionCmd "Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration für das Ziel ausführt.").  
Hinweis:  
Sie müssen verwenden `ExecutionParameter. `Präfix mit allen Variablen in dieser Tabelle.  
{#r_ProbeTemplateExecutionParameters__table_pwj_qdc_dr__entry__4}

| Name | Variable | Typ | Nutzung |
|-|-|-|-|
| Probe | Probe | Referenz | Die sys_ID der MID-Server-Probe. |
| Quelle | Quelle | Zeichenfolge | Beabsichtigter Zielhost |
| Parameter | parameters | Array von JS-Objekt | Array von JavaScript-Objekten, ausgedrückt mit `ExecutionParameter. `Präfix. Um weitere Name-Wert-Paare zu hinzuzufügen Parameter Array, hängen Sie sie an das vorhandene Array an. Erstellen Sie ein JavaScript-Objekt mit der folgenden Syntax, und fügen Sie es zu hinzu `ExecutionParam.Parameter `Array. Dadurch werden der Nachricht zusätzliche Parameter zugewiesen: var newParameter = {"name":"parameterName","value":"parameterValue"}; executionParam.parameters.push(newParameter); |
| MidCapabilities | MidCapabilities | Zeichenfolge (kommagetrennt) | Liste der erforderlichen MID-Server-Fähigkeiten. |
| Wertfähigkeiten | Wertfähigkeiten | Array von Hashmap | Fähigkeitswerte, die zum Auswählen des MID-Servers verwendet werden. Weitere Informationen finden Sie unter [MID-Serverfähigkeiten](https://www.servicenow.com/docs/pCP7ZnBZ56O_vTYXSOcgeA "MID-Server-Funktionen definieren die speziellen Funktionen eines MID-Servers innerhalb des Bereichs einer IP-Adresse."). Wenn zusätzliche Fähigkeiten vorhanden sind, die nach Wert zugewiesen werden, verwenden Sie dieses Beispiel, um die MID-Serverauswahl anzupassen: var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); |
[Tabelle : 1. Ausführungsparameter für Probe-Aktivität]

{#r_ProbeTemplateExecutionParameters__table_pwj_qdc_dr}

## Nachverarbeitungsparameter für Probe-Vorlage {#ariaid-title3}

Verwenden Sie diese Parameter, um ein Nachverarbeitungsskript zu erstellen.
{#r_PbTmpltPstPPrm__table_xlq_3n5_cr__entry__4}

| Name | Variable | Typ | Nutzung |
|-|-|-|-|
| Nutzlast | Nutzlast | Zeichenfolge | Enthält Rohnutzlast, die von der Probe zurückgegeben wird. |
| Ausgabe | Ausgabe | Zeichenfolge | Enthält Ausgabedaten, die von der Probe zurückgegeben werden. |
| EccSysId | EccSysId | Zeichenfolge | Enthält die Referenz-ID, die der Eingabenachricht der ECC-Warteschlange zugeordnet ist. |
[Tabelle : 2. Probe-Nachverarbeitungsparameter]

{#r_PbTmpltPstPPrm__table_xlq_3n5_cr}

## Konfigurieren Sie den Testausführungsbefehl {#ariaid-title4}

Verwenden Sie die von Ihnen erstellten Eingabevariablen, um den Befehl zu konfigurieren, den Orchestration für das Ziel ausführt.

### Vorbereitungen

Erstellen Sie die Eingabevariablen, die Sie benötigen, in Eingaben Formular, bevor Sie mit fortfahren können Ausführungsbefehl Phase.

Erforderliche Rolle: Activity_Creator, Administrator  
Hinweis:  
Sie können die Aktivitätsverbindung zwischen dem MID-Server und dem Ziel testen, ohne die Aktivität in einem Workflow-Kontext ausführen zu müssen. Weitere Informationen finden Sie unter [Testvorlagenausgaben](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#test-template-inputs "Sie können die Eingabeparameter einer anwenderdefinierten Aktivität während ihrer Entwicklung testen, ohne die Aktivität in einem Workflow-Kontext ausführen zu müssen.").

### Prozedur

1. Ziehen Sie Variablen aus der Liste der Eingaben, und legen Sie sie in Befehlsfelder ab.  
   Das System formatiert die Variable in der richtigen Syntax für den Befehl.  
   Abbildung : 1. Probe-Ausführung Befehl
2. Füllen Sie die in der Tabelle angezeigten Felder aus.  
   {#t_MapProbeVariablesToExecutionCmd__table_m3w_qzb_dr__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Eingabe | Eingabevariablengenerator. [Erstellen Sie Eingabevariablen](https://www.servicenow.com/docs/U7vfL6CjuCzOMbAvRE5jqQ#CreateInputVariables "Erstellen Sie die Variablen, die an die Aktivität in übergeben werden sollen Eingaben Formular des Aktivitätendesigners.")Zum Zuordnen zu verfügbaren Feldern. |
   | Probe | Probe, die mit dieser Aktivität ausgeführt werden soll, aus der Liste der Probes im System. |
   | Ziel-Host | Hostname oder IP-Adresse des Zielservers für diese Aktivität. |
   | Erforderliche MID-Serverfähigkeiten | Zu verwendender MID-Server nach Fähigkeiten. |
   | Parameter | Name-Wert-Paare, die mit dieser Probe an den Host übergeben werden sollen. Sie können diese Parameter manuell erstellen oder Eingabevariablen per Drag-and-Drop in die Parameterfelder ziehen und einen Wert zuweisen. |
   [Tabelle : 3. Befehlsfelder für Probeausführung]

   {#t_MapProbeVariablesToExecutionCmd__table_m3w_qzb_dr}
3. Klicken Sie auf Speichern.
4. Klicken Sie Auf Fahren Sie Fort Um zu weiterzufahren Ausgaben Phase.
{#t_MapProbeVariablesToExecutionCmd__steps_gpt_msl_s5}

