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:
Customer has access and understands how to access or grant access to all relevant source systems required for integration
Customer knows how to query all relevant internal source systems for integration
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
Customer has basic knowledge of API technology and is be able to work with JOYN APIs with as needed services support from W Energy.
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
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:
Customer has access and understands how to access or grant access to all relevant source systems required for integration
Customer knows how to query all relevant internal source systems for integration
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
Customer has basic knowledge of API technology and is able to work with JOYN APIs with as needed services support from W Energy.
Customer has a general understanding of the entity definitions in this document (JOYN FAQ web page links are provided for more info)
Effort estimates and Training are per recommendations in this document.