Cobra Integration Wizard Configuration File Settings for a Change Request

This topic outlines the Cobra configuration file settings for a Change Request. These settings ensure that Change Request costs are correctly imported into Cobra. The configuration file is set up using the Cobra Integration Wizard.

To see the required integration file settings for an Excel spreadsheet import, see Step 3: Configure an Import File Integration Configuration in Cobra and review the other Microsoft Excel Integration topics for additional requirements.

Part of the change request process is using Cobra's Integration Wizard, called through the API and web services, to load data from the Open Plan schedule into Cobra. Some of the settings are defined in the wizard and some are overwritten based on options you select on the Change Details on Form tab in Workflow Type Configuration. This allows you to configure options such as how your project is linked to the schedule as well as your change control options. These configurations are set in Workflow Type Configuration for each change request type.

Cobra Process Logs

When you run a process such as the Integration Wizard, Cobra writes error and warning messages to a log. You can view the log from the change request Links tab.

This feature is only enabled if Cobra is configured to write process logs to a file.

For steps on setting this up and for information about the file name, see "Configure Cobra to Write Process Logs to a File".

Warning
If you secure an option in Cobra preferences (Cobra » Project Properties » Preferences tab » Integration Wizard), the setting in the Cobra Integration Wizard configuration is ignored.

To set up the integration file for the change request process using the Cobra Integration Wizard:

  1. In Cobra, click the Integration tab.

  2. In the Import group, click the project to which you are integrating (Open Plan or MS Project).

  3. On the Integration Configuration page, in the Where are you loading the data from? drop-down list, select the product to which you are integrating (Open Plan, Microsoft Project, or Microsoft Project Server.

  4. On the Action Selection page, under the Project Data heading, make the following selections:

  5. On the Project Selection page, PM Compass overrides the Schedule Project and Cobra Project fields based on the project selected in the change request.

    You need to select a project that uses the same field mappings with the schedule as the one you intend to select in the change request. All projects with the same field configuration and schedule mapping can use a single change request type; however, if you have some projects with different configurations (for example, some have three key fields and some have two key fields), you need to create separate integration files and change request types for each project configuration and schedule mapping.

  6. The settings on the Date Selection page are overridden to match what is defined in Workflow Type Configuration.

    You should select to load both budget and forecast as well as Baseline Dates so that the remainder of the Integration Wizard pages allow you to select the proper fields.

  7. Use the Schedule Mapping page to link your project to the schedule based on your configuration settings.

  8. On the Earned Value page, select your preferred settings for how the earned value technique will be created.

  9. On the Resource Assignments page, select Load all budget into default class in the Budget group box for a Budget Change request.

  10. If the Update the Forecast with the Budget Change option on the Change Details on Form tab of Workflow Type Configuration is selected, you must select the options in the Forecast group box.

  11. On the Change Control page, make the following selections:

  12. For A New or Change Amount Workflow Type

    Select Apply historical budget changes as an adjusting entry in the current status period only if you resource load your schedule and you do not want the budget before the current period to change.

    For A Replacement of Existing Time Phased Data Workflow Type

    Select Apply historical budget changes as an adjusting entry in the current status period only if you resource load your schedule and you do not want the budget before the current period to change.

  13. Complete the Integration Wizard to save your configuration.

  14. In PM Compass, enter the configuration file name in the Schedule Integration Configuration field on the Change Details on Form tab of Workflow Type Configuration.

    When the scheduler approves a change request, the Cost System Process step action starts the schedule integration process. The process runs Cobra's API, which calls the Integration Wizard using the file selected in the Schedule Integration Configuration.

Confirm the Configuration Setup

To confirm the configuration is setup correctly:

  1. Create a workflow and select your project.

  2. In the Change Details view, make at least one schedule change.

  3. After approving the change request in Model Changes, click the Links tab of the change request, find the Schedule Integration Process log, and confirm that there are no errors.

  4. Cancel the change request you just created to delete all temporary data and not affect the live projects.

What do you want to do?

Make Cobra projects visible in PM Compass

View the Cobra Process log

Learn about the change management process

Run a Cobra report on a change request


Learn more about...