Interface IHttpRequestNodeBuilder

    • Method Detail

      • asResponsePage

        IHttpRequestNodeBuilder asResponsePage​(boolean asResponsePage)
        Parameters:
        asResponsePage - If true, returns the response from the HTTP request as the workflow response. That is, when the user submits a form and the workflow is triggered, send the response back to the user.
        Returns:
        This builder for chaining methods calls.
      • attachToFormRecord

        IHttpRequestNodeBuilder attachToFormRecord​(boolean attachToFormRecord)
        Parameters:
        attachToFormRecord - Whether to attach the HTTP request response as a file to the current form record.
        Returns:
        This builder for chaining methods calls.
      • basicAuth

        IHttpRequestNodeBuilder basicAuth​(String username,
                                          String password)
        Sets up basic authentication for the HTTP request.
        Parameters:
        username - Username for the basic authentication.
        password - Password for the basic authentication.
        Returns:
        This builder for chaining methods calls.
      • disallowMessageBody

        IHttpRequestNodeBuilder disallowMessageBody​(boolean disallowMessageBody)
        Lets you decide whether a custom HTTP verb supports a message body. Has no effect for standard HTTP verbs such as POST or GET.
        Parameters:
        disallowMessageBody - When a custom HTTP verb is selected, indicates whether a message body is allowed. If no message body is allowed, parameters will be added as URL parameters and no files will be sent.
        Returns:
        This builder for chaining methods calls.
      • header

        IHttpRequestNodeBuilder header​(String name,
                                       String value)
        Includes an additional header in the HTTP request.
        Parameters:
        name - Name of the header.
        value - Value of the header.
        Returns:
        This builder for chaining methods calls.
      • headers

        IHttpRequestNodeBuilder headers​(Map<String,​List<String>> headers)
        Parameters:
        headers - Headers to send with the HTTP request. Replaces all headers that were set on this builder.
        Returns:
        This builder for chaining methods calls.
      • inputCharset

        IHttpRequestNodeBuilder inputCharset​(String inputCharset)
        Parameters:
        inputCharset - Input character set, i.e. the encoding used for sending the HTTP request.
        Returns:
        This builder for chaining methods calls.
      • outputCharset

        IHttpRequestNodeBuilder outputCharset​(String outputCharset)
        Parameters:
        outputCharset - Output character set, e.g. the expected encoding of the response.
        Returns:
        This builder for chaining methods calls.
      • parameter

        IHttpRequestNodeBuilder parameter​(String name,
                                          String value)
        Includes an additional form parameter in the HTTP request.
        Parameters:
        name - Name of the parameter.
        value - Value of the parameter.
        Returns:
        This builder for chaining methods calls.
      • parameters

        IHttpRequestNodeBuilder parameters​(Map<String,​List<String>> parameters)
        Includes additional form parameters to send with the HTTP request. Replaces existing parameters set on this builder.
        Parameters:
        parameters - Form parameters to send with the HTTP request.
        Returns:
        This builder for chaining methods calls.
      • proxy

        IHttpRequestNodeBuilder proxy​(String host,
                                      int port)
        Sets up a proxy for transmitting the HTTP request.
        Parameters:
        host - Host of the proxy.
        port - Port of the proxy.
        Returns:
        This builder for chaining methods calls.
      • proxy

        IHttpRequestNodeBuilder proxy​(String host,
                                      int port,
                                      String username,
                                      String password)
        Sets up a proxy for transmitting the HTTP request.
        Parameters:
        host - Host of the proxy.
        port - Port of the proxy.
        username - Username for authorizing against the proxy.
        password - Password for authorizing against the proxy.
        Returns:
        This builder for chaining methods calls.
      • sendAllFormValues

        IHttpRequestNodeBuilder sendAllFormValues​(boolean sendAllFormValues,
                                                  boolean useFieldAlias)
        Parameters:
        sendAllFormValues - Whether to send the values of all form fields as form parameters with the HTTP request.
        useFieldAlias - When true, uses the alias of a form element instead of its name.
        Returns:
        This builder for chaining methods calls.
      • treat4xxAsNormal

        IHttpRequestNodeBuilder treat4xxAsNormal​(boolean treat4xxAsNormal)
        Lets you decide whether HTTP status codes in the 400-499 range are treated as errors.
        Parameters:
        treat4xxAsNormal - When true, treats responses with 4xx status codes as normal. When false, throws an error instead (the default behavior).
        Returns:
        This builder for chaining methods calls.
      • treat5xxAsNormal

        IHttpRequestNodeBuilder treat5xxAsNormal​(boolean treat5xxAsNormal)
        Lets you decide whether HTTP status codes in the 500-599 range are treated as errors.
        Parameters:
        treat5xxAsNormal - When true, treats responses with 5xx status codes as normal. When false, throws an error instead (the default behavior).
        Returns:
        This builder for chaining methods calls.
      • useFormDataEncoding

        IHttpRequestNodeBuilder useFormDataEncoding​(boolean useFormDataEncoding)
        Lets you decide whether you want to to send data encoded as form data or as multiple part. Files and uploads are supported only for multipart encoding.
        Parameters:
        useFormDataEncoding - When true, the request data is encoded as form data and sent with the content type application/x-www-form-urlencoded. Any selected uploads are ignored. When false, the request data is sent as multiple parts with the content type multipart/form-data. Any selected uploads are included.
        Returns:
        This builder for chaining methods calls.
      • xslTemplate

        IHttpRequestNodeBuilder xslTemplate​(Textbaustein xslTemplate)
        Parameters:
        xslTemplate - Optional XSL template for transforming the received response.
        Returns:
        This builder for chaining methods calls.