pega-8-activity-html-page

 pega-8-activity-html-page

 

Overview 


  1. Create new HTML Rule
  2. Create Pega 7 Activity to Show HTML Page Using Show-HTML Method
  3. Access Pega 7 Activity to Show HTML Page from a Web Browser

  Create new HTML Rule

  • In the Pega 7 Designer Studio, click on +Create > Technical > HTML to create a new HTML Rule.

  • Enter a label for the new HTML Rule, select the context, apply to class and ruleset version.
  • Here, the name of the new rule is HelloWorldHTML. Then click on Create and open.

  • On the HTML tab of the HTML Rule, select "HTML" in the Generate for drop down.
  • Here, Browser Support is set to "All Supported Browsers" and Accessibility remains "No".
<html>
  <body>
    <span>Hello World!</span>
  </body>
</html>
  • Enter HTML code into the source text box, e.g. the above code shows a Hello World! message.

  • Click on Save to save the changes to the HTML Rule.

2  Create a Pega 7 Activity to Show HTML Page Using Show-HTML Method

  • In the Pega 7 Designer Studio, click on +Create > Technical > Activity to create a new Activity Rule.

  • Enter a label for the new Activity Rule, select the context, apply to class and ruleset version.
  • Here, the name of the new rule is ViewHelloWorld. Then click on Create and open.

  • On the Pages & Classes tab of the Activity rule, add a reference to the class that contains the HTML Rule. Here, that class is PGX-MyStore-Work.

  • On the Steps tab of the Activity rule, add two steps as shown below.
  • The first step uses Page-New to create a new clipboard page of the class that contains the HTML Rule.
  • The second step uses Show-HTML and references HelloWorldHTML in the HTMLStream parameter.

  • Check the option "Allow direct invocation from the client or a service" on the Security tab of the Activity rule.
  • The option "Require authentication to run" is left unchecked.
  • Leave the Usage dropdown unchanged so that it is set to "Activity".

  • Click on Save to save the changes.
  • The activity can now be run by clicking on Actions > Run.
  • On the pop-up Run Activity window, click on Run to execute the activity.

  • The HTML page, generated by the activity, is shown in a new window:

  • In Google Chrome, right-click on the page and select View Page Source.

  • Here, the HTML code is not modified and retains all white spaces and line breaks.
  • The option "Omit extra spaces?" on the HTML Rule form can be used to remove white spaces and line breaks to reduce the size of the generated HTML code.

  • The HTML code is now reduced to one line and consecutive white spaces are replaced with a single white space.

3  Access Pega 7 Activity to Show HTML Page from a Web Browser

  • The activity can be accessed from an external browser or other HTTP client via a URL.
  • The target activity is referenced in the pyActivity query string parameter using the class- and activity name, here PGX-MyStore-Work.ViewHelloWorld, so that the URL in this example is:
http://localhost:8080/prweb/PRServlet/?pyActivity=PGX-MyStore-Work.ViewHelloWorld
  • If the activity is accessed from the same browser that is used to work in the Designer Studio, the current user’s session will be used to invoke the activity:

  • If the activity is accessed from a different browser, where no active session is present, a login screen will be shown:

  • Use valid Pega operator credentials for authentication when calling the activity (…even when the option "Require authentication to run" is NOT checked, authentication to Pega is needed).

Allow Direct Invocation from the Client or a Service

  • If the option "Allow direct invocation from the client or a service" is NOT checked on the Security tab of the activity:

  • It is not accessible by an external client and Pega will send an error page:

  • The Pega logs will show a more descriptive error message:
2017-10-31 14:06:35,741 [http-nio-8080-exec-2] [  STANDARD] [          ] [    MyStore:01.01.01]
(internal.mgmt.Executable) ERROR localhost|0:0:0:0:0:0:0:1 admin@pgx.com - 
This activity may not be called directly from input: 
RULE-OBJ-ACTIVITY PGX-MYSTORE-WORK VIEWHELLOWORLD #20171030T210946.682 GMT

Require Authentication to Run Activity

  • If the option "Require authentication to run" is NOT checked, Guest users can run the activity (…if they meet other security and access criteria) using the URL parameter pzAuth:
http://localhost:8080/prweb/PRServlet/?pzAuth=guest&pyActivity=PGX-MyStore-Work.ViewHelloWorld

 

Comments

Post a Comment

Popular posts from this blog

Queue processor FAQ

Image
  Queue processor FAQ A queue processor rule is an internal background process that you configure for queue management and asynchronous message processing. Use standard queue processor rules for simple queue management or low-throughput scenarios, or use dedicated queue processor rules for higher-scaling throughput, and customized or delayed processing of messages. Best practice is to configure queue processors instead of using standard agents to manage message queuing in Pega Platform. For details, see   Background processing best practices . Frequently Asked Questions about queue processors include the following: How do I queue a message to a queue processor? You can queue a message to a queue processor by performing either of the following actions: Use the   Queue-for-Processing   activity method. Use the   Run in Background   SmartShape when you create a case. For more information, see   Queue-For-Processing method   and   Running a background process . Can I queue a message to be
Read more

job scheduler in pega

Image
  What is Job Scheduler? As the name implies it is used to schedule jobs. Job scheduler got introduced on Pega infinity (Pega 8) release and set to replace the advanced agent rules. It belongs to SysAdmin category. Create a new Job Scheduler Records -> SysAdmin -> Job Scheduler -> Create new Note:   If you don’t see it in admin studio, make sure to update the System Runtime Context or AsyncProcessor requestor type context.   Trace the Job scheduler. Similar to agent tracing, you can trace your Job scheduler from the admin studio. 2. Disable the Job Scheduler from admin studio. You can use the Override link, to disable any running Job Scheduler. I just clicked the override link and you see it is disabled and next run is not applicable. There may be some scenarios where you need to disable the job schedulers.   How to start / stop jobs using Pega API? Step 1:   Switch to admin studio -> resources -> APIs You can find the APIs for job schedulers, queue processors. Note:   S
Read more