Data Loaders

Download the Data Loader Workbooks

Procedure

  1. Access the Data Loaders page, and then select Download Templates.
    The Download Templates window appears, displaying a list of the data loader categories.
  2. Select the category whose template you want to download.
    Data Loader CategoryWorkbooks in the Category
    APM Connect
    • APM Family
    • Equipment and Functional Location
    • Tag to Asset Relationship
    • Taxonomy
    • Work History
    APM Failure Elimination
    • Production Loss Analysis (PLA) 1-Admin
    • Production Loss Analysis (PLA) 2-Event
    • Production Loss Analysis (PLA) 3-Plan
    • Root Cause Analysis (RCA)
    • System Reliability
    APM Foundation
    • Asset Criticality Analysis (ACA Checklist)
    • Asset Criticality Analysis (ACA)
    • Custom Asset Hierarchy
    • Geographic Information System (GIS)
    • Policy Instance Data Loader
    • Risk Matrix
    • Role
    APM Health
    • Rounds Allowable Values
    • Rounds Readings
    • Rounds Routes
    • Rounds Templates
    APM Mechanical Integrity
    • Inspection Management (IM) Assets
    • Inspection Management (IM) Functional Location
    • RBI Components To TML Groups Relationship
    • Risk Based Inspection (RBI) 580
    • Risk Based Inspection (RBI) 581
    • Risk Based Inspection (RBI) Corrosion Loop
    • Thickness Monitoring (TM) Equipment
    • Thickness Monitoring (TM) Functional Location
    • Thickness Monitoring (TM) Piping Equipment
    • Thickness Monitoring (TM) Piping Functional Location
    APM Power Generation
    • Generation Availability Analysis (GAA) Events
    • Generation Availability Analysis (GAA) GADS Amplification Codes
    • Generation Availability Analysis (GAA) GADS Cause Code
    APM Safety
    • Calibration
    • Hazards
    APM Strategy
    • Asset Strategy Management (ASM)
    • Asset Strategy Management (ASM) Templates
    • Failure Modes and Effects Analysis (FMEA)
    • FMEA Analysis Template
    • FMEA Asset Template
    • RCM Analysis Template
    • Reliability Centered Maintenance (RCM)
    APM Wind Generation
    • GAA Wind Asset Hierarchy
    • GAA Wind Events
    • GAA Wind Sub Group Capacity
  3. In the Templates column, in the row for the data loader whose template you want to download, select .

    The template is downloaded, and can be populated with data to load into APM.

Import Data Loader Workbooks

About This Task

You can import custom Data Loader workbooks or localized workbooks into APM, so that they can be accessed on the Data Loaders page.

Procedure

  1. Access the Export page.
  2. In the Available Items section, in the Select metadata type drop-down, select DataLoader Templates.
    The Available Items section is populated with the Data Loader catalog entries.
  3. Select the box of Data Loader whose workbook you want to modify, and then select .
    The Data Loader appears in the Selected Items section.
  4. In the File Name box, enter a name for the file that will be exported, and then select the File Type XML(.xml).
  5. Select Start Export.

    The Data Loader files are exported, and a zip file is downloaded containing three files:

    <Data Loader Name> Files:
    A folder containing the excel source workbook for that data loader.
    <DataLoaderName>.xml:
    An xml containing the metadata for the data loader catalog item.
    ExportLog:
    A log file detailing the export from APM.
  6. Open the <DataLoder Name> Files folder, and place a copy of the workbook to be imported into the folder.
  7. If you want to replace the default workbook with the workbook to be imported, rename the workbook to be imported to match the exact naming structure of the default template, and then delete the default template.
    Important: The name of the file to be imported must match the original file name exactly. Otherwise, the workbook will be not be available to download in APM
  8. If you want to add an additional workbook, and keep the default workbook:
    1. Ensure the workbook to be imported has a unique name, different from the naming structure of the default workbook, and then delete the default workbook.
    2. Open the <DataLoaderName>.xml file.
    3. In the DATALOADERTEMPLATE_ID, DATALOADERTEMPLATE_DESC, and the DATALOADERTEMPLATE_FILE_NM parameters, replace the existing value with the name of the new workbook to be imported.
    4. Save the file.
  9. Create a zip file with the <Data Loader Name> Files folder containing the new workbook to be imported, the <DataLoaderName>.xml file, and the ExportLog file.
  10. Access the Import page.
  11. In the Import File box, select Choose File, and then navigate to the zip file you created in the previous step.
  12. Select the box of Data Loader whose workbook you want to import, and then select .
  13. Select Start Import.

    The new workbook is imported into APM.

