Woodford

From Resco's Wiki
Revision as of 08:19, 17 March 2020 by Jzambor (talk | contribs) (Quick start: new section)
Jump to: navigation, search

Woodford is a browser-based configuration tool for building and managing app projects using the Resco platform. It also allows you to manage connected mobile devices and licenses.

How does it work

Connect to your backend server and start Woodford. Create an app project (= a customization, i.e., the way you want the mobile app to look and work). Once you save the changes you make, these are saved on the backend server in custom Resco entities, which are created at the first start of Woodford.

When you publish the project, the customization becomes active and available to be downloaded to Resco mobile apps. When the app synchronizes with your backend system (be it Microsoft Dynamics, Salesforce, Resco Cloud), it downloads the project, available for the user’s security role and downloads/uploads data.

A possible setup using Resco Cloud as your backend server. See Resco platform for other alternatives.


Key concepts

Develop once – deploy everywhere
The development of mobile apps is platform-agnostic. The apps are configured once and the same configuration is used for all platforms and devices.
Adaptable UI
The user interface adapts automatically to different screen sizes, formats, and aspect ratios. It looks great on a phone, on a tablet, or even in your browser. Everything is managed by Resco app and no manual customization is needed.

Availability and installation

An HTML version of Woodford is available on all major platforms and browsers, including Mac OS and the Safari web browser. Former stand-alone application is no longer updated.

Using Woodford requires a SuperUser (Administrator) license.

Microsoft Dynamics

If you are using Microsoft Dynamics:

  1. Go to Woodford download page: www.resco.net/woodford-overview.
  2. Depending on your Dynamics version, download the appropriate solution file:
    • If you are using Microsoft Dynamics CRM 2011, click Woodford for Dynamics 2011 Download (direct link).
    • If you are using a newer version, click Woodford for Dynamics Download (direct link).
  3. Log in to your Dynamics CRM as a system administrator.
  4. Go to the Solutions section of your CRM server settings.
  5. Click Import and select the downloaded Woodford zip file.
  6. Finish the import wizard.
  7. Publish all customizations.
  8. Reload the Dynamics webpage (often, this can be accomplished by pressing F5).

Woodford is now available in the CRM Settings, under MobileCRM section.

Please see your Dynamics documentation if you need more information about how to upload solution packages or publish customizations.

Updating Woodford

If you need to update your Woodford solution to a new version, we recommend the following:

  • First, back up your Woodford projects.
  • Use the procedure for new installation; however, you need to perform an additional step during the solution import wizard. Dynamics detects that the solution package contains an update for a solution that is already installed. Select Maintain customizations (recommended).

Uninstalling Woodford

To uninstall Woodford from Dynamics, remove the Woodford solution file.

Note All projects and records in resco_ entities are removed. Use the Export functionality to back up your projects. To uninstall the Woodford application or solution file, each entity enabled in Plugins (N:N Relationship, Delete, Owner) has to be deactivated in the plugin before removing the solution.

Resco Cloud

If you are using Resco CRM server (Resco Cloud), Woodford does not require any installation.

  • Log in to your Resco CRM server.
  • Select Tools & Settings > Woodford from the menu.

Salesforce

If you are using Salesforce, Woodford does not require any installation.

  1. Go to Woodford download page: www.resco.net/woodford-overview.
  2. Select the appropriate Salesforce version:
    • For production use, click Woodford for Salesforce - Production (direct link).
    • For sandbox environment, click Woodford for Salesforce - Sandbox (direct link).
  3. Log in to Salesforce to open the Resco for Salesforce landing page.
  4. Select Woodford.

By default, Woodford works only with standard Salesforce objects and fields after its first connection with Resco. All you need to do is to sync the solution with all the custom objects and settings you have in your existing organization. Click Update and wait while your custom settings are downloaded to Woodford.

Some Salesforce objects are not available in Woodford by default. See Salesforce object blacklist for more information. Requires Resco managed package.

User interface

Woodford main screen

The main screen of the application has the following three sections:

  • Administration menu in on the left side of the screen. Use Administration menu to access different functions of the application.
  • Main menu or toolbar is in top section of the application. The buttons and settings in the toolbar depend on the function selected in the Administration menu.
  • The main, central pane of Woodford displays content depending on what's selected in the Administration menu.

Administration menu

This menu allows you to access the following functions. Depending on your CRM server and configuration, some functions might be unavailable.

  • App projects – manage and design app projects
  • Device control – manage devices using your projects
  • Mobile users – manage users and licenses
  • Localizations – manage languages available in the mobile app, create a new translation or tweak existing
  • Entities (Resco CRM server only) – manage entities and fields on your CRM server
  • Plugins (Dynamics only) – manage entities controlled by Delete plug-in
  • Maintenance (Dynamics only) – manage mobile audit and tracking data
  • Geocoding – add latitude and longitude to records
  • Location tracking – configure when and how to track the location of mobile users
  • Mobile apps – set up your own branded applications and ask Resco to build them
  • Settings – configure licensing options and user options
  • Profile – update your user profile
  • About – display information about Woodford
  • Resco CRM sync – create a copy of your Microsoft Dynamics data in Resco CRM server
Note While the Woodford is in the evaluation period, Mobile Users menu is not available, as the number of mobile users during the trial period is not limited.

When you use Woodford, the Administration menu can be replaced by submenus or other panes. To return to the Administration menu, use the left arrow (back) button in the top left corner of the app.

Quick start

  1. Click New to create a new app project.
  2. Set up the properties of your new project. Most notably, select one of the predefined project templates, enter a name, and select one or more roles.
  3. Set up various options in the Project menu:
    • Manage your entities: decide which entities and fields should be available in the app.
    • Set up views for your entities. Views are used to display the list of records, for example, your contacts.
    • Set up forms for your entities. Forms are used to display the details of a particular record, for example, a single contact.
    • Click Home screen to update the start menu of your app.
  4. Click Save to save all changes.
  5. Click Publish to upload your project to a custom entity on the backend server.
  6. Users of Resco mobile apps can now connect to the server to update it and download the organization data.