Resco Inspections on Dynamics 365: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{WIP}}
{{Inspections TOC}}
[[Resco Inspections]] can be combined with your [[Dynamics]] 365/CRM organization and grant you access to powerful checklists and questionnaires.
[[Resco Inspections]] can be combined with your [[Dynamics]] 365/CRM organization and grant you access to powerful checklists and questionnaires.


Line 48: Line 48:
# In the web browser, log into your Dynamics 365 organization and switch to the Resco Suite app.<br>[[File:01 Resco Suite app.png|600px]]  
# In the web browser, log into your Dynamics 365 organization and switch to the Resco Suite app.<br>[[File:01 Resco Suite app.png|600px]]  
# Select Inspections and start the Questionnaire Designer tool.<br>[[File:10 Questionnaire Designer.png|600px]]  
# Select Inspections and start the Questionnaire Designer tool.<br>[[File:10 Questionnaire Designer.png|600px]]  
# New window with the Questionnaire Designer opens. Click either the '''New''' button or the '''New Questionnaire''' link to start the [[Questionnaire_Designer#Creating_a_new_questionnaire|New Questionnaire Wizard]].<br>[[File:11 New questionnaire.png|600px]]
# New window with the Questionnaire Designer opens. Click either the '''New''' button or the '''New Questionnaire''' link to start the [[Questionnaire_Designer#Creating_a_new_questionnaire|New Questionnaire Wizard]].<br>[[File:11 New questionnaire.png|600px]]<br>A quick overview of the Questionnaire Designer’s capabilities can be found [[Resco_Inspections_on_Dynamics_365#Designing_the_questionnaire|later in this article]]; more comprehensive information are [[Questionnaire Designer|here]].
#: A quick overview of the Questionnaire Designer’s capabilities can be found [[Resco_Inspections_on_Dynamics_365#Designing_the_questionnaire|later in this article]]; more comprehensive information are [[Questionnaire Designer|here]].
# When your finish your new template, click '''Save & Close'''.
# When your finish your new template, click '''Save & Close'''.
# In the Questionnaires List select the draft of your template and click '''Activate'''.<br>[[File:12 Template activation.png|600px]]
# In the Questionnaires List select the draft of your template and click '''Activate'''.<br>[[File:12 Template activation.png|600px]]
Line 57: Line 56:
=== Mobile app ===
=== Mobile app ===


Finally, it is necessary to download the Resco Inspections mobile app on your device via the corresponding application store and synchronize it with your Dynamics 365/CRM organization: https://docs.resco.net/wiki/Resco_Inspections_(app).
Finally, it is necessary to download the [[Resco_Inspections_(app)|Resco Inspections mobile app]] on your device via the corresponding application store and [[Connecting to CRM|synchronize it with your Dynamics 365/CRM organization]].


Note: If you already use the standard Resco Mobile CRM “blue” app with your Dynamics 365/CRM organization and you enabled Resco Inspections in your existing app project, you don’t have to switch to the Resco Inspections mobile app. The “blue” app fully supports all the Resco Inspections features.
{{Note|If you already use the standard [[Resco Mobile CRM]] “blue” app with your Dynamics 365/CRM organization and you enabled Resco Inspections in your existing app project, you don’t have to switch to the Resco Inspections mobile app. The “blue” app fully supports all the Resco Inspections features.}}


== Designing the questionnaire ==
== Designing the questionnaire ==
Line 75: Line 74:
* Special: Regarding Lookup question is used to store the reference of the entity record from which the corresponding questionnaire has been opened by the mobile user  
* Special: Regarding Lookup question is used to store the reference of the entity record from which the corresponding questionnaire has been opened by the mobile user  


{{Note|When adding a new group or question into your template, carefully define not only its label (i.e., what the mobile user sees in the app) but also the technical name – this must be unique within the template and will appear in the Rules Editor when building a custom business logic. }}
{{Note|When adding a new group or question into your template, carefully define not only its label (i.e., what the mobile user sees in the app) but also the technical name – this must be unique within the template and will appear in the Rules Editor when building a custom business logic.}}
 
