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 resco.ServicePlatform 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 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 accessible from the Resco Cloud landing page and Dynamics which 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).
  • Preview Localization: Guides can be localized. The translation can be either manual or you can leverage cloud services for machine translation.

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.
    Enable Guide.png
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 Dataverse

Before you can use guides on Dataverse, you have to:

  • Install the Guides solution to your Dataverse
  • 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-solution-into-powerapps.png
  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.png

Defining N:N relationships

On the Dataverse backend, 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.
    Creating-new-many-to-many-in-powerapps.png
  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

Resco Cloud

Guides that you create can belong to a category. To keep your guides organized, create guide categories that are suitable for your organization.

  1. Start the Admin Console.
  2. Select Data > Manage Data.
  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.
    Guide category.png

Dataverse

  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".
    Categories.png
  4. Click Save & Close.

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.png

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

Guides on a form.png

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

Guides from inspections.png

Tap the guide that interests you to display it.

Houston9.png Houston10.png

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").
    Creating a new guide.png

See also



Was this information helpful? How can we improve?