Results

The workbook that you imported can be download on the Data Loaders page.

Import an Additional Equipment and Functional Location Workbook

  1. Access the Export page,
  2. In the Available Items section, in the Select metadata type drop-down, select DataLoaders Template.

    The Available Items section is populated with the Data Loader catalog entries.

  3. Select the Equipment and Functional Location box, and then select .
    The Equipment and Functional Location Data Loader appears in the Selected Items section.

  4. In the File Name box, enter Equipment and Functional Location Export, and then select the File Type XML(.xml).
  5. Select Start Export.

    The Data Loader workbook files are exported, and a zip file is downloaded containing three files:

    • Equipment and Functional Location Export Files: A folder containing the default Equipment and Functional Location Data Loader workbook.
    • Equipment and Functional Location Export.xml: An .xml containing the metadata for the catalog item.
    • ExportLog: A log file detailing the export from APM.
  6. Open the Equipment and Functional Location Export Files folder, and place a copy of the workbook to be imported into the folder. In this example the workbook name is Equipment and Functional Location_DE.
  7. Ensure the template to be imported has a unique name different from the naming structure of the default template, and then delete the default template.
  8. Open the Equipment and Functional Location Export.xml file.
  9. In the DATALOADERTEMPLATE_ID and DATALOADERTEMPLATE_DESC parameters, replace Equipment and Functional Location with Equipment and Functional Location_DE.
  10. In the parameter DATALOADERTEMPLATE_FILE_NM, replace the value with Equipment and Functional Location_DE.xml.
  11. Save the file.
  12. Create a zip file with the Equipment and Functional Location Export files.
  13. Access the Import page.
  14. In the Import File box, select Choose File, and then navigate to the zip file Equipment and Functional Location Export.

    In the Available Items section The Equipment and Functional Location entry appears.

  15. Select the The Equipment and Functional Locationbox, and then select .
  16. Select Start Import Button.

    The new template is imported into APM, and is available to download on the Data Loaders page.

Test Data Loader Connection

Procedure

  1. Access the Data Loaders page.
  2. If, on the upper-left corner of the page, the <number> Error link appears beside the , then select the link.
    Note: If the number of errors link does not appear, then the connections needed to use the data loaders are configured properly.
    The Connection Errors dialog box appears displaying the connections status for each connection point needed to use the data loaders.
  3. Select OK.
    The connection status is tested.

Results

The following table describes the connection status for data import jobs.

Connection TestDescriptionIf you get an Error...
APM Connect Web API Test Test the connection between the APM web API and the APM Connect server. Ensure the ports are open between the APM Server and the APM Connect server.
APM Connect Configuration TestTest the configuration of the APM Connect connection parameters configured in APM.

Ensure the parameters configured in APM are correct to establish connection from APM and APM Connect.

APM Fileshare Access TestTests the file share system is connected to the APM Server, so that the server can read and write to the configured file shares.

Ensure the parameters configured in APM are correct to establish connection from APM, and the user has the necessary permissions to access the file share.

APM Staging Database TestTests the APM Server is connected tot the APM Connect IR database. Ensure that PostgresSQL is accepting the connection from APM . These connections are managed in the file pg_hba.conf.
APM Connect Fileshare Access TestTests the file share system is connected to the APM Connect server, so that the server can read and write to the configured file shares.

Ensure the parameters configured in APM are correct to establish connection from APM, and the user has the necessary permissions to access the file share.

APM Connect Staging Database TestTests the connection between the APM Connect server and the IR database to ensure that files can read and written to the IR. Ensure the RunDataLoaderRoute.cfg is configured correctly.

Run a Data Import Job

Before You Begin

This topic assumes that you have migrated your data to the required format for the modules into which you want to import data. The format should match either:

