Applications

inorigo® Applications are web based solutions that through a set of components allows users to view, export and import data. Applications can vary widely in complexity, appearance and usage and are often tailored to full-fill specific needs. Working with in inorigo® Applications covers the functions available in the Applications menu and all of inorigos components that are available to Applications. The following sections describe the functionality of viewing an inorigo® Application in a web browser.

An inorigo® Application may be viewed in several ways on the web, such as:

• in the inorigo® Workbench
• embedded with HTML on a web page
• embedded in a Share Point
• embedded in Confluence

All embedded alternatives use a direct link to the Application to access it.

See the technical documentation on how to access Application definitions and data via the inorigo® web service interface.

Obtain a Direct Link to an Application

To embed an inorigo® Application on the web, a direct link to the Application must be obtained. To obtain the link, right click an Application in the list of Applications in the Workbench and choose Open in new browser tab. In the window that appears, hit Ctrl-C to copy the URL to the clipboard.

 

inorigo® Workbench

All Applications are automatically available from within the inorigo® Workbench under Library – Applications (at the bottom of the Library sidebar).

Bookmark an Application to make it visible under Library – Bookmarks.

Double click an Application to open it in a tab in the Workbench.

To open an Application in a new browser window, right click the Application in the Library and choose Open in new browser window, or double click the Application tab header if the Application is already opened.

Access Rights

When an Application is requested (from within the inorigo® Workbench or with a direct link) inorigo® verifies that the requesting user has the rights neccessary to access the View. If inorigo® is set to use single sign on (SSO), the verification and login process is done automatically. If not, username and password must be filled out manually. See Access Rights for detailed information on how to log in and log out of the Workbench.

Once logged in to the Workbench, only authorized Applications are visible. Requests for unauthorized Applications that are embedded (i.e. with a direct link), prompts the user with the browser login dialog window.

 

How to Publish and Embed Applications

 

 

(adjust the height and with parameters to suite the embedded Application).

When you want to distribute an Application accesible to anyone.

Step-by-step guide

How to publish an Application as content in Confluence

1) Create an Application according to To Define and Edit an Application

2) Assign view rights to the Application consumers: Access Rights to Applications

3) In Confluence insert a HTML macro by

a) clicking the insert button and selecting Other macros

b) selecting the HTML macro

4) In the macro use 

Change the greyed out text with the link you copied from the Application and if necessary, modify other parameters such as Height and width to match the desired size of the window.

How to publish an Application as content in a web page.

1) Create an Application

2) Assign view rights to the Application consumers

3) In the inorigo Workbench, right click on the Application and select Open in new browser tab and copy the URL from there.

4) Paste the URL paste it within a html iframe tag using the format below.

adjust the height and width parameters to the embedded Application

All web components visible with header will have a partly hidden option to open them in a new browser tab. Just double-click the header to do just that. The component will be opened in a new tab in browser with its own unique URL, which can be distributed to any user since /public will be included in URL.

This is very useful when sharing charts or any other Result component, since it is updated live while performing new selections in the filter component(s) connected with it.

Locks

Make any and press lock to keep from selecting other units. You are still able to refine your selection by selecting units within your locked selection range. Notice that locks only apply to you and your current runtime of an application, next time it is opened any applied locks will have been reset.

Save Selections

To bookmark a new selection, select the desired units in an Application and press

When saving a selection you have the option to set what tabs that should be opened when the Application is launched. If the Application view is split and multiple tabs are visible at the same time, you may set a focus for multiple tabs.

Enable Accessible by team to allow other users to make use of the saved selections. Notice that users require update rights for the Application in order to saved selections for teams.

Distribute saved selections in the following ways

• Saved Selections that has been made accessible by team can be accessed by all users in the instance, who has a bookmark for that application. The saved selection is found under the applications bookmark.

• The URL used to open the Application with saved selections can be distributed to any user with access to the application, by copying it from the browser.

 

Clear Selection – Clears current selection

Calculate – Run the current selection to trigger result components (only necessary if Auto Calculate is disabled)

Auto Calculate – Toggle automated calculations, enabled by default.

