Skip to content

Perform Immediate Data Collection#

🔒 DataCollectionInstance.PerformImmediate

Overview#

This operation is used to perform an immediate data collection. There are two types of immediate data collections:

  • Immediate - which uses an existing data collection definition.
  • Immediate ad-hoc - which does not follow any data collection definition, that is, it is completely arbitrary.

Setup#

No special setup is required other than to meet the preconditions of the transaction. For more information, see Data Collection.

Preconditions#

  • All optional references to Resource, Material, Data Collection and Data Collection Limit Sets must be Active.

Sequence of Steps#

Step 1: Instance Details#

  1. Optionally, enter a Data Collection Instance name - otherwise, an automatic name will be provided by a name generator.
  2. Optionally, enter a description.
  3. If you want to create a user-defined Data Collection, activate the Ad-hoc Data Collection. An Ad-hoc Data Collection allows data to be collected without using any pre-defined Data Collection.
  4. If the Ad-hoc Data Collection option has not been activated, it is necessary to select a pre-existing Data Collection.

    Note

    If the wizard is called from a specific Data Collection, this value will be automatically pre-filled and cannot be changed.

  5. Optionally, select a Data Collection Limit Set, which needs to belong to the selected Data Collection.

    Info

    This transaction can be called from the Data Collection, from a Material or from a Resource. Depending from where it is called, some information is automatically pre-filled and cannot be changed.

Screenshot showing a data collection instance setup screen with fields for farm name and measurement type.

Step 2: Parameters (only for Ad-hoc Data Collections)#

  1. Enter as many parameters as desired, using the and buttons, specifying for each parameter:

    • The Parameter.
    • The minimum number of samples.
    • The maximum number of samples.
    • The minimum of readings per sample.
    • The maximum number of readings per sample.

Screenshot showing the parameters for an Ad-hoc Data Collection, including maximum readings per sample.

Step 3: Data Collection#

  1. Provide the data as required by the Data Collection definition. It is important to understand that:

    • Mandatory readings of mandatory samples of mandatory parameters are pre-filled with the default values, if defined.
    • If there are defined limits (not possible for Ad-hoc Data Collections), they are shown on the top-right corner of the parameter and the color of the cell will change accordingly.
    • At any time, it is possible to select the Preview mode to preview the Data Collection.
    • Depending on the type of user interface you have selected, entering the data can be done in separate text areas corresponding to different fields or they can be entered in grid form. For more information, see User Interfaces: Classic vs Modern.
  2. Optionally, enter a comment.

  3. Select Perform to complete the operation.
Classic Modern
Perform data collection instance step three Perform data collection instance step three modern

Note

The Parameters may have validation ranges that have to be followed in order for the values to be accepted.

Info

A Data Collection may be configured to send data to SPC, in which case one or more SPC Charts will appear.