Manage your Collections.
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Import a Collection that has previously been exported.
Import a Collection that has been exported from the same ProcessMaker Platform version. The imported Collection contains the records and the Screens from the exported Collection. Exported Collections have the .json
file extension.
The Collections package must be installed.
Your user account or group membership must have the following permissions to import a Collection unless your user account has the Make this user a Super Admin setting selected:
Collections: Import Collections
Collections: View Collections
See the Collections permissions or ask your Administrator for assistance.
Follow these steps to import a Collection:
View your Collections. The Collections page displays.
Click Browse to locate the Collection to import. Collections have the .json
file extension.
View the Collections in your organization that you're allowed to view or revise.
ProcessMaker Platform displays all Collections in one table. This makes it easy to manage the Collections.
The Collections package must be installed.
Your user account or group membership must have the "Collections: View Collections" permission to view the list of Collections unless your user account has the Make this user a Super Admin setting selected. This permission is different than record permissions in a Collection that allow you to view the records in that Collection.
See the Collections permissions or ask your Administrator for assistance.
Follow these steps to view all Collections in your organization:
Log on to ProcessMaker Platform.
Click the Admin option from the top menu. The Users page displays.
The Collections page displays the following information in tabular format about Collections:
ID: The ID column displays the Collection's ID. ProcessMaker Platform automatically generates the ID value when the Collection is created and represents a sequential number of how many total Collections have been created to that time.
Name: The Name column displays the Collection's name.
Type: The Type column identifies whether the list displays a Collection or a Saved Search.
# Records: The # Records column displays how many records are in each Collection.
Created By: The Created By column displays the user who created the Collection. Hover your cursor over the user's avatar to view that person's full name.
Created: The Created column displays the date and time the Collection was created. The time zone setting to display the time is according to the ProcessMaker Platform instance unless your user profile's Time zone setting is specified.
Use the Search field to filter Collections that display.
Click the +Collection button. See Create a New Collection.
If this Collection has a relationship with another Collection, view the records related to those in this Collection. See View Child Collection Records from a Parent Collection.
If no Collections exist, or you do not have permission to view any, the following message displays: No Data Available.
Control how tabular information displays, including how to sort columns or how many items display per page.
Create a new Collection into which to add records.
A Collection uses at least two Screens to create, edit, and view records in that Collection:
Create a record: Have available a Form-type Screen to create a record in the Collection. Ensure that this Screen contains all the appropriate Screen controls required for authorized Collection stakeholders to create a complete record.
Edit a record: Either use the same Screen that creates a record, or have available a second Form-type Screen to edit any record in the Collection. Ensure that this Screen contains all the appropriate Screen controls for authorized Collection stakeholders to edit or update particular content of a record in the Collection. In many cases, the controls to create a record may be identical to those to edit a record. If you want to use a second Screen, optionally make a copy of the Screen intended to create a record, and then make changes to it without needing to design a new Screen.
View a record: Have available a Display-type Screen to view any record in the Collection. This Screen may serve two purposes:
Provide a read-only view of a complete record: This allows authorized Collection stakeholders to view complete contents of any record in the Collection, but not edit or update it.
Limit the information displayed in a record: This allows authorized Collection stakeholders to view limited content of any record in the Collection to comply with specific legal or privacy requirements.
Ensure these Screens are available before creating a new Collection. You are not required to have the controls in these Screens finalized, as you or an authorized designer may change these Screens at any time. Doing so updates all records within that Collection automatically.
The Collections package must be installed.
Your user account or group membership must have the following permissions to create a Collection unless your user account has the Make this user a Super Admin setting selected:
Collections: Create Collections
Collections: View Collections
These permissions are different than record permissions in a Collection that allow you to view or create records in that Collection.
See the Collections permissions or ask your Administrator for assistance.
See Collection Best Practices before creating a Collection.
Follow these steps to create a Collection:
View your Collections. The Collections page displays.
In the Name setting, enter the name of the Collection. This name must be unique from all other Collections. This is a required setting.
In the Description setting, enter the description of the Collection. This is a required setting.
From the Create Screen drop-down menu, select the Screen from which new records in this Collection are created. This must be a Form-type Screen. This is a required setting.
From the View Screen drop-down menu, select the Screen from which to view records in this Collection. Use this Screen to only display all or parts of a record in the Collection. For example, the Screen selected from the View Screen drop-down menu may be designed to not display sensitive information that all Collection stakeholders should have access. This must be a Display-type Screen. This is a required setting.
From the Edit Screen drop-down menu, select the Screen from which to edit or update records in this Collection. This can be the same or a different Screen as selected from the Create Screen drop-down menu. This is a required setting.
If the Data Connector package is installed, the Collection also creates a Data Connector that uses the Collection name so that Collection records can be acted upon from ProcessMaker Platform assets. See Resources for Collections.
After each Collection is created, three Signals are automatically created for Collection record events. See Collection Signals.
Edit the configuration for a Collection.
Furthermore, your user account or group membership must have the following permissions to configure a Collection unless your user account has the Make this user a Super Admin setting selected:
Collections: Edit Collections
Collections: View Collections
These permissions are different than record permissions in a Collection that allow you to view or edit records in that Collection.
Follow these steps to configure your Collection:
Refer to the following sections to configure your Collection. These configuration sections may be configured independently of one another:
Follow these steps to configure basic settings for your Collection:
In the Name setting, edit the name of your Collection. Since this name displays in the left sidebar when the Collections top menu is selected, ensure that this is a descriptive name. This name is helpful for yourself and those with whom have access to this Collection. This is a required setting.
In the Description setting, edit the description of your Collection. This is a required setting.
From the Edit Screen drop-down menu, select a Screen from which to edit or update records in this Collection. This can be the same or a different Form-type Screen as selected from the Create Screen drop-down menu. Optionally, select this setting's Open Screen option to view the currently selected Screen in a new browser window. This is a required setting.
appear above the record details of the child Collection record.
Enable the Use Randomly-Generated IDs for Links toggle key to generate random IDs for hyperlinks to records in this Collection instead of sequential numbering as each record is created. By default, each record in a Collection is numbered sequentially, which can potentially be determined to access a record without configured permission. This setting is disabled by default.
Click Save.
Record is created: When a record is created in this Collection, broadcast the Collection Signal for subscribing Signal-type events that listen for this event to occur. If this Collection Signal is disabled, it does not broadcast when this type of event occurs.
Record is edited: When a record is edited in this Collection, broadcast the Collection Signal for subscribing Signal-type events that listen for this event to occur. If this Collection Signal is disabled, it does not broadcast when this type of event occurs.
Record is deleted: When a record is deleted in this Collection, broadcast the Collection Signal for subscribing Signal-type events that listen for this event to occur. If this Collection Signal is disabled, it does not broadcast when this type of event occurs.
Follow these steps to configure your Collection's Signals for subscription:
Configure the Collection's Signals for subscription following these guidelines:
Throw Signal on Update: Toggle the Throw Signal on Update toggle key to broadcast this Signal each time a record is edited in this Collection. Note that if multiple records from a Collection are edited in a batch, such as from a script, and the Throw Signal on Update toggle key is enabled, that Signal broadcasts for each edited record, possibly triggering that Signal's webhook if it is enabled. This toggle key is disabled by default.
Throw Signal on Delete: Toggle the Throw Signal on Delete toggle key to broadcast this Signal each time a record is deleted in this Collection. Note that if multiple records from a Collection are edited in a batch, such as from a script, and the Throw Signal on Delete toggle key is enabled, that Signal broadcasts for each deleted record, possibly triggering that Signal's webhook if it is enabled. This toggle key is disabled by default.
Click Save.
By default all users do not have any access to records in your Collection unless a user has the Make this use a Super Admin setting selected.
Follow these steps to configure how users have access to your Collection:
Enter in the Search field the text to filter user accounts, if necessary.
Toggle any of the permission settings for applicable users to allow each user appropriate access to records in this Collection. By default all users do not have any access to records in your Collection unless a user has the Make this use a Super Admin setting selected. If necessary, ensure to grant your own user permissions to access records in your Collection. Follow these guidelines:
Create: Toggle the Create setting to grant or restrict permission for that user to create records in this Collection.
Delete: Toggle the Delete setting to grant or restrict permission for that user to delete records in this Collection.
Edit: Toggle the Edit setting to grant or restrict permission for that user to edit records in this Collection.
Edit Raw Data: Toggle the Edit Raw Data setting to grant or restrict permission for that user to edit JSON associated each record in this Collection.
View: Toggle the View setting to grant or restrict permission for that user to view individual records in this Collection.
List: Toggle the List setting to grant or restrict permission for that user to view the list of all records in this Collection.
Click Save.
Record-level permissions are cumulative: permissions set for a specific user apply regardless of whether that user is a member of a group with record permissions. If that user is granted permissions not granted to a group, regardless of whether that user is a group member, that user maintains that record permission.
By default all groups do not have any access to records in your Collection.
Follow these steps to configure how groups have access to your Collection:
Enter in the Search field the text to filter groups, if necessary.
Toggle any of the permission settings for applicable groups to allow its members appropriate access to records in this Collection. By default all groups do not have any access to records in your Collection unless a group member has this permission or has the Make this use a Super Admin setting selected for his or her user account. Follow these guidelines:
Create: Toggle the Create setting to grant or restrict permission for members of that group to create records in this Collection. If a group does not have the Create toggle key enabled, the +Record button used to create a record is not visible for its members unless individual users in the group have this permission.
Edit Raw Data: Toggle the Edit Raw Data setting to grant or restrict permission for members of that group to edit JSON associated each record in this Collection. If a group does not have the Edit Raw Data permission, JSON associated with a record of the Collection is not visible to members of this group unless individual users in the group have this permission.
View: Toggle the View setting to grant or restrict permission for members of that group to view individual records in this Collection. If a group does not have the View toggle key enabled, members of that group do not see any records in that Collection unless individual users in the group have this permission.
List: Toggle the List setting to grant or restrict permission for members of that group to view the list of all records in this Collection. However, if the View permission is enabled, then group members may view to individual records in this Collection.
Click Save.
When a record in a Collection is viewed, the record data is displayed in tabular format with customizable columns.
Follow these steps to configure the columns to display when viewing records of your Collection:
Follow these guidelines to select which column(s) display information when viewing records in a Collection: Remove a column that displays when viewing records in a Collection:
Alternatively, drag the informational component from the Active Columns list to the Available Columns list.
Add a column that displays when viewing records in a Collection:
Drag the informational component from the Available Columns list to the Active Columns list, and then place the informational component in the order from top-to-bottom that you want that informational component to display when viewing records in a Collection. Informational components at the top of the Active Columns column display left-most in the column order; components at the bottom of the Active Columns column display right-most in the column order.
Configure how a column displays information when viewing records in a Collection:
In the Label setting, edit the column label that displays for the Collection record.
In the Field setting, edit the variable name that represents the Collection variable used in the Create screen for this Collection. data.
represents that what follows derives from a Collection variable. To derive that information, view the Collection variable used in that Collection's Create Screen, then use the specific key name in the following syntax, where CollectionData
represents the variable name: data.CollectionData
.
Use the Sortable toggle key to adjust whether the column is sortable in search results.
Click Save.
Add a custom column to include custom labels when viewing the records in a Collection:
In the Label setting, enter a column label that displays in search results.
In the Field setting, enter the name of the default informational component replacing any spaces with an underscore. For example, for the Modified By column, set the Field setting to modified_by
. This setting is case sensitive and all characters must be in lower case letters.
Use the Sortable toggle key to adjust whether the column is sortable in search results.
Click Save.
Sort the order that columns display when viewing records in a Collection:
Reset the columns displayed when viewing records in a Collection:
Click Confirm.
Click Save after you configure all your Collection settings.
Configure a relationship between 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.
Consider the following example of two Collections at a college:
Professors: One Collection named Professors contains record information about each professor, such as the name, department of study, email address, and classes each professor teaches.
Available Courses: Another Collection named Available Courses contains record information about all courses offered at that college, such as the name, the professor teaching that course, and its area of study.
The common data between these Collection records is the name of the course. Use this common data to establish a one-to-many relationship from one Collection to the other. To establish a relationship between the available courses and which classes are available of each course during a semester, the Available Courses Collection is the parent Collection. The Professors Collection is the child Collection that contains multiple records of each class from the Available Courses Collection, thereby establishing the one-to-many relationship between these Collections. Students use this example to register for classes in available courses.
Inversely, the Professors Collection can be the parent Collection, with the Available Courses Collection being the child Collection: students can view all classes that a specific professor teaches regardless of the courses that professor teaches.
Follow these steps to configure a relationship between data in your Collection with data in another:
In the Name setting, enter a name for this relationship. This name displays when viewing a child Collection record in the Relationships tab of a record of the parent Collection. This is a required setting.
In the Description setting, enter a description for this relationship. This is a required setting.
In the Relationship section, configure details of this relationship by selecting a child Collection and the common data keys linking the child Collection to this parent Collection. The data in the parent Collection's key matches with that in the child Collection's key and the respective record(s) from the child Collection is retrieved. Follow these guidelines:
From the Parent Collection Data Key drop-down menu, select a common data key from the parent Collection to link to its corresponding common data key in the child Collection.
From the Child Collection drop-down menu, select the name of the child Collection to which to establish this relationship.
From the Child Collection Reference to Parent Key drop-down menu, select the common data key from the child Collection to link to the selected data key in the parent Collection.
Click Save.
Filter all Collection in your organization to find that one you need.
Follow these steps to search for a Collection:
Enter in the Search field the text to filter by the Collection name that displays in the Name column.
As you enter text into the Search field, Collections display that match your entered text.
If there are no search results, the following message displays: No Data Available.
Click the Import button. The Import Collection screen displays.
Click Import. The Import Collection screen displays to indicate that the Collection imported correctly.
Click List Collections. The Collections page displays the imported Collection with the same name as the original Collection except with a number "2" suffix.
Click the Collections iconin the left sidebar. The Collections page displays the Collections that you are allowed to view.
Click the Records icon. See View All Records in a Collection.
Click the Edit icon. See Edit a Collection.
Click the Delete icon. See Delete a Collection Record.
Click the Export icon. If the Collection is a Saved Search of Collection records, the Export icon is disabled. See Export a Collection.
Click the +Collection button. The Create Collection screen displays.
Click Save. The Collection displays an empty list of records for that Collection so you may create your first record. See Create a Collection Record. Furthermore, the Collection icondisplays access to the Collection from the left sidebar of the Collections page. See View Records in a Collection.
The must be installed.
See the permissions or ask your Administrator for assistance.
. The Collections page displays.
Click the Configure iconfor your Collection. The Configuration tab displays.
. The Configuration tab displays. Use the Configuration tab to configure basic settings for your Collection.
From the Create Screen drop-down menu, select a Screen from which new records in this Collection are created. This must be a Screen. Optionally, select this setting's Open Screen option to view the currently selected Screen in a new browser window. This is a required setting.
From the View Screen drop-down menu, select a different Screen from which to view records in this Collection. Use this Screen to only display all or parts of a record in the Collection. For example, the Screen selected from the View Screen drop-down menu may be designed to not display sensitive information that all Collection stakeholders should have access. This must be a Screen. Optionally, select this setting's Open Screen option to view the currently selected Screen in a new browser window. This is a required setting.
In the Custom Record Title setting, edit the text to display in the breadcrumbs menu when displaying a record from this Collection. This setting accepts to dynamically reference Collection data that displays in record's breadcrumbs menu. All references included in mustache syntax for the custom record title are case sensitive. By default this setting has the value {{ id }}
to reference the record ID of the Collection record that is currently displayed. Spacing within mustache syntax is not required, but provides greater readability. Reference Collection data by referencing the Collection variable in mustache syntax. Within the mustache syntax, precede the Collection variable name with data.
to indicate that this is Collection data.
Example: {{ data.CollectionVariableName }}
Include plain text in the Custom Record Title if this helps provide clarity to the record title. Custom Record Title data from a parent Collection is also displayed in a child Collection when viewing a record of that child Collection to highlight the between the two Collections. Below is an example.
This is a record in the child Collection List of Courses in a College that has a relationship with the parent Collection List of Professors in a College. The name of the parent Collection and its Custom Record Title value, specified as: {{ data.professor_name }} - {{ data.professor_email }}
Optionally, .
Configure if the broadcast for this Collection when any of the following record events occur. Each Collection's Signals are created and display in when that Collection is created.
. The Configuration tab displays.
Locate the Collection Signals group of settings.
Throw Signal on Insert: Toggle the Throw Signal on Insert toggle key to broadcast this Signal each time a record is created in this Collection. Note that if a comma-separated value (CSV) file is imported into this Collection to create records and the Throw Signal on Insert toggle key is enabled, that Signal broadcasts for each new record, possibly triggering that if it is enabled. This toggle key is disabled by default.
Configure how have permission to access the records in your Collection. Permissions may be set differently for each user . If a user account has the Make this user a Super Admin setting selected in that account, then these settings have no effect on that user. ProcessMaker does not check permissions for user accounts with this setting selected.
. The Configuration tab displays.
Click the User Permissions tab.
Configure how have permission to access the records in your Collection. Permissions may be set differently for each group. Groups have access to records in this Collection under the following circumstances:
If a user has the Make this user a Super Admin setting selected in his or her user account, then these settings have no effect on that user. ProcessMaker Platform does not check permissions for user accounts with this setting selected, allowing such users to administer and install which might otherwise require permissions be granted to a user account to perform. For more information about this setting, see .
. The Configuration tab displays.
Click the Group Permissions tab.
Delete: Toggle the Delete setting to grant or restrict permission for members of that group to delete records in this Collection. If a group does not have the Delete toggle key enabled, the Delete iconused to delete each record is not available for members of this group unless individual users in the group have this permission.
Edit: Toggle the Edit setting to grant or restrict permission for members of that group to edit records in this Collection. If a group does not have the Edit toggle key enabled, the Edit iconused to edit that record is not available for members of this group unless individual users in the group have this permission.
. The Configuration tab displays.
Click the Columns tab. Use the Columns tab to customize how the records in a Collection when . Collection records display in tabular format when the View icon is clicked for a record. The Active Columns column displays the currently selected or default columns to present the Collection records in tabular format. The Available Columns column displays optional informational components that can be displayed. The informational components in the Active Columns list display in the order that these informational components display in tabular format. Informational components at the top of the Active Columns column display left-most in the column order; components at the bottom of the Active Columns column display right-most in the column order.
From the Active Columns list, click the Remove iconfor the informational component not to display when viewing records in a Collection. The removed informational component moves to the bottom of the Available Columns list.
Click the Configuration iconfor the informational component from the Available Columns column. Note that columns that do not have the Configuration icon are default columns that cannot be configured, but only removed from the Collection records view. The Configure screen for that informational component displays.
Use the Add Custom Column screen to add custom labels for one of the default informational components, such as the Created By or Modified By columns, to provide more relevant context to that record information. Click the Add Custom Column button at the bottom of the Available Columns column. The Create Custom Column screen displays.
Sort the informational components in the Active Columns list in the order that they are to display when viewing records in a Collection. To do so, click theicon for an informational component, drag it, and then place it into the order the column is to display. Do not drag the information component to the Available Columns column, or it will no longer be included as a column that displays when viewing records in a Collection.
If it is necessary to reset the columns in your Collection to the default layout, click the Reset to Default button. Doing so displays the Reset to Default screen.
to be the parent in the relationship. The Configuration tab displays.
Click the Relationships tab.
Click the +Relationship button. The Add Relationship screen displays.
Use the Search function to filter all from the Collections page based on your entered text.
The must be installed.
Your user account or group membership must have the "Collections: View Collections" permission to view the list of Collections unless your user account has the Make this user a Super Admin setting selected. This permission is different than in a Collection that allow you to view the records in that Collection.
See the permissions or ask your Administrator for assistance.
. The Collections page displays.
Export a Collection.
Export a Collection to your local computer. The exported Collection may then be imported to the same or another ProcessMaker Platform instance of the same ProcessMaker Platform version. An exported Collection may then be shared with others so they can import your Collection. If the Collection is a Saved Search of Collection records, it cannot be exported; export from the Collection itself.
When a Collection is exported, the following also exports:
Records: All records within that Collection export.
Screens: The Screens used to create, view, and edit records in that Collection also export.
The exported Collection has the .json
file extension.
The Collections package must be installed.
Your user account or group membership must have the following permissions to export a Collection unless your user account has the Make this user a Super Admin setting selected:
Collections: Export Collections
Collections: View Collections
See the Collections permissions or ask your Administrator for assistance.
Follow these steps to export a Collection:
View your Collections. The Collections page displays.
Click Download, then browse for the location on your local computer to save the exported Collection.
By default, ProcessMaker Platform exports the Collection using the original Collection name except spaces in the name are replaced with underscores (_
). The file has the file extension .json
. Rename the default file name if necessary, though do not change the file extension. As a best practice, specify in the file name that this is an exported Collection to distinguish it from other exported assets.
Specify a directory location to save the file. ProcessMaker Platform exports the .json
file to your local computer. The following message displays when the Collection exports successfully: The collection was exported.
Delete a Collection.
However, the Screens used in that Collection are not affected.
Deleting a Collection from the Collections page cannot be undone.
Follow these steps to delete a Collection:
Click Confirm.
Click the Export iconfor your Collection to export. If the Collection is a Saved Search of Collection records, it cannot be exported; export from the Collection itself. The Export Collection page displays.
Click Export. ProcessMaker prepares the Collection for export and a Download button displays when the export file is ready.
The must be installed.
These permissions are different than in a Collection that allow you to view or delete records in that Collection.
See the permissions or ask your Administrator for assistance.
When a Collection is deleted, all records in that Collection are also permanently deleted. Furthermore, all for that Collection are also deleted.
. The Collections page displays.
Click the Delete iconfor your Collection to delete. The Caution screen displays to confirm the deletion of the Collection.