Technical Process als ReSTful HTTP-Webservice bereitstellen

Um im Webservice Configuration Editor einen Technical Process als Operation eines ReSTful-Webservices bereitzustellen, gehen Sie wie folgt vor:

Legen Sie in der Baumstruktur bei Bedarf einen neuen Knoten an (entspricht einem URL-Part des Webservices). Weitere Informationen hierzu finden Sie unter Webservice-Konfiguration grafisch bearbeiten.
Legen Sie für den gewünschten Knoten (vom Typ Constant, Variable oder Remainder) über Add HTTP ReST Service einen neuen Service vom Typ HTTP ReST an. Passen Sie ggf. die (Sicherheits-)Eigenschaften an.
Legen Sie für den HTTP-ReST-Service über das Kontextmenü Add HTTP ReST Operation eine neue Operation an, oder wählen Sie in der Tabelle Operations einen bestehenden Eintrag aus, der überschrieben werden soll.

Sie können jeweils einmal pro Service eine Operation GET, POST, PUT, DELETE vergeben oder einen frei wählbaren Operationsnamen eingeben Bei den Operationsnamen wird zwischen Groß-/Kleinschreibung unterschieden.
Ziehen Sie einen Prozess aus der Ansicht Projects per Drag&Drop auf die gewünschte Operation, um den Prozesspfad zuzuordnen.
Definieren Sie Input-Modus und Output-Modus für jede Operation, um festzulegen welche XML-Struktur erwartet und erzeugt wird.
Aktivieren Sie ggf. die Nutzung von Platzhaltern, um Parameter für die Webservice-Operation zu verarbeiten und Informationen aus dem HTTP-Request als Platzhalter bereitzustellen.
Folgende Platzhalter mit Informationen aus dem HTTP-Request stehen bei Option Enabled innerhalb des X4-Prozesskontexts zur Verfügung, z. B. innerhalb von XSL-Mappings:
- REQUEST_PARAMETER_<Name>: Gewünschter Parameter (Groß-/Kleinschreibung wird beachtet!)
- REQUEST_HEADER_<NAME>: Gewünschter HTTP-Header (nur Großschreibung!)
- REQUEST_METHOD
- REQUEST_SCHEME
- REQUEST_PATH
- REQUEST_FULL_PATH
- REQUEST_REMOTE_ADDRESS
- REQUEST_REMOTE_PORT
- REQUEST_REMOTE_USER
- REQUEST_LOCAL_ADDRESS
- REQUEST_LOCAL_PORT
- REQUEST_SERVER_NAME
- REQUEST_SERVER_PORT
Definieren Sie Sicherheits-Optionen wie Realm oder Guest Allowed für die Operation.

Beispiel: ReSTful Webservice-Konfiguration (Auszug XML-Speicherformat)

XML

<Constant value="example">
    <Service type="Http">
        <Operation name="GET" process="x4db:/1/RestExamples/http/DirectOutput.wrf">
            <InputHandler type="HTTP-MetaXml" />
            <OutputHandler type="HTTP-Content" />
        </Operation>
    </Service>
</Constant>