Package Visualizer

<< Click to Display Table of Contents >>

Navigation:  Automation Server > Automation Server configuration and administration guide > Initial project configuration > Deployment of processes and new versions > Advanced Deployment > User interface explained >

Package Visualizer

Overview

When a project runs in a production environment and multiple deployments have been made, it is important to review and analyze the new packages to make sure that the package to deploy is correct. It is also important to check what is going to be deployed before generating the file, that is, whether you want to deploy a project for the first time, perform a deployment for improvement of a project or explore a deployment package.

Bizagi knows this and provides an interface called Package Visualizer. Through this section, we describe how it can be used, the information it provides, and some other important details.

 

When can you use it?

The Package Visualizer is useful when you are going to create or import a .bex file. The following is the list of contexts where this feature can be used:

 

One click deployment: in the last step of a deployment process, you see the View exported objects button. When you click it, the Package Visualizer shows the objects that will be deployed to the selected environment.

 

Package-visualizer-01

 

Importing a .bex file using the Management Console: in Management Console, it is available an option to explore the .bex file in the file menu in the main ribbon. When you click it, the Package Visualizer shows the objects in the .bex file when the deployment was generated.

 

Package-visualizer-03

 

Importing a .bex file using the Bizagi Studio:  is available an option to explore the .bex file in the file menu in the main ribbon to visualize a .bex file.

 

Package-visualizer-10

 

How to use it

The Package Visualizer lets you graphically explore and analyze all the components and objects taken into account in a deployment. However, it does not let you change, add or delete any information, components and objects. In this part of the article, we describe the details of the features which are available when launching the Package Visualizer either from any of the three options mentioned before.

 

There are four components in the visualizer:

 

1. Tree View

Package-visualizer-04

 

The Tree View is a hierarchical representation of the objects. It is presented on the left panel of the Package Visualizer and splits the deployment's objects into three main groups: Application (Business Processes), Entities and Global. The Bizagi structure is not completely represented in the tree since it would be too big, only a prioritized group of Bizagi's elements is shown. Such group considers:

 

Application

oApplication

oProcesses

oProcess Version

oBusiness Rule

Entity

oEntity (And subtypes)

oAttribute

oValues of entities

oRelevant

oStakeholder Context

oCollections | My Stuff

oStakeholder Actions

oMy search

Global

oHolidays

oUser Properties

oUser Groups

oDocument Templates

oEmails

Other

oSystem Entities

 

2. Context view

 

Package-visualizer-05

 

The Context View shows the members of the selected node in the Tree View. When a selected node has subcategories, the Context View shows tables containing the information of the elements of every subcategory. In this table, you can see the name of the object, the last person who modified it, and the last modification date.

 

Package-visualizer-06

 

When you select a node from the Tree View, the Context View shows the context path in the title and several tables with the objects of the node grouped by the type of element. Each element in the table shows its name, the last person who modified and the date of the last modification for each attribute.

 

Package-visualizer-07

 

3. Search View

When you move to the Search tab, a search bar appears so you can input object names or query for people (those who modified the objects).

 

The following image shows a search performed by object name:

 

Package-visualizer-08

 

The following image shows the search results of a person's name query:

 

Package-visualizer-09

 

The search results are grouped by the type of object, and can be collapsed or sorted (on an ascending or descending fashion) by any of the columns. To collapse a group, click the icon shown next to the group's title. To sort a table by a column, click the column's name to cycle between ascending, descending.

 

4. Dependency Viewer

When you select a node from the Tree View, you can click the element name to display the dependency viewer. The dependency viewer lets you identify the elements involved in the deployment package and the relation between them.

 

Package-visualizer-12

 

Once you select the element, the Dependencies view shows you a map with the information of the elements which have a relation with the selected element.

 

Package-visualizer-13

 

An element can be used by several objects in the deployment packages and can have several dependencies. To change the object where the dependencies are analyzed, select the object from the drop-down list displayed at the top of the view.

 

Package-visualizer-14

 

Hover the mouse pointer over any of the elements of the map to show its name.

 

Package-visualizer-19

 

You have the following options available when using the dependency viewer.

 

Icon

Name

Description

Package-visualizer-15

Left to right

Shows the map oriented from left to right. This is the default view

Package-visualizer-16

Top to bottom

Shows the map oriented from top to bottom

Package-visualizer-17

Auto zoom

Shows the map with a 100% zoom

Package-visualizer-18

Fit to view

Fits the map to the current view size

 

Important considerations

With the package visualizer you can explore .bex files generated using a version of Bizagi higher than or equal to 11.0.

Some of the files generated in Bizagi 11.0 may show an error when trying to visualize it. This error may also occur when the .bex file has problems with its metadata.

 

Package-visualizer-11

Advanced deployment: In Export, you see the View exported objects button inside the Tasks for package section. When you click it, the Package Visualizer shows the objects that will be deployed to the selected environment.

 

Package-visualizer-02

 

note_pin

It is not available a Save option since the .bex file is not editable when you navigate the objects to be deployed using the Package Visualizer.