Procedure

  1. Access the Data Loaders page.
  2. Select Import New.
    The Import Data window appears.
  3. In navigation tree, select the data loader category, and then select the data loader that you want to use to import data according the following table.
    Data Loader CategoryWorkbooks in the Category
    APM Connect
    • APM Family
    • Equipment and Functional Location
    • Tag to Asset Relationship
    • Taxonomy
    • Work History
    APM Failure Elimination
    • Production Loss Analysis (PLA) 1-Admin
    • Production Loss Analysis (PLA) 2-Event
    • Production Loss Analysis (PLA) 3-Plan
    • Root Cause Analysis (RCA)
    • System Reliability
    APM Foundation
    • Asset Criticality Analysis (ACA Checklist)
    • Asset Criticality Analysis (ACA)
    • Custom Asset Hierarchy
    • Geographic Information System (GIS)
    • Policy Instance Data Loader
    • Risk Matrix
    • Role
    APM Health
    • Rounds Allowable Values
    • Rounds Readings
    • Rounds Routes
    • Rounds Templates
    APM Mechanical Integrity
    • Inspection Management (IM) Assets
    • Inspection Management (IM) Functional Location
    • RBI Components To TML Groups Relationship
    • Risk Based Inspection (RBI) 580
    • Risk Based Inspection (RBI) 581
    • Risk Based Inspection (RBI) Corrosion Loop
    • Thickness Monitoring (TM) Equipment
    • Thickness Monitoring (TM) Functional Location
    • Thickness Monitoring (TM) Piping Equipment
    • Thickness Monitoring (TM) Piping Functional Location
    APM Power Generation
    • Generation Availability Analysis (GAA) Events
    • Generation Availability Analysis (GAA) GADS Amplification Codes
    • Generation Availability Analysis (GAA) GADS Cause Code
    APM Safety
    • Calibration
    • Hazards
    APM Strategy
    • Asset Strategy Management (ASM)
    • Asset Strategy Management (ASM) Templates
    • Failure Modes and Effects Analysis (FMEA)
    • FMEA Analysis Template
    • FMEA Asset Template
    • RCM Analysis Template
    • Reliability Centered Maintenance (RCM)
    APM Wind Generation
    • GAA Wind Asset Hierarchy
    • GAA Wind Events
    • GAA Wind Sub Group Capacity
  4. In the Select a File for importing box, select Choose File, and then navigate to and select the file that you want to import.
  5. In the Job Description box, enter a short description of the job.
  6. Select Import.
    The job is run, and the status of the job appears in the Status and Log column.
    Tip: If necessary, you can cancel an import job by selecting the button that appears in the Status and Log column. If you cancel a job, any changes that have already occurred are not removed, therefore, you may need to manually modify records to update or remove unwanted data.
    StatusDescription
    WaitingInitial state when job is created. The data import job is queued for pre-processing on the APM Connect Server.
    Staging In ProgressThe data import job is being prepared on the APM Connect Server.
    Staging FailureThe data import job failed during preparation.
    Staging CompleteThe data import job was prepared successfully.
    Dataloader Enqueued The maximum number of data load jobs has been exceeded, as determined in the APM Connect Connection Records, or there is a job of the same type running. The data import will begin once the other jobs are complete.
    Configuring DataloaderThe data import job is configuring the proper user roles and arranging data processing for most efficient execution flow.
    In ProgressThe data import job is loading data into the APM Data Source.
    Data Synchronization in ProgressThe data import job is synchronizing the loaded data and relationships across the APM Data Source.
    Job CancellingThe data import job is in the process of being cancelled. This occurs after you select .
    Cancelled by UserThe data import job was cancelled successfully.
    Note: When a job is cancelled, the data imported prior to cancelling is not removed.
    ErrorsThe data import is complete, but encountered one or more errors. You can download the log file to view detailed error messages.
    CompleteData has been imported into APM.
    Note: If the icon appears, the data was imported with warnings. You can download the log file to view detailed warning messages.

Access the Details of an Import Job

Before You Begin

This topic assumes that you have successfully run a data import job.

Procedure

  1. Access the Data Loaders page.
  2. In the Job ID column, select the job that you want to open.
    On a new page, the datasheet for the selected job appears.

  3. To view the information contained in the Log Text, select .
    The Text Editor window appears, displaying details about the job, such as error messages, warnings concerning the data load and general information regarding the data records that were loaded.

About Populating Site Reference Data

The APM Family Data Loader can be used to populate the Site Reference on Equipment and Functional Location records in APM.

About This Task

The APM Family Data Loader populates the ENTY_KEY system field and the MI_SITE_KEY system field associated with the Site Reference value to be populated. On asset records, the Site Reference is stored in the MI_SITE_KEY field, a system field in APM. The APM Data Loader uses the Site Name (MI_SITE_NAME) to translate the value to the corresponding Site Key and populate the MI_SITE_KEY field; therefore, you do not need to know the key to be able to populate the site reference. This functionality is important because this value can change from one database to another.