Load Selections – Load your or team members saved selections for the current application.

Reload – Reload all data in the application, current selections always remains.

A blue dot indicates that data in the application has been updated elsewhere. Until reload is pressed (or the browser window is refreshed) the data remains in its current viewing state.

A red dot indicates that the reload of the Application on the server is finished, and there is a newer version of the Application available in the server memory.

Display Modes has been introduced in order to easily control Application layout.

 

 

Utilize application selection parameters to send a link to an Application with a predefined set of selections or store in Favourites in browser for quick and easy access the next time.
You can use any filter box that has a unique identifier (pX) for your selection.

How to:

• Open the Application in a new browser window
• to the URL, add box id. and a value as query string parameter to select item. Repeat &pX=value for each new item in selection (replace X with the filter box id).
• To lock the selection, simply add parameter &lock=true

Values can be supplied as Text representation or as unique identifier. Value should never contain spaces since this is considered an invalid URL. Replace space with %20 which is supported by all browsers.

Example:

An Application holds a filter box with continents (p0) countries (p1) and a map. Open the Application in new browser window and add selection according to:

Use either p0 or p1 to perform selection

Filter box need not to be visible to be available for selections.

And yet more; since all the filter boxes have unique identities, they will be available for URL selections regardless of which tab they reside. One can thus make a composite selection from several tabs for distribution.

The following variable

&focus=

can be used to focus components and panels when an Application is loaded.

Example:  https://instance.url/verso/1de19003-fc75-dd5b-7190-aad900b2bf6a?DisplayMode=Browser&focus=p3

Result: The panel that component p3 is located on will be opened.

 

For applications with multiple tabs in split panels, several components can be targeted.

Example: the ID of a Knowledge Graph and the Variable Name of a filter component have been targeted

https://inorigo.url/verso/applicationID?DisplayMode=Browser&focus=4F244534-F2FB-6D3C-A01C-AA5600B93FA1&focus=p61

Result

 

The following identifiers can be targeted

ID – rightclick a component / panel in the context navigator or main panel in Application builder to obtain

Name

Variable Name – pX number for filter components

Focus can also be bookmarked and is available over the API

 

Filter Component example.

Filter component menu

Click the  in the filter component title bar to expand component tools. The available and visible tools may differentiate between filter components.

The functions available are:

Filter component context menu

Some of these options are also available from the context menu in filter components, revealed by right clicking units inside the filter component.

When a filter component displays any structure (Composition, Classification or Recursive structure), the parent nodes are indicated with a triangle pointing down (open) or right (closed)

Input panels are used to create, edit or delete units. Only certain filter components allows for unit editing, typically those with the editing buttons visible under the component. In some components editing may also be accessed by right-clicking units in the filter component.

The number of entries or selections in an input panel depends on the settings and type of units that you are editing. In order to complete an input to create or edit a unit, make sure that all red fields and fields marked with an asterisk * are filled out. Until they are, it will not be possible to press save.

For some fields, like Telephone Number in the image below, you may choose a number of entries by adding new fields to the panel.

Once save is pressed, the new unit is created/updated immediately and will appear in the filter component.

Designer should be aware of the following when defining a Filter component as Compact:

• does not support Classification or Composition structures, i.e. only flat.
• does not support multiple selections
• does not support context menu when managing inorigo® objects, options are only available from Menu and Buttons

While searching the Compact Filter component, indicators help you navigate and orientate in the list:

The criteria used when evaluating the filter search is Contains, just as in an ordinary Filter Component.

A Calculation Box example.

The calculation box show calculations based on information in other filter components in the Application and in the underlying information model.

More information about setting up the calculation box, or embedding an HTML page inside it is available under calculation box in the application builder documentation.

The web version of Selection Box supports all features available in settings as described in section Selection Box under Working with inorigo Application Builder

Example of Selection Box

Selection Box is now limited to show a maximum of 100 items per Filter Box. A trailing overflow item will be added if the limit is reached.

Example of a custom Text Area on the web

The Text area component contains static text like information, headers, etc. Selections or other user interactions cannot affect the text inside the component. The header of the component is often hidden to hide the component window and display only the text in the Application.

