1

Guides

From Resco's Wiki
Jump to navigation Jump to search
resco.Guides

Resco Guides is a workforce knowledge management software by Resco.

It is an optional component of Mobile App Development Toolkit that allows you to create step-by-step instructions that your technicians in the field can follow to solve a problem. If you have an existing solution that uses Woodford and Resco mobile apps, it can be added to your solution in a few clicks.

It is available for Microsoft Dataverse/Dynamics 365, Salesforce, and Resco Cloud backends.

Features

  • Guides: Step-by-step instructions that combine text content, images, videos, and PDF attachments that are related to a particular record (for example, a piece of machinery). Guides can be displayed in Resco mobile apps or Power Apps.
  • Guides library: A web application that allows you to create, modify, and publish guides.
  • Feedback: App users can rate the guides and provide feedback to the guide editors in the back office.
  • Guides harvesting: App users can quickly collect simple guides from the field (take/upload photos and add comments) if they identify missing processes. Guide editors in the back office can then standardize the guides, add proper language and associations, and then publish them to make the information available to all users in the field (knowledge decentralization from experts to the entire organization).
  • Localization: Guides can be localized. The translation can be either manual, or you can leverage cloud services for machine translation.
  • AI generation: You can generate new guides using AI.

Prerequisites

License

  • Resco Guides requires Resco's ultimate license.
  • If you need more information, contact us at sales@resco.net.

Configuring in Woodford

Enabling guides
  1. Edit an app project in Woodford.
  2. Select Settings > Guides from the Project menu.
    1. Select Enable Guides.
    2. Select the entities for which you want to define guides. For example, if you want guides for your products, select the Product entity. You can add multiple.
      Notes:
      • Once guides are enabled for an entity, they cannot be disabled.
      • On Dynamics, you need to create an N:N entity before you can enable guides for an entity.
    3. Select Enable Feedback and set the delay after viewing a guide when a feedback form appears.
  3. Click Save.
  4. Optionally, click Add To Home if you want to add the Guides view as the last item on your home screen.
  5. For manager/admin projects that should have access to the Guides Editor, click Add Editor To Home.
    Guides: Add Editor To Home
Adding guides to entity forms
The home screen item lists all guides. Alternatively (or in addition) to the home screen button, you can add a list of related guides to an entity form. Users that display a record can then see the list of relevant guides.
  1. Edit an entity form.
  2. Click Add List and select "Guides List".
  3. Optionally, set up a filter, for example, Status Reason Equals Published.
  4. Save all changes.

Setting up Power Platform

Before you can use guides on Microsoft Power Platform (Dynamics/Dataverse) , you have to:

  • Install the Guides solution to your organization.
  • Create N:N entities between the Guide entity and entities that need access to guides.

Installing the guides solution

  1. Download the Guides managed solution file from Resco web.
  2. Log in to https://make.powerapps.com/ as a system administrator.
  3. Select the correct environment where you want to install guides.
  4. Select Solutions from the menu.
  5. Click Import solution and select the downloaded solution file.
    Import Guides solution into powerapps
  6. Finish the import wizard.
  7. Wait until the import is complete. Then, click Publish all customizations.

The Resco Guides managed solution includes custom tables and a model-driven app "Resco Guides", designed to run on a PC. Select "Resco Guides" in the list of apps on your environment and click Play to start it. It offers the following features:

  • Guides: Starts the Guides library tool for creating, editing, and managing guides.
  • Categories: Allows you to view, create, and update guide categories.
  • Guides: Displays the standard view for guides in model-driven apps.
  • Guide Feedbacks: Displays the rating and feedback left by users.
Resco Guides model driven app showcase

Defining N:N relationships

On Dataverse, before you can associate a guide with another table in Woodford, you must create an N:N relationship.

  1. Go to https://make.powerapps.com/ and select the right environment with guides installed.
  2. Select Tables from the menu and switch to All tab.
  3. Find the "Guide" table and click it.
  4. Click New > Relationship > Many-to-Many.
    Guides: Creating new many to many relationship in powerapps
  5. Select the other table from the list, for example, "Account", if you want to link guides to the Account records.
  6. Click Done and wait until the relationship is created.

Adding guide categories

Guides that you create can belong to a category. To keep your guides organized, create guide categories that are suitable for your organization, such as "maintenance" or "safety".

Power Platform

  1. Start the Resco Guides app.
  2. Select Categories from the menu.
  3. Click New and enter the name of the new category, such as "Maintenance".
    Adding guide categories in Dataverse
  4. Click Save & Close.

Resco Cloud

  1. Start the Admin Console.
  2. Select Data > Manage Data and enable Show System Entities.
  3. Scroll down to the Guide Category entity and open it.
  4. Click New and enter a category, for example, "Maintenance" or "Repair", and save it.
    Adding guide categories in Admin Console

Salesforce

On Salesforce, because of the specifics and limitations, the recommended way for managing Guide Categories is using the Resco Mobile CRM app. This method can be used with any backend.

  1. Edit an app project in Woodford.
  2. Select the "Guide Category" entity (rh_guidecategory) from the project menu.
  3. Create a simple view and a simple form so that you can view and edit categories in the mobile app.
  4. Add the entity to your home screen, then save everything and publish the project.

Guides library

Guides library or editor is a web tool for guide authors. It serves for creating and managing guides. See Guides library for details.

Using guides in the app

In the app, you can find guides in three places:

On the home screen - all guides (if you used the Add To Home button in Guides configuration)

Guides on the home screen showcase

On the entity form - related guides (if you added the related guides list to the form)

Guides on a form showcase

In a questionnaire (if you added the guide as a static component of the questionnaire)

Guides from inspections showcase

Tap the guide that interests you to display it.

Guide showcase Guide showcase

Harvesting guides from the app

You can also create new draft guides:

  1. On the home screen, tap Guides.
  2. Tap the plus button in the top right corner.
  3. Add a title, description, steps, and photos.
  4. Save the guide.
  5. Synchronize the app to make the guide available in the Guides Editor (status = "collected").
    ALT=Creating a new guide showcase

Harvesting is not supported with Salesforce.

See also




Was this information helpful? How can we improve?
Retrieved from "https://docs.resco.net/mediawiki/index.php?title=Guides&oldid=12247"