Modernized Questionnaire Player

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. We are preparing the second generation of the questionnaire player that overcomes some of the shortcomings of the older player and opens new integration opportunities. Gen 2 brings modern user interface with accessibility features baked in.

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 custom development effort for each of the affected platforms (iOS, Android, Windows, web). Gen 2 brings a modern, platform-agnostic, and future-proof technology stack and allows for 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. The feature list below is not complete. Also, not all features are available in the first preview.

Improved navigation

Thanks to a new, automatically generated table of contents, you can jump straight to the question group that’s relevant for you. There’s also a new search function that allows you to find the question you need directly.

Better descriptions

You can now use formatted text to provide clear instructions to your inspector. Edit the text in a WYSIWYG editor: add colors, styles, text decoration, images, or links. The content is saved in industry-standard Markdown format.

Semantic colors and global styles

Colors and styles are now streamlined and easier to use.

Form validation

When a user attempts to save or complete a questionnaire, the Questionnaire Player validates all visible questions. If it finds any responses that fail the validation, the list of validation errors is displayed. The player scrolls to the first invalid response. Users can fix it and proceed to the next invalid response.

Enhanced image editor

The image editor is embedded directly in the Questionnaire Player. It allows users to modify the captured or selected image without the need for an external application. The editor lets the users zoom in for precise editing. An intuitive toolbar includes all the standard editing features including cropping, adding text, shapes, freehand drawing, etc. You can select features like text font/size, color, line thickness, and much more.

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

Features unavailable for preview

In the early preview, some standard features are not yet available:

• Data mapping
• Tagged images
• Reports

We will periodically release new previews. For information about new features included in preview releases, check the preview documentation for release 19.0.

Preview availability

• A limited preview (closed beta) was available from May to September 2025.
• Public preview is planned to start on October 23, 2025.

Get started with gen 2

The preview is available for the following platforms:

• Power Platform (with or without Dynamics features)
• Resco Cloud

The new player is available in several forms:

• Part of Resco Mobile CRM
• A component you can add to Power Apps.
• A component you can add to Power Pages.

Prepare your test environment on Power Platform

1. Download the preview version of Resco Suite from the Preview page. The earliest supported version for the public preview is 19.0.
2. Go to make.powerapps.com and switch to a suitable sandbox/developer environment.
3. If you participated in the limited preview, delete the standalone solution RescoPcfQuestionnaire.
4. Install the preview version of Resco Suite.
5. Wait until the installation concludes, then Publish all customizations.
   

Use the Resco Inspection model-driven app for testing

In the preview release, the Resco Suite solution includes a new model-driven demo app for testing the second generation of questionnaires: Resco Inspections.

The app includes a welcome page with basic information and five menu items:

• Questionnaire Designer - use it to create a new questionnaire
• Report Designer - use it for creating advanced reports from questionnaires or other data
• Templates - list of questionnaire templates. Select any published template and start filling out the form.
• Answers - list of completed questionnaires.
• Result Viewer - use it to search, filter, and export questionnaire answers

Try Power Pages

The new player can be added to Power Pages. We have prepared a sample page that you can add to your organization.

1. Start the Resco Inspections app.
2. On the Get Started page, scroll down to the section about Power Pages and download the solution file.
3. Go to make.powerapps.com and import the solution. Wait for installation, then publish all customizations.
4. Go to make.powerpages.com and make sure you are in the same environment.
5. Go to the Inactive sites tab and Reactivate the rescoQuestionnaire site.
6. Find the demo among your active sites. It contains the questionnaire player component on the home page, and has the required tables and WebAPI permissions set.

To display an actual questionnaire:

1. Open the source code in Visual Studio Code.
2. Find <resco-questionnaire> component in the Home page.
3. Instead of the placeholder, enter the ID of a questionnaire/answer that exists in your environment.
4. Save, Sync, and Preview. Sometimes, it might be necessary to fully reload the page to bypass the browser cache.

Warning

The demo page uses benevolent table permissions to simplify testing. For production use, review and adjust the settings.

Power Platform: Add questionnaire component to your forms

If you want to try out the gen 2 player as a PCF in a model-driven app, add the component to your forms.

1. In make.powerapps.com, edit the form for the questionnaire table.
   
2. Using the form editor, add a new form tab. Name and order the form tabs as desired.
   
3. Select the section included in the new tab and hide its label.
   
4. In the list of components, scroll down to More components and add Questionnaire. (If you don't see the questionnaire, click Get more components to add it.)
5. Select any text field as the component binding placeholder. If you are not familiar with PCF, check out also Resco Power Components documentation or Microsoft documentation about PCF.
   
6. Select the added component and hide its label, then save all changes.
   
7. Repeat the same steps for the Questionnaire Answer table.

Prepare your test environment on Resco Cloud

If you don't want to test on Power Platform, you can use our Resco Cloud. Create a new preview organization or use your existing organization on https://preview.resco.net.

Create an app project (required for Resco Mobile CRM)

If you want try Gen 2 questionnaires in Resco Mobile CRM, you need to enable Feature Version fields.

1. Start Woodford.
2. Create a new app project. Select Inspections as your initial template.
3. Go to the Questionnaire entity. Edit its view and add the field Feature Version.
   
4. Go to the QuestionnaireAnswer entity. Edit its view and the field: resco_questionnaire.resco_featureversion. Ensure you are adding the correct field: for the answer entity, you must add the parent template's feature version.
   
5. Save all changes and publish the app project.

Design a new questionnaire

1. Start Questionnaire Designer (18.2 or later).
2. Click New and verify that you are using Gen 2 technology. If not, go to Settings and switch to Gen 2.
   
3. Click Create or use any of the methods for faster questionnaire creation, for example, Generate by AI.
   
4. Add some questions and groups to your questionnaire.
5. Save all changes and publish the questionnaire.

Alternatively, you can convert existing questionnaires. Edit the questionnaire, click Options and on the Features tab, click Upgrade (Beta). then save all changes. Keep in mind that some features are not yet enabled for gen 2 questionnaires and they might be lost in the conversion process. We recommend publishing the template before conversion to ensure you have a version to return to if you are unhappy with the conversion.

Play the new questionnaire

You can play (display and answer) gen 2 questionnaires either in Resco Mobile CRM or in the questionnaire component in model-driven apps.

Prerequisites:

• One of: Questionnaire component by Resco or Resco Mobile CRM 18.2 or later
• Preview feature enabled in your organization
• Published gen 2 questionnaire

In the case of Resco Mobile CRM, the app will autodetect gen 2 questionnaires and launch the correct player. In the questionnaire component for PowerApps, you need to switch to the proper form tab.

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.

How to provide feedback?

You have several options for how you can leave feedback, report problems, or suggest improvements:

• Use the Resco support portal. Select the Preview Feedback option. See How to report requests for more information about the portal.
• Use the Send Feedback button directly from the Gen 2 player.
  

How to migrate?

Gen 2 is currently in preview and not supported in production. We will have more information about how to migrate later.

See also

• Gen 2 page on Resco web
• Frequently asked questions