Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Once the TFS connection has been created (see External Systems), you can begin associating projects in TFS with projects in Enterprise Tester. Project links can be created and managed either from the Resources tab on your tree view navigator or on the External System Links tab.

External System Links Tab

From the Admin tab, Expand Extensions and double click on External Systems.  From the External Systems summary grid, double click the External System you wish to create a link for.  Then navigate to the Links tab. Click on Add from the tool bar.

 

The Add External System Link screen will appear.  Complete the name and select the Link Source.  This is the entity type you wish to synchronize.

...

Once you have selected the Source, additional fields to configure the ET project and the TFS project will appear.

...

Once you have completed the screen click on OK.  The External Links Details screen will appear.  See the Field Configuration section below. 

Resources Tab

From the Resources Tab tab, click to expand "Project Links". To view all configured links for your project, double click on your project.

...

To create a new project link select "New" from the toolbar or from the navigator you can right click on your project and select "Add New Project Link" from the menu or from the navigator you can right click on your project. Complete the details selecting the TFS connection that you created in the steps outlined in the above section, and your TFS project to link to. Now click on 'Save'.

Once the project link to TFS has been created, Enterprise Tester will initiate a refresh of all the metadata. This may take a few minutes.

Field Configuration

Once the refresh look up completes Refresh Lookups completes the next step is to configure Enterprise Tester inbuilt fields to TFS fields.

...

When a project link is created a refresh lookups Refresh Lookups kicks off.  This process finds all the TFS field values for your project to populate the picklist (select list) for this screen.  If you do not see any TFS values in the drop down list or an incomplete list is presented, click on Refresh Lookups to update the picklist values.

Field Configuration - Mappings

On the mappings Mappings tab, the Synchronize Entities option is pre-selected. The selection of this option will ensure that incident and tasks are synchronized.  If the Synchronize Entities is not selected, then only the Tasks will run. See the Task section for more detail.

This screen displays two tabs for outlining and configuring the steps undertaken when synchronization is initiated.

...

The Map Fields activity is the only configuration you will need to complete on this screen.  Note that it is the only activity that displays false in the Configured column. To configure the field mappings, click to select Map Field and click Config from the toolbar.

The Configure Field Mappings screen will appear and all ET inbuilt fields have pre-set mapping to TFS inbuilt fields.

...

  1. To complete the field mappings, click on the field row and select Edit from the tool bar.
  2. Complete mapping Enterprise Tester field values to TFS field values.  Where picklist values in ET and TFS are exact matches,  the mappings will be automatically configured.
  3. Click Save Changes.
  4. Complete mapping field values for all fields following steps 1-3.

...

Note that all activities are pre-configured including the Map Fields activity. To view the fields that are pre-configured to synchronize, click on Map Field and then click Config from the toolbar.

The Configure Field Mappings screen will appear and a number of TFS inbuilt fields have pre-set mapping to ET inbuilt fields.  These are configured as either Copy Field or Automap field type mappings.

...

Adding New Field Mappings - Configuring Custom Fields

Custom Fields can be synchronized from ET.  A little set up is required to selected and configure the fields that you wish to synchronize. 

From the Map Fields screen,  you can add a new field to you synchronization configuration.  To do this click on Add on the Configure Field Mappings screen.

The Add Mapping dialog dialogue will appear.  

Here select the type of mapping you wish to create:

TypeDescription
Automap Field

Automap Field mapping will automatically map all matching field values in ET and TFS so that it is not necessary to do this manually.

In addition when synchronizing in the TFS to ET direction, new field values detected on synchronize from your external system (TFS) will be added to the ET field value picklist if they don't already exist. Using this type of field mapping eliminates duplicate field management in TFS and in ET. It will also allow incident synchronization to complete even when map values already exist. This type of mapping is useful for fields like Versions and Components which tend to continually grow.

This type of mapping should be used when your picklist values in ET and TFS are the same.

Supported field types include, Combo box (select lists), multiselect list, radio button groups and checkbox groupsMultiselect List, Radio Button Groups and Checkbox Groups.

*Note: that this feature does not synchronize the picklists between TFS and ET but it does add values to the ET picklists when new values are detected on incidents during synchronization.
**Note: automapping of components and versions from ET to TFS are supported as well. 

Copy FieldCopy field will copy the text from your TFS issue to the mapped field in ET. This is recommended when synchronizing text fields.
Set Field to Value

Set field to value field mapping allows you to specify a value to populate the field in ET with regardless of the values in TFS.

All Field types are supported.

Set Field to Value (if it's null or empty)

Set field value field mapping allows you to specify a value to populate the field in ET with, if the field does not currently have a value set/is null.

All Field Types are supported.

This mapping type is useful for setting a default value, if the value was not populated by a previous mapping (and so when used in this way, the mapping should appear at the bottom of the list of field mappings). 

Map Field

The Map field option allows you to manually map the field values in ET with those of TFS. This is useful when your your picklist values in TFS are different to your picklist values in ET.

ET will automatically map any exact value matches when first displaying the mapping configuration screen.

Supported field types include: Combo box (select lists), multiselect list, radio button groups and checkbox groups.

...

In addition to synchronizing requirements and incidents between TFS and ET you can also set up tasks to synchronize picklist field values.  A good example of when this would be useful are the fields Versions and Components.  

Versions and components Components are normally being added to over time - and this can be a burden to then have to replicate these changes in Enterprise Tester manually.

A good way of managing the consistency of of the field values in TFS with the field values in ET is to set up a task to update the full list of picklist values on synchronization.  This will ensure that your picklist values are always up-to-date with the field value list in TFS without having to manually manage the task.

...

This feature supports both inbuilt and custom fields. The following field types are supported: combobox Combobox (single select list), multiMulti- select list, checkbox group, radio button groupSelect List, Checkbox Group,Radio Button Group.

To set up a picklist synchronization task. Navigate to the Task tab on your project link configuration screen.

Click on Add from the toolbar and enter in a name for your task and click OK.

Next, select your TFS Field and your ET Field and click on Save.

 

The task is then created, and is displayed in the tasks grid.

...