The Exposed Properties of an App
Exposed properties are parameters passed in the URL of an app. They apply to certain types of data sources from the Applications category and, when the app is run, they are used to:
- Restrict the records displayed by applying a specific filter.
- Display records using a specific view.
- Narrow the search to specific records in Service Manager or in a Self Help knowledge base.
Examples
App narrowing the search for employees based on the login
See the use case.
- Employees are displayed using a Data Viewer widget that points to an EasyVista data source.
- To display only employees whose login contains the value, ALBERS, the exposed property of the data source, SearchValue, is passed as a parameter in the URL.
App retrieving the details of an incident
- An automatic email containing a direct link to the Incident form is sent to users.
- To retrieve the incident, the exposed property of the EasyVista data source, SearchValue, is passed as a parameter in the URL.
App narrowing the search for information from a Self Help knowledge base based on the title of a ticket
See the use case.
- A Self Help project is implemented in the app via a Self Help widget that points to an EasyVista Self Help data source.
- To enable the search for information in this Self Help project, the exposed property of the EasyVista data source, SearchValue, is passed as a parameter in the URL.
- The app is linked to Service Manager Incident form.
- The value to be retrieved from the data source is determined dynamically in Service Manager based on the title of the current ticket.
Notes
- The list of objects with exposed properties as well as the properties that can be used are defined by EasyVista. You cannot add new ones.
- The parameters passed in the URL apply to all app widgets that point to a data source where one of the exposed properties is specified.
- Integration of exposed properties:
- Shortcuts integrate the exposed properties of apps to which they point.
- The QR code does not take exposed properties into consideration. This enables it to be valid at all times.
List of predefined exposed properties
Objects can have several exposed properties.
- Filter property:
- Used to apply a specific filter to restrict the records displayed.
- Applies to EasyVista data sources and EasyVista Discussions data sources.
- Corresponds to the Content > Filter property of the data source.
- The search value corresponds to the filter selected from the drop-down list.
- View property:
- Used to display records using a specific view.
- Applies to EasyVista data sources.
- Corresponds to the Content > View property of the data source.
- The search value corresponds to the view selected from the drop-down list.
- Search Value property:
- Used to search records for a specific value.
- Applies to EasyVista data sources, EasyVista Self Help data sources and EasyVista Virtual Agent data sources
- Corresponds to the Search > Search Field property of the data source.
- The search value corresponds to the Search > Search Value property of the data source.
Caution
- Aliases associated with parameters are for information purposes only. They do not have any impact on the search values.
- You must select the column to be used for a Search Value exposed property in the Search section of the data source.
See the use case.
- Because the app URL can be seen by users, parameters are therefore passed using aliases. For security reasons, you should specify anonymous aliases such as Param1, Param2, etc.
- For contextual apps implemented in Service Manager forms, you must map the Service Apps exposed properties with the relevant fields in the Service Manager form.
See the use case.
Only fields in the Service Manager form with an alias that are present in the main form presentation will be available for the mapping.See the procedure if the field you want is not available.
Best Practice
- To retrieve a filter ID or view ID, select the relevant filter or view in the Content section of the data source. The GUID will automatically be loaded as the default value in the exposed properties.
- Rename the default values of parameter aliases so that you can identify their function easily.
example Default value SearchValue ==> Alias Phone
- URL generation:
- No exposed property is selected by default when you open the dialog box. Select the exposed properties you want and generate the URL.
- If you modify one of the exposed properties, you should regenerate the URL so that the modifications you made are taken into account.
Screen description
Access: In the general properties or in the dialog box for sharing the app
Note: When using exposed properties for the first time, the dialog box will display all exposed properties available for the app. Select those you want to pass in the URL and define their value.
Widget name: App object with exposed properties.
Property name: Name of the exposed property applicable to the object. See the list.
URL parameter alias: Alias used to identify the parameter function.
- Double-click the cell to modify the default name.
Content/Value: Parameter value to be passed in the URL.
- Double-click the cell to modify the value.
- Filter/View parameters: Filter ID or view ID (GUID).
- SearchValue parameter: String of characters in the column selected in the Search > Search Field property of the data source.
- Values specified in the data source are displayed as default values.
example DS EasyVista Employee data source using the List view ==> Value of the View exposed property = {42CEA486-C6CD-4146-AFB6-8830D59E0A86}
Add Properties: Used to add new exposed properties from those that have not yet been used.
- Select the exposed properties you want to pass in the URL and define their value.
Delete Properties: Used to delete the selected exposed properties from the list. They will no longer be passed as a parameter in the URL and will once again be available in the Add Properties dialog box.
Generate URL: Used to generate the URL using the selected exposed properties. A link will be used to run the app in a new Web browser tab via the URL containing the exposed properties.
- Parameters are passed using aliases.
- You should separate exposed properties using the ampersand &.
Use cases
Narrow the search for employees based on the login
example Generate a URL that will display the list of Service Manager employees whose login contains the value ALBERS ==> You must define the Search Value exposed property linked to the data source pointing to the list of employees.
Step 1: Create the data source pointing to the list of employees.
1. Create an EasyVista data source and name it DS EasyVista Employee.
2. Specify the following properties.
- Parent Query: Operation > Directory > Employees
- Filter: None
- View: List
3. Complete the information required for the exposed properties.
- Search > Search Field property: Login
Step 2: Create the widget to display the list of employees.
1. Create a Data Viewer widget.
2. Link it to the DS EasyVista Employee data source in Grid mode.
All records in the data source will appear in List mode.
Step 3: Configure the Search Value exposed property of the data source.
1. Click or
to open the Exposed properties dialog box and click Exposed properties.
2. Add the Search Value exposed property of the data source so that a search can be run on specific values.
- Click Add Properties.
- Select the Search Value property of the DS EasyVista Employee data source and click OK.
The data source's exposed property will be added to the list of exposed properties already used in the app.
3. (optional) Modify the default value of the alias, SearchValue, and give it a meaningful name so that you can identify the exposed property easily.
- Double-click the URL parameter alias cell.
- Rename the parameter alias, Login.
4. Indicate the search value for the data source.
- Double-click the Content/Value cell.
- Enter the value you want to search for, ALBERS.
Step 4: Run the app with the exposed property.
1. Select the Login exposed property in the DS EasyVista Employee data source.
2. Click Generate URL.
The direct link to the app will be generated and displayed at the bottom of the dialog box.
3. Run the app using this URL.
- Click the Execute url application link.
or
- Click to copy the link.
- Access the link using your Web browser.
The list of employees whose login contains ALBERS will appear.
Search in Self Help contextual information to a ticket title
See Forms - Contextual Apps > Use case.