release notes
Release 61.33
Release 61.32
Release 61.31
Release 61.30
Release 61.29
View More...
Release 61.33
Release 61.32
Release 61.31
Release 61.30
Release 61.29
View More...
announcements
What's coming in 2022 Q1?
What's coming in Q4?
What's coming in March?
What's coming in the remainder of Q1?
What's coming in January?
What's coming in December?
What's coming in November?
Embedded AIhow to's
MANUALS

User Manuals

  • General System Manual
  • ELN & LIMS - User Manual
  • LIMS - User Manual
  • AI & DOE - User Manual
  • Chemical Drawing Manual

Admin Manuals

  • Configuration Portal - System Admin Manual
  • Alchemy Scripting - System Admin Manual
  • Field Property Guidelines - System Admin Manual

Onboarding

  • Customer Implementation Manual

User Manuals

  • General System Manual
  • ELN & LIMS - User Manual
  • LIMS - User Manual
  • AI & DOE - User Manual
  • Chemical Drawing Manual

Admin Manuals

  • Configuration Portal - System Admin Manual
  • Alchemy Scripting - System Admin Manual
  • Field Property Guidelines - System Admin Manual

Onboarding

  • Customer Implementation Manual
DEVELOPERS
Integration API
Integration API
BETA

Send Feedback

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
send feedback

Send Feedback

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
sign in

Customer Implementation Manual

  • General Approach
  • Sales to Customer Success Transition
  • Project Kickoff
  • Technical Solution Design
    • 4.1 Discovery Workshop #1: Workflows
    • 4.2 Discovery Workshop #2: Formulations
    • 4.3 Discovery Workshop #3: Lab Test Data
    • 4.4 Discovery Workshop #4: Materials
    • 4.5 Discovery Workshop #5: Reports, Chemistry Topics, Privileges
    • 4.6 Discovery Workshop #6: Integrations
  • Iterative Configuration & Testing
  • Data Assessment & Import
  • User Validation Testing (UVT)
  • System and Instrument Integration
  • Launch
  • Appendix - Roles & Responsibilities

** It is not recommended to read this Manual on phones and smaller screen tablets, since you may not enjoy the full user experience.

1. General Approach

This document provides an overview for implementing Alchemy’s Integrated ELN+LIMS.
‍

High customer satisfaction is the primary goal for all implementations.


The Statement of Work (SOW) will determine the scope of the implementation. Leveraging an iterative design and configuration process enables customers to realize value from Alchemy quickly. 
‍

Additional goals in the implementation process:

  • Leverage 100% of the discovery done in the sales process.
  • Use customers’ time wisely with efficient, well-planned meetings.
  • Show the customer weekly configuration progress in the Alchemy application as early as possible and solicit early feedback. 
  • SMEs and BSOs leveraged throughout to advocate for usage once deployed.
  • Expand Alchemy’s use to other lab types or business groups

‍

The following table describes the phases for an implementation.

Phase
Description
Output
0. Sales to Customer Success Transition
An internal handoff occurs between the Sales Engineer (SE) and the Customer Success Manager (CSM) to leverage discovery and configuration work conducted during the sales process. Review SOW.
• Customer folder
• Discovery document
• AE to schedule customer kick-off
• Draft Project Plan
1. Project Kickoff
AE will present the customer objectives. CSM will present the implementation process, project plan, dependencies, and expectations. Schedule Discovery Workshops.
• Meeting cadence
• SMEs and BSOs
• Stakeholder Communication Plan
• Kickoff Slides
2. Technical Solution Design
Complete Discovery Workshops. Requirements added during discovery workshops will require a Change Order.
• Solution design
• Updated Project Plan
3. Iterative Configuration & Testing
CSM configures and tests the workflows (process templates), data forms (record templates), user access rights & permissions (tags), and reports based on the outputs of design. Application Developers extend the platform if necessary.
• Recorded demos
• Working Solution
• User Training Guide
• System Templates
4. Data Assessment & Import
Schedule training to fill in data migration template and follow up with customer. Review the template once completed. Import data sufficient for UVT to begin.
• Data imported for UVT
• Final data for import prepared and validated
5. User Validation Testing (UVT)
Customer will perform user validation testing per defined test cases to confirm that the processes and any integrations have been completed to specification. If the customer has an admin license, the admin will also get customized training videos.
• Final configuration approval
• Training videos
• Access to Alchemy’s Knowledge Center
6. System & Instrument Integration
Scope system and instrument integration(s). Meet regularly with the integration team to monitor progress.
• Working Integration(s)
7. Launch
Configure production tenant. Import full dataset to finalize legacy data migration.
All end users will be given a mutually agreed-upon start date. An intro email, including links to training videos will be sent to all end users to notify them of the date.
• The tenant is ready for the rollout
• Launch email sent to customer

