Skip to content

electric-cloud/EF-ReportingTools

Repository files navigation

EC-ReportingTools

Electric Flow Procedures to create reports. Report links are attached to the job and the pipeline if present.

Procedures

json2table

Create a table from a JSON string:

[
	{
		"col1": "123",
		"col2": "456"
	},
	{
		"col1": "789",
		"col2": "012",
		"col3": "345"
	},
	{
		"Text": "<b>Bold</b>",
		"Image": "<img src=\\"../../../flow/public/app/assets/img/svg-icons/icon-nodes.svg\\" height=\\"20\\" width=\\"20\\">",
		"Link": "<a href=\\"../..\\">Commander UI</a>"
	}
]

Note the double escapes '\'; the first is necessary to protect the embedded quotes, the second is needed to protect the escape itself because this JSON is being used to generate a step with DSL.

Sample Table

Parameters

jsonData: required, string, JSON array with one or more key-value pairs for each array element reportName: optional, string, report name to be used as file name as well

Timeline

jsonData: required, string, JSON array with items defined by resource, label, startDate, and endData. Dates should be in YYYY/mm/dd formmat or integer microseconds.

[
	{
		"resource": "Resource One",
		"label": "First",
		"startDate":  "2018/4/10",
		"endDate": "2018/5/1"
	},
	{
		"resource": "Resource Two",
		"label": "First",
		"startDate":  "2018/4/20",
		"endDate": "2018/5/15"
	},
	{
		"resource": "Resource Two",
		"label": "Second",
		"startDate":  "2018/5/20",
		"endDate": "2018/5/30"
	},		{
		"resource": "Resource Three",
		"label": "First",
		"startDate":  "2018/5/5",
		"endDate": "2018/5/8"
	}
]

reportName: optional, string, Timeline name to be used as file name as well

Sample Timeline

Gantt Schedule

jsonData: required, string, JSON array with items defined by taskName, startDate, and endData.

[
	{
		"taskName": "First Task",
		"startDate":  "2018/4/10",
		"endDate": "2018/5/1"
	},
	{
		"taskName": "Second Task",
		"startDate":  "2018/4/20",
		"endDate": "2018/5/15"
	},
	{
		"taskName": "Third Task",
		"startDate":  "2018/5/5",
		"endDate": "2018/5/8"
	}
]

ganttName: optional, string, Gantt Chart name to be used as file name as well

Sample Gantt Chart

Test examples

Run these DSL files to generate tests for the plugin procedures. These DSL file create both pipelines and procedures in the "Test" project with the same name as the DSL file. Either can be run. A link to the report will appear on the job and on the pipeline if the pipeline is run.

  1. Simple JSON to Table TableSample
  2. Simple Gantt Chart GanttChartSample
  3. Simple Resource Timeline TimelineSample
  4. Environment and Release Timeline EnvironmentReleasePhasesTimeline
  5. Environment Inventory EnvironmentInventory

Plugin Versioning

  • 1.0.0 - Initial
  • 1.1.0 - Support HTML in table (closes #5), add Environment Inventory example (closes #4)

About

Electric Flow Plugin with procedures to create some common reports

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published