Skip to main content
Skip table of contents

What are some of the key points to consider prior to implementing JOYN FSM?

General Implementation Considerations

This page helps you understand how to plan for an FSM implementation including

  • Integration Efforts

  • Manual upload Efforts

  • Considerations and assumptions around access to data and understanding of technology among your staff

  • Availability of internal resources

  • Timeline Estimations

  • Training

  • Goal Setting/Risk Minimization

  • Upload Templates

NOTE: This is not a complete detailed list and there are always unknowns in any project given your goals for the project. The intent of the document is to help you plan to minimize project risks as much as possible given what we believe is typical for a basic implementation to get going.

Integration Unknowns

Integration unknowns are usually the biggest cost factor in an implementation. However, the less the unknowns, the faster the implementation goes and in turn can lower the overall cost of implementation.

Note: It is difficult for W Energy to know the level of expertise to which your staff knows its own internal systems or understands basic integration technologies such as APIs. Therefore, the assumptions for estimates we have made in this document are as follows:

  1. Customer has access and understands how to access or grant access to all relevant source systems required for integration

  2. Customer knows how to query all relevant internal source systems for integration

  3. W Energy staff would help with S2T mapping for integrations assuming all customer source system data identification is clearly defined. I.e. No Business Analysis is required by W Energy on internal source systems to understand structures, perform queries, etc to support S2T mapping

  4. Customer has basic knowledge of API technology and is be able to work with JOYN APIs with as needed services support from W Energy.

  5. Customer has a general understanding of the entity definitions in this document (JOYN FAQ web page links are provided for more info in entity tables below)

Integration vs Manual Upload

While integrations are great and keep everything live and in sync between different systems, it can sometimes be a costly endeavor if you don’t have the right SMEs to setup proper integrations and this can lead to expensive delays and rework. Therefore – depending on the level of expertise available within your staff – sometimes it may be a quicker path to value to perform manual uploads of such data.

Integration

Manual Upload

Benefit

Keeps systems in sync

Lower Cost, Faster, less SME knowledge required

Cost

Higher Cost, Lengthier, requires more SME knowledge

Does not keep systems in sync

Recommendation to use when

-When SME knowledge is readily available and high

-Does not get in the way of or does not delay value creation

-When Manual uploads are not possible for high value use cases driven by source data in other systems (e.g. kicking off a task from SCADA)

-When SME knowledge is NOT readily available

-Significantly expedites the path to value creation vs Integration

This page provides both Integration and Manual upload estimates for entities that have both options.

Estimates for Entities that can be integrated or manually uploaded

More info (if available)

Setup Assumptions

Integration Effort (Hours)

Manual Upload Effort (Hours)

Fields

https://w-user-documentation.scrollhelp.site/production/what-is-a-field

Fields can be setup manually unless they are already sourced from some source system

6

4

Areas/Routes

https://w-user-documentation.scrollhelp.site/production/what-is-an-area

Initially, areas can be defaulted as Routes from Production Acctg system

6

4

Stops

https://w-user-documentation.scrollhelp.site/production/what-is-a-stop

Assume customer has access to and can attain all relevant stops from relevant so

6

4

Stop Lat/longs

https://w-user-documentation.scrollhelp.site/production/what-is-a-stop

Only battery/pad/stop lat/longs are required; Assume all assets are geographically inside stops per source system data

6

4

Assets/Objects

https://w-user-documentation.scrollhelp.site/production/what-is-an-object

Asset lat longs are not required; Assume all customer has access to and can attain all assets as needed

6

4

Picklists

https://w-user-documentation.scrollhelp.site/production/how-do-picklists-work-in-fsm

Assume customer has access to and can attain all relevant picklists from relevant sourc systems. E.g. failure reason codes, certifications, etc

6

4

TOTAL

36

24

Upload Templates

Below are the templates that can be used to upload assets

#

Template

Info

Steps 1 - 7 are required if you plan to use JOYN OG Production Volume Data Capture. If you do not plan to utilize the JOYN OG Production Volume Data Capture features - please check with the JOYN Platform SME as you may be eligible to skip directly to step 8.