Resource viewer example, browser supporting the source format for direct display.

The Resource window  to the left is a normal Filter component.

Resource Viewer component to the right has two parts; the left one listing the result of the selection made in Filter component, and the right displaying the result of clicking on an item in the list, this is configurable in the Layout settings in inorigo® Application Builder. External documents supported for direct view in Resource viewer is currently pdf files and xls charts.

Another Resource viewer example, browser not supporting the source format for direct display, click the red area to download for view in a default program associated with the file type.

Click the  in the top right corner of resource viewer title bar to expand component tools.

The functions available are:

The purpose of the charts is to display the information from the filter components to present the information in a graphical and useful way.

All settings available for inorigo® Application Builder Bar charts are also applied in the Application on web. Charts are populated with data from any Filter component as specified in Content Settings, in inorigo® Application Builder:

An example of a Bar chart

Hover

Moving the mouse over a bar in the chart will reveal the object properties as specified in settings in Application Builder.

Select

A mouse left-click on a bar in chart will outline the object. It is possible to select several bars combining the mouse left-click with Ctrl-button.

Chart warnings

Using chart Fixed Axis displays warnings on each Bar exceeding the minimum and maximum preset in configuration, see example below.

There are three indicators on web, one for each Bar and the tooltip, and the third in upper left corner that returns a summary for the entire chart.

 

Video tutorial on using Bubble Charts in Applications

 

All settings available for inorigo® Application Builder Bubble charts are applied in the Application on web. Charts are populated with data from any Filter component as specified in Content Settings, in inorigo® Application Builder:

Example of a Bubble chart

Hover

Moving the mouse over a bar in the chart will reveal the object properties as specified in settings in Application Builder.

Select

A mouse left-click on a bubble in chart will outline the object. It is possible to select several bubbles combining the mouse left-click with Ctrl-button.

Chart warnings

Using chart Fixed Axis display a warning icon in upper left corner that contains information on each value exceeding the minimum or maximum preset in configuration, see example below.

 

Video tutorial on using Line Charts in Applications

 

All settings available for inorigo® Application Builder Line chart are applied in the Application on web. Charts are populated with data from any Filter component as specified in Content Settings, in inorigo® Application Builder:

Example of a Line chart

Hover

Moving the mouse over a (trend) line in the chart will reveal the object properties as specified in settings in Application Builder.

Select

A mouse left-click on a dot in chart will outline the object. It is possible to select several dots combining the mouse left-click with Ctrl-button.

Chart warnings

Using chart Fixed Axis display a warning icon in upper left corner that contains information on each value exceeding the minimum or maximum preset in configuration, see example below.

Video tutorial on the Pie Chart Component

All settings available for inorigo® Application Builder Pie chart are applied in the Application on web. Charts are populated with data from any Filter component as specified in Content Settings, in inorigo® Application Builder:

An example of a Pie chart

Hover

Moving the mouse over a segment in the chart will reveal the object properties as specified in settings in legacy Application Builder.

Select

A mouse left-click on a segment in chart will explode the object. It is possible to select several segments combining the mouse left-click with Ctrl-button.

Chart warning

Using chart Fixed Axis display a warning icon in upper left corner that contains information on each value exceeding the minimum or maximum preset in configuration, see example below.

A Matrix example.

Sorting

To sort the data, click the column heading you want to order by. The first click will set up a sort of ascending type (). A second click on the same header will change the sort to descending () and a third ends the sort on that column.
To sort rows based on many columns at the same time, hold down CTRL and click as described above. There is no limit to how many additional sorts you can apply.
Note that the sorting you set up wont effect coming changes to cells and rows. The way to reenact the sorting is simply to redo the clicking of column headers you want to order by.

Click the Matrix menu  at the rightmost column header position to hide (and show) columns.

Visible column are indicated in the list with a tick mark.

Click the    in the top right corner to expand the component tools.

 

The functions available are:
Aggregation tables can now be sorted by the user on multiple columns by clicking on the column headers. Users may also clear the sorting through the menu command reset sorting.

Tooltips

