The Excel Templates

The Excel Templates

When creating and adjusting your Payees, Contracts or Catalogue on Curve; you can do so using the active interface. However, for large sets of metadata, you’ll find it more efficient to create and adjust data in bulk using our Excel Templates. Altogether, there are over 20 Templates that can be used, each specifically designed to import specific datasets onto Curve.

Creating new data via the Excel Templates

1. DOWNLOAD YOUR TEMPLATES

A fresh set of Excel Templates can be downloaded at all times using the Download Templates button hidden underneath every Import button on Curve. As we further develop the Curve platform, it may be that we are required to make changes to the Templates in order for them to represent the changes we make to Curve. So please make sure you are using the latest version of our Templates when importing your metadata. When using an outdated Template, Curve will reject your import and notify you your Template is out of date.

2. ADD DATA TO YOUR TEMPLATES

Via the Excel Templates, you can add exactly the same types of data as you could when creating data via the Curve interface. You will recognise the columns in your Excel resemble the available fields in the interface. For more information on what each field represents, whether it’s mandatory, why and how you should complete it; please visit the respective article of what you are working on in our Documentation. If you are struggling to configure your data via Excel, an excellent tip is to create one Payee, Contract, Work, … as an example via the Curve interface first; and then export your setup in the Excel template, using the Export button on each respective page. Also our Getting Started Guide templates may prove helpful as an example of how these templates should be completed.

3. IMPORT YOUR TEMPLATE ON ITS RESPECTIVE PAGE

A Payee template needs to be imported via the Import button on the Payee page, a Track template needs to be imported via the Import button on the Track page.

4. ENABLE/DISABLE OVERWRITE BLANK VALUES

This option is only relevant when you are using the Templates to adjust existing metadata onto Curve. It does not affect your import when creating new Payees, Contracts or Catalogue. For more information on how this feature behaves, please read the alinea on adjusting existing data via Excel Templates below.

5. A NOTIFICATION / EMAIL WILL INFORM YOU YOUR IMPORT HAS FAILED OR SUCCEEDED

When Curve confirms the import has succeeded, the job is done. However, Curve could refuse your Template for a variety of reasons. Perhaps some mandatory data is missing or does not match some of the requirements. The email or notification will display why your import has errored, giving you a chance to make changes to your Template and try again. When the import has errored, the entire file will be rejected, even if it’s just one line of data that did not meet the requirements.

It appears the template does not match – A popular error message states your template does not match. Curve is very particular in recognising the Templates you import, making sure you do not accidentally import any erroneous data. Rearranging or removing columns,  adding data outside of the expected range, changing the format of the excel file, using an outdated Excel template; are all actions that will cause Curve to reject your Template. In this case, make sure you are importing your Template on the correct page, that you are using the latest version of our Template by downloading a fresh set of Templates, and that you copy-paste the data into a fresh Template. Using a fresh template generally always resolve this issue.

Adjusting existing data via the Excel Templates

Similar to how you can import new data onto Curve using the Excel templates, you can also adjust existing data on Curve by exporting it in an Excel Template, adjusting the data in your Excel file, saving that file, and then reimporting it back to Curve.  Curve will reference the changes made in the Excel Template based on the Curve IDs or unique identifiers such as ISRCs or Cat Numbers, and make sure these changes are reflected in your data on Curve.

Payees, Contracts and Catalogue can all be exported from the Export button on their respective page. The format in which your data is exported will automatically match the format in which it can be imported.

It is possible that Curve will export large datasets in a CSV rather than an XLS structure. This because XLS files do not scale well and are difficult to create for large datasets. In these cases, the data needs to be copied from your CSV export into a fresh Template in XLS format in order for Curve to allow your data to be reimported.

CURVE WILL ONLY ADJUST THE DATA OF ASSETS MENTIONED ON THE FIRST TAB OF YOUR TEMPLATE

For example, if you wish to adjust the data of 10 Tracks in your catalogue, and mention just those 10 Tracks on the first tab of your Track import, then your import will only affect those 10 Tracks. Any other Tracks you have in your catalogue will remain unaffected by your import.

OVERWRITE BLANKS DO IMPACT YOUR IMPORT WHEN ADJUSTING EXISTING DATA

Whereas this feature did not affect your data when creating new Payees, Contracts or Catalogue; it does have a significant impact when you are using the Excel templates to adjust existing assets. When this option is enabled, a blank value in the Excel Template will overwrite any existing data on Curve. When this option is disabled, a blank value in the Template will not overwrite or delete any existing data on Curve, though it may recreate tabulated data from scratch.

When updating data with Overwrite Blank values enabled, your Template will need to be an exact representation of how you want those assets to be on Curve.

  • When a field in the Excel Template for a given Payee/Contract/Catalogue is blank, then this data will also be cleared from Curve upon import.
  • When no data lists are provided, Curve will clear any data lists from your asset. By this, we mean Terms attached to a Contract, Contracts attached to a Track/Release/Work, Aliases attached to a Track, Tracks attached to a Release, … practically anything on Curve where more than one piece of data can be provided.

When updating data with Overwrite Blank Values disabled, you are only required to include the data that you wish to update.

  • When a field in the Excel Template for a given Payee/Contract/Catalogue is blank, it will not clear any existing data in this field on Curve.
  • When no data lists are provided, Curve will leave data lists as they are. By data lists, we mean Terms attached to a Contract, Contracts attached to a Track/Release/Work, Aliases attached to a Track, Tracks attached to a Release, … practically anything on Curve where more than one piece of data can be provided. So a blank Terms tab in your Contract template will not clear any terms from your Contracts, a blank Contracts tab in your Catalogue template will not clear any contracts from your Catalogue

Regardless of Overwrite Blanks being enabled or not; when data lists are provided, Curve will recreate these lists entirely from scratch based on the data in your Template.

So under any circumstance; when your Contract template specifies Terms for your Contract, it will clear any existing terms on your Contract and replace it with the Terms specified in the Template. When your Release template has linked Tracks specified for your Release, it will unlink any existing Tracks from that Release and replace them with the Tracks specified in your Template.