Integrate
Clarity
Timesheets in Rally

ccppmop1581
Users can complete their timesheets directly inside Rally by adding the Timesheet app.
(On-Premise only)
Enable https for your
Clarity
product environment. See
Application Server Properties
in
Clarity
System Administration (CSA)
.
(SaaS only)
You can also configure SSO for the timesheet integration between
Clarity
and Rally SaaS. See
Configure SSO for
Clarity
Timesheet Integration with Rally
below.
3
2
Complete the Prerequisites
In
PPM (klassisch)
, complete the following prerequisites.
Follow these steps:
  1. Install the Agile add-in and configure the integration with Rally.  For more information, see Integrate
    Clarity
    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 timesheets from
    Rally
    , 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:
      • Select the
        Active
        checkbox.
      • Set the
        Track Mode
        to
        PPM.
      • Select
        Open for Time Entry
        .
  5. To allow resources to enter time against a project, open the project and go to the
    T
    eam
    tab. Enable the following settings in the
    Properties, Settings
    page of each resource:
    • Set the
      Track Mode
      to
      PPM
    • Select
      Open for Time Entry
    Users (resources) can complete only their own timesheets. They cannot search, fill, or approve the timesheets for other resources.
(SaaS Option) Configure SSO for Timesheet Integration with Rally
You can configure SSO for the timesheet integration 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
without having to log in again.
Users that have logins for both Rally and
Clarity
are able to log in to either application using SSO.
If you are using SSO to authenticate to
Clarity
, contact your SSO team for the custom URL that they use to access
Clarity
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
(for example, the homepage):
https://cppm1234.ondemand.ca.com
Use the above custom URL to first configure the Referrer URL in
Clarity
and then the Timesheet Path in Rally.
Configure
Clarity
for the Timesheet Integration
The following procedure describes how to configure an integration record for
Clarity
and Rally
.
Follow these steps:
  1. Click
    Administration
    ,
    General Settings
    ,
    Integrations
    .
  2. Open the existing integration record and verify that the
    Integration URL
    field points to the Rally server. For example,
    https://rally1.rallydev.com
    .
  3. (SSO Only) 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 created in
    Clarity
    and are given the access rights listed in the prerequisites section on this page. Users will use their
    Clarity
    credentials while accessing the timesheet in
    Rally
    .
Add and Configure the Timesheet App in
Rally
The following procedure describes how to expose the
Clarity
timesheet on a
Rally
page. This integration is enabled by a community app that allows users to enter their Clarity time within
Rally
.
  1. Access the Rally documentation  and follow the steps for adding the Timesheet app.
  2. From the settings icon of the Timesheet app, select
    Edit App Settings
    .
  3. Configure the following settings:
    • PPM Host Name
      . In a non-SSO environment, enter the
      Clarity
      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
    • Port (HTTPS).
      In a non-SSO environment, enter the
      Clarity
      server port number. In an SSO environment, enter the IdP port number.
    • PPM Host Relative Path (for SSO Only)
      . 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.
Open Your
Clarity
Timesheet Inside
Rally
As a team member, you can access your
Clarity
timesheet directly from
Rally
after the integration is configured by your administrators.
Follow these steps:
  1. Log in to
    Rally
    .
  2. Navigate to the
    PPM Timesheet
    app.
  3. If you are in a non-SSO environment, enter your
    Clarity
    login credentials and click
    Login
    . If you are in an SSO environment, you do not need to log in again.
    The timesheet appears.
  4. You can create, fill-in, and submit your timesheet.
    The following image shows a user creating their new
    Clarity
    timesheet from inside
    Rally
    The following image displays a sample Clarity Timesheet accessed from CA Agile Central.
After you log in to the
Clarity
timesheet page from
Rally
, you can only view your timesheet. No other
Clarity
pages are available.
More Information
: