Welcome to the Cyara Knowledge Center

Rally is an Agile Planning and Test Management platform where Cyara failures can be fed as a defect for easier Defect Tracking purposes.

1. Click Toolbox > Integrations .
2. Click New Integration.
3. Select Rally from the Type dropdown list.
4. Enter a Name and a Description for the integration.
5. Select a User Account to access the Cyara REST API in the Impersonate User field.
   
   
6. In the Rally Details section, enter the API URL and Incident Portal URL of your Rally instance, and the authentication details for the REST request in the Username and Password fields.
   Ensure you include the {id} tag in the URL in the following format to include the Rally instance.

   https://rally1.rallydev.com/#/{projectId}/defects?detail=/defect/{id}

   Note: These URLs are specific to your own Rally Account and setup, also make sure to include {id} and {projectId} tags in the URL.
7. Generate your Rally API User Token by clicking the API Keys menu in your Rally instance and selecting Create API Key.
   
   Select Full Access and click Create. You will be presented with a new API Key.
8. Click Test Authentication to confirm that your API User Token and User Account credentials are working correctly.
9. In the Field Selection section, either click New Rally Field to create a pre-formatted field mapping for a set Rally field or click New Custom Field to create a new customizable field. The following table contains the default list of fields available in Rally.

   Parameters	Configurable
   API Token	Yes
   Incident URL	Yes
   Incident Portal URL	Yes
   Project	Yes - This has to be a choice field if it needs to be done through Cyara Alarm Else a Lookup Field for regular defect integration
   Tags	Yes
   Iteration	Yes
   Description	Yes
   Name	Yes
   Notes	Yes
   User Story	Yes (Known Issue: All user stories in the project will get loaded irrespective of the iteration selection)
   Test Cases	Cannot be mapped: A known issue that will be addressed in a future release.
   Owner	Cannot be mapped: A known issue that will be addressed in a future release.

   Additionally, you can create Custom Fields to map to Rally. The following table contains the additional custom field configuration available for the Cyara-Rally integration.

   Custom Field Display Name	Rally Field Name	Field Type	Rally Field Value
   Priority	Priority	Choice	None,Normal,Low,High Attention,Resolve Immediately
   Severity	Severity	Choice	None, Minor Problem, Major Problem, Crash/Data Loss, Cosmetic
   State	State	Choice	Submitted,Fixed,Closed,Open
   Environment	Environment	Choice	None,Development,Test,Staging,Production
   Scheduled State	ScheduleState	Choice	Defined,In-Progress,Accepted,Completed
   Resolution	Resolution	Choice	None, Architecture, Code Change, Configuration Change, Database Change, Duplicate, Need More Information, Not a Defect, Software Limitation, User Interface
   TargetDate	TargetDate	Single line text	2020-11-20
   FixedInBuild	FixedInBuild	Single line text	Test20.0.1
   TargetBuild	TargetBuild	Single line text	Test20.0.1
   VerifiedInBuild	VerifiedInBuild	Single line text	Test20.0.1
   FoundInBuild	FoundInBuild	Single line text	Test20.0.1
   PlanEstimate	PlanEstimate	Single line text	5
   SalesforceCaseID	SalesforceCaseID	Single line text	123
   SalesforceCaseNumber	SalesforceCaseNumber	Single line text	232652d
   Blocked	Blocked	Choice	true,false
   BlockedReason	BlockedReason	Single line text	Testing
   Ready	Ready	Choice	True, false Note: Ready and Blocked status can’t be set to true at the same time

   1. Specify a property name to send to Rally in Field Name.
   2. Enter a display name for this field in Display Label. This name is displayed when the user creates an incident.
   3. Select the type of field in Type. The options are: Constant, a Choice for multiple fixed values. or a Single Line Text or MultiLine Text input or a Lookup for values built using an API call.
   4. In Field Value, specify the constant value or template for the value to send to the external service. For a Choice field, use a comma separated list of values, the first being the default.
   5. The checkboxes allow you to configure field properties such as Required, Read-Only and Overridable.
   6. Click Add Field to add the new field to the Field Selection table.
10. Click Save Details to save your changes, and Enable the integration using the toggle in the top right corner of the Integrations screen.
    Note: As mentioned above, there are known issues with the current version of the Cyara Rally Integration, where User Stories, Test Cases, and Owner fields are not being mapped correctly. These issues will be addressed in a future release.