Agile Requirements Designer

 View Only

Tech Tip: ALM Limitation with Title Length and Special Characters

  • 1.  Tech Tip: ALM Limitation with Title Length and Special Characters

    Posted Oct 16, 2017 02:35 PM

    This document can also be viewed here: 



    When trying to export test cases from Agile Requirements Designer to ALM, I am receiving errors such as 'ALM has failed' and 'Bulk operation failed'. 



    alm has failed.png



    Steps to reproduce the issue:

    1. Using example flow 'Make Tea' from C:\Program Files\Grid-Tools\AgileDesigner\examples, I modified the flow to have new block titles.
    2. From the Path Explorer, I generated test cases and stored them successfully.
    3. I then connected to HP Application Lifecycle Management connector and logged in. 
    4. I clicked the 'Setup Configuration' button and ensured mappings were correct 
    5. In the Path Explorer again, I exported the test cases to HP ALM. 

    make tea with question marks.png

    CA Agile Requirements Designer (ARD)- Agile Designer + HP ALM Application Lifecycle Management

    The root cause of this issue was an ALM limitation in not accepting certain special characters in the Title/Test Case Name field. For example, ?,'/!
    The reason you do not received a message with this information specifically is because the ALM APIs are limited and do not provide a sufficient error message for the problem. 

    You may also receive this error message if your Title/Test Case Name is too long. There is a character limit in ALM which can be increased or decreased by your ALM administrator. 

    We found the issue by copy/pasting the test case name into the Title field in ALM. If you test the title names from within ALM, you will receive a specific error message.


    Development is currently working on an enhancement to improve this ALM limitation. In the meantime, here are some workarounds that can be used:

    Option #1 
    - When creating new test cases, do not add any special characters in the 'Name' field, but instead add them in the 'Description' field. 
    - For example: 
    Name: Have Water 
    Description: Have Water? 



    test case description with special character.png




    Option #2 
    - Before exporting your test cases in Path Explorer, remove the special characters from the test case name. 



    alm test case name.png

    alm path name.png



    Option #3: 
    - In your ALM mappings/configuration, under the Description field's AgileDesigner Field Name, change the drop down option to 'Description of Blocks'. 
    - When you export to ALM, in the description field, you will see all the titles/names of blocks as is with the special characters included. 
    - This will not be in the main title in ALM, but at least the real titles with special characters will be available in ALM.



    alm mapping description of blocks.png

    Additional Information:

    If you experience any further, please open a support case by going to or calling one of these numbers