Integrate CA PPM Timesheets Inside CA Agile Central

Users can complete their CA PPM timesheets directly inside CA Agile Central by adding the PPM Timesheet app.
ccppmod152
Configure CA PPM Timesheet from 
CA Agile Central
Users can complete their CA PPM timesheets directly inside CA Agile Central by adding the PPM Timesheet app.
Complete the Prerequisites
In 
CA PPM
, complete the following prerequisites for integrating CA PPM timesheets with CA Agile Central.
Follow these steps:
  1. Install the Agile add-in and configure the integration with CA Agile Central. See Configure the Integration for details.
  2. Select 
    Administration
    General Settings
    System
     
    Options
    . In the 
    New User Experience
     section, select the following options:
    • Activate New User Experience
    • Activate Timesheets
  3. To allow resources to access their CA PPM timesheets from CA Agile Central, complete the following tasks:
    • Grant the
       Timesheet - Navigate
       access right to the resource.
       
    • Select 
      Home
      Resource Management
      Resources
      . Click a resource and select 
      Properties
      Settings
      . Set the following options for the resource.
      • Select the 
        Active
         check box.
      • Set the 
        Track Mode
         to 
        PPM.
      • Select 
        Open for Time Entry
        .
  4. Set 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.
Configure SSO for CA PPM Timesheet Integration with CA Agile Central
You can configure SSO for the timesheet integration between 
CA 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 CA PPM without having to log in again.
Users that have logins for both CA Agile Central and CA PPM are able to log in to either application using SSO.
If you are using SSO to authenticate to CA PPM, contact your SSO team for the custom URL that they use to access CA 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 as shown below 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 as shown below tells you where to land in CA PPM (the homepage):
https://cppm1234.ondemand.ca.com
Use the above custom URL to first configure the Referrer URL in CA PPM and then the Timesheet Path in Agile Central.
Configure 
CA PPM
The following procedure describes how to configure an integration record for CA PPM and CA Agile Central
.
  1. Select 
    Administration
    General Settings
    Integrations
    .
  2. If an integration already exists for CA PPM and CA Agile Central, complete the following steps: 
    1. Open the existing integration record and verify that the
       Integration URL
       field points to the CA Agile Central server. For example, 
      https://rally1.rallydev.com
      .
    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, 
      https://mycompany.my.idpname.com
      ). 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 CA PPM and CA Agile Central does not exist, complete the following steps:
    1. Create the integration by entering the required values. See Configure the Integration for details.
    2. In 
      Integration URL
       field, enter the URL for the CA Agile Central server. For example, 
      https://rally1.rallydev.com
      .
    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, 
      https://mycompany.my.idpname.com
      ). 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 Timehsheet. See Complete the Prerequisites for details.
Configure CA Agile Central
The following procedure describes how to expose CA PPM timesheet on a CA 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:
    • CA PPM Host Name
      . In a non-SSO environment, enter the CA PPM server URL. In a SSO environment, enter the first part of the URL that takes you to your IdP for authentication. For example, 
      https://<mycompany>.<myidpname>.com
      .
    • CA PPM Port (HTTPS). 
      In a non-SSO environment, enter the CA PPM server port number. In a SSO environment, enter the IdP port number. 
    • CA PPM Timesheet Path
      . In a non-SSO environment, you are not required to enter the timesheet path. In a 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=12345678-12345678&customerID=XXXXX&relayState=https://ondemand.ca.com/fedsso?targetUrl=https://cppm1234.ondemand.ca.com/pm/integration.html
Configure PPM Timesheets From 
CA Agile Central
You can view and fill your timesheets directly from 
CA Agile Central
This feature is not available for CA PPM On Premise and CA PPM SaaS when using SSO. This feature is also not supported if CA PPM On Demand is used with the CA On Demand Portal.
Follow these steps:
  1. Log in to CA PPM as the administrator.
  2. Verify that agile add-in is installed. See the Configure the CA Agile Central Integration section.
  3. Navigate to the Integrations page from the Administration menu and verify the integration settings. See Configure the CA Agile Central Integration section.
  4. Verify that in the System
     
    Options, under the New User Experience section, 
    Activate New User Experience
     and 
    Activate Timesheets
     fields are enabled.
  5. As an admin, you can give any resource the access to view timesheets from CA Agile Central. Verify that the resource has Timesheets-Navigate right, to view timesheets.
     
  6. Verify that in the Time Tracking section for the resource, the following settings are enabled:
    • Track Mode
       - set as PPM
    • Open for Time Entry
       - checkbox is selected
  7. Navigate to Settings, Properties of the resource. Verify that the 
    Active
     field is enabled under the 
    General
     section.
    image2017-1-19 12:41:41.png
  8. Verify that the resource or the login user who wants to access timesheets belongs to a Project with the following settings enabled:
    • Track Mode
       -  set as PPM
    • Open for Time Entry
       - field is enabled
    As a resource, you can fill only your timesheets. You cannot search for, fill, and approve the timesheets of other resources.
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.
Access CA PPM Timesheets from CA Agile Central
As a team member, you can access your CA PPM timesheets directly from CA Agile Central.
This feature is not available for on-premise or SaaS configurations using SSO. This feature is also not supported if CA PPM On Demand is used with the CA On Demand Portal. 
Follow these steps:
  1. Log in to 
    CA Agile Central
    .
  2. Create a custom app for timesheets. See Extend CA Agile Central With Apps and PPM Timesheets Integration with CA Agile Central. A predefined PPM Timesheet app is also available in the App Catalog.
  3. Navigate to the custom app that you created for viewing CA PPM timesheets.
  4. In the CA PPM Login window, enter your login credentials and click Login.
    Your PPM timesheets appear.
  5. You can create, enter time, and submit your timesheets. The following image displays a sample CA PPM timesheet in a custom app on a CA Agile Central page. 
    The following image displays a sample CA PPM Timesheet accessed from CA Agile Central.
After you log in to the CA PPM Timesheet page from CA Agile Central, you can only view your timesheets. No other CA PPM pages are accessible from inside the custom app iframe.