Procedure

  1. On the data worksheet, add a column that contains MI_SITE_NAME in the column name.
    For example if you are working with a relationship, where a distinction needs to be made regarding which family is associated with each column, then the column name will be prefaced with the Family ID. As shown in the following image, the column name might take the form MI_EQUIP000|MI_SITE_NAME, where MI_EQUIP000 is the Family ID.
  2. Enter the site name to designate the site by which the asset record, once loaded into APM, will be filtered.
  3. Continue populating the source workbook, and then run the data loader.

Considerations for Loading with .CSV Files

Typically when you load data into APM you will use the provided Data Loader workbooks, however, if you have a program that creates reports that generates .csv files, APM can load that data as long as you follow these guidelines.

The Data Import job can accept a .zip file that contains .csv files as input. The format of the .zip file is specific to each Data Loader and must contain .csv files that conform match these specific rules.

  • There must be a .csv file for each worksheet defined in the workbook template for the Data Loader.
  • The filename must match the worksheet name with the file extension .csv. For example, the .csv for the Equipment worksheet must be named Equipment.csv.
  • The .zip must contain all the .csv files that match the worksheets expected by the data loader.

A .zip that meets all of these requirements can be used as input to the Data Import job.

About the Rounds Pro Data Loaders

You can use the Rounds Pro Data Loaders to import content into the Rounds Pro module in bulk.

The Rounds Pro Data Loaders are used to create records in the following families and relevant relationships between them:

  • Rounds Pro Picklist Values Data Loader
  • Rounds Pro Step Template Data Loader
  • Rounds Pro Route Masters Data Loader
    • Create Route
    • Create Step
    • Human Resource
    • Teams

About the Rounds Data Loaders Requirements

This documentation assumes that your organization has completed the deployment of the Rounds Pro module. The Rounds Pro Data Loaders should be used only after the Rounds Pro module has been implemented.

As part of the security settings, the Security User performing the data load operation must be associated with either the MI Data Loader User or MI Data Loader Admin Security Role, and must also be associated with the MI Operator Rounds Administrator Security Group or a Security Role that is associated with this Security Group.

The following requirements must be met for the data load operation to be performed:
  • All imported date values are in UTC.
  • Functional Locations and/or Equipment have already been loaded into APM.
  • Blank values are not copied to the entities. If there are blank values, those fields will be skipped.
  • No customization (that is, rules changes) is done on the related families that override the baseline families.

About the Rounds Pro Data Loaders General Loading Strategy

This section describes any prerequisites to loading the data and the order in which the data will be loaded.

Data Import

When importing data using the Rounds Pro Data Loaders:

  • The batch records is limited .xls spreadsheet file.
  • You must use the data loader workbook while considering the rules described in Workbook Layout and Use.
  • When importing huge number of records using the Rounds Pro Data Loader, you can split the records in the spreadsheet into batches and assign a batch ID for each batch. Records within a spreadsheet of a batch should be coded with the same Batch ID. Each list of batch records should be loaded using an individual spreadsheet. Using the batch ID, you can import the records to the Data Loaders.
  • Below are the recommendations of the number of records per batch that can be loaded into Data Loaders using the Batch IDs:
    • Picklists: 1000 records per batch (Same for both Reading and Action types)
    • Step Templates: 1000 records per batch
    • Steps: 1000 records per batch
    • Conditions: 1000 records per batch
    • Routes: 10 Routes (Not more than 1500 steps per route, no more than 5 user or team assignments per route)
    Note: Small batches are less efficient compared to larger batches. There is overhead with each batch that can be reduced by reducing the number of batches.

Schedule and Date Fields

  • The Rounds Pro Data Loaders require that Schedule values are expressed using the JSON format used in the APM database. Valid schedule expressions may be easily generated via the schedule setting feature on a schedule field in a Route or Checkpoint Task record in Record Manager, and then copying the resulting text value to the worksheet.
  • The Route Data Loaders use a non-standard date format. Data should be formatted as yyyy-mm-dd hh-mm-ss (for example, 2015-05-23 17-45-34).

  • All date values are assumed to be in UTC. The time zone of the user loading the data is not relevant.

About the Rounds Pro Data Loader Workbooks Layout and Use

Overview of Rounds Data Loader Workbooks

This section provides a high-level overview and explanation of how the data loader workbooks are constructed.