2. Sales to Customer Success Transition

Meet with the Account Executive and Pre-Sales Solution Engineer

Before engaging with the customer, the Customer Success team will meet with the Account Executive (AE) who sold Alchemy to the customer and the Solution Engineer (SE) involved in giving demos to the customer. The following information will be provided from the SE:

  • Who is the customer and what they are producing/selling?
  • What is this customer trying to accomplish with Alchemy?
  • What are the customer’s challenges?
  • Why did the customer choose Alchemy?
  • What did you build in your demo that I can use in the actual implementation?
  • Was there a sandbox? If so, who was involved? Who was Active?
  • Can we use this sandbox as a starting point for the implementation?
  • How does the customer do their work today?
  • Customer roles and responsibilities.
    ‍

The Statement of Work (SOW)

Our goal is to implement Alchemy as fast as possible based on the scope defined in the SOW. Customers may change their minds, especially as they learn more about what Alchemy can do. If scope needs to change, it is common practice to write Change Orders to ensure our customers receive the functionality that is most important to them.

3. Project Kickoff

For most CSMs, the first meeting with the customer will be the project kickoff meeting. The AE or the VP of Customer Success will email the customer, welcome the customer to Alchemy, and ask to schedule the kickoff meeting.

The CSM and customer project sponsor collaborate on the kickoff deck and agenda:

  • Introductions
  • Alchemy Intro 
  • Alchemy Implementation
  • What to expect in the future?

Prepare to discuss the draft project plan during the kickoff meeting. Highlight any dependencies or milestones that will need to be finalized. Agree on a regular meeting cadence as well as a schedule for the Discovery Workshops. Send an email to everyone on the customer team including a list of action items that resulted from the meeting.

The person or team that evaluates Alchemy during the sales process could differ from the team that is implementing Alchemy. Please ensure both teams are included in the project kickoff meeting and include a review of the SOW if necessary. Ensure the items listed in the SOW accurately capture what we need to deliver. If there are significant discrepancies, you may need to arrange a Change Order to cover them.

4. Technical Solution Design

The next step in the implementation is to run a series of Discovery Workshops so you can learn details about the customer’s needs. 

Discovery Workshop guidelines:

  • SME(s), BSO(s) and End User(s) should attend.
  • Plan to meet 2-3 times per week for the Discovery Workshop sessions unless on-site.
  • The content and order of the discovery workshops may vary by customer.

After every workshop session, document a summary:

  • A short list of what was discussed, including decisions made
  • Action items for the customer 
  • Action items for Alchemy
  • What is happening next

4.1 Discovery Workshop #1: Workflows

Goals

This workshop is appropriate for all customers. Learn the customer’s objectives, challenges and vocabulary. Document all the stages of each workflow and connections between them. 

Customer Commitment
Number of sessions: 1-2 sessions per workflow

Length: 60-90 minutes

Preparation: Customer to provide example forms used throughout the workflow

Workshop #1 Overview

  1. Customer description of daily work:
  • [Formulating and Testing] or [R&D Process] or [Other topic]
  • Review of demo from sales process if applicable
  • Formal/informal approval process if applicable
  • Create processes and workflows 
  1. Review sample data, such as formulations and test data.
  2. Discuss processes in detail:
  • What stages are in this process? 
  • What information do you need to capture at each stage? 
  • Is there an approval here?

