{"id":844,"date":"2008-03-06T20:41:13","date_gmt":"2008-03-07T04:41:13","guid":{"rendered":"https:\/\/blogs.plm.automation.siemens.com\/t5\/Polarion-Blog\/Exposing-Work-Items-Inside-the-Polarion-Wiki\/ba-p\/380598"},"modified":"2026-03-26T05:31:31","modified_gmt":"2026-03-26T09:31:31","slug":"exposing-work-items-inside-the-polarion-wiki","status":"publish","type":"post","link":"https:\/\/blogs.sw.siemens.com\/polarion\/exposing-work-items-inside-the-polarion-wiki\/","title":{"rendered":"Exposing Work Items Inside the Polarion Wiki"},"content":{"rendered":"

Polarion 3.0.3 Release is out. The new release ships with a hidden but quite interesting improvement of its wiki functionality.
\nThe feature is called “embedding of workitems inside wiki pages”. Instead of simple references you can directly display workitems inside your wiki pages.<\/p>\n

In this blog I want to give you some examples how this functionality can come very handy inside your projects.
\nJust by embedding simple workitem queries in your wiki pages you will be able to create custom specification documents, impact reports or project status reports.<\/p>\n

Lets have a look at the different ways how work items can be embedded.
\n

Embedding via Workitem ID<\/H3>
\nUse this if you want to embed exactly one workitem inside your wiki page.
\nWiki syntax:
\n{wi: ProjectName\/WorkItemId | List of Fields | expand=yes\/no}<\/p>\n

ProjectName(optional): name of project where work item is located. If no one is specified current project name used by default
\nWorkItemId: identifier of work item.
\nfields = List of Fields(optional): list of entries in form FieldName as Type that specifies fields to output. Type can be text, image, image-text. By default the application outputs following fields: id as text, type as image, status as image, severity as image.
\nexpand: if this property is set to yes all specified information about work item is presented below the link<\/p>\n

Example:
\n{wi: MyProject\/WI-245 | description as text, status as text-image, severity as text | expand = no}
\n

Embedding By Query<\/H3>
\nUse this if you want to add multiple items inside your wiki page.
\nThe syntax text is similiar to Polarion Query builder syntax
\n{wi: query=Polarion Query | List of Fields | sortby = Field tablewidth=Width | tableheight = Height | expand=yes\/no}<\/p>\n

Example:
\n{wi: query= type:defect AND (priority:critical OR priority:major) | sortby=created | fields = ID, status as image, severity as image-text, description as text | tablewidth=90% | tableheight=240px}
\n

Creation of custom specification documents<\/H3>
\nIn many cases specification documents consist of some static sections and sections in which you list requirements.<\/p>\n

In following Example I combined both approaches – embedding via workitem ID and embedding by query – to create a simple specification document<\/p>\n

\"fullspecificationpage.gif\"<\/A>
\nAfter some static section at the beginning we list the description of workitem DEMO-1.
\nUsing list as output format( output=list) will display all selected fields below the workitem. I prefer that format because I find it easier to read.
\nExpand is set to yes (expand=yes) so all listed fields (here only description) are expanded already when you open the wiki page.
\nWe could add additional fields inside the fields section seperated by comma (fields = title as text, description as text…)<\/p>\n

\"embeddingoneitem.gif\"<\/A><\/p>\n

In the next section I have added multiple items by query. We have two options here. We can specify a query to filter for specific requirements to be displayed..
\nFor example we could query for all functional requirements with following query: categories.id:functional or
\nfor all requirements in status proposed with following query: status\"Smileyroposed.
\nThe other option is to pick a set of items by id inside our query.
\nI have chosen the latter approach in our example.<\/p>\n

\"embeddingmultipleitems.gif\"<\/A>
\n

Displaying linked testcases to a requirement in a table view<\/H3>
\nYou can easily query for linked testcases to a requirement if you know the id(s) of the requirement.
\nLets say our requirement has the id DEMO-22 and we want to find all testcases linked to it.
\nTo display requirement DEMO-22 we simply embed it by ID. To display linked testcases in the next column we use following trick.
\nAll linked testcases will have a link to DEMO-22. So if we don’t search by id (id\"SmileyEMO-22) but just for the word DEMO-22 we will find all items with the word DEMO-22 inside<\/p>\n

.\"wikiquerylinkedtestcases.gif\"<\/A>
\nAll testcases that link to DEMO-22 will have the word inside the linked work items section.
\nAs we want to list testcases only the complete query will look like this: “type:testcase AND DEMO-22”<\/p>\n

\"linkedtestcases.gif\"<\/A>
\n

Creating Backlog Reports by User<\/H3>
\nIf you want to embed all open items per user for a specific timpoint you can do that simply by following query:
\nstatus\"Smileypen AND timePoint.id:Iter1 AND assignee.id:ron<\/p>\n

\"backlogwiki.gif\"<\/A><\/p>\n

\"backlog.gif\"<\/A>
\n

Manage Project reports<\/H3>
\nCreate a wiki page that displays items of type project report. The project report item contains personal judgement of the project manager about his project
\nIn that way you can aggregate reports of different projects within one wiki page
\n

Manage risks<\/H3>
\nSome requirements should be controlled via risks that are assigned to users for periodical review.
\nCreate a risk page which embeds the risks sorted by different aspects<\/p>\n

I hope the different scenarios gave you some ideas how that feature could be applied within your project.
\nThink about: News pages, project announcements, testplan reports, release notes, glossaries
\nStay tuned for upcoming blogs.<\/p>\n

Best
\nTim<\/p>\n","protected":false},"excerpt":{"rendered":"

Polarion 3.0.3 Release is out. The new release ships with a hidden but quite interesting improvement of its wiki functionality.
\nThe feature is called “embedding of workitems inside wiki pages”. Inste…<\/p>\n","protected":false},"author":68985,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spanish_translation":"","french_translation":"","german_translation":"","italian_translation":"","polish_translation":"","japanese_translation":"","chinese_translation":"","footnotes":""},"categories":[1],"tags":[],"industry":[],"product":[],"coauthors":[],"class_list":["post-844","post","type-post","status-publish","format-standard","hentry","category-news"],"_links":{"self":[{"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/posts\/844","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/users\/68985"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/comments?post=844"}],"version-history":[{"count":1,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/posts\/844\/revisions"}],"predecessor-version":[{"id":845,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/posts\/844\/revisions\/845"}],"wp:attachment":[{"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/media?parent=844"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/categories?post=844"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/tags?post=844"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/industry?post=844"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/product?post=844"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/polarion\/wp-json\/wp\/v2\/coauthors?post=844"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}