Chapter 1. Configuring VPGO

Chapter 1. Configuring VPGO The VPGO module is configured in the VISUAL PLANNING client. You can define as many VPGO templates as you need based on the three existing template types: Diary template Events list template Resources list template Each template is associated with a dimension. SETTINGS The settings of the VPGO module can be accessed from the module configuration window. Go to Settings > Configuration pane > Click VPGO. In the window that appears, click the Settings button at the bottom left. The following window appears: Description The description is optional. If a description is entered, it will be displayed as the global module description in VPGO. Short description The following VISUAL PLANNING variables can be included: $USERNAME, $USERFULLNAME, $USEREMAIL. These variables automatically insert the login, the dimension identification headings and the email address of the user who is logged in respectively. Here you can define the wording that will appear beneath the schedule name on the VPGO home page. Login dimension 2

By default, users of the VPGO module have to be declared in the VPGO module license. However, access to the VPGO module can also be defined via a dimension of the schedule. In this case, enter the name of the dimension enabling this access here. The following fields are then accessible: Define the filter authorizing access to the VPGO module. For example, an "Active User" filter only gives access to the module to users included in the filter. Choose the heading identifying each user's permission group. This heading must be a list-type heading allowing either single or multiple choices. The different choices must be entered in the same way as the permission groups in Admin Center. The users' permissions will then be the permissions defined for the permission group in Admin Center. Choose the heading that will enable the user to identify themselves (i.e. the login) on the smartphone. This heading must be a text-type heading. Choose the heading that will verify the user's password. This heading must be a password-type heading. If necessary, choose the heading for retrieving the user's email address. This heading must be a text-type heading. User profile headings This field enables the user's profile headings to be selected. The headings that can be selected here are the headings of the login dimension. The selected headings can then be edited by the user once they have logged into VPGO by pressing the corresponding button. When the mouse is positioned over each profile heading, a tooltip will present its description if it has one. Terms of use heading 3

Choose the heading that will confirm whether the user has checked the terms of use. This heading must be a booleantype heading. Terms of use text The text that will be displayed asking the user to accept the terms of use should be entered into this field. In VPGO, the general terms of use are always accessible by pressing the button. CHANGING THE PASSWORD If the users are defined via a login dimension, the user can change their password on their mobile by pressing the button. The following window appears: TAB ORDER The tab order can be changed. To do this, drag and drop the tabs in the VPGO configuration tree. The first tab will be the first VPGO template in the configuration tree. MANAGING CHILD EVENTS It is possible to create a Diary or Events list template for child events in the case of a vertical hierarchy. The events can then be modified if the hierarchy allows. However, it will not be possible to create child events. CREATING A VPGO TEMPLATE Creating a Diary template 4

Go to Settings > Configuration pane > Click VPGO. To create a VPGO Diary template, Right-click VPGO Templates > Create a Diary > Choose the dimension or click the button and choose the dimension. The pane below is activated: Specify the characteristics (below) of the Diary template and confirm by clicking OK. Give the template a name. Give the template a description. If a description is entered, it will appear in the tab header in VPGO. This represents the creation date and time and the most recent change to the template, together with the login of the user who made the change. This property is updated automatically. If this box is checked, the template is activated and made available to VPGO users. If this box is checked, users can access the template in offline mode. If this box is checked, the duplication button is displayed when editing an event. Choose the filters that will be available in the template from the list of existing events filters. Choose the period when events are visible. 5

