Integrate Clarity PPM Timesheets in Agile Central

Users can complete their cappm timesheets directly inside Agile Central by adding the PPM Timesheet app.
ccppmop1551
Users can complete their
Clarity PPM
 timesheets directly inside Agile Central by adding the PPM Timesheet app.
Enable https for your 
Clarity PPM
 product environment. See 
Application Server Properties
 in Clarity PPM System Administration (CSA).
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.