Guides

Warning

Work in progress! We are in the process of updating the information on this page. Subject to change.

Guides are an optional component of the resco.ServicePlatform that allows you to create documentation that your technicians in the field can follow.

Prerequisites

• Resco Cloud backend
• Release 15.0 (spring 2022) or later

Features

• Guides: Documents that combine images, text content, and PDF attachments that are related to a particular record (for example, a piece of machinery) that users of Resco mobile apps can display in their apps.
• Guides editor: A web application accessible from the Resco Cloud landing page which allows you to create, modify, and publish guides.
• Feedback: App users can rate the guides as feedback for the guide editors.
• Drafts: App users can quickly assemble draft guides: take photos and add comments. Guide editors in the back office can then expand the guides, add some polish, and then publish them to make the information available to all users in the field.

Configuring in Woodford

1. Edit an app project in Woodford.
2. Select Settings > Guides from the Project menu.
   • Select Enable Guides.
   • Select the entities for which you want to define guides.
   • 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.

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.

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.

Guides editor

1. Log in to your Resco Cloud organization.
2. On the landing page, select Guides Editor.

I don't see guides editor

If you are using a resco.FieldService or resco.Inspections organization with a custom manager's landing page, there's no Guides Editor link on it. You can add it manually.

1. Start Woodford (System Administrator > Manage Apps or Administration > App Configurator).
2. Edit the Manager app project and edit its home screen.
3. Click Add IFrame and add the link to the Guides Editor in the following format. Replace the sample with a valid link to your organization.
   
4. Save all changes and publish the app project.