Create Parser Templates

Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-user-guide/zephyr-test-automation/parser-templates/create,-edit-and-delete-templates/create-parser-templates.html

Request

To create a parser template, send the following API request to your Zephyr server: 

POST http(s)://{your-zephyr}/flex/services/rest/latest/parsertemplate 

where your-zephyr is the host name or IP address of your Zephyr server.

The request body should look like this:

{ "name": "My custom parser", "jsonTemplate": "[{ status: \"${testsuite.testcase.failure}\", stepText: \"${testsuite.testcase.failure}${testsuite.testcase.system-out}\", statusExistPass: false, statusString: null, statusFailAttachmentText: \"${testsuite.testcase.failure:message}\", statusPassAttachmentText: \"classname: ${testsuite.testcase:classname} name: ${testsuite.testcase:name} time: ${testsuite.testcase:time}\", packageName: \"${testsuite.testcase:classname}\", skipTestcaseNames: \"\", testcase: { name: \"${testsuite.testcase:name}\" }, requirements: [ { id: \"${testsuite.testcase.requirements.requirement}\" } ], attachments: [ { filePath: \"${testsuite.testcase.attachments.attachment}\" } ] }]" }

This JSON object has two top-level properties: 

Response

The Zephyr response will look like this -- 

{ "id": 101, "name": "My custom parser", "jsonTemplate": "[{ \"status\": \"${testsuite.testcase.failure}\", \"stepText\": \"${testsuite.testcase.failure}${testsuite.testcase.system-out}\", \"statusExistPass\": false, \"statusString\": null, \"statusFailAttachmentText\": \"${testsuite.testcase.failure:message}\", \"statusPassAttachmentText\": \"classname: ${testsuite.testcase:classname} name: ${testsuite.testcase:name} time: ${testsuite.testcase:time}\", \"packageName\": \"${testsuite.testcase:classname}\", \"skipTestcaseNames\": \"\", \"testcase\" : {\"name\": \"${testsuite.testcase:name}\"}, \"requirements\": [ {\"id\": \"${testsuite.testcase.requirements.requirement}\"} ], \"attachments\": [ {\"filePath\": \"${testsuite.testcase.attachments.attachment}\"} ] }]", "isDeleted": false, "isDefault": false, "isSbAutomationTool": false, "createdBy": 1, "createdOn": 1581580703992 }

Here --

  • id – An identifier that Zephyr assigned to the template. You will use it to specify a template you want to edit or delete. 

  • jsonTemplate – The template contents (see Parser Template Syntax). 

  • isDeleted – Indicates whether the template has been deleted or not. 

  • isDefault – true if a template is a pre-configured request, or false if it is a user-defined request.  

  • isSbAutomationTool – Reserved for internal use.

  • createdBy – The id of the user who created the template. 

  • createdOn – The creation timestamp. 

Note

A template becomes available right after you created it. All the templates are available for your entire organization in Zephyr. 

See Also

Create, Edit and Delete Parser Templates

Parser Templates

Parser Template Syntax