Example questions specific to the R&D process:

  1. Describe the basic stages of your R&D process:
  • Ideation
  • Concept Refinement
  • Product & Process Development
  • Manufacturing & Commercialization
  • Post-Launch
  1. How are you tracking this process now? 
  • Project management software?
  • Excel? Other?
  1. What information do you capture now to start a new R&D process? Imagine a form you would fill out; what fields would you fill in?
  2. What information do you need to capture for each additional stage of the process?
  3. Who is responsible for filling out information at each stage of the process?
  4. Are any approvals needed at the end of a stage?
  5. Under what circumstances would you go backward to a previous stage?
  6. Example reports or charts you want to obtain from this process:
  • All current R&D projects and their current stage or associated cost
  • Average project duration or Average Stage Duration

Next Steps

After this session, enter some sample customer data in Alchemy and start the next session by showing a short demo of what was entered. 

4.2 Discovery Workshop #2: Formulations

Goals

This workshop is appropriate for any customer wanting to implement ELN. LIMS-only implementations will skip this workshop. After this workshop, you will be able to create formulation templates in the Lab Book. 

Time Commitment
Sessions: 1-4

Length: 60-90 minutes

Preparation: Customer to provide sample formulations, contributing properties, formulating phases and processing steps in sample formulations.

Workshop #2 Overview

In Alchemy, formulation templates should be used as a starting point. Add all processing steps that are needed as well as materials that are always present, or the entire phases. As part of the template, add tests that are always required, and/or calculated properties. During the workshop, the elements of digitized formulations will be discussed:

  • Formulating Inputs: Customer to provide sample formulations.
  • Contributing Properties: Customer to provide contributing properties. 
  • Formulating Phases: Provide overview of how phases are used in Alchemy to understand if they will be needed. Customer to provide phases if relevant.
  • Processing Steps: Discuss processing steps provided in sample formulations to create a library of all common processing steps. 

Next Steps 

Based on the answers received during this session, configure a prototype for Formulation Session #2. This will help visualize how formulations will be represented in the system.

4.3 Discovery Workshop #3: Lab Test Data

Goals 

This workshop is appropriate for all ELN and LIMS customers. SMEs are required for this workshop. Define all properties, conditions, and test methods that will be used inside the Lab Book, QC, or Sample Testing process. Data Migration template training will be provided if data migration is planned.

Time Commitment
Sessions: 2-3

Length: 60-90 minutes

Preparation: Customer to provide lab test data.

Workshop #3 Overview

Compare the customer data properties against the standard library in Alchemy and note the differences. Use this session to discuss open items from the analysis. 

  1. Discuss items that are not clear enough. 
  2. Discuss the differences between the test data and the Alchemy Standard Library.
  3. Demo creating test methods in Alchemy to demonstrate both a simple and complex solution.

Next Steps 

Schedule the Data Migration template training if data migration is included.

4.4 Discovery Workshop #4: Materials

Goals 

This workshop is appropriate for all ELN customers and most LIMS customers. SMEs are required for this workshop. Define all material types, subtypes, and specifications. Define properties associated with each type and/or subtype. 

Time Commitment
Sessions: 1-2

Length: 60-90 minutes

Preparation: Customer to provide materials data (for example, TDS, SDS). Provide the list of materials in Excel, Technical Data Sheets or Safety Data Sheets. Ideally, provide an export of the entire material records database.

Workshop #4 Overview

Discuss Types and Subtypes as it relates to materials in Alchemy. Each Type and Subtype has a common set of properties. Demo an example in Alchemy to show the connection.

  1. Discuss where materials data is currently stored.
  2. Discuss general classifications of materials, such as Raw Material, Intermediate Material, and Finished Goods.
  3. Define properties needed for a Raw Material:
    • Name
    • Description
    • Status (such as Experimental or Production)
    • Technical Data Sheet
    • Safety Data Sheet
    • Density
    • Pigment content
    • Solids content
    • Vendor
    • Manufacturer
    • Unit Cost
  4. Categorize materials into Types and Subtypes. All materials of a given Type will share the same properties. All Subtypes will share properties. 

