Documente Academic
Documente Profesional
Documente Cultură
IMPLEMENTATION GUIDE
7.4
© 2018
Pegasystems Inc., Cambridge, MA
All rights reserved.
Trademarks
For Pegasystems Inc. trademarks and registered trademarks, all rights reserved. All other trademarks or service marks are property of
their respective holders.
For information about the third-party software that is delivered with the product, refer to the third-party license file on your
installation media that is specific to your release.
Notices
This publication describes and/or represents products and services of Pegasystems Inc. It may contain trade secrets and proprietary
information that are protected by various federal, state, and international laws, and distributed under licenses restricting their use,
copying, modification, distribution, or transmittal in any form without prior written authorization of Pegasystems Inc.
This publication is current as of the date of publication only. Changes to the publication may be made from time to time at the
discretion of Pegasystems Inc. This publication remains the property of Pegasystems Inc. and must be returned to it upon request. This
publication does not imply any commitment to offer or deliver the products or services described herein.
This publication may include references to Pegasystems Inc. product features that have not been licensed by you or your company. If
you have questions about whether a particular capability is included in your installation, please consult your Pegasystems Inc. services
consultant.
Although Pegasystems Inc. strives for accuracy in its publications, any publication may contain inaccuracies or typographical errors, as
well as technical inaccuracies. Pegasystems Inc. shall not be liable for technical or editorial errors or omissions contained herein.
Pegasystems Inc. may make improvements and/or changes to the publication at any time without notice.
Any references in this publication to non-Pegasystems websites are provided for convenience only and do not serve as an
endorsement of these websites. The materials at these websites are not part of the material for Pegasystems products, and use of
those websites is at your own risk.
Information concerning non-Pegasystems products was obtained from the suppliers of those products, their publications, or other
publicly available sources. Address questions about non-Pegasystems products to the suppliers of those products.
This publication may contain examples used in daily business operations that include the names of people, companies, products, and
other third-party publications. Such examples are fictitious and any similarity to the names or other data used by an actual business
enterprise or individual is coincidental.
Pegasystems Inc.
One Rogers Street
Cambridge, MA 02142-1209
USA
Phone: 617-374-9600
Fax: (617) 374-9620
www.pega.com
Feedback
If you have suggestions or comments for how we can improve our materials, send an email to AppDocBug@pega.com.
CONTENTS
Introduction 5
Post-install setup tasks 6
Update the email account 6
Updating the email account 6
Enable the work object search index 7
Set up a connection to a development system 7
Configuring settings 9
Build your organization structure 9
Creating the structure 9
Option 1 10
Option 2 10
Add rulesets and an application rule 10
Adding a customization ruleset 10
Adding a reporting ruleset 11
Temporarily add the customization ruleset to your access group 11
Adding the application rule 12
Remove the customization ruleset from the access group 13
Creating the access groups 14
Updating operators 15
Add project resources 15
Removing operator access to Pega Agile Studio 16
Operator privileges 17
Operator privileges by user 17
Create menu 17
Agile Studio menu 18
Actions and privileges by work type 18
Products (PRD) 18
Releases (RLS) 19
Goals (GOAL) 19
Epics (EPIC) 20
Introduction
This guide provides system administrators with detailed instructions about how to perform post-
installation setup and configuration tasks that should be completed before users begin working in the
Pega Agile Studio application. It is not intended to describe all Pega Agile Studio capabilities.
After installation, the following setup tasks are required to prepare Pega Agile Studio for acceptance
testing and general use. These tasks allow you to fully demonstrate and run through the various
features, functions, and processes supported in the application.
When you have completed these setup tasks, perform the configuration tasks outlined in Configuring
settings on page 9.
Agile Studio uses an Email Account instance named PegaProjMgmt-Work to define the email
server and account it uses to send email notifications to resources when new work is assigned to
them and when work for their project team is updated.
To enable this function, update the instance with your organization's outgoing email account host,
email address, and sender information.
2. Select the Designer Studio > Integration> Email > Outbound Email landing page option.
3. In the PegaProjMgmt-Work Work Pool row, click the gear icon to edit the account details.
Full Name - enter text that you want to appear as the full name of the sender.
From - enter the email address associated with this email account using the format recognized by
your (SMTP) host. Typically, the format is address@mydomain.com. If your SMTP host requires
authentication, include one @ character.
Host (SMTP) - enter the Internet IP address or the domain name of your SMTP host. For example:
youremailserver.mydomain.com
5. Click Submit.
Agile Studio also supports Pulse notifications. For more information, see Configuring Pulse email
notifications.
The Agile Studio Search Tool, located on the header of the user portal, provides full text search
capability. Users can enter text strings to search for, locate, and display project work objects such as
projects, sprints, user stories, tasks, and more. We recommend that you enable search indexing for
work, data, and rules. For information on enabling search indexing, see Enabling and disabling
classes for search indexing.
You can skip this step if your development system is not built on Pega Platform or
you are not planning to connect to a system.
You can establish a connection between Pega Agile Studio and one or more Pega Platform
development systems built on Pega Platform.
This connection allows users to create, view, and update user stories and bugs within the Agile
Workbench feature of their Pega Platform development system and allows developers to associate
rule changes with their Agile Studio user stories and bugs.
All connection setup tasks are performed in your development system. Repeat the setup process
in each development system where you are planning to track and monitor project work. For
information on connecting a Pega Platform development system to Agile Studio from the Integration
& security tab of your application, see Integrating Agile Workbench with Pega Agile Studio.
For information on connecting development systems on earlier versions of Pega Platform to Agile
Studio, see Working with Development Systems on Previous Pega Platform Releases on the Agile
Studio product page.
Pega Agile Studio to Pega Platform integration provides an operator for authentication. For the SOAP
Services, this operator ID is PM_ SOAPOper and for REST it is AS_RESTOper. For added security,
before you put Pega Agile Studio into production, you may want to change the password on this
operator ID in Pega Agile Studio and in the authentication profiles in the development environment.
The authentication profile used by SOAP is PM_Integration_AuthProfile and REST uses PM_
AgileStudio_AuthProfile. To enable an OAuth 2.0 connection for the REST connections, add a client
registration data instance and update the service package as specified in Accessing the Pega API by
using OAuth 2.0.
On the Pega development side, create an OAuth provider and delete and recreate the PM_
AgileStudio_AuthProfile Authentication Profile as specified in Accessing protected API resources
by using OAuth 2.0.
Configuring settings
Users: System Administrator, Senior Project Manager, Project Manager
After you complete the post-install setup, there are several configuration tasks that you perform to
complete the typical configuration setup before users begin to access the system for testing and start
to customize it as a production environment.
Although these tasks can be performed at a later time, it is a recommended practice to perform them
after you have completed the post install setup tasks.
l Operator privileges
Pega Agile Studio includes a basic organizational structure that provides a working sample for
demonstration and learning purposes. To configure and prepare for production use, you can build a
structure that emulates your corporation and its divisions and departments. When pulled into
reports, this structure enables you to view work that is complete or in-process by the units in your
organization.
As an administrator, you can view a tree of the installed organization and its branches by selecting
the Designer Studio > Org & Security > Organization> Organizational Chart landing page
option.
Option 1
Update the Organization tree directly in Designer Studio. For more information, see Organization
landing page.
Option 2
Integrate Pega Agile Studio with the Pega Platform Single Sign-on features that synchronize the
organization chart with your LDAP directory. For more information about this option, see
Authentication Services or talk to your Pega Platform implementation team.
Adding new rulesets and an Application rule enables you to store and package the configuration and
rules you create when you customize Pega Agile Studio without impacting your installed rule base. It
also allows users to create and save custom reports using the Report Wizard and Report Browser
tools.
n Adding two rulesets - one for configuration customization and one for reporting
n Updating operators
1. From the Records Explorer, expand the Sysadmin category. Right-click RuleSet and select New.
Do not create the ruleset using a Save As option on an existing ruleset such as PegaProjectMgmt.
These are password protected. The Save As function carries over the protection into the new
ruleset. Before you use this ruleset in a production environment, you should lock it. You can then
increment the version and create new unlocked versions for additional customization.
2. Enter a RuleSet Name for the ruleset and move to the next field.
The system provides default values in the Version and Description fields.
1. From the Records Explorer, expand the Sysadmin category. Right-click RuleSet and select New.
Do not create the ruleset using a Save As option on an existing ruleset such as
PegaCustFoundation or PegaProjectMgmt. These are password-protected rulesets. The
Save As function carries over the protection into the new ruleset. This ruleset should
remain unlocked with Check-Out disabled in your production environment to allow users
to customize reports.
2. Enter a RuleSet Name for the ruleset and tab to the next field.
The system provides default values in the Version and Description fields.
5. Click Save.
1. From your name in the header of the portal, select the Access Group menu option to open the
access group you are currently using.
2. On the Advanced tab of the Access Group, add your customization ruleset to the PRODUCTION
RULESETS list.
3. Click Save. The rule form will display a warning due to the production ruleset.
2. Enter a Label and Version. In the Context section, select the customization ruleset you created.
a. In the Built on Application field, select AgileStudio and its highest version.
b. Add the customization and reporting rulesets you created to the APPLICATION RULESETS
list.
5. Click Save.
7. Click Save.
2. On the Advanced tab of the Access Group, click the trash icon to delete the customization ruleset
from the PRODUCTION RULESETS list.
3. Click Save.
1. Select the Designer Studio > Org & Security > Security > Access Groups landing page
option.
2. Select one of the AgileStudio access groups and click Save as.
3. Give it an Access Group Name that represents access to your custom development application and
the user's role.
The following screenshot provides a best practice example of naming an access group using the
sample Agile Studio:SrProjManager access group where the application name is followed by the
user role separated by a colon (:).
4. On the Definition tab, select the custom Application Name and Version you created.
5. On the Advanced tab, add your reporting ruleset and Version to the PRODUCTION RULESETS
and DESIGN TIME CONFIGURATION lists. This allows users to create custom reports.
6. Click Save.
Updating operators
Pega Agile Studio is also installed with sample operators that you can use to create your own
operators. You can update them to reference the access groups you created in the previous step and
then use these operators to create your project resources.
1. Select the Designer Studio > Org & Security > Organization > Operators landing page
option.
2. Select an operator.
3. In the APPLICATION ACCESS section of the Profile tab, click the plus icon to add a row to the
ACCESS GROUP list.
Select the radio button next to the custom access group you created to make the application the
default application.
4. Click Save.
Project resources are operators that are assigned to create, manage, and complete project work. Pega
Agile Studio is installed with five sample operators that represent the typical project administrative
and team roles with different levels of security and privilege associated with their project role and
function.
l System Administrator - performs technical and operational tasks; has access to the Pega Agile
Studio developer portal
l Project Manager - performs day-to-day project management functions to create, oversee, track,
and manage projects
l Lead Architect - oversees and leads the application development effort; performs development
tasks and bug fixes
This table lists the operators configured in Pega Agile Studio and their associated access groups,
access roles, and portal. Passwords are set to install. You can use them as models and starting points
to assess your resource needs and add your own project resources.
If you are connecting Pega Agile Studio to a 5.5, 6.1, or 6.2 development environment, the operator
IDs must be identical in Pega Agile Studio and the development system in order to correctly pull the
user’s Pega Agile Studio worklist into Designer Studio.
Operator ID Access Group Access Role Portal
AgileStudioSysAdmin AgileStudio:SysAdmin PegaProjectMgmt:SrProjectManager Developer
Operator privileges
Sample operators are configured with a set of privileges that are associated with their access role.
The privileges define the processing actions that type of operator has security to perform and
correspond to actions that display in the Agile Studio menu on the operator's portal and the Actions
menu associated with the processing of project work.
Example: All project resources can view a project and add tasks, but only a Project Manager can
create a project.
To see a list of the actions and privileges for processing functions by operator role, see Operator
privileges by user.
The following tables list the menu actions and privileges that are configured for the sample Pega Agile
Studio users: Senior Project Manager (SPM), Project Manager (PM), Lead Architect (LA), and System
Architect (SA). There is also a separate Access Group and Access Role configured for each user.
Use the tables in this topic to help determine the access group and roles you want to assign your
resources based upon the functionality you want them to have the security to perform.
Operator privileges are associated with the actions that display on the menus accessed by the user.
Create menu
When a privilege or action is available, the option displays on the Create menu of the user portal.
Action Category Action Privilege Name SPM PM LA SA
Create
Product AddProduct x
Project CreateProject x x
Epic AddEpic x x x x
Issue AddIssue x x x x
Feedback AddFeedback x x x x
Backlog CreateBacklog x x
Maintain MaintainResources x x
Resources
Maintain MaintainEnvironmentData x x
Environment
Data
Bulk BulkProcessAssignments x x
Processing tab
on Resources &
Workbaskets
option
View
Products x x x x
Releases x x x x
Goals x x x x
Epics x x x x
Projects x x x x
Backlogs x x x x
Feedback x x x x
Resources & x x x x
Workbaskets
The following tables lists the flow and local action privileges assigned to the Pega Agile Studio work
types, as well as the sample operators who have been given the security to perform those actions.
Products (PRD)
Action Privilege Name SPM PM LA SA
Add product AddProduct x
Releases (RLS)
Action Privilege Name SPM PM LA SA
Add release AddProductVersion x
Goals (GOAL)
Action Privilege Name SPM PM LA SA
Add goal AddGoal x
Epics (EPIC)
Action Privilege Name SPM PM LA SA
Add epic AddEpic x x x x
Reassign ReAssign x x x x
Sprints (SPR)
Action Privilege Name SPM PM LA SA
Edit Edit x x x x
Resolve Resolve x x x x
Reassign ReAssign x x x x
Withdraw Withdraw x x x x
Backlogs (BL)
Action Privilege Name SPM PM LA SA
Edit Edit x x x x
Resolve Resolve x x x x
Tasks (TASK)
Action Privilege Name SPM PM LA SA
Create/add task CreateNewTask x x x x
Reassign ReAssign x x x x
Bugs (BUG)
Action Privilege Name SPM PM LA SA
Enter/add bug EnterBug x x x x
Reassign ReAssign x x x x
Issues (ISSUE)
Action Privilege Name SPM PM LA SA
Enter/add issue EnterIssue x x x x
Reassign ReAssign x x x x
Feedback (FDBK)
Triage Triage x x
Reject Reject x x
Edit Edit x
Reassign ReAssign x x x x
Integration
Integrating with external systems
User: System Administrator
Pega Agile Studio contains a collection of SOAP and REST services that you can use to build and
support integration with an external application to push and pull information to and from the
application. For technical details on available Agile Studio services, see Integrating Agile Studio with
Other Applications.