URL-Parameter verwenden
Was sind URL-Parameter?
URL-Parameter sind Teile einer URL, die Daten an eine Web-App übergeben. Sie werden häufig verwendet, um dynamische Inhalte auf einer Webseite zu generieren, z. B. auf einer E-Commerce-Plattform, oder um Daten an eine Anwendung zu übergeben, z. B. ein Online-Formular. Ein weiterer möglicher Anwendungsfall sind Deep Links.
URL-Parameter können in der Web App Configuration aktiviert werden (.wac-Datei).
Beispiel für URL-Parameter
Beispiel mit einem URL-Parameter:
http://localhost:8080/X4/webapp/URL-Parameter-Demo/Module/Approval?approved=true
ttp://localhost:8080/X4/webapp/HowTo_WebApps/Module/urlParameter?message=hello
Beispiel mit mehreren URL-Parametern:
http://localhost:8080/X4/webapp/URL-Parameter-Demo/Module/Approval?approved=true&id=1234&name=John
So können Sie URL-Parameter verwenden
Der Benutzer klickt auf einen Link mit URL-Parametern wie oben gezeigt.
Die URL-Parameter werden an alle technischen Prozesse weitergegeben, die von der Component aufgerufen werden, die vom Benutzer durch die URL aufgerufen wurde. Die URL-Parameter können dann im Mapping eines technischen Prozesses verwendet werden.
Beispiel
Beispiel für einen technischen Prozess zum Abrufen von URL-Parametern:
Erster Baustein im Technical Process: request.xml mit der Operation Write
Die URL-Parameter aus dem Link werden als Input weitergegeben, an den Baustein request.xml mit der Operation Write.
request.xml hat folgendes Input-Format. Der Inhalt des Tag <Component> ist abhängig von der verwendeten Component, aber die Struktur im Tag <Parameters> ist immer identisch:
Example for Input
<?xml version="1.0" encoding="UTF-8"?>
<Get>
<Component>Components/urlParameter.detail</Component>
<Parameters>
<Parameter key="message" value="hello"/>
</Parameters>
</Get>Zweiter Baustein im Technical Process: mapTo_UrlParameter.xsl
Die Informationen aus den Parametern key und value können in Mappings verwendet werden.
Beispiel für ein Mapping, bei dem nur Eingaben mit key='message' is zulässig sind:
Example for Mapping
<?xml version="1.0" encoding="UTF-8" standalone="no"?><xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" exclude-result-prefixes="xs" version="2.0">
<xsl:output method="xml" media-type="text/xml"></xsl:output>
<xsl:template match="/">
<Ok>
<URL_PARAMETER>
<xsl:value-of select="if(//Parameter[@key = 'message']) then //Parameter[@key = 'message']/@value else ('no Parameter')"></xsl:value-of>
</URL_PARAMETER>
</Ok>
</xsl:template>
</xsl:stylesheet><!--Created by X4 Designer, Copyright © SoftProject GmbH. All rights reserved.-->Output
Der Prozess erzeugt einen Output mit key='message':
Output-Beispiel
<?xml version="1.0" encoding="UTF-8"?>
<Ok>
<URL_PARAMETER>hello</URL_PARAMETER>
</Ok>