To import data using the Rounds Data Loaders, GE Vernova provides separate data loader workbooks for:

  • Rounds Pro Picklist Values
  • Rounds Pro Steps
  • Rounds Pro Step Template
  • Rounds Pro Step Conditionals
  • Rounds Pro Route Masters

The workbooks support the baseline Rounds Pro functionality in APM. The workbooks must be used to perform the data load.

Each data loader workbook contains one worksheet for each node that will be populated in the data model.

Each worksheet in these data loader workbooks contain field values that must be mapped to the appropriate APM family or field combination. The individual sections in this document specify the source and target fields and relationships required between predecessors and successor.

The list of fields tabulated is not exhaustive.

Data Loader Batch Fields

The Rounds Pro Data Loaders workbooks include columns of data that are used to identify batches of related records. These values are not imported to a field in the APM database. Generally, these will be the first few columns in each worksheet. They each use a prefix that identifies the relevant record type being imported, whereas columns that will be imported have IDs that match the field IDs in APM, which generally use the prefix MI_.

Rounds Pro Picklist Values Data Loader Workbook

When importing data using the Rounds Pro Picklist Values Data Loader, the data loader will create one Picklist Value record for each row of the worksheet. If the import worksheet specifies a Picklist Value that is an exact match for an existing record, the record is not imported. Since the unique identification of a Picklist Value record includes all its fields, it is not possible to update existing Picklist Value records using the data loader.

Note: Picklist Values records do not support Site Filtering.

On the worksheet, you will specify the picklist values that will be used in Step Templates and Steps.

Field Caption

Field ID

Data Type (Length)

Comments

Picklist Batch ID

RTE_PICK_PCKLST_IDCharacter (50)This field is required for identification during the data load process and must be unique. The value in this field is not imported to APM.
Picklist IDMI_RTE_PICK_PCKLST_ID_CCharacter (50)This field is required and must be unique.

Value

SYCD_ID

Character (50)

This field is required.

Description

SYCD_DESC_TXCharacter (255)Provide a brief description.

Sequence

SYCD_SEQ_NBRNumericThis field is required and must be unique within Picklist Values.

Rounds Pro Step Template Data Loader Workbook

When importing data using the Rounds Pro Step Template Data Loader, the data loader will create one Step Template record for each row in the data loader workbook. If the import worksheet specifies a Template ID value that matches the Template ID of an existing Step Template record, the existing record will be updated. If the worksheet specifies values for Category or Picklist Value that do not already exist in the database for the specified type (numeric or character) of Step Reading the record will not be imported.

The Step Templates will be loaded into APM and will be filtered based on the designated site name in the Site Reference Name field.

Step Template Worksheet

Field Caption

Field ID

Data Type (Length)

Comments

Template Batch ID

RTE_PICK_PCKLST_IDCharacter (50)This field is required for identification during the data load process. It should match the ID of the Template Batch to which the Step Template will be linked. Use <Dummy ID> if you want to import standalone records not linked to a Template Batch. The value in this field is not imported to APM.
Template IDMI_RTE_PICK_PCKLST_ID_CCharacter (50)This field is required and must be unique. The value in this field is not imported to APM.

Step Type

MI_STP_TMP_STEP_TYPE_C

Character (50)

This field is required.

Reading Type

MI_ML_STP_TMP_READING_TYPE_CCharacter (50)This field is required. The valid values are:
  • Character
  • Numeric

Reading Picklist

