You are here: System management > System Settings landing page > System Settings – Resource URLs tab > Configuring Directed Web Access

Configuring Directed Web Access

Complete these steps to support Directed Web Access in your application:

  1. Create an Operator ID or IDs that start with the reserved word "External". Include a password for the operator. Specify in the Operator ID form an access group, organization, and division that correctly provide the external operator with the ability to complete the external assignment and correctly identify the operator in history records. On the Advanced tab, set the License Type field to "Invocation".
  2. Select Designer Studio > System > Settings > URLs, and complete the Public Link URL field to identify the URL of your system. For example,
    http://mysystem/prweb/

    Identify here the URL that is to be conveyed to external users; this may identify a proxy server. The standard function rule getPublicLinkURL(), referenced in the correspondence, accesses this Dynamic Systems Settings value.
  3. Create a correspondence rule (Rule-Obj-Corr type). By convention, choose a Correspondence Name key for the correspondence rule that starts with the word "External". For the Correspondence Type, select Email.
  4. In the Stream Source field, use an include directive (not a JSP tag) to copy in the standard correspondence fragment named ExternalInstructions.Email at the point where the link is needed. For example:
    Dear {.pyCustomerName}:
    {.pyNote Normal}
    {INCLUDE FRAGMENT="ExternalInstructions" }
    Our thanks.
    {pyCorrPage.pySignature NORMAL }
  5. Include the standard flow action EngageExternal (or another you have based on that one) as a local flow action in an assignment. When selected, this starts a flow execution of the standard flow Work-.EngageExternalQuick.

    In the post-processing of the EngageExternalQuick flow, param.CorrName is hard-coded to ExternalRequestBrief. Therefore, if you want to allow the user to select a different correspondence rule, configure the flow action to lead to a shape that calls the EngageExternalForInformation flow.

    Alternatively, customize EngageExternalQuick to take correspondence as a parameter. To use this method, you must perform a save-as and make a modification of three rules:
    1. Add the correspondence parameter to the flow.
    2. Change the activity that launches the flow so it passes the parameter through.
    3. Click the Params button on the flow action rule and specify the actual Rule-Obj-Corr rule name in the window that appears.
  6. In the flow, right-click the Create External Assignment shape and select View Properties. In the Assignment Properties form that appears, locate the OperatorModel field. Select the operator that you created in Step 1 as the Operator ID for the flow to use.
  7. Test the flow. At runtime, the operator uses the EngageExternal flow action to identify the party (or email-addressee) to receive the email correspondence, enter a subject line, and message. Depending on your configuration, the operator can also select the correspondence rule.
  8. The system creates the external assignment. Flow execution pauses until the external party completes the external assignment. The link in the external assignment does not require sign-on, but can only be used once.

Asynchronous processing

If you want processing in the flow to continue without waiting for the external assignment to be completed, use a Spinoff shape in the flow to start the standard flow Work-.EngageExternalForInformation.

If the external user is only to supply text for a note, use the EnterInformationExternal flow action.