Modernized Questionnaire Player

From Resco's Wiki
(Redirected from Questionnaire Player Gen 2)
Jump to navigation Jump to search
Warning Work in progress! We are in the process of updating the information on this page. Subject to change.

Questionnaire Player is a Resco component that is responsible for displaying questionnaires to users. In release 19.0, we introduced the second generation of the questionnaire player, which addresses some of the shortcomings of the legacy player and opens new integration opportunities. Gen 2 brings a modern user interface with accessibility features baked in.

The Questionnaire Player has been completely reworked and modernized using React-based technology and the MUI design framework. It delivers a fresh, modern user interface with a consistent layout and responsive design that adapts seamlessly across desktop, tablet, and mobile devices. The Questionnaire Player is no longer dependent on Woodford. Data collection is now possible outside Resco Mobile CRM without a mobile project or any Woodford-specific configuration. Questionnaires are defined once and can be rendered consistently in Resco mobile apps, Power Apps, Power Pages, and Dynamics 365, without changes to the form itself. Behind the scenes, the original proprietary implementation built on legacy components has been fully replaced by a modern architecture designed to support ongoing enhancements and future requirements.

Why a new generation?

Woodford dependency
The gen 1 questionnaire player requires Woodford (or, more precisely, access to a mobile app project in Woodford) in order to display. By decoupling the player from Woodford, you can go beyond Resco Mobile CRM or Power Platform/Dynamics, you can display the player almost anywhere.
Technology limitation
The first generation of the player is based on the forms used in Resco Mobile CRM. Any questionnaire changes require a custom development effort for each affected platform (iOS, Android, Windows, web). Gen 2 delivers a modern, platform-agnostic, future-proof technology stack that enables much faster development cycles.
Outdated design
Given the constraints of the gen 1 player, some features were impractical to implement. For example, a frequently desired feature, nested groups, is almost impossible for gen 1.

Feature highlights

Gen 2 questionnaires bring new features.

AI voice-activated form filling

Use conversational AI to fill out questionnaires. Technicians can initiate a guided voice session in which the AI assistant "reads" the questionnaire aloud, following the logical order of the question groups. The system is fully rule-aware, meaning it respects existing skip logic and asks only relevant questions based on previous answers. The interaction is flexible: users can choose to answer questions one by one or summarize an entire group of questions in a single spoken prompt. All transcriptions are displayed in real time and remain editable, allowing a final human review before the form is saved.

This use case requires you to set up an OpenAI API key in Woodford configuration. It is only available in the new questionnaire player in Resco Mobile CRM and requires an internet connection for the AI conversation.

Enhanced integration with Power Pages

Compared to legacy questionnaires, we've fundamentally reimagined how our technology integrates with Power Pages. Questionnaire Player is a native, lightweight React component that loads directly in the browser, without heavy background processes, and uses a streamlined data model. To get you started faster, we've included a preconfigured "Demo Page" that lets you deploy a working example almost instantly.

See Power Pages with Gen 2 questionnaires for details.

AI translate for questionnaires

Utilize the power of AI to quickly generate localized versions of your questionnaires. Edit a questionnaire, click Change Localization, add any language, then click AI Translate.

ai generated translation of questionnaires

Table of contents

Gen 2 questionnaires include an automatically generated table of contents. No more endless scrolling when you can jump straight to the relevant section. If you are using group scoring, the TOC displays real-time scores for each section as they are completed, giving users immediate feedback on their progress.

Rich text

In legacy questionnaires, if you wanted to guide a user, you had to juggle separate blocks for text, images, and links. Rich text combines everything into a single formatted block. The intuitive editor supports bolding, bullet points, hyperlinks, and embedded images. Build professional-looking miniguides right inside the form.

Search button

Find what you are searching for without scrolling. Navigating large questionnaires is now much more effective thanks to the Search function. All occurrences are highlighted, and you can easily jump to the previous/next one.

Improved validation

Mistakes happen, but users should not be punished for skipping a question. Validation now highlights missing/invalid answers and guides the user from question to question until all problems are solved.

Better integration with Power Apps

We have deeply embedded the modernized questionnaire player into the Power Apps ecosystem by transforming it into a native PCF (Power Apps Control Framework) component. The player is "context-aware"; it can often infer the correct template from the form context, or display a native lookup dialog for immediate selection. The player can automatically link itself to parent records—like Assets or Accounts—by passing "Regarding" information directly through the form parameters, ensuring every entry is perfectly categorized.

See Power Apps with Gen 2 questionnaires for details.

Deprecated features and compatibility

The following features are no longer available or greatly transformed in the modernized questionnaire player:

  • Simplified styling: We are moving away from complex, global "Styles." These have been replaced by intuitive color settings and layout options (such as horizontal or vertical orientation) that are now configured directly within individual question properties.
  • Standardized data formats: To ensure maximum speed and reliability, legacy data formats are no longer supported. The modernized player now exclusively utilizes full template dependency, our latest JSON schema, and the questionnaire_answer entity for all response storage.
  • Legacy static components like logo, static image, description, link, etc., have all been combined into rich text.
  • Tagged image is unavailable.

We understand that some existing workflows may rely on these specific legacy components. If your current operations require these features, you can continue to use the legacy Questionnaire Player (Gen 1) alongside the new version until you are ready to transition your templates to the new standards.

Data model, answer storage, template format

Gen 2 questionnaires use only three tables:

  • Resco_questionnaire for templates
  • Resco_questionnaireanswer for answers
  • Resco_questionnairefolder to keep templates organized in the Questionnaire Designer

If you are familiar with the generation 1 data model, you may notice that the resco_question and resco_questiongroup tables are not listed. We’re doing away with them, even in templates; all questions are now serialized (in gen 2 templates). Do not remove resco_question and resco_questiongroup tables from your server: they are needed in the Questionnaire Designer to support gen 1 questionnaires.

If you are already using the latest gen 1 answer storage options, nothing changes. Gen 2 supports only the latest data model:

  • latest JSON schema (minimal JSON and flexible JSON)
  • Resco_questionnaireanswer as the storage table
  • Full template dependency

See Resco Inspections data model for details.

Business logic via JavaScript

The second generation of Questionnaire Player uses a new JavaScript library that can be used to manipulate the player and fetch data from the backend. See www.npmjs.com/package/@resconet/qp-bridge.

Here's a high-level overview of using the new qp-bridge:

  1. Install Node.js.
  2. Run the command npm create @resconet/qp-script. A wizard will guide you through the process of creating a new TypeScript project.
  3. Write your code.
  4. Build your project.
  5. In the Questionnaire Designer, edit a questionnaire and upload the build output.
Note You can continue using the traditional Resco JavaScript Bridge in the context of Resco Mobile CRM app for data manipulation within the questionnaire; however, it cannot be used for working with the new questionnaire user interface.