Chat now with support
Chat with Support

erwin Evolve 2020.2.1 - User Guide

erwin Evolve 2020.2.1 User Help Guide
erwin Evolve 2020.2.1 User Help Guide
erwin Evolve 2020.2.1 User Help Guide
Getting Started Creating Sites and Pages Data Layout Options Filtering Data Property Groups Data Visualizations Displaying Diagrams Using Web Modeler Automatic Diagrams (Diagram Designer) Navigating your Site Workflow Explained Social Interaction Features Questionnaires Reference Configuration and Administration Customizing Your Site Troubleshooting Upgrading Evolve Suite Addendum

Creating your First Evolve Site

Creating your First Evolve Site

If you are new to Evolve, once you have familiarized yourself with the Key Concepts, Metamodel Considerations and how to Run Evolve Designer, you can use the following pages to help you get your first Site up and running.

Once you have completed these tasks, you should have a simple working Site containing all the fundamental elements. Only once you have done this do we recommend that you go on to try different options.

Configure your server

Create a Site

Create a basic Index Page displaying a simple list of objects

Create a simple Object Page

Create a Menu to link to your Index Page

Publish your Site

Once you have published your Site and tested that it works, you can go on to explore how to extend your Site by creating more adventurous pages using the information in the Layouts and Behaviors section.

 

Important factors to remember when extending your site

As you go on to add more content to your site, remember these important factors:

You must create an Object Page for each type of object you want to view.

Your CW model must contain a Template Diagram with the same Category and Rule combination for every Diagram you want to display in Evolve.
This must be one template only for each Category and Rule - if you have multiple templates then Evolve will report an error.

Creating Sites and Pages

Creating Sites and Pages

Create a Site

Create a Site

Before you can create a Site, you must ensure you have completed the configuration of your Evolve Server.

See Configure your Server for details.

These instructions explain how to set up a basic, empty Site, and then how to configure the deployment settings so that it can be published.

Once the Site is created, you should follow the instructions in the rest of the help to learn how to create Index Pages, Object Pages and a Menu.

An Evolve Site is explicitly linked to one CW Model. You can create one Site in each Model in your repository.

Creating a Site makes changes to your Model's meta model, resulting in new Object Types and Associations being added to the Model.

If you are using Evolve for the first time and want to experiment with creating a Site, we recommend that you create a copy of an existing Model and use that as the basis of your Site.

 

Step 1 - Create a Site in your Model

To create a Site in your Model:

1Run Evolve Designer

2Select the Model you want to create a Site in

The page updates to show Sites in your Model.

If your Model is not listed, you must enable it to support having an Evolve Site. To enable your Model:

i.Click the plus (+) icon in the top-right of the dialog.

A pop-up menu listing all the models in your repository is displayed.

                              ii.           From the pop-up, select the Model you want to use for your Site

Your Model's meta model is updated with the new Object Types and Association Types required for Evolve. This process may take a few moments.

Once the Model is updated, an icon representing the Model is displayed in the Evolve Designer window.

          3. On the Sites page, click the (+) icon in the top-right of the dialog.

The New Site dialog is displayed.

          4. Enter a Name for your Site in the Site Name field

          5. Click Create.

Step 2 - Configure the Site settings

To configure the Site settings:

1.In Evolve Designer click the top Site node.

2.Review the following settings:

Setting

Description

Site Language

Choose the language of the Site if you want to override the global Evolve setting.

Number Separator

Select 'None' (default), 'Comma' or 'Space' to specify which number separator is used when displaying numbers on your Evolve Site.

For example:

None - 1000 or 1000000

Comma - 1,000 or 1,000,000

Space - 1 000 or 1 000 000

Less Theme

Choose the theme of the Site if you want to override the global Evolve setting.

Export Diagram Images

Static Sites only.

Use this option if you are publishing your Site in Static mode and you are showing Diagrams created in CW Modeler using the CW Modeler Diagram behavior.

You can leave this option unselected if you are not displaying diagrams or are only using the Vector (HTML5) behavior to prevent images of diagrams being generated when you publish your Site - a process which can take some time.