Choose the event headings and/or attributes that will identify events. This data will be displayed in the duration bars. Choose the character that separates identification details when the event is presented. Choose the dimension that defines the icon in the event duration bar. Choose the size of icons. This box is only active if a dimension has been chosen above. Choose the dimension that defines the event border color. Choose the dimension(s) that define(s) the event background color. If several dimensions are selected, the event bar will show the dimension colors. If only one dimension defines the background color and it is shaded, it will also be visible in the duration bar. Define the maximum number of event lines that will appear on one page. If the value stays at -1 (the default value), all the lines will be displayed on one page. This filter defines the resources to which the template applies. It is possible: to select an existing filter or to create a custom filter specific to the template. To do this, select Customized. If this box is checked, it activates a pull-down menu containing the list of resources. Choose the event creation hierarchies. If no hierarchy is chosen, it will not be possible to create events in this template. The hierarchies available are the ones that allow an event to be created with the resources of the template dimension. Choose the event input editor. It is possible to select: The automatic editor: the appropriate editor appears based on the filters defined in the editor settings. If the event is included in a filter defined in an editor, this editor will be opened. A specific editor: this editor will always open for all events in the context. 6

Select the resource-type headings of the template dimension for which events should be displayed. Choose the events filters for the dependent resources selected above. It is possible: to select an existing filter or to create a custom filter specific to the template. To do this, select Customized. Creating an Events List template Go to Settings > Configuration pane > Click VPGO. To create a VPGO Events List template, right-click VPGO Templates > Create an Events List > choose the dimension or click the button and choose the dimension. The pane below is activated: Specify the characteristics (below) of the Events List template and confirm by clicking OK. Give the template a name. Give the template a description. If a description is entered, it will appear in the tab header in VPGO. This represents the creation date and time and the most recent change to the template, together with the login of the user who made the change. This property is updated automatically. 7

If this box is checked, the template is activated and made available to VPGO users. If this box is checked, users can access the template in offline mode. If this box is checked, the duplication button is displayed when editing an event. Choose the filters that will be available in the template from the list of existing events filters. Choose the period when events are visible. If this box is checked, the names of entities and VISUAL PLANNING attributes are displayed. This option is only available if the Auto Format Text box is not checked. Right-clicking brings up an HTML editor. This makes it possible to create your own visuals for events: By entering formatted or unformatted text, By inserting images, tables and event attributes. This option is only active if the Auto Format Text box is checked. The data will be displayed in the tooltip. Select the headings and/or event attributes that will be used to describe events. The wording that will be displayed can be modified. 8

Select the heading that will be used to group the data. The order can be ascending or descending. Select the heading that will be used to sort the data. The order can be ascending or descending. Choose the dimension that defines the icon in the event duration bar. Choose the size of icons. This box is only active if a dimension has been chosen above. Choose the dimension(s) that define(s) the event background color. If several dimensions are selected, the event bar will show the dimension colors. If only one dimension defines the background color and it is shaded, it will also be visible in the duration bar. Define the maximum number of event lines that will appear on one page. If the value stays at -1 (the default value), all the lines will be displayed on one page. This filter defines the resources to which the template applies. It is possible: to select an existing filter or to create a custom filter specific to the template. To do this, select Customized. If this box is checked, it activates a pull-down menu containing the list of resources. Choose the event creation hierarchies. If no hierarchy is chosen, it will not be possible to create events in this template. The hierarchies available are the ones that allow an event to be created with the resources of the template dimension. Choose the event input editor. 9

It is possible to select: The automatic editor: the appropriate editor appears based on the filters defined in the editor settings. If the event is included in a filter defined in an editor, this editor will be opened. A specific editor: this editor will always open for all events in the context. Creating a Resources List template Go to Settings > Configuration pane > Click VPGO. To create a VPGO Resources List template, right-click VPGO Templates > create a Resources List > choose the dimension or click the button and choose the dimension. The pane below is activated: Specify the characteristics (below) of the Resources List template and confirm by clicking OK. Give the template a name. Give the template a description. If a description is entered, it will appear in the tab header in VPGO. This represents the creation date and time and the most recent change to the template, together with the login of the user who made the change. This property is updated automatically. If this box is checked, the template is activated and made available to VPGO users. If this box is checked, users can access the template in offline mode. 10