[[File:16 Question name.png|600px]]


=== Enable scoring ===
=== Enable scoring ===


You can use the native Scoring feature to evaluate each answered questionnaire based on the value of the answers (more information can be found here):  
You can use the native '''[[Questionnaire_Designer#Scoring|Scoring]]''' feature to evaluate each answered questionnaire based on the value of the answers.
 
[[File:Summer 2020 scoring.png|600px]]


=== Define styles ===
=== Define styles ===


To make the questionnaire more appealing to the mobile user, you can change the appearance of each question by using the Form Styles (more information can be found here):
To make the questionnaire more appealing to the mobile user, you can change the appearance of each question by using the [[Questionnaire_Designer#Editing_styles|Form Styles]].
* create and define your custom style within the Form Styles library  
* create and define your custom style within the styles library  
* assign the custom style to the corresponding question  
* assign the custom style to the corresponding question
 
[[File:18 Style.png|600px]]


=== Add custom business logic ===
=== Add custom business logic ===


To make the questionnaire more interactive and dynamic for the mobile user, you can add a custom business logic with different level of complexity (more information can be found here):
To make the questionnaire more interactive and dynamic for the mobile user, you can add a custom business logic with different levels of complexity.
* Smart questions: simple rules that allow you to easily control some properties of the groups or questions  
; [[Questionnaire_Designer#Smart_question_properties|Smart question properties]]: Simple rules that allow you to easily control some properties of the groups or questions<br>[[File:Smart question rule.png]]
* Rules: more complex root-level or group-level rules managed within the Rules Designer  
; [[Questionnaire_Designer#Smart_default_values|Smart default values]]: Configure a default value to save time for the inspector in the field<br>[[File:Smart default value.png|600px]]
* JavaScript: more advanced logic that cannot be covered by rules can be written in JavaScript  
; [[Questionnaire_Designer#Editing_rules|Rules]]: More complex root-level or group-level rules managed within the Rules Designer <br>[[File:19 Rules.png|600px]]
; [[Resco_JavaScript_Bridge#Questionnaire|JavaScript]]: The most advanced logic that cannot be covered by smart properties or rules can be written in JavaScript


=== Add custom commands ===
=== Add custom commands ===
Line 114: Line 120:
There are multiple ways how the mobile user can open the questionnaire template within the Resco mobile app; some of them require advanced customization and configuration in the Woodford project.  
There are multiple ways how the mobile user can open the questionnaire template within the Resco mobile app; some of them require advanced customization and configuration in the Woodford project.  


See '''[[Adding questionnaires to app projects]]''' for various integration options.
== Mobile reports on questionnaires ==
Usually, as a final step of the inspection, maintenance, repair, or survey, the mobile user needs to [[Mobile report|generate an output]] that is shared with the customer or the back-office workers.
You can either set up your reports directly in the [[Questionnaire Designer]] together with the questionnaire template; or, for more complex use cases, use a standalone tool, [[Report Designer]].
See '''[[Mobile reports for Resco Inspections]]''' to learn more about these approaches.
=== Generating reports from completed questionnaires ===
Generating a mobile report is easy: simply select the option '''Complete with a Report''' when finishing a questionnaire.
[[File:44 Complete wit a report.png| 200px]] [[File:45 Mobile report.png|400px]]
== Reviewing questionnaires in Dynamics ==
Resco Inspections provide several tools that allow the back-office user to review the answered and completed questionnaires directly within the Dynamics 365/CRM user interface.
=== Result Viewer ===
[[Result Viewer]] is a web-based tool integrated into Dynamics 365/CRM that can be used by the back-office users to review the in-progress or completed questionnaires in a read-only way, filter them by different criteria, and even export the answers into CSV file.
To access the Result Viewer in Dynamics 365, in the web browser (we suggest using Chrome) log into your Dynamics 365 organization and switch to the Resco Suite app.
[[File:01 Resco Suite app.png|600px]]
Go to the Inspections section and open the Result Viewer tool.
[[File:40 Result Viewer 1.png|600px]]
* Left panel = filter criteria
* Middle panel = list of in-progress / completed questionnaires
* Right panel = selected questionnaire (read-only)
[[File:41 Result Viewer 2.png|600px]]
See [[Results Viewer]] for more information.
=== Result Viewer on entity form ===
Since the Result Viewer component is a Dynamics web resource developed by Resco and included in the Woodford managed solution, it can be easily placed on any entity form in Dynamics 365/CRM and configured to display the completed questionnaires associated with the specific record.
See '''[[Results_Viewer#Adding_completed_questionnaires_to_Dynamics_entity_forms|Adding completed questionnaires to Dynamics entity forms]]''' for instructions.
=== Questionnaire Player on entity form ===
Questionnaire Player is another Resco-built web resource that can be placed on the Questionnaire entity form in Dynamics. When configured properly, it displays the answered questionnaire the same way as the Resco mobile app and even allows the back-office user to modify the in-progress questionnaire.
Detailed steps:
# In Dynamics 365/CRM go to Settings > Customizations > Customize the System > Entities > Questionnaire > Forms > open the entity form where you want to insert the Questionnaire Player.
# Go to the '''INSERT''' tab and add new one-column tab to the form. Change its label to Questionnaire Player.
# Select the newly created Questionnaire Player tab and add a web resource <code>resco_MobileCRM/WebClient/index.html</code>. Enter the name and the label.
# Add a custom parameter <code>qplayer=1</code> check '''Pass record object-type code and unique identifier as parameters'''.
# Optionally, switch to the '''Formatting''' tab and change the '''Number of Rows''' to 20. Save and publish the changes.
[[File:46 Questionnaire Player 1.png|600px]]
In Dynamics 365/CRM open any in-progress questionnaire -> switch to the Questionnaire Player tab to review and update the answered incomplete questionnaire:
[[File:47 Questionnaire Player 2.png|600px]]
== Resco Inspections data structure ==
To understand the data structure used to store questionnaire data, see the '''[[Questionnaire_Designer#Technical_information|technical information]]'''.
Currently, the standard Woodford managed solution is not customized in order to provide a user-friendly view of the Resco Inspections data structure. So there are two options available:
* Customize the Resco Inspections entities – define the entity forms and views based on your requirements using the standard Dynamics 365/CRM customization tools.
* For Dynamics 365 (online) organizations you can download a [https://www.resco.net/downloads/rescoInspectionsentities_1_0_0_0_managed.zip separate managed solution] created by Resco and import it into your organization. It contains a separate model-driven app called Resco Inspections Entities that provides a nice and comprehensive view of the Resco Inspections data structure.
[[File:13 Resco Inspections Entities.png|600px]]
List of all answered questionnaires:
[[File:14 All Answered Questionnaires.png|600px]]
Detail of the selected answered questionnaire with the possibility to see the related question groups, questions or update the in-progress questionnaire via Questionnaire Player:
[[File:15 Questionnaire detail.png|600px]]
== Performance considerations ==
If you're looking at a large-scale deployment of Resco Inspections, read about the [[Resco_Inspections#Performance_considerations|tips and settings that can improve performance]].
== Custom questionnaire logic via JavaScript ==
You can employ Resco JavaScript Bridge to add advanced business logic to your questionnaires. See '''[[Resco_JavaScript_Bridge#Questionnaire|JSBridge for questionnaires]]''' to get started.




[[Category:Resco Inspections]] [[Category:Dynamics]]
[[Category:Resco Inspections]] [[Category:Dynamics]]

Navigation menu