ProcessMaker Developers Documentation
processmaker.comKnowledge CenterProcessMaker University
Guides
Guides
  • Getting Started
    • Installing ProcessMaker
  • Authentication
    • Creating a Client Application
    • Getting an Access Token
    • Getting a Refresh Token
  • Working with the API
    • Starting a Request via REST API
    • Starting a Request via Web Hook
  • Embedding Forms
    • Starting a Request via Anonymous Web Entry
    • Participating in a Workflow via Intermediate Web Entry (Anonymous)
    • Participating in a workflow via Intermediate Web Entry (Authenticated)
    • Angular Inbox Tutorial
      • Part 0: Overview
      • Part 1: Hello World
      • Part 2: Services & Dependencies
      • Part 3: Components
      • Part 4: The Inbox
      • Part 5: The Screen & Form Elements
  • Script Task Examples
    • PHP
  • Packages
    • ProcessMaker Platform Packages
      • Actions By Email Package
      • Advanced Screens Package
      • Advanced User Package
      • Auth Package
      • C# Package
      • Collections Package
      • Comments Package
      • Conversational Forms Package
      • Data Connector Package
      • Decision Tables Package
      • Documentation Package
      • DocuSign Package
      • Dynamic UI Package
      • File Manager Package
      • Google Places Package
      • IDP Package
      • Java Package
      • PDF Generator Package
      • PM Blocks Package
      • Process Optimization Package
      • Python Package
      • R Package
      • Saved Searches Package
      • Send Email Package
      • Signature Package
      • Slack Notification Package
      • Translations Package
      • Versioning Package
      • Vocabularies Package
      • Web Entry Package
    • Custom Packages
      • The Package Skeleton
      • Creating Your First ProcessMaker Package
Powered by GitBook
On this page
  1. Packages
  2. ProcessMaker Platform Packages

Collections Package

Create multiple sets of schema-less data records using Screens that do not require an external database.

PreviousC# PackageNextComments Package

Last updated 11 months ago

Overview

Use the Collections package to maintain sets of schema-less data records using , each referred to as a . The Collections package has the following features:

  • An external database is not required to store Collections. Collections are maintained in the ProcessMaker instance.

  • A Collection is composed of a set of records. Similar to a relational database, a record is a grouping of fields that represent related data. Design the grouping of fields using Screens to represent this data, thereby making it easy for any user to view, create, or edit record data if they have the appropriate permission(s) to do so. Within a Collection, potentially use different Screens to create a record, edit a record, or view a record within that Collection. This provides greater control in how information within a Collection is consumed by various stakeholders in the Collection. Consider the following use case:

    • Create a record: Allow an assistant to create a record using Screen for this purpose, such as in a medical practice.

    • Edit a record: In the same medical practice, a dedicated Screen allows a nurse to edit patient information after the new patient has granted legal permission for medical staff to edit sensitive medical information (in compliance with HIPAA standards).

    • View a record: Use a third Screen that references identical record information, but limits the content and editing so that the medical practice complies with patient legal protections.

  • Collections are schema-less, meaning that any type or format of data may be stored in a Collection. Because Collections are schema-less, changing the thereby changes the types of information or data to all records within that Collection. You are not constrained by how you define a Collection when you create it. For example, if you want to allow Collection stakeholders to attach a file that becomes associated with a record, add a in the applicable Screen(s) that represent information in that Collection; the new File Upload control becomes available in all records in that Collection.

  • Determine which users and/or groups have permission to view, create, edit, or delete Collections by setting . These permissions are different than that specify which users and/or groups can manage records within an individual Collection.

  • into a Collection to simultaneously create multiple records from the CSV file's data records.

  • The Collections package integrates with the package. Use the Saved Searches package to save and share searches associated with a Collection. See Saved Searches Package. Use ProcessMaker Query Language () parameters to compose queries to . Furthermore, changes to a Collection may then be applied to Saved Searches associated with that Collection.

  • Establish . A Collection relationship links two Collections by designating one Collection as a parent Collection, the other as a child Collection, and defining data keys or columns linking both Collections. The Collection from which this relationship is created is automatically designated as the parent Collection. The relationship is a one-to-many relationship such that a record in the parent Collection can have multiple matching records in the child Collection.

  • An external database is not required to store Collections. Collections are maintained in the ProcessMaker instance.

  • The Collections package integrates with the Saved Searches and Data Connector packages:

    • Saved Searches package: Use the Saved Searches package to save and share searches. See .

    • Data Connector package: Access both Collection records and third-party data sources from any ProcessMaker asset, including Screens, Scripts, and Process models. See .

Saved Searches
Saved Searches Package
Data Connector Package
Screens
Collection
Screen(s) that are used to create, edit, and view records in each Collection
File Upload control
Collection permissions
record permissions
Import a CSV file
PMQL
search for record information in a Collection
relationships between records in one Collection with those in a second