QualityOne Vaults provide a management system that allows organizations to efficiently standardize food safety practices across regions and local manufacturing sites using the HACCP (Hazard Analysis Critical Control Points) methodology. Users can create model HACCP plans in their Vault to define principles and procedural requirements for maintaining the HACCP system. To save time and effort, users can copy existing model HACCP plans as templates when creating new HACCP plans.
Configuration Overview
Configuring your Vault to use HACCP involves the following steps:
- Configure objects
- Configure picklists
- Configure object layouts
- Configure lifecycles
- Configure workflows
- Configure object actions
- Configure the HACCP Flow Diagram
- Configure HACCP Document Generation
- Configure user permissions
Note: Depending on your Vault’s creation date and which features are currently enabled and configured, some of the steps described in this article may be unavailable or already complete in your Vault.
Configuring Objects
You must activate the HACCP Plan and HACCP Plan Design object types on the HACCP Plan object in order to run the Create HACCP Plan from Design and Create HACCP Plan Design from Design actions.
To use the HACCP Flow Diagram and perform hazard analysis, you must also activate object types for the following objects:
- HACCP Plan Process Step
- Process Step
- CCP-Hazard Analysis
- CCP Library
- PRP/CM - Hazard Analysis
- HACCP Hazard Control
To create HACCP Plan Process Steps from the HACCP Flow Diagram and run the Create HACCP Plan Design from Design and Create HACCP Plan from Design actions, you must enable the System manages field value (read-only) checkbox on the Name (name__v
) field on the following objects:
- CCP-Hazard Analysis
- HACCP Plan Ingredient
- HACCP Plan Process Step
- Process Hazard Analysis
- Ingredient Hazard Analysis
- PRP/CM - Hazard Analysis
- HACCP Hazard Control
Configuring Hazard Analysis Fields
To perform hazard analysis using the HACCP Flow Diagram, you must ensure the following fields on the Process Hazard Analysis object are activated:
- Significant Hazard
- Potential Hazard Identified
- Hazard Classification
- Hazard Classification Group
- Origin & Nature of the hazards
- Risk Category
- CCP
- PRP
- OPRP
- Control Measure
- Subsequent Step
- Modification
- Hazard Analysis Complete
- Hazard Analysis Complete Reason
You must assign the Hazard Analysis Complete and the Hazard Analysis Complete Reason fields to all HACCP Plan Process Step object types, and to the HACCP Plan Process Step Group object.
If your organization uses a HARPC (Hazard Analysis and Risk-Based Preventive Controls) system, you must activate the Is FSMA Food Safety Plan? field on all relevant HACCP Plan object types.
Defining Hazard Analysis Outcomes
You can define formulas for showing and hiding each outcome section of a hazard analysis on the HACCP Flow Diagram. For instance, the following formula configured on the CCP field of the Process Hazard Analysis object tells Vault when to display the CCP section:
(subsequent_step_eliminate_reduce__v = false) && (eliminate_reduce_occurrence__v = true) && (do_control_measures_exist__v = true)
To configure, define a formula on the following Process Hazard Analysis fields:
- CCP
- PRP
- OPRP
- Control Measure
- Subsequent Step
- Modification
Configuring Picklists
Your Vault includes the following picklists for categorizing and filtering hazards as part of the hazard analysis process, which you can customize as needed to fit your business needs:
- Hazard Analysis Complete Reason: Users can select from multiple values to give a reason for the hazard analysis completeness status on a Process Hazard Analysis record.
- Step Hazard Analysis Complete Reason: Users can select from multiple values to give a reason for the hazard analysis completeness status on a HACCP Plan Process Step record.
- Group Hazard Analysis Complete Reason: Users can select from multiple values to give a reason for the hazard analysis completeness status on a HACCP Plan Process Step Group record.
- Hazard Analysis Type: Users can select either Material Hazard Analysis or Process Hazard Analysis to classify the hazard analysis type on a Process Hazard Analysis record.
- Hazard Classification Group: Users can select from multiple values to classify a hazard on a Process Hazard Analysis and Hazard record.
- Hazard Classification: Users can select from a list of pre-defined values determined by their selection for Hazard Classification Group to further classify a hazard.
- Origin & Nature of the hazards: Users can select from multiple values to describe hazards in a Process Hazard Analysis record.
- Preventive Control Type: Users can select from multiple values on a Process Hazard Analysis to describe the type of preventive control applied as part of a HARPC plan.
Configure the Hazard Classification Group or both the Hazard Classification Group and Hazard Classification picklists with values applicable to your organization’s business needs, or use the values provided in Configuring Material Verification Checklists.
If you configure both picklists, you must also configure a picklist dependency on the Hazard Classification Group picklist to make values available to select for the Hazard Classification field.
Configuring Object Layouts
HACCP provides a default object layout for the HACCP Plan object to allow users to create, analyze, and review food safety-related procedures. You can customize object layouts or create custom object layouts from Admin > Configuration > Objects > HACCP Plan > Layouts.
- For the HACCP Plan (
haccp_plan__v
) object:- Detail Form Section: If your organization uses a HARPC system, add the Is FSMA Food Safety Plan? field.
- Related Object Section: Insert the HACCP Plan Process Step, HACCP Plan Ingredient, and HACCP Plan Process Step Group objects.
- Insert the HACCP Plan Materials control section with the slider (
) icon. When you do this, ensure you deactivate the Material field in the Details section.
- For the HACCP Plan Process Step (
haccp_plan_process_step__v
) object:- Detail Form Section: Add the Hazard Analysis Complete and Hazard Analysis Complete Reason fields.
- Related Object Section: Insert the HACCP Plan Process Step Group (
haccp_plan_process_step_group__v
) object to display a list of groups associated with the process step.
- For the HACCP Plan Process Step Group (
haccp_plan_process_step_group__v
) object:- Detail Form Section: Add the Hazard Analysis Complete and Hazard Analysis Complete Reason fields.
- For the Hazard (
hazard__v
) object:- Detail Form Section: Add the Hazard Classification Group field. If your configuration uses the Hazard Classification field, you must also add it.
- For the Process Hazard Analysis (
process_hazard_analysis__v
) object:- Detail Form Section:
- Add the following fields:
- HACCP Plan Process Step Group
- Hazard Analysis Complete
- Hazard Analysis Complete Reason
- Hazard Analysis Type
- Hazard Classification Group
- Significant Hazard
- Add the Hazard Classification field, if relevant to your configuration
- If your organization uses a HARPC system, add the following fields:
- Is Preventive Control required?
- Preventive Control Justification
- Type of Preventive Control
- Add the following fields:
- Detail Form Section:
- For the Process Hazard Analysis - Hazard (
pha_hazard__v
) object:- Detail Form Section: Add the Brief Description field.
HACCP Plan Lifecycle
HACCP includes the HACCP Plan Lifecycle object lifecycle, which your organization can use and customize to suit your specific needs.
HACCP Workflows
The HACCP Plan Lifecycle includes standard object workflows which your organization can use and customize to suit your specific needs.
Configuring HACCP Object Actions
The HACCP Plan object lifecycle contains the following standard actions:
- Create HACCP Plan Design from Design: Copies the hierarchy of a HACCP Plan Design and its related records into a new set of records. The Source HACCP Plan field in the new HACCP Plan record will contain the ID of the copied HACCP Plan.
- Create HACCP Plan from Design: Offers the same functionality as the Create HACCP Plan Design from Design action except HACCP Plan is the target object type rather than HACCP Plan Design.
- HACCP Flow Diagram actions: Support the functionality of HACCP Flow Diagrams, enabling users to launch, lock, and unlock diagrams directly from a specific HACCP Plan.
Configuring the Create HACCP Plan from Design & Create HACCP Plan Design from Design Actions
Depending on your business needs, add these actions as a record action on the HACCP Plan object to:
- Add these actions as user actions on any HACCP Plan Lifecycle state
- Add these actions as entry actions on any HACCP Plan Lifecycle state
When users run the Create HACCP Plan Design from Design or Create HACCP Plan from Design actions, the Source HACCP Plan field in the new HACCP Plan record will contain the ID of the copied HACCP Plan Design. Vault does not copy:
- System-managed fields.
- Inactive object types.
- Inactive object fields.
- Any fields with the Do not copy this field in Copy Record checkbox selected.
Configuring HACCP Plan Copy Objects
All standard transactional HACCP objects are included in HACCP deep copy actions. To include additional objects in the copy, see Configuring HACCP Plan Translation.
Note: You must configure the HACCP Plan - Material object as a custom transactional object in order for the materials in a HACCP Plan to be included in the deep copy actions. This step will not be required in a future release.
Configuring HACCP Flow Diagram Actions
The following actions support the HACCP Flow Diagram:
- Launch Process Flow Diagram: Allows users to launch the HACCP Flow Diagram for a HACCP Plan record.
- Lock HACCP Flow Diagram and Unlock HACCP Flow Diagram: Prevents users from editing the HACCP Flow Diagram and unlocks the diagram so users can make updates.
To make these actions available to users on a HACCP Plan, first add them as record actions on the HACCP Plan object. You can then add these actions to the relevant HACCP Plan lifecycle states as user actions or entry actions.
Configuring the HACCP Flow Diagram
You can configure some fields and subsections that display within the Hazard Analyses section of the Information panel when users perform hazard analysis from the HACCP Flow Diagram. You cannot create new sections.
Hiding Subsections
To hide the Hazard Assessment and Categorization of Control Measures subsections:
- Navigate to Admin > Configuration > HACCP Setup > HACCP Flow Diagram Information Panel Sections.
- Select the Hazard Assessment Subsection or Categorization of Control Measures Subsection record.
- From the All Actions menu of the subsection record, select Edit.
- Set the Hide Section field to Yes.
- Click Save.
Configuring Fields
To configure fields to display in the Potential Hazard Description and Hazard Assessment subsections:
- Navigate to Admin > Configuration > HACCP Setup > HACCP Flow Diagram Information Panel Sections.
- Select the Potential Hazard Subsection or Hazard Assessment Subsection record. Field configuration is not available for other Hazard Analysis subsections.
- Under HACCP Flow Diagram Info Panel Section Fields, click Create.
- Enter a Name for the section field record. This value does not display anywhere outside the Admin area and is for configuration tracking purposes only.
- Optional: Enter a Label and Description.
- In the Object field, select Process Hazard Analysis.
- Enter a Field that exists on the Process Hazard Analysis object. This value must be in the following format:
Field.[field_name__v]
, for instance,Field.ccp__v
. - Enter a Display Order.
- Click Save.
To map fields that display in the Hazard Assessment subsection:
- Under HACCP Flow Diagram Info Panel Section Field Mappings, select the field mapping you wish to configure. You cannot create new field mappings.
- From the All Actions menu, select Edit.
- Optional: Update the Label and Description.
- Enter a Field on the Process Hazard Analysis object from which to map the value. This value must be in the following format:
Field.[field_name__v]
, for instance,Field.severity__v
. - Click Save.
Configuring HACCP Document Generation
To configure HACCP Document Generation, do the following:
- Activate the HACCP Plan Reports document type.
- Create a HACCP Template document template. For more information about creating a document template and configuring Merge Fields, see Managing Document Templates, Using Merge Fields for Microsoft Word & Excel and Configuring Merge Fields for Microsoft Word & Excel.
- Configure the appropriate lifecycles and workflows for the HACCP Plan Report document types.
Limitations
HACCP has the following limitation:
- The Create HACCP Plan Design from Design and Create HACCP Plan from Design actions do not copy values stored in Attachment fields.
Configuring User Permissions
You must ensure users have the appropriate read and create permissions to access the appropriate objects and object fields in addition to the permissions outlined below:
- For the HACCP Plan object:
- Create, Edit, and Delete permission.
- For the HACCP Plan object fields: if a field needs to be unique, you must enable the field to be required as well. To do so, select the Values must be unique setting and the User must always enter a value (required) setting.
- For users to view a HACCP Flow Diagram and its associated hazard analysis information, they must have Read permission on the following objects; to modify a HACCP Flow Diagram, users must have Create, Edit, and Delete permissions on the following objects:
- HACCP Plan Process Step
- HACCP Plan Process Step Connection
- HACCP Plan Ingredient
- HACCP Plan Process Step Group
- HACCP Plan Process Step Position
- HPPSC Position
- Process Hazard Analysis
- Ingredient Hazard Analysis
- Hazard
- CCP-Hazard Analysis
- Ingredient Involved
- HPPS - PHA
- Process Hazard Analysis - Hazard
- HPPS - HPPSG
- PRP/CM - Hazard Analysis
- PHA - Subsequent Steps
- HACCP Hazard Control
- PHA - HHC
- HACCP Process Modification
- For the Create HACCP Plan Design from Design or Create HACCP Plan from Design actions: Create permissions for both the target object type and the target object.
- To run the Generate HACCP Plan Report action, users must have the following permissions:
- Create permission for the HACCP Plan Reports document type.
- Create permission for the following HACCP Plan Reports document subtypes:
- Generated HACCP Documents
- HACCP Templates
- Create permission for the following document classifications of the Generated HACCP Documents document subtype:
- HACCP Flow Diagrams
- HACCP Plan Binders
- HACCP Plan Reports
- Create permission for the HACCP Plan Data Documents document classification of the HACCP Templates document subtype.
- Create permission for the HACCP Plan Binder binder.
Related Permissions
You can complete all the steps in this article with the standard System Administrator or Vault Owner security profile. If your Vault uses custom security profiles, your profile must grant the following permissions:
Type | Permission | Controls |
---|---|---|
Security Profile | Admin: Configuration: Document Fields: Create, Edit | Ability to create and modify document fields. |
Security Profile | Admin: Configuration: Document Lifecycles: Edit | Ability to modify document lifecycles. |
Security Profile | Admin: Configuration: Document Types: Edit | Ability to modify document types. |
Security Profile | Admin: Configuration: Object Lifecycles: Create, Edit | Ability to create and modify object lifecycles. |
Security Profile | Admin: Configuration: Object Workflows: Create, Edit | Ability to create and modify object workflows. |
Security Profile | Admin: Configuration: Objects: Create, Edit | Ability to create and modify Vault objects. |
Security Profile | Admin: Configuration: Templates: Create, Edit | Ability to create and modify document or binder templates. |
Security Profile | Pages: All Pages: Process Flow Diagram | Ability to configure the HACCP Flow Diagram. |
Security Profile | Pages: All Pages: Side Panel Configuration | Ability to configure fields on the Information panel of the HACCP Flow Diagram. |