MI_ML_STP_TMP_RDNG_PCKLST_CNumericThis field is required if selected as the Reading Type.
Reading Picklist ValueMI_ML_STP_TMP_RDNG_VALS_CCharacter (50)This field is required if Reading Picklist is selected.
Action PicklistMI_ML_STP_TMP_ACTN_PCKLST_CCharacter (50)This field is required if it is selected.
Action Picklist valueMI_ML_STP_TMP_ACTN_VALS_CCharacter (50)This field is required if Action Picklist is selected.
Site Reference NameMI_SITE_NAMECharacter (50)This field is required and must match an existing Site name.
Note: If you want to set the site reference to be a Global Site Reference, enter the constant ‘*Global*’ in the MI_SITE_NAME column on the spreadsheet.
DescriptionMI_STP_TMP_DESC_CCharacter (255)Please provide a brief description.
LockedMI_STP_TMP_IS_LOCK_LBooleanThe default value for this field is False.
StatusMI_STP_TMP_STAT_CCharacter (50)The default value for this field is Active.
Is Shutdown RequiredMI_STP_TMP_REQ_EQUIP_SHUT_LLogicalThe default value for this field is False.
Unit of MeasureMI_STP_TMP_UOM_CCharacter (50)The field must be a valid value in the global Unit of Measure list. This field is disabled if the Reading Type field is Character.
FrequencyMI_STP_TMP_FREQ_C<need information>
Lower Level 1 ValueMI_ML_STP_TMP_LO_LVL1_ALRT_VALCharacter (50)Must use one of the Picklist Values specified for the Step Reading. This field is disabled if the Reading Type field is Numeric.
Lower Level 1 MessageMI_ML_STP_TMP_LO_LVL1_MSG_CCharacter (50)None
Lower Level 2 ValueMI_ML_STP_TMP_LO_LVL2_ALRT_VALCharacter (50)Must use one of the Picklist Values specified for the Step Reading. This field is disabled if the Reading Type field is Numeric.
Lower Level 2 MessageMI_ML_STP_TMP_LO_LVL2_MSG_CCharacter (50)None
Lower Level 3 ValueMI_ML_STP_TMP_LO_LVL3_ALRT_VALCharacter (50)Must use one of the Picklist Values specified for the Step Reading. This field is disabled if the Reading Type field is Numeric.
Lower Level 3 MessageMI_ML_STP_TMP_LO_LVL3_MSG_CCharacter (50)None
Upper Level 1 ValueMI_ML_STP_TMP_UP_LVL1_ALRT_VALCharacter (50)Must use one of the Picklist Values specified for the Step Reading. This field is disabled if the Reading Type field is Numeric.
Upper Level 1 MessageMI_ML_STP_TMP_UP_LVL1_MSG_CCharacter (50)None
Upper Level 2 ValueMI_ML_STP_TMP_UP_LVL2_ALRT_VALCharacter (50)Must use one of the Picklist Values specified for the Step Reading. This field is disabled if the Reading Type field is Numeric.
Upper Level 2 MessageMI_ML_STP_TMP_UP_LVL2_MSG_CCharacter (50)None
Upper Level 3 ValueMI_ML_STP_TMP_UP_LVL3_ALRT_VALCharacter (50)Must use one of the Picklist Values specified for the Step Reading. This field is disabled if the Reading Type field is Numeric.
Upper Level 3 MessageMI_ML_STP_TMP_UP_LVL3_MSG_CCharacter (50)None

Rounds Pro Step Conditionals Data Loader Workbook

When importing data using the Rounds Pro Step Conditionals Data Loader, the data loader will create one Step Conditional record for each row in the data loader workbook. If the import worksheet specifies a Template ID value that matches the Template ID of an existing Step Conditional record, the existing record will be updated.

Step Conditionals Worksheet (MI_STP)

Field Caption

Field ID

Data Type (Length)

Comments

Conditional Step Batch IDROUNDS_STP_COND_BATCH_IDCharacter (50)This field is required for identification during the data load process and must be unique. The value in this field is not imported to APM.
Step IDMI_STP_ID_CCharacter (50)A unique ID to identify a step.
Related Asset IDROUNDS_STP_REL_ASSET_IDCharacter (50)If this value matches an existing Asset ID, the Conditional Step will be linked to this asset.
Related Asset Family IDROUNDS_STP_REL_ASSET_FAMILYIDCharacter (50)If this value matches an existing Asset Family ID, the Conditional Step will be linked to this asset.
Step NameMI_STP_COND_STP_NAMECharacter (50)The name of the Primary step. This field is required and must match an existing Step name.
OperatorMI_STP_COND_OPERATORCharacter (50)This field specifies the operators that determine if the reading value entered for the primary Step meet the condition specified.
Conditions Field ValueMI_STP_COND_FLD_VALCharacter (50)None
Conditional Step NameMI_STP_COND_STP_NAME_CONDCharacter (50)The name of the Conditional step.
Conditional Step IndexMI_STP_COND_STP_INDEXNumeric (50)None
Immediate Parent StepMI_STP_COND_STP_PARENTCharacter (50)This field contains the name of the current step in the route to which you want to add conditional steps.

Rounds Pro Routes Data Loader Workbook

When importing data using the Rounds Pro Routes Data Loader, you can
  • Create Route Master
  • Assign or unassign a Security User to the route
