Integrate Clarity PPM Timesheets in Agile Central

ccppmop157
Users can complete their 
Clarity PPM
 timesheets directly inside Agile Central by adding the PPM Timesheet app.
(On-Premise only)
Enable https for your 
Clarity PPM
 product environment. See 
Application Server Properties
 in Clarity PPM System Administration (CSA).
(SaaS only) 
You can also configure SSO for the timesheet integration feature in an integration between Clarity PPM and CA Agile Central SaaS. See 
Configure SSO for Clarity PPM Timesheet Integration with Agile Central
 below.
 
 
3
 
2
 
 
Complete the Prerequisites
In 
Clarity PPM
, complete the following prerequisites for integrating 
Clarity PPM
 timesheets with Agile Central.
 
 
Follow these steps:
 
  1. Install the Agile add-in and configure the integration with Agile Central. 
  2. Click 
    Administration
    General Settings
    System
     
    Options
    .
  3. In the 
    New User Experience
     section, select the following options:
    • Activate New User Experience
    • Activate Timesheets
  4. To allow resources to access their 
    Clarity PPM
     timesheets from 
    CA Agile Central
    , complete the following tasks::
    • Grant the
       Timesheet - Navigate
       access right to the resource.
       
       
    • Click 
      Home
      Resource Management
      Resources
      . Click a resource and select 
      Properties
      Settings
      . Set the following options for the resource as shown in the image.
      • Select the 
        Active
         checkbox.
      • Set the 
        Track Mode
         to 
        PPM.
         
      • Select 
        Open for Time Entry
        .
         
         
  5. Enable the following settings in the assigned project for each resource:
    • Set the 
      Track Mode
       to 
      PPM
       
    • Select 
      Open for Time Entry
       
     Users (resources) can complete only their own timesheets. They cannot cannot search, fill, or approve the timesheets for other resources.
(SaaS Option) Configure SSO for 
Clarity PPM
 Timesheet Integration with Agile Central
You can configure SSO for the timesheet integration between 
Clarity PPM
 and Agile Central in a SaaS environment. Implementing SSO allows the users (for example, developers or product owners) between the two products to access either application without having to log in a second time.
For example, Mike, a product owner logs into CA Agile Central to review the product backlog and wants to record time while remaining in this application. Mike wants to access the My Timesheets feature in 
Clarity PPM
 without having to log in again.
Users that have logins for both Agile Central and 
Clarity PPM
 are able to log in to either application using SSO.
 If you are using SSO to authenticate to 
Clarity PPM
, contact your SSO team for the custom URL that they use to access 
Clarity PPM
 in a SaaS environment. The following is an example of a custom URL:
https://mycompany.my.idpname.com/run?appkey=12345678-12345678&customerID=XXXXXXXX&relayState=https://ondemand.ca.com/fedsso?targetUrl=https://cppm1234.ondemand.ca.com
The first part of the URL takes you to your identity provider (IdP) for authentication:
 
https://mycompany.my.idpname.com/run?appkey=12345678-12345678&customerID=XXXXXXXX
After authentication is complete, the end part of the URL tells you where to land in 
Clarity PPM
 (for example, the homepage):
https://cppm1234.ondemand.ca.com
Use the above custom URL to first configure the Referrer URL in 
Clarity PPM
 and then the Timesheet Path in Agile Central.
Configure SSO in 
Clarity PPM
 
The following procedure describes how to configure an integration record for 
Clarity PPM
 and Agile Central
.
 
  1. Click 
    Administration
    General Settings
    Integrations
    .
  2. If an integration already exists for 
    Clarity PPM
     and Agile Central, complete the following steps:
    1. Open the existing integration record and verify that the
       Integration URL
       field points to the Agile Central server. For example, .
    2. In the
       Referrer URL
       field, enter the source URL from where the request is coming into PPM. The Referrer URL can be the same as your IdP URL (for example, ). Sometimes, the IDP can have another URL that becomes the source before reaching PPM. In this case, enter the other URL as the source URL for the Referrer URL.
  3. If an integration instance between 
    Clarity PPM
     and Agile Central does not exist, complete the following steps:
    1. Create the integration by entering the required values.
    2. In 
      Integration URL
       field, enter the URL for the CA Agile Central server. For example, .
    3. In the 
      Referrer URL
       field, enter the source URL from where the request is coming into PPM. The Referrer URL can be the same as your IdP URL (for example, ). Sometimes, the IDP can have another URL that becomes the source before reaching PPM. In this case, enter the other URL as the source URL for the Referrer URL.
  4. Verify that the CA Agile Central users are set up in CA PPM so that they can access PPM timesheets.
 
Configure SSO in Agile Central
 
The following procedure describes how to expose 
Clarity PPM
 timesheet on a Agile Central page.
  1. From the 
    Settings
     icon for a page, select 
    Add App
    .
  2. Search for "PPM Timesheet" and select 
    Add App
     to add the app to your pages.
  3. From the settings icon for the app, select 
    Edit App Settings
    .
  4. Configure the following settings:
    •  
       
      Clarity PPM
       Host Name
      . In a non-SSO environment, enter the 
      Clarity PPM
       server URL. In an SSO environment, enter the first part of the URL that takes you to your IdP for authentication.
      Example: 
      https://<mycompany>.<myidpname>.com
       
    •  
       
      Clarity PPM
      Port (HTTPS). 
      In a non-SSO environment, enter the CA PPM server port number. In an SSO environment, enter the IdP port number.
    •  
       
      Clarity PPM
      Timesheet Path
      . In a non-SSO environment, you are not required to enter the timesheet path. In an SSO environment, enter the part of the URL (after the IdP URL) that takes you to the PPM home page. You can append the path to take the user directly to the timesheet page. See the following example:
      run?appkey=12345-123458&customerID=XXX&relayState=
      https://ondemand.ca.com/fedsso?targetUrl=https://cppm1234.ondemand.ca.com/pm/integration.html
       
       
Add the PPM Timesheet App from the App Catalog
A PPM Timesheet app is available for you to add and configure as illustrated in the following image:
 
This image shows how you can add the pre-built PPM Timesheet app in CA Agile Central.
 
Open Your 
Clarity PPM
 Timesheet Inside Agile Central
As a team member, you can access your CA PPM timesheet directly from CA Agile Central.
 
Follow these steps:
 
  1. Log in to 
    CA Agile Central
    .
  2. Navigate to the 
    PPM Timesheet
     app.
  3. If you are in a non-SSO environment, in the 
    Clarity PPM
     login window, enter your login credentials and click 
    Login
    . If you are in an SSO environment, you do not need to log in again.
    Your CA PPM timesheet appears.
  4. You can create, fill-in, and submit your timesheet.
    The following image shows a user creating their new 
    Clarity PPM
     timesheet from inside 
    CA Agile Central
    .  
     
    The following image displays a sample CA PPM Timesheet accessed from CA Agile Central.
     
 After you log in to the 
Clarity PPM
 timesheet page from 
CA Agile Central
, you can only view your timesheet. No other CA PPM pages are available.