Verwenden Sie Ersetzungsparameter zur Konfiguration des Unified Service Desk

Artikel
06/27/2024

Ersetzungsparameter können zum Anpassen von Interaktionen bei bestimmten Geschäftsprozessen über Aktionen und die Fensternavigationsregeln verwendet werden. Weitere Informationen: Ersatzparameter

In diesem Thema finden Sie Informationen zu den Ersetzungsschlüsseln, die Sie in Ihren Ersetzungsparametern verwenden können, um eine spezielle Handhabung anzugeben, wie Sie die Ersetzungsparameter in Unified Service Desk unter bestimmten Bedingungen verwenden können.

Ersetzungsschlüssel

Die folgende Tabelle enthält Informationen zu den Ersetzungsschlüsseln, die Sie in den Ersetzungsparametern verwenden können.

Ersetzungsschlüssel	Beschreibung
+	Dieser Schlüssel ersetzt, wenn vorhanden, einen leeren oder nicht vorhandenen Schlüssel durch eine leere Zeichenfolge. Beispiel: In einem Szenario, in dem `account.name` nicht definiert ist, würde das Aufrufen von `[[account.name]]` "Nicht alle Parameter in der Handlungsaufforderung <ActionName> sind verfügbar. Handlungsaufforderung wird beendet" führen. Fehler. Dieser Vorgang hält die Verarbeitung der Regel oder des Positionsartikel, der ausgeführt wird, an. `[[account.name]+]` gibt jedoch einen leeren Wert aus und führt nicht zu diesem Ersetzungsschlüsselfehler.
$	Dieser Schlüssel ermöglicht das Escaping von Anführungszeichen und Zeilenumbrüchen. Er wird normalerweise Operator als verwendet, wenn der Aufruf eines Skriptlet oder die Rückgabe eine mehrzeiligen Zeichenfolge geschieht. Beispiel: `[[script.MyMultiLineString]$]`
^	Dieser Schlüssel verhindert das Escaping von Anführungszeichen und Zeilenumbrüchen und wird zum Ausgleich eines mehrzeiligen Ergebnissatzes verwendet. Beispiel: `MyMultiline=[[myvalue]^]`
u	Dieser Schlüssel dient zum URL-Codieren (auch "Percent Encoding") des Ersetzungsparameters. Ein Beispiel ist der Ersetzungsparameter in der folgenden URL: https://mysite?something=`[[opportunity.name]u]`. Die folgende Zeichenfolge wird zurückgegeben: https://mysite?something=My%20Opportunity.
x	Dieser Schlüssel dient zum XML-Codieren des Ersetzungsparameters. Dadurch können die XAML-Zeichen, wie etwa <, in der Ausgabe korrekt angezeigt werden. Zum Beispiel: `[[myvalue]x]`.
g	Dieser Schlüssel wird verwendet, um den Wert von der globalen Sitzung zurückzugeben. Wird der Schlüssel in der globalen Sitzung nicht gefunden, führt dies zu einem "Schlüssel nicht gefunden"-Fehler.
a	Dieser Schlüssel dient zur Rückgabe des Werts von der derzeit aktiven Sitzung, die sich im Fokus befindet. Wird der Schlüssel in der aktiven Sitzung nicht gefunden, führt dies zu einem "Schlüssel nicht gefunden"-Fehler.
v	Dieser Schlüssel wird verwendet, um innerhalb eines Ersetzungsschlüssels Schlüssel zu ersetzen. Denken Sie etwa an die folgenden beiden Werte: - account.name = „My Account“ - mytemplate.value = „Meine Vorlage ist `[[account.name]+]`“ Wenn Sie `[[mytemplate.value]]` aufrufen, wird die folgende Zeichenfolge zurückgegeben: "Meine Vorlage ist [[account.name]+]". Wenn Sie jedoch `[[mytemplate.value]v]` aufrufen, wird die folgende Zeichenfolge zurückgegeben: "Meine Vorlage ist My Account".

Spezialisierte Handler

Oft müssen Sie etwas einfaches tun, erwa ein Wenn/Dann/Ansonsten-Konstrukt, für das kein Skriptlet erstellt werden muss. Solche Situationen erfordern die Verwendung eines Skriptlets innerhalb eines Aktionsaufrufs. Es gibt zwei spezialisierte Handler, die Sie bei der Erstellung von Inline-Skriptlets in Aktionsaufrufen unterstützen: $Expression und $Multiline

$Expression

Denken Sie an eine Situation, in der Sie den Anzeigenamen auf der Grundlage des Etitätstypcodes (usw.) der aktuellen Entität wechseln müssen. Sie erstellen eine URL, die diese Informationen benötigt. In dieser Situation kann nur eine Firma oder ein Kontakt geladen sein.

In diesem Szenario werden wir die Navigieren-Aktion über ein Steuerelement, das durch eine Standardwebanwendung gehostetet wird, abrufen, indem wie den folgenden Wert im Feld Daten verwenden:

url= https://mysite/showmessage.aspx?displayname={either the account or contact display name}

Um dies zu erreichen, verwenden wir $Expression wie folgt:

url= https://mysite/showmessage.aspx?displayname=$Expression("[[$Context.etc]]" == "1" ? "[[account.name]u+]" : "[[contact.fullname]u+]")

Dadurch wird bei der Ausführung des Prozesses effektiv ein Skriptlet erstellt und ausgeführt.

$Multiline

Im $Expressions-Abschnitt ging es um die Erstellung eines Inline-Skriptlets innerhalb einer Aktion. Wenn Sie ein komplexeres Skriptlet benötigen, jedoch kein Skriptlet-Objekt für seine Speicherung verwenden möchten, können Sie zum Speichern mehrerer Skriptlets den Befehl $Multiline verwenden.

Im Beispiel aus dem Abschnitt $Expression kann dies wie folgt aussehen:

url= https://mysite/showmessage.aspx?displayname=$Multiline( $Expression(  
function doWork()  
{  
      If ("[[$Context.etc]]" == "1")  
          return "[[account.name]u+]"   
      else   
          return "[[contact.fullname]u+]"  
}  
doWork();   
))

Siehe auch

Ersetzungsparameter
Ausführen von Skripts mithilfe der Skriptlets in Unified Service Desk
Unified Service Desk-Konfiguration - Exemplarische Vorgehensweisen

Freigeben über