If this box is checked, the names of entities and VISUAL PLANNING attributes are displayed. This option is only available if the Auto Format Text box is not checked. Right-clicking brings up an HTML editor. This makes it possible to create your own visuals for events: By entering formatted or unformatted text, By inserting images, tables and event attributes. This option is only active if the Auto Format Text box is checked. The data will be displayed in the tooltip. Select the headings and/or event attributes that will be used to describe events. The wording that will be displayed can be modified. Select the heading that will be used to group the data. The order can be ascending or descending. Select the heading that will be used to sort the data. The order can be ascending or descending. 11

If this box is checked, the resources' icons are displayed. Choose the size of icons. This box is only active if the Display Icon box is checked. The color of the resource lines can be selected by choosing the resource color or the color of one of the calculated headings with thresholds for the resource. The color will appear in the resource editing field (to the left of the resource line). Define the maximum number of lines that will appear on one page. Choose the filters that will be available in the template from the list of existing resource filters. Choose the input editor used when creating resources. Choose the input editor used when editing resources. It is possible to select: The automatic editor: the appropriate editor appears based on the filters defined in the editor settings. If the resource is included in a filter defined in an editor, this editor will be opened. A specific editor: this editor will always open for all resources in the context. EDITING A VPGO TEMPLATE To edit an existing template: 1. Go to Settings > Configuration pane > click VPGO and the editing window will be displayed on the screen. 2. Click the template to edit and the corresponding panel will be displayed. 3. Edit the template settings. DUPLICATING A VPGO TEMPLATE To duplicate an existing template: 1. Go to Settings > Configuration pane > click VPGO and the editing window will be displayed on the screen. 2. Click the template to duplicate > Duplicate and the corresponding panel will be displayed with the new duplicate template. 3. Edit the template settings. DELETING A VPGO TEMPLATE To delete a template, select the template by right-clicking > Delete. The following message appears: 12

Click: Yes to confirm the deletion, No to cancel. CREATING AN INPUT EDITOR Creating a resource editor Specific resource editors can be created for the VPGO Resources List template. To do this: 1. Go to Settings > Configuration pane > click VPGO, 2. Click the button to the left of "Input editors", 3. Right-click Resource editors > Create a resource input editor > select the dimension you want. The corresponding pane opens: 13

Specify the characteristics of the editor (below) and confirm by clicking OK. The Name field is required. It gives the template a name. The Description field is optional. It gives the template a description. This represents the creation date and time and the most recent change to the template, together with the login of the user who made the change. This characteristic cannot be edited. This box determines whether the template is active. Uncheck the box to make the resource editor temporarily unavailable. Choose the filter that defines the resources to which the template applies. Choose the data to display when editing resources. The wording that will be displayed when editing can be modified, together with the associated tooltip. 14

Creating an event editor Specific event editors can be created for the VPGO Events List template and the Diary template. To do this: 1. Go to Settings > Configuration pane > click VPGO, 2. Click the button to the left of "Input editors", 3. Right-click Events editors > Create an event input editor. The corresponding pane opens: Specify the characteristics of the editor (below) and confirm by clicking OK. The Name field is required. It gives the template a name. The Description field is optional. It gives the template a description. 15

This represents the creation date and time and the most recent change to the template, together with the login of the user who made the change. This characteristic cannot be edited. This box determines whether the template is active. Uncheck the box to make the resource editor temporarily unavailable. Choose the filter that defines the events to which the template applies. Choose the data to display when editing events. To be able to edit a resource of a given dimension in an event, the identification headings of Dimension type must be displayed in the list of available entities. The wording that will be displayed when editing can be modified, together with the associated tooltip. 16

Chapter 2. Using VPGO Downloading the VPGO app Download the VPGO app on to your mobile device from Google Play or the App Store. Adding a planner to VPGO To add a planner: 1. Open the VPGO app on the mobile, 2. Click the Add button, 3. Choose how to add the schedule, Manually or by Flash code. Adding a planner manually Enter the information below: Enter the URL where the planner is stored. It takes the form: http://vp_server_name/vplanning/. where vp_server_name is the name of the server where VISUAL PLANNING is installed. 17