A Matrix has the option to display tooltips for each individual cell. Click or hover a matrix cell to reveal a given tooltip.

 

Symbols

An aggregation table example.

Click    in the top right corner to expand the Aggregation table tools.

 

Aggregation tables can now be sorted by the user on multiple columns by clicking on the column headers. Users may also clear the sorting through the menu command reset sorting.

When multiple units are explicitly and implicitly selected in two or more filter components we cannot determine what units that connects to which. The knowledge graph does great job at meeting that need.

Tree structures are generated to display the relation between all selected units that has been included in the Knowledge Graph.

By default, Knowledge Graph is expanded scale to fit the defined area and visualization is set Left to Right.

The default mouse pointer symbol when managing objects in Connection graph box

The default mouse pointer symbol while zooming and panning.

Knowledge Graph Features

• Dragging units – Point the mouse on a unit in the graph and the pointer will change to a hand. Drag the object in the graph to put it in another location. Connection lines will follow while dragging units.
• Collapse and expand – Expand and Collapse branches at users will simply by double-clicking any unit in the graph. Any unit having a child object attached can be collapsed.
• Highlight Connections – Highlight a connection by clicking units in the graph.
• Highlight with Search – If available, the search field can be used to highlight units and their connections as well.
• Tooltip – Hover to display the name of a unit as a tooltip
• Zoom and Pan – While mouse pointer icon is an arrow, Zoom and Pan will work in entire graph box.
  • Zoom out: Shift + mouse double-click or scroll wheel on mouse.
  • Zoom in: mouse double-click or scroll wheel on mouse the opposite direction.
  • Pan: mouse-click and drag any direction

• Sorting – The units in the Knowledge Graph will always be sorted on text, from left to right or top-down, depending on the Application direction selected.

This example will display filtered data from JIRA issue application, some statistics for an overview of bugs.

Lets have a look at the example:

In Model Builder, create a Generic Unit with the following attributes:

The data needed for the Specific Units is exported from JIRA and pasted into a Model Builder matrix.

Create an inorigo® Application:

First thing will be to list the Specific units in a Filter component, and link to the other filter components needed from that one.

At last, add the Web Page Result component.

The only setting change needed for that is:

with an Expression as follows:

$IIF($SIZE(@p0) = 0, “”, “https://jira.ortelius.se/browse/” + $NTH(@p0, 0))

Explaining a bit about the expression; means that if nothing is selected, then show “” (nothing) in Web Page, else show base address https://jira.ortelius.se/browse/ + the selected item in p0 Filter component.

Test the setup by selecting an item in p0:

Web content is not supported by Application Builder

The address looks allright, lets save the Application and try on the web.

It works!

A few charts to get an overall picture of the statistics would be great, add another tab in Application Builder design and add 2 Bar charts, and here is the result:

(won’t get into details about the setting of charts)

Resulting charts.

The pop-up in the upper right corner in an Application or in the Workbench will appear due to either one or both of the following reasons:

• disconnected from network
• Tomcat service or server hosting the Tomcat service has been shut down or rebooted

When connection has been established again it looks like in the following image when trying to access an Application:

Click on the “Communication problem” banner, press Esc button on keyboard or reload the web page (F5) to refresh the web page.

Context menu contains two options for Lock/Unlock depending on the state in which the item in Filter box is.  “Lock…” is available when items are selected but not locked, while “Unlock…” is available for items being locked.

The two options in context menu are:

• Lock the item that was right-clicked to open context menu
• Lock all selected items

Locks all items simultaneously

Lock and Unlock is also available for implicit selected items

Objects not part of a selection Lock will get a strike through and dimmed to enhance this; they can not be selected or locked. The implicit selected items can be locked.

If the Group setting is on, blocked items are sorted after un-selectable items.

The Lock options are also available from the Application toolbar.

Use the appropriate option from the context menu to unlock object(s).

Unlock objects one by one or unlock all at the same time

The Unlock options are also available from Application toolbar.

Title bar tooltip is supported for all types of components. It can be set, enabled, or disabled through the Application Builder

inorigo Applications are tested and supported in the following browsers: Edge, Chrome, Firefox, Safari (Mac)