Versions Compared

Key

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

...

UI Tabs
UI Tab
titleDocument Generator Add-in
UI Text Box
Let's learn how to add Document Generator Add-in to Microsoft!


Multimedia
nameS - Document Generator - Microsoft Add-in.mp4
width100%
height40%

(Video Description: How to add Document Generator Add-in to Microsoft)

UI Tab
titleEdit an existing Template
UI Text Box
Let's see how we can edit an existing template!


Xray offers a variety of report types, yet you might find the need to customize them. If so, you’re welcome to:


UI Steps
sizesmall
UI Step

Navigate into "Jira Admin Settings" and to "Document Generator" under Xray settings

UI Step

From any listed report, on the far right of each line click the button and select "Download" for the report you want to change


Multimedia
nameS - Document Generator - Download an existing Report.mp4
width100%
height40%

(Video Description: How to download an existing report)


You now have the ability to open the report in Word or Excel and make modifications using our add-in. Furthermore, without the help of our add-in, you can also make edits using any other document editor of your choice.


UI Tab
titleCreate a New Template
UI Text Box

Let's see an example of how to create a new template.


As an example, we will demonstrate using the Xray Add-in with Word.


UI Steps
sizesmall
UI Step
Start with either a blank document or a company template, and set the layout to either portrait or landscape.
UI Step
Craft a header for your document, and with the help of the Xray Document Generator add-in, insert the specified fields. You’re welcome to add your company logo if you wish.
  • Project Name: ${ProjectName}
  • Prepared by: ${Assignee}
  • Document Date: %{(new Date()).getDate() + "/" + ((new Date()).getMonth()+1) + "/" + (new Date()).getFullYear()}
UI Step
Give a title to your report, in our case "List of TestRuns Covering the Requirement"
UI Step
In this example, we’ll be creating a table that includes only the headers for the following seven fields:
  • Key
  • Execution Status
  • Executed by
  • Start Date
  • End Date
  • Defect Count
  • Comment
UI Step

You can now add the following fields under your table header in your document, using the snippets provided by our Xray Document Generator Add-in. The code below serves as a guide. Don’t hesitate to explore beyond what’s provided if you’re feeling adventurous.


Tip

#{for Tips} Using our Xray Document Generator Add-in, go to “Xray Entities” and load any of them into your document. These entities display the fields that you can fill in your document. #{end}


Code Block
languagetext
themeFadeToGrey
titleSnippets from Xray DG
collapsetrue
&{for issues}

#{for a=TestRunsCount}

${TestRuns[a].Key}	${TestRuns[a].Execution Status}	${TestRuns[a].Executed By}	${TestRuns[a].Started On}	${TestRuns[a].Finished On}	${TestRuns[a].ExecutionDefectsCount}	${TestRuns[a].Comment}

#{end}

&{end}


UI Step

After completing the above steps, go ahead and give it a name, then save your work!


UI Expand
titleFind an example of a Template

View file
nameTemplate Example.docx
height150


UI Tab
titleSingle Test Run
UI Text Box
Let's upload the newly created examples and use them for a single Test run
UI Tab
titleMultiple Test Run
UI Text Box

Let's upload the newly created examples and use them for multiple Test run

...