When importing data using the Rounds Pro Routes Data Loader, this data loader will create records as follows:
  • Route Master: The Route Master data loader does the following:
    • Creates a Route Master record or a route template.
    • Associates or links existing steps created in the step dataloader or in the step designer.
    • Assigns the route to a user.
    • Assigns the route to a team.
    • Validates that the users, teams, and steps exist already when trying to link these items together.
    Note: Update a Route Master or delete a Route Master functionality is not available.

    The Route Master is created, associated to all the steps included and is assigned to all individuals and/or teams included.

    The Route Master will be loaded into APM and will be filtered based on the designated site name in the Site Reference Name field.

    Note: If you want to set the site reference, to be a Global Site Reference, enter the constant ‘*Global*’ in the MI_SITE_NAME column on the spreadsheet.
  • Steps: The data loader generates one step record for the existing steps in each row in the Step worksheet. Using this Step data loader, the steps are associated to the required route. The data loader creates one step record for each row in the Step worksheet. Step must exist before including it in the Step data loader.

    The Next Date, Non-compliance Date, and the Non-compliance Next Check Date fields on the Step record will be populated automatically by existing rules based on the value in the Schedule column. If the Schedule is invalid, the record will not be created.

  • Human Resource:

    A relationship is created between the Route and the Human Resource record. Therefore, the Human Resource records must already exist before the data loader is used.

  • Teams:

    A relationship is created between the Route and the teams records. Therefore, the Teams records must already exist before the data loader is used.

Route Master Worksheet (MI_RTE_MST)

Field Caption

Field ID

Data Type (Length)

Comments

Route Batch IDRTE_MST_BATCH_IDCharacter (50)This field is required for identification during the data load process and must be unique. The value in this field is not imported to APM.
Route IDMI_RTE_MST_ID_CCharacter (50)This field is required and must be unique.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records and assign the security users to Routes.
Note: This field is not required and may not be populated on this worksheet when you only assign or un-assign the security users to Routes.
Route DescriptionMI_RTE_MST_DESC_CCharacter (255)A description of the route.
ScheduleMI_RTE_MST_SCHED_CCharacter (50)This option generates the route instances from an associated route.
EAM Job KeyMI_RTE_MST_EAM_JOB_KEY_CCharacter (50)This field is used to link a Route Master to a given EAM Job identifier.
StatusMI_RTE_MST_STATUS_FCharacter (50)This field indicates if the route has been added to the My Routes list.
Is Schedule ActiveMI_RTE_MST_SCHEDULE_ISACTIVELogical

This field indicates if the Route Schedule is active.

A schedule can be created for a route in the Plan Routes section, after you select the schedule option.

Next Due DateMI_RTE_MST_NEXT_DUE_DTNumeric (50)The date when the next instance of the route will be generated if the route master corresponding to the instance has an active schedule.
FrequencyMI_RTE_MST_FREQ_NNumeric (50)This field displays a number for the duration at which a route schedule recurs.
Frequency IntervalMI_RTE_MST_FREQ_INTVAL_CCharacter (50)The time unit to measure the duration at which the route schedule recurs.
Floc Equipment Reference NumberMI_RTE_MST_FLOC_EQUI_REF_NUM_CCharacter (50)This field contains a unique alphanumeric number.
Floc Equipment StatusMI_RTE_MST_FLOC_EQUI_STS_CCharacter (50)This field displays the equipment status, Out of Service, Online, or Available.
Route Master Compliance Tracking FlagMI_RTE_MST_CMPLNC_ISACTIVEButtonEnable the button to activate compliance tracking for a schedule on a route.
Route Master Compliance Horizontal IntervalMI_RTE_MST_CMPLNC_HRZN_INTRVLCharacter (50)This field contains the time units to measure the frequency based on which the route instance must be completed.
Route Master Compliance Horizon UnitMI_RTE_MST_CMPLNC_HRZN_UNITNumeric(50)A number to specify the frequency in time units, such as days, weeks, and so on, based on which the route instance must be completed.
Basis For OccurrenceMI_RTE_MST_BASIS_FOR_OCCUR_CCharacter (50)You can select EAM or Schedule.

Steps Worksheet (MI_STP)

Field Caption

Field ID

Data Type (Length)

Comments

Route Batch IDRTE_MST_BATCH_IDCharacter (50)This field is required for identification during the data load process and must be unique. The value in this field is not imported to APM.
Route IDMI_RTE_MST_ID_CCharacter (50)This field is required and must be unique.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records and assign the security users to Routes.
Note: This field is not required and may not be populated on this worksheet when you only assign or un-assign the security users to Routes.
Related Asset IDMI_STP_REL_ASSET_ID_CCharacter (50)If this value matches an existing Equipment ID (for Equipment) or Functional Location (for Functional Locations) the Checkpoint will be linked to this asset.
Step IDMI_STP_ID_CCharacter (50)A unique ID to identify a step.
Step TypeMI_STP_STEP_TYPE_CCharacter (50)The type of the step, whether a strategy step, template step, or a normal step. This is a required field.
Step Sequence NumberMI_STP_SEQ_NUMCharacter (50)A unique number to identify the step sequence.

Human Resource Worksheet (MI Human Resource)

Field Caption

Field ID

Data Type (Length)

Comments

Route Batch IDRTE_MST_BATCH_IDCharacter (50)This field is required for identification during the data load process and must be unique. The value in this field is not imported to APM.
Route IDMI_RTE_MST_ID_CCharacter (50)This field is required and must be unique.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records and assign the security users to Routes.
Note: This field is not required and may not be populated on this worksheet when you only assign or un-assign the security users to Routes.
First NameMI_HR_FIRST_NAME_CHRCharacter (50)The first name of the human resource personnel.
Last NameMI_HR_LAST_NAME_CHRCharacter (50)The last name of the human resource personnel.

Teams Worksheet (MI_TEAMS)

Field Caption

Field ID

Data Type (Length)

Comments

Route Batch IDRTE_MST_BATCH_IDCharacter (50)This field is required for identification during the data load process and must be unique. The value in this field is not imported to APM.
Route IDMI_RTE_MST_ID_CCharacter (50)This field is required and must be unique.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records.
  • When you use the data loader to create Route, Measurement Locations and Checkpoint Task records and assign the security users to Routes.
Note: This field is not required and may not be populated on this worksheet when you only assign or un-assign the security users to Routes.
Team NameMI_TEAMS_TEAM_NAME_CHRCharacter (50)A unique ID to identify a team.

About the Rounds Pro Data Loaders Load Verification

After each worksheet is loaded:
  • Review the data loader log to identify any errors or warnings
  • Update the data loader workbook to correct any errors, and then re-import
  • Repeat until the import of each record is error free
Note: It is recommended that a query is executed in APM on the relevant family to ensure that records have been created and populated as expected. Imported records should also be spot checked in the Rounds Pro Manager and the Rounds Designer to verify that the expected relationships have been created.

To perform the load verification of the loaded data loaders, log in to the Rounds Pro as a Rounds Pro Administrator user.

On the left navigation menu, select Health, and then select Rounds Pro Manager. The Rounds Pro Manager page appears. From the Rounds Pro Manager page, access the Rounds Designer and the Route details page to verify the data loaded using the data loaders.

Note: The data loaders will load new data records only. Any changes to the records that are loaded can be made through the Rounds Pro Manager only.

Data Loader Load Verification for Rounds Designer

Access the Picklist Management page and verify that the loaded data using Data loader appears as expected with all the records imported and that the values can be edited, or new values added to both the Action and Reading Picklist type. Also verify that you can create new character (and numeric, if applicable) Picklists.

Access the Step Template page and verify that the loaded Step Templates list appear as expected and the Step template records displays all the details and can be edited as required.

Verify that the Health Indicator are created for the given levels as expected.

Access a Step and verify that the loaded Steps list appear as expected in the asset hierarchy.

Select a Step to view the step details and verify that the Step records displays all the imported values and can be edited as required.

Access a Step that was imported and verify that the Health Indicators record is linked to the Step as expected.

Access a Step Condition and verify that all the data is loaded from the data loader for that conditional step.

Data Loader Load Verification for Route Masters

Access the Route Masters page.

Verify that the loaded Route Masters page appears as expected with all the data for the Routes, associated steps and is assigned to all individuals and/or teams included in the Data Loader.

In the Route Masters page, select a rout from the ROUTE NAME column, verify the following list for the selected route:
  • The existing assigned assets and steps appear as expected.
  • The existing steps created in the step data loader or in the step designer can be assigned to the route.
  • The assigned Assets and Steps can be reordered.
  • The asset details appearing as imported.
  • The Route name and route description appear as imported.
  • The route schedules have been populated.
  • The route has been to a user or team.
  • The Basic for Occurrence (EAM and Schedule) details are loaded as expected with all the required data.
  • The Route Preview details are appearing as expected with the loaded data.
  • It can be assigned to a new User or Team or remove the assigned team or user.

Verify that the updated changes in the routes are appearing as expected in the Route Masters page.