59.29 SET_REQUEST_ECID_CONTEXT Procedure

This procedure adds an Execution Context ID (ECID) HTTP request header to g_request_headers. This overrides the application level security setting "Pass ECID."

Syntax

APEX_WEB_SERVICE.SET_REQUEST_ECID_CONTEXT (
    p_ecid  IN VARCHAR2 DEFAULT AUTO_ECID )

Parameters

Parameter	Description
p_ecid	The identifier for the execution context. Options include: AUTO_ECID - (Default) An automatically determined ECID header is added. NULL - No ECID header is added. If neither, substrb(p_ecid, 1, 64) is used as the ECID header.

Example 1

On application level, the sending of an ECID header is switched off. By calling set_request_ecid_context without any parameter, the following call to make_rest_request has an "ECID-Context" request header with an automatically determined ECID.

BEGIN
    apex_web_service.set_request_ecid_context;
END;

Example 2

On application level, the sending of an ECID header is switched off. By providing an ECID value, the following call to make_rest_request has an "ECID-Context" request header.

BEGIN
    apex_web_service.set_request_ecid_context(
        p_ecid => 'my-123456' );
END;

Example 3

On application level, the sending of an ECID header is switched on. By providing an ECID value of NULL, the following call to make_rest_request has no "ECID-Context" request header.

BEGIN
    apex_web_service.set_request_ecid_context(
        p_ecid => null );
END;

Example 4

On application level, the sending of an ECID header is switched on. By providing an ECID value, the following call to make_rest_request uses this value instead of an automatically determined ECID.

BEGIN
    apex_web_service.set_request_ecid_context(
        p_ecid => 'my-123456' );
END;