Class FcHttpRequestProps

    • Constructor Detail

      • FcHttpRequestProps

        public FcHttpRequestProps()
    • Method Detail

      • getCustomBodyContent

        public String getCustomBodyContent()
        Returns:
        The custom body content
      • getCustomBodyContentType

        public EHttpContentType getCustomBodyContentType()
        Returns:
        The custom body content type
      • getCustomLocationResolutionUri

        public String getCustomLocationResolutionUri()
        Returns:
        When the resolution type for the Location header is set to RESOLVE_AGAINST_CUSTOM_URI: the custom URI against which to resolve the URI from the Location header.
      • getFilesToTransmit

        public MultiFile getFilesToTransmit()
        Returns:
        Files to transmit with the HTTP request (requires a multipart request, see isForceMultipart()).
      • getHeaderParameters

        public List<Setting<String>> getHeaderParameters()
        Returns:
        Headers to send with the HTTP request.
      • getHttpRequestType

        public EHttpRequestType getHttpRequestType()
        Returns:
        How the body of the HTTP request should be created.
      • getHttpVerb

        public String getHttpVerb()
        Returns:
        The HTTP verb to use for the HTTP request.
      • getInputCharset

        public String getInputCharset()
        Returns:
        Input character set, i.e. the encoding used for sending the HTTP request.
      • getLocationResolutionType

        public EHttpLocationResolutionType getLocationResolutionType()
        Returns:
        When the HTTP response has a 3xx status code with a Location header, how to resolve the URI in that header. Defaults to RESOLVE_AGAINST_REQUEST_URI according to RFC 7231.
      • getMultipartHeaderType

        public EMultipartHeaderType getMultipartHeaderType()
        Returns:
        How to handle Unicode characters in headers of multipart HTTP requests.
      • getOutputCharset

        public String getOutputCharset()
        Returns:
        Output character set, e.g. the expected encoding of the response.
      • getOutputFileName

        public String getOutputFileName()
        Gets the file name to use for writing the content of the HTTP response to a file. May contain placeholders. When empty, the file name is determined automatically, either from the response headers or from the request URL.
        Returns:
        The file name of the file with HTTP response.
      • getPostUrl

        public String getPostUrl()
        Returns:
        URL to which to direct the HTTP request.
      • getRequestParameters

        public List<Setting<String>> getRequestParameters()
        Returns:
        Additional form parameters to send with the HTTP request.
      • getSingleFileToTransmit

        public SingleFile getSingleFileToTransmit()
        Returns:
        The SingleFile to transmit as body content
      • getXslTemplate

        public UuidEntityRef getXslTemplate()
        Returns:
        Optional XSL template for transforming the received response.
      • isAsResponsePage

        public boolean isAsResponsePage()
        Returns:
        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.
      • isDisallowMessageBody

        @Deprecated
        public boolean isDisallowMessageBody()
        Returns:
        When a custom getHttpVerb() is selected, 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.
      • isSendAllFormValues

        public boolean isSendAllFormValues()
        Returns:
        Whether to send the values of all form fields as form parameters with the HTTP request.
      • isShowBasicAuthProps

        public boolean isShowBasicAuthProps()
        Returns:
        Whether the user can configure the basic authentication settings in the UI.
      • isShowCustomBodyContent

        public boolean isShowCustomBodyContent()
        Returns:
        Whether to show the UI for selecting a custom body content (custom text file or binary file).
      • isShowCustomLocationResolutionUri

        public boolean isShowCustomLocationResolutionUri()
        Returns:
        Whether to show the UI with the input for the custom URI for resolving the Location header should be shown. See also getCustomLocationResolutionUri().
      • isShowDisallowMessageBody

        @Deprecated
        public boolean isShowDisallowMessageBody()
        Deprecated.
        Returns:
        Whether the user can configure the body message setting in the UI.
      • isShowFilesToTransmit

        public boolean isShowFilesToTransmit()
        Returns:
        Whether the user can configure the files to transmit setting in the UI.
      • isShowHttpRequestTypeSelection

        public boolean isShowHttpRequestTypeSelection()
        Returns:
        Whether to show the UI for selecting the type of body content for the request.
      • isShowMultipartHeaderTypeSelection

        public boolean isShowMultipartHeaderTypeSelection()
        Returns:
        Whether to show the UI for selecting the multipart header type.
      • isShowProxyProps

        public boolean isShowProxyProps()
        Returns:
        Whether the user can configure the proxy settings in the UI.
      • isShowRequestParameters

        public boolean isShowRequestParameters()
        Returns:
        Whether to show the UI for entering custom key value pairs that are included in the request.
      • isShowSendAllFormValues

        public boolean isShowSendAllFormValues()
        Returns:
        Whether to show the UI with the checkbox for including all submitted form field data in the request.
      • isShowSingleFileToTransmit

        public boolean isShowSingleFileToTransmit()
        Returns:
        Whether to show the UI for selecting a binary file to use as the HTTP request body.
      • isShowUseFieldAlias

        public boolean isShowUseFieldAlias()
        Returns:
        Whether to show the UI with the checkbox to use the alias of form fields instead of their names, see also isSendAllFormValues().
      • isTreat4xxAsNormal

        public boolean isTreat4xxAsNormal()
        Returns:
        When true, treats responses with 4xx status codes as normal. When false, throws an error instead (the default behavior).
      • isTreat5xxAsNormal

        public boolean isTreat5xxAsNormal()
        Returns:
        When true, treats responses with 5xx status codes as normal. When false, throws an error instead (the default behavior).
      • isUseBasicAuth

        public boolean isUseBasicAuth()
        Returns:
        Whether to use basic authentication via a username and password.
      • isUseFieldAlias

        public boolean isUseFieldAlias()
        Returns:
        When true, uses the alias of a form element instead of its name.
      • isUseProxy

        public boolean isUseProxy()
        Returns:
        Whether to use a proxy when sending the HTTP request.
      • setAsResponsePage

        public void setAsResponsePage​(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.
      • setAttachToFormRecord

        public void setAttachToFormRecord​(boolean attachToFormRecord)
        Parameters:
        attachToFormRecord - Whether files created by the workflow node are attached to the form record.
      • setCustomBodyContent

        public void setCustomBodyContent​(String customBodyContent)
        Parameters:
        customBodyContent - The custom body content to set
      • setCustomBodyContentType

        public void setCustomBodyContentType​(EHttpContentType customBodyContentType)
        Parameters:
        customBodyContentType - The custom body content type to set
      • setCustomLocationResolutionUri

        public void setCustomLocationResolutionUri​(String customLocationResolutionUri)
        Parameters:
        customLocationResolutionUri - When the resolution type for the Location header is set to RESOLVE_AGAINST_CUSTOM_URI: the custom URI against which to resolve the URI from the Location header.
      • setFilesToTransmit

        public void setFilesToTransmit​(MultiFile filesToTransmit)
        Parameters:
        filesToTransmit - Files to transmit with the HTTP request.
      • setHeaderParameters

        public void setHeaderParameters​(List<Setting<String>> headerParameters)
        Parameters:
        headerParameters - Headers to send with the HTTP request. Replaces all headers that were set on this instance.
      • setHttpRequestType

        public void setHttpRequestType​(EHttpRequestType httpRequestType)
        Parameters:
        httpRequestType - How the body of the HTTP request should be created.
      • setHttpVerb

        public void setHttpVerb​(String httpVerb)
        Parameters:
        httpVerb - The HTTP verb to use for the HTTP request.
      • setInputCharset

        public void setInputCharset​(String inputCharset)
        Parameters:
        inputCharset - Input character set, i.e. the encoding used for sending the HTTP request.
      • setLocationResolutionType

        public void setLocationResolutionType​(EHttpLocationResolutionType locationResolutionType)
        Parameters:
        locationResolutionType - When the HTTP response has a 3xx status code with a Location header, how to resolve the URI in that header. Defaults to RESOLVE_AGAINST_REQUEST_URI according to RFC 7231.
      • setMultipartHeaderType

        public void setMultipartHeaderType​(EMultipartHeaderType multipartHeaderType)
        Parameters:
        multipartHeaderType - How to handle Unicode characters in headers of multipart HTTP requests.
      • setOutputCharset

        public void setOutputCharset​(String outputCharset)
        Parameters:
        outputCharset - Output character set, e.g. the expected encoding of the response.
      • setOutputFileName

        public void setOutputFileName​(String outputFileName)
        Sets the file name to use for writing the content of the HTTP response to a file. May contain placeholders. When empty, the file name is determined automatically, either from the response headers or from the request URL.
        Parameters:
        outputFileName - The file name of the file with HTTP response.
      • setPostUrl

        public void setPostUrl​(String postUrl)
        Parameters:
        postUrl - URL to which to direct the HTTP request.
      • setRequestParameters

        public void setRequestParameters​(List<Setting<String>> requestParameters)
        Parameters:
        requestParameters - Additional form parameters to send with the HTTP request. Replaces existing parameters set on this instance.
      • setSendAllFormValues

        public void setSendAllFormValues​(boolean sendAllFormValues)
        Parameters:
        sendAllFormValues - Whether to send the values of all form fields as form parameters with the HTTP request.
      • setSingleFileToTransmit

        public void setSingleFileToTransmit​(SingleFile singleFileToTransmit)
        Parameters:
        singleFileToTransmit - The SingleFile to transmit the body content of
      • setTreat4xxAsNormal

        public void setTreat4xxAsNormal​(boolean treat4xxAsNormal)
        Parameters:
        treat4xxAsNormal - When true, treats responses with 4xx status codes as normal. When false, throws an error instead (the default behavior).
      • setTreat5xxAsNormal

        public void setTreat5xxAsNormal​(boolean treat5xxAsNormal)
        Parameters:
        treat5xxAsNormal - When true, treats responses with 5xx status codes as normal. When false, throws an error instead (the default behavior).
      • setUseBasicAuth

        public void setUseBasicAuth​(boolean useBasicAuth)
        Parameters:
        useBasicAuth - Whether to use basic authentication via a username and password.
      • setUseFieldAlias

        public void setUseFieldAlias​(boolean useFieldAlias)
        Parameters:
        useFieldAlias - When true, uses the alias of a form element instead of its name.
      • setUseProxy

        public void setUseProxy​(boolean useProxy)
        Parameters:
        useProxy - Whether to use a proxy when sending the HTTP request.
      • setXslTemplate

        public void setXslTemplate​(UuidEntityRef xslTemplate)
        Parameters:
        xslTemplate - Optional XSL template for transforming the received response.