Choose the required planner. Click OK to add the planner. Enter a URL in the form http://vp_server_name/vplanning/web/m into your browser and flash the code of the planner to add with the VPGO app. where vp_server_name is the name of the server where VISUAL PLANNING is installed. Choosing the language The user interface language is the language of the mobile device on which the app is installed. Connecting to the schedule If identification is defined through Admin Center, the user name and password are the same as the ones used to connect to VISUAL PLANNING. If identification is defined by a dimension, the user name and password are the ones entered into the headings used for identification in the VPGO module settings. Once these details have been entered, VPGO offers to link the login information to the digital fingerprint if your mobile phone has a fingerprint scanner. If you accept, the app will offer fingerprint authentication the next time you log in. Once connected, the following screen is displayed: 18

From this screen, you can: Log out by pressing the button Choose offline mode by pressing the button and deactivating the Online button. If you are connected to the server, the button will be displayed on all VPGO screens, If you are disconnected from the server, the button will be displayed on all VPGO screens. Access the Settings by pressing the menu button at the top left of the screen and then pressing Settings. The following window appears: The functions below can be accessed from this screen. Attachments What to download: If this button is activated, only files smaller than 20 MB can be downloaded, How to download: If this button is activated, downloads can use mobile data, When to download: If this button is activated, downloads can only take place when the mobile is charging, Battery: Defines the minimum battery level for downloading to be enabled, Quota: Defines the space allocated to attachments, Empty the cache: press this button to empty the cache. Fingerprint To activate fingerprint recognition, press the button. 19

Next time you log into VPGO, a window will suggest linking a fingerprint that has already been saved on your mobile with your VPGO login. Storage This function is only possible if your mobile has a fingerprint scanner that has been set up. Press the button to view your storage space. The following screen appears: Choosing a template When VPGO is launched, an existing template can be selected by pressing the corresponding tab. When you select a Diary or Events list template, the corresponding events are displayed. When you select a Resources list template, the corresponding resources are displayed. Using VPGO templates Diary template 20

When VPGO is launched, if a Diary template has been configured for the schedule, it can be selected by pressing the corresponding tab. This view displays all the days of a full month. Days containing at least one event are highlighted. When you select a day, the list of events including the day is displayed below: Each event is identified by the characteristics described when configuring the VPGO module. When the events list is displayed, more detailed information can be viewed for each event. To view this information, press an event. Today's date The current date can be selected by pressing the Date button. You can move forward or backward through time by pressing the corresponding arrows. Events filters If events filters were selected in the "Events filter" field when configuring the Diary module, events can be filtered. To select an events filter, press the button. The screen below appears: 21

Select the filter to apply and press OK to save changes. Resources filters If the "Choice of Dimensions" box was checked during configuration, events can be filtered based on the list of resources for the Dimension. To select a resource, press the button. The screen below appears: Select the resource and press OK to save changes. Searching The events displayed can be filtered. Filtering can: Filter the event lines displayed, Filter based on headings and the properties displayed, Condition: Contains. Note that headings and properties that are not visible in the template are not counted when checking the filter condition. 22

Pressing an event opens the editing window: The data displayed for an event can be edited if the user has the required permissions. To edit data, press the property to edit. Three options are available when editing an event: Press OK to save the changes, Press Delete to delete the event. A message appears. Press OK to delete or Cancel to cancel the deletion, Press Cancel to leave the event as it is. Date Changing the date The delete option is only available in online mode. Press a date to edit it. The following window appears: Select a date and press Define to save the changes. Changing the time This change is only possible if the event is hourly. Press the date to change the time. The following window appears: 23