See the Evolve Configuration Reference for details on the full list of settings.

          3. Select the Deployments > [server name] > Model node (showing the Scriptname of the Model           your Site is in).

The settings are shown in the right-hand pane

          4. Complete the following fields:

Setting

Description

Site URL Name

Specify the name of this Model Site as it appears in the URL, such as http://<server-name>/<evolve-IIS-site-name>/[sites|statics]/<site-url-name>/

Ensure that the name is all lower-case and has no spaces or special characters.

To change the Site URL Name for an existing Site, see: Change the URL Name of your Site.

Site Display Name

Enter the name of your site. This is only displayed on the top-level Evolve Sites page.

AD Mapping

Dynamic Deployments Only

This control now replaces the single mapping per license type, allowing a much greater level of control of groups.

The control is used for both Active Directory and SAML2 configurations.

AD Group - is used to specify the name of the Active Directory group you want to use for this configuration. It is also used for the name of the "Outgoing Claim Type" in a SAML2 configuration.

If a user is a member of this AD Group or Claim, then they will assume the permissions indicated on this row of the table. If a user is a member of multiple Groups or Claims, then they will receive the aggregate of the permissions, with the exception of CW User Type, which will be promoted to the highest license type they are allowed.

Dynamic Deployments Only - this can be one of "Social", "Contributor", "Diagrammer".

AD Default Social Role Name

Dynamic Deployments Only

Only used if the Evolve Authentication Method is set to Active Directory.

Specify the default Role you want newly created Evolve Social users to be given.

AD Default Contributor Role Name

Dynamic Deployments Only

Only used if the Evolve Authentication Method is set to Active Directory.

Specify the default Role you want newly created Evolve Contributor users to be given.

Display Model in Evolve

Applies to Dynamic Sites only.

Use this option to specify if this Model Site is available or disabled in Evolve.

See the Evolve Configuration Reference for details on the full list of settings.

          5. Save the Site.

                    The settings are complete.

Step 3 - Publish your Site

Now the Site and IIS are configured, you must publish your site so that all the required files are generated and placed in the correct location on the web server.

To publish your Site:

In Evolve Designer, click Dynamic Site or Static Site in the Publish area on the Home menu.

All the Site's files are generated in the correct location for the web server to host them.

The status area at the bottom of Evolve Designer updates as the various processes involved in publishing are performed. Once the operation is complete, it reports 'Site generated in ....'.

 

These instructions are for publishing your Site for the first time - there are different publishing options for when you are editing a Site that has already been published. See Publishing your Site for full details.

Accessing a Dynamic Site

You can access a Dynamic Site at the following URL:

http://<server-name>/<evolve-IIS-site-name>/sites/<site-id>/

Accessing a Static Site

You can access a Static Site at the following URL:

http://<server-name>/<evolve-IIS-site-name>/statics/<site-id>/

Layouts and Behaviors Explained

Layouts and Behaviors Explained

Evolve offers many different possibilities for how you want the information in your Index Pages and Object Pages to be displayed.

These display options are controlled by Layouts and Behaviors.

Layouts control the physical structure of the web page, whereas Behaviors control how the data is displayed inside the Layout. Some Behaviors can only work with certain Layouts. Additionally, some Layouts and Behaviors can only be used on Index Pages, while others can only be used on Object Pages. However, some can be used on both.

Use the table below to see all the page display options available in Evolve, then follow the links to find out how to create them in your own Site.

There are a number of different options for how you want to display the properties of objects on Object Pages. For full details on these display options see:

Working with Property Groups and Property Group Layouts

Page Display Options

Type

Example

Description

Editable?

Used in

Simple List

The Simple List is the default Layout for all new Index Pages and displays objects in a simple bulleted list.

On Object Pages this layout is used to show related objects, such as Associations or Diagrams the object appears on.

No

Index Pages

Object Pages

Accordion

An Accordion is an Object List where each object reference is clickable and can be expanded to show further information about the object - either properties of the object, or associations.

When you use an Accordion, you can nest other Layouts and Behaviors inside it, such as another list of Associated Objects.

No

Index Pages

Table (Complex)

