1. User Manual
  2. Getting started
  3. Upload a file

Upload a file

You can upload both process models in BPMN and event logs in CSV, XES and MXML formats. This can be done through two options – “Upload Local File” and “Upload File from a URL”.

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 a file selection. Here you can select the relevant file and it will appear beside the “Browse”. Click “OK” to upload the file.

Finally, the successful uploaded 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”.

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.

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.

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.

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.

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”.

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”.


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

A dialog box will appear with a message about the total number of events process and if the file has been imported successfully. Click “OK” to complete the import.

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

Note: After a user uploads a CSV file, the schema mapping is stored in system. So next time when we try to upload a CSV file with the same header (both header names and order), the importer will prompt a dialog to let a user choose whether to apply the saved mapping.

Upload a file from URL

This feature allows us to upload a file from Dropbox, Google Drive and Microsoft OneDrive. To upload a file from URL, click on “File -> Upload”.

Switch to the “Upload file from URL” tab.

Note: The supported file formats are bpmn, csv, mxml, mxml.gz, xes, xes.gz and zip.

Upload from Microsoft OneDrive

In Microsoft OneDrive, right-click on the file you want to upload and click on “Embed”.

Once the Embed drawer opens, click on the “Generate” button to generate the URL of the file.

Once the link is generated, copy the link contained in the inverted commas (” “) of the “iframe src” parameter in the embed code snippet.

Paste the link to the “File to upload” input box and click on “Select”.

Once you click on “Select”, the file name will be displayed as highlighted below. Click on “OK” to upload the file.

The log will be successfully uploaded in the Apromore workspace.

Upload from Google Drive

To upload a file from Google Drive, right-click on the file you want to upload and click on “Share”.

Once the share window opens up, click on the “Change” button in the “Get Link” section to change the file-sharing permissions. Make sure the file’s visibility is set to “Anyone with the link”.

Once the sharing permissions are set, click on the “Copy link” button to copy the URL of the file.

Paste the link to “File to upload” input box and click on “Select”.

Once you click on “Select”, the file name will be displayed as highlighted below. Click on “OK” to upload the file.

The log will be successfully uploaded in the Apromore workspace.

Similarly, to upload a file from Dropbox make sure the file’s visibility is set to “Anyone with the link”. Paste the link to the “File to Upload” input box under the “Upload file from URL” tab to successfully upload the file in Apromore.