Skip to main content

Creating an OData Dialog - Knowledgebase / Lasernet CE Connector / Lasernet CE Connector General Information - Formpipe Support Portal

Creating an OData Dialog

Authors list

This article provides step-by-step instructions on how to create a new OData Dialog record as a part of the Lasernet Connector configuration within Microsoft Dynamics 365 Customer Engagement (D365 CE).

OData Dialogs is an action that allows executing a report in Microsoft Dynamics 365 Finance and Operations. Clicking the OData Dialogs button in D365 CE opens a print dialog. Here you can choose a printer, a number of copies, etc. Data is received from the D365 CE entities. The button is used when D365 CE is not connected to Microsoft Dynamics 365 Finance and Operations (D365 FO), or if you want to use a logic app.


1. Sign into your D365 CE system.

2. On the Sales menu, click the drop-down menu to show the navigation menu flyout, and then under the Settings flyout, click OData Dialogs in the Lasernet list.


The Active Lasernet OData Dialogs page is displayed. Follow the steps listed below to create a new OData Dialog record.

3. On the Active Lasernet OData Dialogs page, click the NEW button.

4. Fill in all the required fields and then click the Save icon.


In the OData Endpoint as well as OData Submit Endpointtext boxes, enter the URL which is composed of the Microsoft Dynamics 365 Finance and Operations environment URL and the API interface to your Lasernet service. The latter is a fixed part. Here is an example of this fixed part for the OData Endpoint text box value:

.../api/services/LACCRMServiceGroup/LACCRMReportExecuteService/newReport

Here is an example of this fixed part for the OData Submit Endpoint text box value:

.../api/services/LACCRMServiceGroup/LACCRMReportExecuteService/executeReport

As a result, a new OData Dialog record is listed on the Active Lasernet OData Dialogs page.


5. In the Active Lasernet OData Dialogs list, click the OData Dialog record you have just added. You can see the OData Dialog page opens for editing.

6. In the Lasernet Groups/OData Dialogs (OData Dialog) section, click a plus icon to add a group/OData Dialog record.

7. In the dialog displayed, enter a name in the corresponding text box as well as select a group and then click the Save icon to save changes.

In addition, you can add a new OData Dialog record when adding a new group or editing the existing one. To this end, see step 11 in the Configuration | Lasernet Connector for Dynamics 365 CE | Add a new button to a new flyout article.

ODATA Dialog fields

The following table defines some of the fields when creating a new ODATA Dialog record:

ODATA Dialog field query Answer

What does Pre-Fetch Print dialog No/yes do?

This is when the information needed to populate the printing dialog is fetched from FO ahead of time and stored in the browser's local storage (cache) when a form is opened.
It will not run if a match is found in the cache.
 
It can remove the “Loading” message that’s displayed the first time a user opens the printing dialog for a given form in a cleared browser.
 
It can have a negative impact on performance if there are many buttons applied to the same form/entity.

What does Fetch print Dialog On Click No/yes do?

Same as above, except that it happens when the user clicks on the OData dialog button.

Does not have a negative impact on performance, as it is only invoked when the user clicks on the button.

However, the time saved using this will only be in the range of 50-400 ms.

What does Wait for Fetch No/yes do?

 If the printing dialog should wait for any running pre-fetches (the two above), or if it should start its own fetch as soon as it opens.
 
It will only wait if a pre-fetch has signaled that it’s running.
 
The printing dialog will start its own fetch if the pre-fetch fails.

It's faster to wait for an existing pre-fetch than to start a new fetch, however, a pre-fetch will not be able to display an error message from FO.

Any failed pre-fetch will require a fresh fetch and will result in extra time.

What does Wait for Fetch timeout No/yes do?

How many seconds the printing dialog should wait for a running pre-fetch to finish (option above), before starting its own fetch.

What does Storage Timeout  No/yes do?

How many seconds the information for the printing dialog should be stored in the browser's local storage (cache) before being removed (expired).
 
This value should be set low if the customer is frequently changing report mapping in FO and wants to avoid clicking on "CLEAR CACHE FOR ALL" under Lasernet Parameters in D365.

How to use the Image 16 field? How do you add a picture?
How to use the ModernImage and what's the difference from Image ##?

Image 16 is an image with 16x16 pixels, 32 is 32x32 pixels, and ModernImage is for SVG (Vector) images.
An example is the images for standard Direct Print and Lasernet flyout:

 

Uses the following LAC web resources:

Which are applied using Image16, Image32 and ModernImage:


The same values could also be applied to buttons, like so:

 
The difference between 16/32 and modern image is that modern is vector-based, so it scales up without becoming pixilated.
Furthermore, the unified interface only supports modern images.




Helpful Unhelpful

Add a comment

Please log in or register to submit a comment.

Need a password reminder?

Share