Integrate Clarity PPM Timesheets in Rally

ccppmop158
Users can complete their
Clarity PPM
timesheets directly inside Rally 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 Rally SaaS. See
Configure SSO for Clarity PPM Timesheet Integration with Rally
below.
3
2
Complete the Prerequisites
In
Clarity PPM
, complete the following prerequisites for integrating
Clarity PPM
timesheets with Rally.
Follow these steps:
  1. Install the Agile add-in and configure the integration with Rally.
  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
    , 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 Rally
You can configure SSO for the timesheet integration between
Clarity PPM
and Rally 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 Rally 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 Rally 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 Rally.
Configure SSO in
Clarity PPM
The following procedure describes how to configure an integration record for
Clarity PPM
and Rally
.
  1. Click
    Administration
    ,
    General Settings
    ,
    Integrations
    .
  2. If an integration already exists for
    Clarity PPM
    and Rally, complete the following steps:
    1. Open the existing integration record and verify that the
      Integration URL
      field points to the Rally 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 Rally 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 Rally 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 Rally users are set up in CA PPM so that they can access PPM timesheets.
Configure SSO in Rally
The following procedure describes how to expose
Clarity PPM
timesheet on a Rally 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
      Relative Path
      . In a non-SSO environment, you are not required to enter the path. In an SSO environment, enter
      /pm/integration.html
      , which is the relative path to the integration URL.
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 Rally
As a team member, you can access your CA PPM timesheet directly from Rally.
Follow these steps:
  1. Log in to
    .
  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
    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
, you can only view your timesheet. No other CA PPM pages are available.