Advanced Searching

Searches in Atrium are performed against a default set of fields which serves most use cases. There are, however, more specific searches that can be performed to return highly targeted results based on the properties of a given type.

Searches must follow the query string syntax supported by elasticsearch.

Shared Properties

Property Field Type Description
name String Name of item
created Date Date item was created
createdBy String User who created the item
updated Date Date item was updated
updatedBy String User who updated the item

Indexed Properties by Type

Type Property Field Type Description
file      
  workflowId String Unique id of the workflow that created the file
  workflowRunId String Unique id of the run that created the file
  projectId String Unique id of the project (if it is a project file)
  content.length Long File size in bytes
project      
  projectId String Unique id of the project
job      
  jobId String Unique id of the job
  clientId String Unique id of the client the job is in
  projectId String Unique id of the project the job is in
jobRun      
  projectId String Unique id of the project the run is in
  submitDuration Long Elapsed time in seconds between submitted and started
  runDuration Long Elapsed time in seconds between started and stopped
  runId String Unique id of the job run
  submitted Date Timestamp when the workflow was submitted
  started Date Timestamp when the job started
  stopped Date Timestamp when the job stopped
  status String Current status of run
workflow      
  workflowId String Unique id of the workflow
  projectId String Unique id of the project the workflow is in
workflowRun      
  submitDuration Long Elapsed time in seconds between submitted and started
  runDuration Long Elapsed time in seconds between started and stopped
  runId String Unique id of the workflow run
  submitted Date Timestamp when the workflow was submitted
  started Date Timestamp when the workflow started
  stopped Date Timestamp when the workflow stopped
  published Date Timestamp when the workflow published
  projectId String Unique id of the project the workflow is in
  workflowId String Unique id of the workflow the run is related to
  status String Current status of run
result      
  projectId String Unique id of the project the result is in
  workflowId String Unique id of the project the result is in
  runId String Unique id of the run that produced the result
  workflowRunId String Unique id of the run that produced the result

Examples

In the examples below, substitute your login name (typically your email address) for ‘demo’.

Find all jobs and workflows submitted by a user that are running

updatedBy:demo AND status:RUNNING

Find all workflows and jobs run by a user within a date range

updatedBy:demo AND (type:workflowRun OR type:jobRun) AND (status:SUCCESS OR status:FAILURE) AND updated:[2014-12-28 TO 2015-01-14]

Find all workflows created by a user since the end of December

createdBy:demo AND type:workflow AND created:[2014-12-31 TO *]

Find all jobs and workflows submitted by a user that ran longer than 8 hours

Durations are in seconds

createdBy:demo AND runDuration:>28800

Find files larger than a specific size

File sizes are stored in bytes. To compute bytes for a 5 (megabyte, gigabyte, terabye) file:

megabyte 5 * 1024 * 1024
gigabyte 5 * 1024 * 1024 * 1024
terabyte 5 * 1024 * 1024 * 1024 * 1024

The queries (respectively)

type:file AND content.length:>=5242880
type:file AND content.length:>=5368709120
type:file AND content.length:>=5497558138880

Find all files created by a user

createdBy:demo AND type:file