Next Steps

Demonstrate how types and subtypes with properties assigned are viewed in Alchemy.

4.5 Discovery Workshop #5: Reports, Chemistry Topics, Privileges

Goals 

This workshop is appropriate for all ELN customers and most LIMS customers. SMEs are required for this workshop. Create all relevant view templates, privileges for all process templates, and solo record templates.

Time Commitment
Sessions: 1

Length: 60-90 minutes

Preparation: Customer to provide examples of all reports listed in the SOW.

Workshop #5 Overview

Review reports provided by the customer or defined in the SOW. 

  1. Level of access - who should be able to edit and view certain stages, or record templates? 
  2. Explain the use of tags in Alchemy.
  3. Defining privileges on the process level, stage level and solo records level.
  • Who can see this [Process Template[Stage 1], or [Solo record]?
  • Who can edit this [Process Template[Stage 1], or [Solo record]?
  • Who should not be able to view this [Process Template[Stage 1], or [Solo record]? 

Next Steps

Configure a couple of view templates and share them via Alchemy. Share a recording of functions with users.

4.6 Discovery Workshop #6: Integrations

Goals

This workshop is appropriate for all ELN customers and LIMS customers. Stakeholders for the integration, customer IT managers, developers, and a representative from the Alchemy integration team are required for this workshop. Define system and/or instrument integrations included in the SOW.

Time Commitment
Sessions: 1-2

Length: 60-90 minutes

Preparation: Customer to provide

Workshop #6 Overview

Integrations can be grouped into two main categories:

  1. System integrations
  2. Instrument Integrations

System integrations are usually more complex and require the data to flow between Alchemy and a 3rd party system and can be 1-way or bi-directional.

Questions for the SMEs and Lab users:

  • What data from Alchemy do you need to have available in other systems?
  • What data from other systems do you need in Alchemy? 
  • Which systems does the data from Alchemy need to go to?
  • Which systems will Alchemy need to receive the data from?
  • What instruments need to be integrated?
  • Provide examples of the instrument output files
    ‍

Questions for the customer's IT:

  • Who are the System Administrators from the customer for the systems in scope?
  • What capabilities do their systems have to integrate with Alchemy (i.e. REST APIs, flat files)

Follow-up Actions

  1. Include the integration points in the solution map
  2. Schedule a sequence of working sessions with the integration from Alchemy and the customer

Next Steps

After the integration workshop, we should have scoped which records and data from Alchemy will need to be sent to 3rd party systems and where we will receive the data from those systems.

5. Iterative Configuration & Testing

The Iterative Configuration and Testing phase will be considered successful if all items from the project plan are on the tenant and verified by the customer during the demo. 

SOW defines the scope of configuration. By configuration, we are considering not only configuration changes made directly in the configuration portal but also adding the following items to the user portal:

  • Conditions
  • Properties (measured and calculated)
  • Test methods
  • Material Types
  • Material Subtypes
  • Formulation templates
  • Processing steps

Demo all work completed during the defined meeting cadence and revise requirements based on feedback from each demo.

6. Data Assessment & Import

Customers will be trained to use the Data Migration Template for test methods if specified in the SOW. This phase requires a larger time commitment from the customer and should be communicated at the project kickoff. The training session will last 60-90 minutes.

A follow-up session will be scheduled to review the progress on completing the template, and answer any questions the customer may have. Once the template is delivered, the CSM will review for accuracy and provide the completed template to the integration team to execute the import. Once data is imported, the customer and the CSM will review for completeness.

7. User Validation Testing (UVT)

User Validation Testing is a four week period that allows end users to verify the system against their internal processes. Users should be able to use the system independently once this phase is completed. This phase will start by scheduling a minimum of four (4) 60 minute UVT sessions. Before UVT starts the CSM will prepare training material that is also used for collecting feedback. 

Some of the feedback will be addressed during the UVT phase or before launch. The rest of the feedback will be evaluated and addressed over time using TAM hours. The UVT phase is complete once blockers are completed and the customer approves the final configuration.

8. System and Instrument Integration

Integration code will be developed and tested that will integrate Alchemy with the customer system(s) and instrument(s). The Alchemy integration team will take an advisory role, deliver the documents from the Integrations Discovery Workshops, and let the customer IT develop any necessary middleware code. Generally, Alchemy will also own a part of the development.

Once the integration middleware code is developed, it will be tested by the integration team and then go through UVT by the end users.

9. Launch

This phase will require configuring a production tenant ready for launch, with only legacy migrated data (no other data created) and all privileges set up. Access will be provided to all users on the day the launch is scheduled.  During this phase, meetings will pause once the launch date is confirmed. 

Throughout all seven phases of work, Alchemy adheres to the highest standards and a documented methodology for project management, governance and communications. Alchemy follows a transparent process for project delivery, changes and communications to keep all stakeholders, subject matter experts and project resources in sync.

10. Appendix - Roles & Responsibilities

Following is an overview of the important roles and responsibilities of key stakeholders at Alchemy and at the Customer. These roles persist from initial implementation throughout the customer journey as the Alchemy platform is constantly evolving.

Alchemy Roles & Responsibilities

Named Customer Success Manager (CSM) for Account

Alchemy Customer Success Managers are trained chemists, materials scientists, chemical engineers, and biochemists with expert knowledge of the Alchemy Cloud platform. A designated Customer Success Manager (CSM) serves as a single point of contact throughout all phases of work. The Alchemy CSM will marshall and manage other Alchemy resources as necessary to execute the full scope of work. 

Application Developer

Application Developers are software engineers with expert knowledge of the Alchemy Cloud platform and products as well as coding and scripting experience. Application Developers are assigned to projects on an as needed basis to complete specific portions of work that require their expertise.

VP Customer Success

Executive responsible for Alchemy’s Customer Success strategy and execution. Serves as the function head and point of escalation throughout the customer journey.

Sales Solution Engineer

Alchemy representative for the discovery, solution mapping, and configuration work in the sales process. Including but not limited to documenting customer tech stack, desired goals and key objectives, introducing Alchemy platform to the prospect, gathering initial requirements, scoping of the initial SOW, and answering questions.

Account Executive

Alchemy executive responsible for consummating a mutually beneficial commercial agreement with the Customer. Drives relationships with prospect key stakeholders and serves as the primary conduit between Alchemy’s CS, Product and  IT departments and the Prospect to ensure Alchemy meets Prospect needs and properly supports Prospect during the sales process.

Customer Roles & Responsibilities

Steering Committee (if applicable)

At larger enterprises, there may be a set of individuals that represent relevant competencies and have higher-level responsibility for the actions of their staff performing the roles listed below. Responsible for the strategy, decisions, and execution of their staff.

Business Owners (BSOs)

The business owner is the customer champion, executive buyer, or leader who is responsible for the Customer’s successful rollout of Alchemy.

Subject Matter Experts (SMEs)

SMEs are individuals designated by the customer. SMEs are those familiar, at a granular level, with the workflows being digitized. Usually, there is one SME per group or team that will be using Alchemy applications to execute their work.

User Validation Testers

Configurations will be reviewed and validated by a small group of User Validation Testers, usually the SMEs and potentially some designates. Confirm that the Alchemy implementation meets customer specifications and defined system functionalities are available.

Users

Users are all people who have IDs and passwords to access Alchemy. Users execute lab-related work in Alchemy or manage and monitor the work of others through Alchemy.

Administrators (Admins)

Administrators are all people who have IDs and passwords to the Alchemy configuration portal. Configure workflow-driven applications using the Alchemy configuration portal and manage access rights and privileges for all the Users at their company

© 2017-2025, Alchemy Cloud, Inc. All Rights Reserved. Confidential & Proprietary. Not for redistribution. Legal Terms

We use cookies to operate this website, improve its usability, personalize your experience, and track visits. By continuing to use this site, you are consenting to the use of cookies. We also share data with our social media and analytics partners. For more information, please read our updated Privacy Policy.

Accept