Select a time and press Define to save the changes. Dimension For a dimension, resources can be edited if the Dimension entity is displayed in the event. Choose the resource for the dimension and press OK to save changes. If no hierarchy was defined at the configuration stage, it will not be possible to create an event. To create an event, just press the button. If several hierarchies were selected at the configuration stage, choose one on the following screen: The resources for the obligatory dimensions of the selected hierarchy must be chosen on the following screen: 24

Press the button to cancel the creation of the event. Press the OK button to continue creating the event. Enter the event's properties on the next screen: Then: confirm the creation of the event by pressing the OK button, or cancel it by pressing the Cancel button. Events list template When VPGO is launched, if an Events List template has been configured for the schedule, it can be selected by pressing the corresponding tab. Events corresponding to the filter defined in the template will be displayed. Each event is identified by the characteristics described during the configuration. 25

When the events list is displayed, more detailed information can be viewed for each event. To view this information, press an event. Events filters If events filters were selected in the "Events filter" field when during configuration, events can be filtered. To select an events filter, press the button. The screen below appears: Select the filter to apply and press OK to save changes. Resources filters If the Choice of Dimensions box was checked during configuration, events can be filtered based on the list of resources for the Dimension. To select a resource filter, press the button. The screen below appears: Select the resource and press OK to save changes. Searching The events displayed can be filtered. Filtering can: Filter the event lines displayed, Filter based on headings and the properties displayed, Condition: Contains. 26

Note that headings and properties that are not visible in the template are not counted when checking the filter condition. Pressing an event opens the editing window. The data displayed for an event can be edited if the user has the required permissions. To edit data, press the property to edit. Three options are available when editing an event: Press OK to save the changes, Press Delete to delete the event. A message appears. Press OK to delete or Cancel to cancel the deletion, Press Cancel to leave the event as it is. Date Changing the date The delete option is only available in online mode. Press a date to edit it. The following window appears: 27

Select a date and press Define to save the changes. Changing the time This change is only possible if the event is hourly. Press the date to change the time. The following window appears: Select a time and press Define to save the changes. Dimension For a dimension, resources can be edited if the Dimension entity is displayed in the event. Choose the resource for the dimension and press OK to save changes. If no hierarchy was defined at the configuration stage, it will not be possible to create an event. To create an event, just press the button. If several hierarchies were selected at the configuration stage, choose one on the following screen: 28

The resources for the obligatory dimensions of the selected hierarchy must be chosen on the following screen: Press the button to cancel the creation of the event. Press the OK button to continue creating the event. Enter the event's properties on the next screen: Then: confirm the creation of the event by pressing the OK button, or cancel it by pressing the Cancel button. Resources list template 29

When VPGO is launched, if a Resources List template has been configured for the schedule, it can be selected by pressing the corresponding tab. Resources corresponding to the filter defined during configuration will be displayed. Each resource is identified by the characteristics described during the configuration. When the resource list is displayed, more detailed information can be viewed for each resource. To view this information, press a resource. Searching Searching The resources displayed can be filtered. Filtering can: Filter the resources displayed, Filter on the headings displayed, Condition: Contains. Note that headings that are not visible in the template are not counted when checking the filter condition. Pressing a resource opens the editing window: 30

Press the button to send an email to the person. The headings displayed for a resource can be edited if the user has the required permissions. There are three possibilities: Press OK to save the changes, Press Delete to delete the resource. Press Cancel to leave the resource as it is. To create a resource, just press the button. The screen below appears: Then: confirm the creation of the resource by pressing the OK button, or cancel it by pressing the Cancel button. Special cases Geolocation heading 31

If automatic location has been deactivated in the definition of the Geolocation heading, the position can be calculated. Press the map to display the position. This screen is displayed: Press the Click the button to return to the starting point on the map. button to calculate your route. A pop-up appears: Select an application to calculate your route. Attachment heading VPGO presents all the route calculation apps installed on your mobile. If the heading is displayed, pressing the link opens the file. The heading must be loaded on the server and be of type File list. If the heading is displayed, the image corresponding to the resource is displayed. The heading must be loaded on the server, have only one file and be of type Image album. Use in offline mode 32