1

Upload Fields for JOYN OG Production Data Capture

https://w-user-documentation.scrollhelp.site/production/what-is-a-field

Field Export.xlsx

2

Upload Routes for JOYN OG Production Data Capture

https://w-user-documentation.scrollhelp.site/production/what-is-an-area

Route Export.xlsx

3

Upload Stops for JOYN OG Production Data Capture

https://w-user-documentation.scrollhelp.site/production/what-is-a-stop

Stop Export.xlsx

4

Upload Wells for JOYN OG Production Data Capture

https://w-user-documentation.scrollhelp.site/production/what-is-an-object

Well Export.xlsx

5

Upload Tanks for JOYN OG Production Data Capture

https://w-user-documentation.scrollhelp.site/production/what-is-an-object

Tank Export.xlsx

6

Upload Meters for JOYN OG Production Data Capture

https://w-user-documentation.scrollhelp.site/production/what-is-an-object

Meter Export.xlsx

7

Upload Other Equipment for JOYN OG Production Data Capture

https://w-user-documentation.scrollhelp.site/production/what-is-an-object

Equipment Export.xlsx

8

Upload Stops for JOYN FSM

https://w-user-documentation.scrollhelp.site/production/what-is-a-stop

stop template for fsm.xlsx

9

Upload Assets for JOYN FSM

https://w-user-documentation.scrollhelp.site/production/what-is-an-object

object template for fsm.xlsx

10

Upload Users in bulk

https://w-user-documentation.scrollhelp.site/production/how-do-i-setup-a-user

User_Upload_Template with field.xlsx

Estimates for Entities/Setup that have done via integration

More info (if available)

Setup Assumptions

Integration Effort (Hours)

SSO

https://w-user-documentation.scrollhelp.site/production/how-does-joyn-perform-authentications

User will be uploaded with correct email address for SSO to work

4

SCADA

https://w-user-documentation.scrollhelp.site/production/which-api-can-i-use-to-create-tasks

Customer has predefined # of alarms and logic to call JOYN API to kick off task(s). Effort is for general training to educate customer how to set these up.

4

Other Systems

https://w-user-documentation.scrollhelp.site/production/which-api-can-i-use-to-create-tasks

Customer has predefined the systems and # of associated internal business logic/action to call JOYN API to kick off task(s). Effort is for general training to educate customer how to set these up.

4

TOTAL

12

Estimates for Entities that must be manually uploaded/setup

More info (if available)

Setup Assumptions

Manual Upload Effort (Hours)

Teams

https://w-user-documentation.scrollhelp.site/production/what-is-a-team

Customer has predefined the teams needed for the task types required and knows which users will belong on which teams

4

Areas

https://w-user-documentation.scrollhelp.site/production/what-is-an-area

Customer has predefined areas by production accounting routes and/or foreman areas defined as a collection of stops

4

Task Type

https://w-user-documentation.scrollhelp.site/production/how-do-i-set-up-a-task-type

Customer has predefined 5 task templates, workflows/business logic, attributes required to setup 5 initial use cases (4 hours/template)

4 hours per task template; for 5 templates = 20

User Schedules

https://w-user-documentation.scrollhelp.site/production/how-do-i-setup-a-user

Basic hitch and schedule setup will initially be defaulted from 4AM to 10PM with 7 days on / 0 days off. Customer can change/udpate after the initial implementation as needed.

4

Roles

https://w-user-documentation.scrollhelp.site/production/how-do-i-create-and-manage-roles

Default roles will be created. Customer Admin can create more roles after initial implementation as needed.

4

Users

https://w-user-documentation.scrollhelp.site/production/how-do-i-setup-a-user

Internal User list will be provided by customer and will be manually uploaded; SSO integration will work as long as correct email addresses are uploaded for user

4

Vendor Users

https://w-user-documentation.scrollhelp.site/production/how-do-i-setup-a-user

External Users (Vendors) list will be provided by customer and will be manually uploaded

