Custom Code Invocation - Preprocessor and Postprocessor

Configure the parameters for the preprocessor and postprocessor to filter the request and response objects for your business requirements. You can specify the Java class name or custom JavaScript code or Rules for preprocessor and postprocessor. Java class names contain the preprocessor and postprocessor.

name: "<Name of the rule>"
description: "<Description of the rule>"
priority: <Priority of the rule>
condition: "<Condition to evaluate>"
actions:
   - "<Set of actions to execute>"

The step allows you to further filter the data received from a service call.

1. Under the Custom Code Invocation, follow these steps:
   • Under Preprocessor, configure one of the following:
     • Select Java, and in the Class text box, enter the preprocessor class. This step enables a developer to include any business logic on the data before forwarding the request to the external data source.
     • Select JavaScript to open a text box. Here, you can write custom JavaScript code for the preprocessor.

       JavaScript Code Validation for the Preprocessor: You can validate your JavaScript Code for the preprocessor before saving an operation. To validate the JavaScript code, click the Validate icon in the JavaScript code text box for the preprocessor.

       

       The following are different scenarios that occur when you validate the JavaScript code for the Preprocessor:

       • If you click Validate, and if the JavaScript code has no errors, the Validate Successful message appears. You can save the operation.
       • If you click Validate, and if the JavaScript code has errors, the Error message dialog is displayed with a Download link to the validation results. When you click Download, a .txt file with the validation results will be downloaded to your local system. In this case you must provide a valid JavaScript code, validate the updated code, and only then you can save the operation.

         Important: If you have validated the JavaScript code and found errors, the Console does not allow you to save the operation.

       • If you do not want to validate the JavaScript code for the Preprocessor, and want to save the operation, do not click Validate.
     • Select Rules to open a text box. Here, you can write rules for the preprocessor.
   • Under Postprocessor, configure one of the following:
     • Select Java, and in the Class text box, enter the postprocessor class. This step enables a developer to include any business logic on the data before sending the response to a mobile device.
     • Select JavaScript to open a text box. Here, you can write custom JavaScript code for the postprocessor.

       JavaScript Code Validation for the Postprocessor: You can validate your JavaScript Code for the postprocessor before saving an operation. To validate the JavaScript code, click the Validate icon in the JavaScript code text box for the postprocessor.

       

       The following are different scenarios that occur when you validate the JavaScript code for Postprocessor:

       • If you click Validate, and if the JavaScript code has no errors, the Validate Successful message appears. You can save the operation.
       • If you click Validate, and if the JavaScript code has errors, the Error message dialog is displayed with a Download link to the validation results. When you click Download, a .txt file with the validation results will be downloaded to your local system. In this case you must provide a valid JavaScript code, validate the updated code, and only then you can save the operation.

         Important: If you have validated the JavaScript code and found errors, the Console does not allow you to save the operation.

       • If you do not want to validate the JavaScript code for the Postprocessor, and want to save the operation, do not click Validate.
     • Select Rules to open a text box. Here, you can write rules for the postprocessor.

2. Under the Properties section, provide details for the following advanced service properties:
   • Timeout (in ms) - the duration in milliseconds after which the service call times out. Provide the details in the text box.
   • Cache Response - the duration in seconds within which the service response is fetched from the cache. Select the Cache Response check box, and provide the details in the text box.
   • Unescape embedded xml in response - To ignore the MuleSoft response received in the XML value field, select the Unescape embedded xml in response check box.
   • Response Encoding - Select the appropriate response encoding. The default value is UTF-8. For more information about different encoding schemes, refer to Response Encoding Schemes.

3. Under the Pass-through Cookies, specify a comma separated list of cookie names. When cookies names are present in the incoming client request, these cookies are sent to the backend target along with preprocessor request. A sample value looks like - cookie1, cookie2.

Exception Handling in Preprocessor - Support to access config map as part of onException handler

The service config and input map are being sent to the onException Implementation of postprocessor.

For example:

 @OnException
  public Result executeWithAnnotation(@KonyContext Result result,
      @KonyContext DataControllerRequest request, @KonyContext     DataControllerResponse response,
      @KonyContext(parameterName = ContextParams.INPUT) Map<String, Object> inputMap,
      @KonyContext(parameterName = ContextParams.CONFIGMAP) Map<String, Object> configMap,
      @KonyException Exception exception) throws Exception {

    Param config = new Param();
    config.setName("className");
    config.setValue((String)configMap.get("className"));

    result.setParam(config);
    return result;
}

Note:  In a Java service when an exception occurs, middleware calls the OnException method of the postprocessor if configured. Extended the ability to call onException even in the case of exception in preprocessor and postprocessor.

Note: You should not modify JVM timezone through custom code as modifying it can result in app server outage.