When you are disconnected from the server, the app still allows events and resources to be created/viewed as long as the templates are accessible in offline mode (see template configuration). Creating and editing an event If no hierarchy was defined at the configuration stage, it will not be possible to create an event. To create an event, just press the button. If several hierarchies were selected at the configuration stage, choose one on the following screen: The resources for the obligatory dimensions of the selected hierarchy must be chosen on the following screen: Press the button to cancel the creation of the event. Press the OK button to continue creating the event. Enter the event's properties on the next screen: 33

Then: confirm the creation of the event by pressing the OK button, or cancel it by pressing the Cancel button. If confirmed, the event will remain suspended until synchronized with the server. A notification will appear at the top of your screen. Touch the notification and then Events to view the events awaiting creation or editing. The list of events waiting for synchronization is displayed: The icon appears next to events awaiting creation. Swipe the event from left to right to view or delete it. 34

When the connection to the server is restored, the app will synchronize with the server and process the event awaiting creation: If the event awaiting creation complies with all the requirements and event creation permissions, it will be created and will appear in VPGO and the rich client, If the event awaiting creation fails to comply with a requirement or the event creation permissions, it will not be created and this alert will appear. The icon appears next to events that could not be created. Pressing an event opens the editing window. 35

The data displayed for an event can be edited if the user has the required permissions. To edit data, press the property to edit. Once the changes have been made, there are two possibilities: Press OK to save the changes, Press Cancel to leave the event as it is. If confirmed, the event will remain suspended until synchronized with the server. A notification will appear at the top of your screen. Touch the notification and then Events to view the events awaiting editing. The list of events waiting for synchronization is displayed: The icon appears next to events awaiting editing. Swipe the event from left to right to view or delete the change. 36

When the connection to the server is restored, the app will synchronize with the server and process the event awaiting editing: If the event awaiting editing complies with all the requirements and event editing permissions, the changes will be made, If the event awaiting editing fails to comply with a requirement or the event editing permissions, it will not be changed and this alert will appear. The icon appears next to events that could not be edited. Creating and editing a resource To create a resource, just press the button. The screen below appears: Then: confirm the creation of the resource by pressing the OK button, or cancel it by pressing the Cancel button. If confirmed, the resource will remain suspended until synchronized with the server. A notification will appear at the top of your screen. Touch the notification and then Dimension to view the resources of the Dimension awaiting creation or editing. 37

The list of resources waiting for synchronization is displayed: The icon appears next to resources awaiting editing. Swipe the resource from left to right to view or delete it. When the connection to the server is restored, the app will synchronize with the server and process the resource awaiting creation: If the resource awaiting creation complies with all the requirements and resource creation permissions, it will be created and will appear in VPGO and the rich client, If the resource awaiting creation fails to comply with the resource creation permissions, it will not be created and this alert will appear. 38

The icon appears next to resources that could not be created. Pressing a resource opens the editing window: The data displayed in a resource can be edited if the user has the required permissions. To edit data, press the property to edit. Once the changes have been made, there are two possibilities: Press OK to save the changes, Press Cancel to leave the resource as it is. If confirmed, the resource will remain suspended until synchronized with the server. A notification will appear at the top of your screen. Touch the notification and then Dimension to view the resources of the Dimension awaiting creation or editing. The list of resources waiting for synchronization is displayed: 39

The icon appears next to resources awaiting editing. Swipe the resource from left to right to view or delete the change. When the connection to the server is restored, the app will synchronize with the server and process the resource awaiting editing: If the resource awaiting editing complies with all the requirements and event editing permissions, the changes will be made, If the resource awaiting editing fails to comply with the resource editing permissions, it will not be changed and this alert will appear. The icon appears next to resources that could not be edited. 40