4

Vendor Companies

https://w-user-documentation.scrollhelp.site/production/what-is-a-vendor-and-a-vendor-user

List of vendor companies that external users would belong to will be provided by Customer and will be manually uploaded

4

TOTAL

48

Project Timeline

A typical timeline for a ready to implement JOYN FSM project can be as little as 2 to 4 weeks or as long as 4+ months. However, the actual timeline is defined by your readiness as a client in terms of:

  • Clarity and focus of goal

  • Clearly defined and focused set of use cases supporting the overall goal

  • Clearly defined criteria/setup/needed attributes/logic/workflow for the use cases

  • Clearly defined user personas and identified users for testing and feedback input for use cases

  • Clearly defined and well understood source systems and APIs for potential integrations to support use cases

  • Ability to attain relevant data required for the project (e.g. manual uploads, etc) for general setup and use cases

Editable Excel Timeline Templates based on below Timelines

Excel Estimation Template.xlsx

Sample 2 Month Timeline without Integrations

#

Milestone

Date

1

Setup environments

Day 1

2

Load Master Data and Metadata

Day 14

3

Design/Build/Configure 5 use cases (task types)

Day 28

4

First UAT and feedback for minor setup modifications

Day 42

5

Second UAT for final confirmation

Day 49

6

Training

Day 56

7

Go Live

Day 63

Sample 2.5 Month Timeline with Integrations

NOTE: Integration timelines are estimates and may change subject to customer’s SME knowledge for internal systems.

#

Milestone

Date

1

Setup environments

Day 1

2

Load/Integrate Master Data and Metadata

Day 14

3

Design/Build/Configure 5 use cases (task types)

Day 28

4

Integration Transaction data to/from EAM/ERP system

Day 42

5

First UAT and feedback for minor setup modifications

Day 56

6

Second UAT for final confirmation

Day 63

7

Training

Day 70

8

Go Live

Day 77

Training

Training can be conducted remotely or in person. It is up to the customer what training model to use. However, this is what we recommend:

  • Basic Web Administrator Training: One 4 hours session or 2 x 2 hour sessions

  • Basic Mobile user Training: One 2 hours session

  • If your field users cannot be accommodated in a single training session, it may be better to train one set of users and then internally train the trainer.

  • Additional Training can be requested as needed.

Goal Setting & Risk Minimization

It may be tempting to move hundreds of field activities to JOYN all at once in a big bang approach. However, historical indicators all but ensure this is a recipe for failure.

The change management involved across hundreds of field activities may be too much for the organization to handle.

Instead – the natural, faster and more effective path to success is to spend time up front getting 4 or 5 activities setup in JOYN and rolled out across a small user base. This leads to immediate success due to:

  • Focused planning and execution

  • Less change management

  • Controlling the blast radius of risk for a smaller set of use cases and personnel

  • Allows for fine tuning the small kinks

  • Once the first 4-5 activities succeed, the next 400-500 usually spread like wildfire!


Summary of Recommended Effort Estimate from Above

Low End of Estimate

High End of Estimate

Entity Setup*

88 hours

102 hours

Training*

6 hours

6 hours

TOTAL:

94 hours

108 hours

*Note: It is difficult for W Energy to know the level of expertise to which your staff knows its own internal systems or understands basic integration technologies such as APIs. Therefore, the assumptions for estimates we have made in this document are as follows:

  1. Customer has access and understands how to access or grant access to all relevant source systems required for integration

  2. Customer knows how to query all relevant internal source systems for integration

  3. W Energy staff would help with S2T mapping for integrations assuming all customer source system data identification is clearly defined. I.e. No Business Analysis is required by W Energy on customer’s internal source systems to understand structures, perform queries, etc to support S2T mapping

  4. Customer has basic knowledge of API technology and is able to work with JOYN APIs with as needed services support from W Energy.

  5. Customer has a general understanding of the entity definitions in this document (JOYN FAQ web page links are provided for more info)

  6. Effort estimates and Training are per recommendations in this document.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.