A Table (Complex) behavior displays objects and properties in table format. You can choose which properties to display as columns, and you can include associations.

Users can sort the list by clicking column headings, and they can optionally edit objects directly in the Table itself.

Yes

Index Pages

Object Pages

Table (Simple)

The Table (Simple) layout creates a basic table for displaying lists of data, with the ability to open the Object Page for a listed item.

No

Index Pages

Object Pages

Simple Matrix

 

A Simple Matrix creates a table which displays Associated Objects for the object in question, and shows which other similar objects these Associated Objects are associated to.

For example, you could show which Risk objects your Process is associated with, and which other Processes are associated with those Risks.

No

Object Pages

Tabs based on Lookup Values

This list-type display organizes your objects into groups based on the value of Lookup properties (drop-downs such as Category).

Vertical tabs on the left side of the page are used to represent the values, while the objects themselves in each tab are displayed in simple lists.

Option

You can optionally include an Overview Chart which creates an 'Overview' tab displaying a Pie Chart showing the proportion of each value.

No

Index Pages

Pie Chart based on Lookup Values

 

The Pie Chart based on Lookup Values display creates a chart for a specified Object Type showing the percentage of objects with values from one Lookup (drop-down) property.

The chart is identical to the optional Overview Chart offered by the Tabs based on Lookup Values display.

No

Index Pages

Recursive Pie Chart

A Recursive Pie Chart allows you to show a top-level chart which sums the values of properties of associated objects (or Intersection Objects), and then allows users to click those items to view a second chart showing all the objects associated to the selected object.

No

Index Pages

Object Pages

Roadmap

 

A Roadmap is a type of Gantt Chart that enables you to show a number of objects and their start and end dates.

No

Index Pages

Object Pages

Lifecycle Roadmap

A Lifecycle Roadmap is a type of Gantt Chart that enables you to show a number of objects, displaying their overall time frame, as well as highlighting in different colors any number of phases of their lifecycle.

No

Index Pages

Cost Benefit Chart

A Cost/Benefit Chart enables you to compare properties you class as Costs in your organization against properties you class as Benefits.

The result is a chart that allows you to evaluate your expenditure in terms of business importance.

No

Index Pages

Simple Bar Chart

 

The Simple Bar Chart behavior displays a simple bar chart on your Index Page, listing a maximum of 20 objects on the y axis and referencing a simple number property on the x axis.

No

Index Pages

Multi-Axis Bar Chart

 

On your Index Page, the Multi-Axis Bar Chart behavior displays a simple bar chart which compares the values of two properties of the objects referenced.

No

Index Pages

Simple Bubble Chart

Simple Bubble Charts allow you to compare objects of the same type, by analyzing three levels of data and using the values to affect the size and position of the representations on the chart.

No

Index Pages

Cluster Bubble Chart

Cluster Bubble Charts are similar to Simple Bubble Charts, except they allow you to visualize the properties of an Associated Object (directly or indirectly), or an Intersection Object.

No

Index Pages

Visual Identity

 

The Visual Identity layout is used to show a list of objects with visual indicators to represent some of their properties.

The layout displays each object as a rectangle, and then at the bottom of each shape you can show icons to represent the values of one or more properties of your object.

The Visual Identity layout requires a Custom Site deployment.

No

Index Pages

Object Pages

External Picture

The External Picture layout can be used to display an image, stored on the Evolve server, which is referenced as a property of an object.

The External Picture layout requires a Custom Site deployment.

No

Index Pages

Object Pages

Image

 

The Image Layout is used to display an image for an object that is referenced using a Single-Line Text or URL Property.

It is used on its own, not together with other properties, so suits larger images more.

No

Index Pages

Object Pages

Vector Map

 

Vector Maps enable you to highlight countries or places on a map so that the user can click through to see more detailed information about that area.

No

Index Pages

Object Pages

Radar

The Radar Layout is used to display and compare three or more properties of an Object, or many Objects, in one chart.

It is used on its own, not together with other properties, so suits larger images more.

No

Index Pages

Object Pages

View Box

 

Layout reserved for internal Evolve use.

No

Index Pages

Object Pages

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating