Return to User manual

Upload a file

You can upload both process models in BPMN and event logs in CSV, XES and MXML formats.

Upload a process model

To begin uploading a .bpmn file, click on “File -> Upload”.

To browse for the .bpmn file, click “Browse” and locate the file.

Note: The plugin supports the following delimiters: Tab, Semicolon, Comma and Spaces. However, the comma delimiter is most supported by the plugin.

A window will open displaying the file details. Here you can change the existing name of the process. Click “OK” to upload the file.

Finally, the successful uploaded .bpmn file will be placed into the location/repository in which the user has initiated the plugin.

Upload an event log

Apromore allows users to import event logs in Comma-Separated Value (CSV) format, standard XES format and in MXML format. Event logs can be uploaded uncompressed or compressed (zip or gz). The supported file extensions are .csv,  .csv.zip, .xes, .xes.zip, .xes.gz.

Files in XES format are imported directly, as they already contain all the metadata required by Apromore.

On the other hand, CSV files need to be pre-processed before being imported into the Apromore workspace.

To begin uploading a CSV file, click on “File -> Upload”.

This image has an empty alt attribute; its file name is 1-10-1024x501.png

To browse for the CSV file, click “Browse” and locate the file.

Note: The plugin supports the following delimiters: Tab, Semicolon, Comma and Spaces. However, the comma delimiter is most supported by the plugin.

This image has an empty alt attribute; its file name is 2-11-1024x503.png

A window will open up displaying the data based on the imported .CSV file.

In this pop up window, the user can tag each column in the CSV file with one of the following column types: case identifier, activity, start timestamp, end timestamp, other timestamp, resource, event attribute, or ignore (in the latter case, the column is dropped).

In order to upload a CSV file, the user must indicate which column corresponds to the case identifier, which column corresponds to the activity, and the end timestamp. These three columns are mandatory. The user may also tag other columns, for example.

This image has an empty alt attribute; its file name is 3-9-1024x504.png

Additionally, the CSV importer supports a wide range of encoding options. A user can change the encoding by simply clicking on the drop down menu located at the bottom of the window.

This image has an empty alt attribute; its file name is 4-9-1024x513.png

The CSV importer is sometimes able to automatically tag the columns corresponding to case identifier, activity, and timestamp. It is important however to check that the columns have been tagged correctly. We can manually alter the column attribute by clicking the drop down box as shown below, and choosing the desired attribute.

This image has an empty alt attribute; its file name is 5-5-1024x512.png

We can opt not to import a column by attaching the “Ignore” tag to it. In order to make it easier to ignore multiple columns, we can click on the “Event attribute -> Ignore” button at the bottom-left corner. From that point on, any column we select becomes tagged with “Ignore”.

This image has an empty alt attribute; its file name is 6-5-1024x510.png

Similarly, if we need to tag multiple columns as “event attribute”, we can click on “Ignore –> Event Attribute” in the bottom-left corner. From that point on, any column we select becomes tagged with “Event Attribute”.


This image has an empty alt attribute; its file name is 7-4-1024x509.png

After the columns have been tagged, click ‘Upload Log’ to finish the import.

This image has an empty alt attribute; its file name is 8-4-1024x509.png

The successfully imported log will be placed in the current folder in the Apromore workspace. Apromore internally stores files in XES format.

This image has an empty alt attribute; its file name is 9-5-1024x504.png