Skip to main content
Version: 2.15.X

Building Cases with Collections

Cogynt Workstation workflows often rely on collections to catalog events, comments, and custom fields within a single entity. The Collections widget is where collections are built and housed. Once created, collections can contain events, comments, and custom fields.

Assumptions

This guide assumes:

  • That at least one collection exists in Workstation.
  • That events have been ingested.
  • Optionally, that event notifications have been configured.

Attaching Events to Collections

Events that have been ingested can be attached to a collection to indicate that the event is relevant to the collection.

To attach events to collections:

  1. From an open Events Explorer, Notifications, or Notifications Explorer widget, locate the event.
  2. Click and drag the event into the collection open inside the Object Details Viewer. Release to attach the event.
  3. To view events within a collection that have been loaded into Object Details Viewer, click the Items tab.
  4. Drag events into another Object Details Viewer for further analysis.
    • One Object Details Viewer widget is required per event to be analyzed.
    • Events cannot open in the same Object Details Viewer as the collection they came from.
    • At least two Object Details Viewer widgets are recommended per workspace.
  5. Add other Object Details Viewer widgets to the working view, and repeat steps 1-4 as needed.

Events attached to collections can also be dragged into other widgets for further investigation. The Object Details Viewer widget must be open in your workspace.

Removing Events From Collections

Events that have been attached to a collection can be removed.

To remove events from collections:

  1. From the Collections Details Viewer, click the Items tab.
  2. From the right side of the event attached to the collection, click the X button to delete it.
tip

From the toast at the bottom right of the screen, confirm deletion occurred or click Undo to return the event to the collection if deletion occurred in error.

Collections can involve related collections, linking multiple incidents, events, and collection data for easy access and reference. For example, a collection for a geographic region can hold related collections for the names, addresses, and IDs for the people who work there.

To attach related collections:

  1. Open a workspace containing both collections and Object Details Viewer widgets.
  2. Drag a collection into Object Details Viewer. This collection will hold related collections.
  3. From the Collections widget, find other collections to link as related.
  4. Drag a related collection from the Collections widget into the Object Details Viewer. The Object Details Viewer shows two options:
    1. View collection details opens the collection.
    2. Add collection as related attaches the related collection to the collection open in Object Details Viewer.
  5. Drop a related collection into Add collection as related.
  6. Enter an optional description of how these collections are related.
  7. At the bottom of the open collection in Object Details Viewer, click the Related Collections dropdown.
  8. Confirm the related collection exists in the list, or drag another related collection into the Object Details Viewer.

Related collections can be viewed from any collection they belong to.

To view related collections:

  1. Drag a collection containing at least one related collection into the Object Details Viewer widget.
  2. At the bottom of the collection inside the Object Details Viewer widget, click the Related Collections dropdown.
  3. Locate the related collection to view from the list of related collections.
  4. Drag the related collection into any Object Details Viewer widget to view.

Optional descriptive text can be edited to clarify the relation between collections, fix typos, or add more details.

To edit a related collection's descriptive text:

  1. Drag a collection containing at least one related collection into the Object Details Viewer widget.
  2. At the bottom of the collection inside the Object Details Viewer widget, click the Related Collections dropdown.
  3. Locate the related collection from the list of related collections.
  4. Click the previous descriptive text used for the related collection. This field will contain none if no descriptive text exists.

Using Custom Fields

If Custom Field Templates have been created for collections, it is possible to view collections and modify these fields with Object Details Viewer. Once a collection is loaded into the Object Details Viewer widget, users can view, add to, or edit data for any custom fields available.

note

A custom field may temporarily appear as Disabled when a new Custom Field Template is created if there are a high volume of collections in Cogynt.

Customizing a collection with custom fields adds functionality for user specific workflows, feedback and user engagement. Text fields are a common use case, as collections can be summarized or users can provide detailed analysis.

To use custom fields in collections:

  1. From a workspace, click a collection in the Collections widget and drag it into the Object Details Viewer.
  2. At the top of the Object Details Viewer, click the Custom Fields tab. The widget changes to show all currently created custom fields.
  3. Change the desired custom field(s) as needed:
    • Text or Rich Text fields can be edited by hovering over the field and selecting Edit.

      note

      Text and rich text fields lock to prevent more than one user making changes, and only unlock after submitting changes. Changes also submit automatically after 30 minutes of inactivity.

    • Checkboxes can be directly checked or unchecked.

    • Select options are set by directly clicking into the menu and selecting the desired option.

Custom Fields are displayed based on their type:

  • Rich Text and Regular Text fields are displayed in shaded boxes.
  • Select menus always display the default or currently selected value.
  • Checkbox groups dim all unchecked values.
note

Checkbox custom fields used in collections can filter between checked or unchecked. Click the More menu () to the right of the checkbox field title, and select All, Checked, or Unchecked to determine the list's visibility setting.

Custom field templates, groups, and options reflect the configuration set in the Custom Field Templates screen of the Designer tab.