Resource-Mapping

Allgemeines

Innerhalb jeder REST-Call-Aktion steht Ihnen das "Resource-Mapping" zur Verfügung. Mit Hilfe des Resource-Mapping können Sie REST-Call-Aktionen nahezu beliebig dynamisieren bzw. variabel gestalten. Dies können Sie tun, indem Sie in die REST-Call-Aktion Platzhalter einfügen, die sich aus verschiedenen Quellen speisen können. Wenn der REST-Call ausgeführt wird, werden die Platzhalter mit den zum Ausführungszeitpunkt ermittelten Werten belegt.

Das Resource-Mapping können Sie über das - Icon aufrufen.

Beispiel - Dynamischer Hostname

Sie haben verschiedene Hosts, die Sie ansprechen möchten:

  • host01.example.com

  • host02.example.com

  • host03.example.com

Sie können die ID des Hosts oder den Host als Ganzes im Resource-Mapping ablegen. Später können Sie beispielsweise folgende Hosts angeben:

Statisch - host01.example.com

Statisch und dynamisch - host${ID}.example.com

Dynamisch - ${host}

Beispiel - E-Mail-Adresse als dynamischer Query-Parameter

Ihr REST-Call erfordert die E-Mail-Adresse des ausführender Benutzers der Ereignisquelle.

Sie können einen Platzhalter anlegen, bei dem Sie als Ressource "Benutzerwert" und als Wert "E-Mail geschäftlich" auswählen.

Sie können nun einen Query-Parameter anlegen und dabei den angelegten Platzhalter auswählen.

Beim Ausführen des REST-Calls ermittelt Intrexx automatisch die geschäftliche E-Mail-Adresse des ausführenden Benutzers und übermittelt Sie im Request.

Sie können das Resource-Mapping in nahezu allen Textfeldern verwenden. Beim Auslösen eines REST-Calls prüft Intrexx für alle Felder, ob Keys bzw. Platzhalter vorliegen und ersetzt diese (wenn möglich) durch den aktuell gültigen, auf dem Server vorliegenden Wert. Die Ersetzung läuft dabei von links nach rechts und betrachtet jeden Key nur einmal, ein "Schachteln" der Keys ist daher nicht möglich. Keys, die nicht im Mapping vorkommen, werden ignoriert. Keys, die "escapt" sind (\${meinPlatzhalter}) werden nicht verarbeitet. Einmal im Mapping definiert, kann ein Key an allen Stellen einer REST-Call-Aktion verwendet werden. Bei Bedarf auch mehrfach in einem Eintrag. Keys gelten nur innerhalb einer einzigen REST-Call-Aktion. Sie müssen in jeder (neuen) Aktion neu erfasst werden. Allerdings gibt es die Möglichkeit, Werte für Keys vor der Ausführung im Verarbeitungskontext zu hinterlegen und dann auf diese zu verweisen, sodass mehrere REST-Call-Aktionen gleiche Werte benutzen können. Gleichzeitig können die Werte gemeinsam im Verarbeitungskontext geändert werden können.

Beim Ersetzen wird nur der Wert des Keys eingesetzt, Anführungszeichen o.ä. kommen keine hinzu. Wenn Anführungszeichen o.ä. erforderlich sind (z.B. bei einem JSON), dann müssen diese manuell ergänzt werden. Maskierende (escapende) Anführungszeichen innerhalb der im Server geholten Werte bleiben als maskierende Zeichen erhalten.

Resource-Key anlegen

Schritt-für-Schritt

Um einen Resource-Key anzulegen, gehen Sie wie folgt vor:

  1. Klicken Sie beim entsprechenden Textfeld auf das - Icon.

    Das Dialogfenster "Resource-Mapping" wird angezeigt.

  2. Klicken Sie auf das - Icon.

    Das Dialogfenster "Ressource hinzufügen" wird angezeigt.

    Key

    Erfassen Sie einen Namen für den Key.

    Ressource

    Dynamische Dialoge Beachten Sie, dass nach jeweils ausgewählter Ressource unterschiedliche Eingabe- und Auswahlfelder angezeigt werden.

    Wählen Sie eine der folgenden Ressourcen aus:

  3. Klicken Sie auf "OK".

    Sie gelangen zurück in das Dialogfenster "Resource-Mapping".

    Der angelegt Resource-Key wird angezeigt.

Resource-Key einfügen

Schritt-für-Schritt

Um einen Resource-Key einzufügen, gehen Sie wie folgt vor:

  1. Klicken Sie beim entsprechenden Textfeld auf das - Icon.

    Das Dialogfenster "Resource-Mapping" wird angezeigt.

  2. Markieren Sie den gewünschten Key.

  3. Klicken Sie auf "OK".

    Der Resource-Key wird mit führendem Dollar-Zeichen und geschweiften Klammern in das Feld eingefügt (z.B. ${email-business}).