© 2015 Zinfonia Holdings Pty Ltd All Rights Reserved

www.zinfonia.com • admin@zinfonia.com

Zinfonia Catalogue and Link Import File Specifications

To import work title information into Zinfonia you must create an import file according to specifications below. As part of the import process you can set global

action links for all works imported or you can use a separate link file which is also specified below.

Catalogue Import File Format The catalogue import file must be a Unicode* text file with specific columns separated by a TAB (09hex|9decimal) character and each record separated by a CR

(0Dhex|13decimal) or CR/LF (0D/0Ahex|13/10decimal) combination.

For fields that require carriage return (such as the Description, Orchestration or Premiere fields), the Paragraph Marker ¶ CR (B6hex|182decimal) may be used.

The first line MUST contain tab-separated Column Headings in the exact same order and representation as the table below. Any information that is greater than

the max size will be truncated. Any information which is not applicable may be left blank.

Records MUST contain at least a Unique Work ID, Composer Last Name and Title.

While the inclusion of composer dates is not mandatory, inclusion will assist in the speed of the processing of your requests.

All information should be in mixed case. Information all in CAPITALS may be rejected.

*A standard ASCII file can also be used so long as there are no extended characters.

Version: 1.3c

Last Updated: 20 October 2016

Change Log v.1.3B: New WEMZ column (38) added

v.1.3C: New SRDistID , GRDistID columns (39/40) added, Changed names of Premiere/Category columns

Catalogue Record Field Columns Mandatory Fields are marked in RED

# COLUMN MAX WIDTH DESCRIPTION SAMPLE

1 WORKID 20 Your Work ID Reference

Note: This MUST be Unique for all of your titles

BACH1234

2 PUBID 36 The Zinfonia assigned publisher ID

Note: This may be left blank if only one publisher defined or

if unknown

00000000-0000-0000-0000-000000000000

3 Composer1LastName 50 The family name of the primary composer

Note: as this field is mandatory, you MUST include a

composer even if there is none using names like Anonymous

or Unknown. When a title has more than three composers,

we recommend the use of names like Various or

Miscellaneous

Bach

4 Composer1FirstNames 50 The first names of the primary composer Johann Sebastian

5 Composer1YearBorn 4 The year the primary composer was born (leave empty if

unknown)

1685

6 Composer1YearDied 4 The year the primary composer died (leave empty if unknown

or the composer is living)

1770

7 Composer2LastName 50 The family name of the secondary composer (the secondary

composer is optional)

Webern

8 Composer2FirstNames 50 The first names of the secondary composer Anton

9 Composer2YearBorn 4 The year the secondary composer was born (leave empty if

unknown)

1883

10 Composer2YearDied 4 The year the secondary composer died (leave empty if

unknown or the composer is living)

1945

11 Composer3LastName 50 The family name of the tertiary composer (the tertiary

composer is optional)

12 Composer3FirstNames 50 The first names of the tertiary composer

13 Composer3YearBorn 4 The year the tertiary composer was born (leave empty if

unknown)

14 Composer3YearDied 4 The year the tertiary composer died (leave empty if unknown

or the composer is living)

15 Title 254 The main title of the work.

Note: The title should use the western character set

Fuga (2. Ricercata) a 6 voci

16 Subtitle 254 The subtitle of the work aus "Das Musikalische Opfer"

17 TitleEN 254 The English title of the work (if different from the main title) Fugue (2. Ricercare) for 6 voices

18 SubtitleEN 254 The English subtitle of the work (if different from the main

title)

from “The Musical Offering”

19 TitleDE 254 The German title of the work (if different from the main title)

20 SubtitleDE 254 The German subtitle of the work (if different from the main

title)

21 TitleFR 254 The French title of the work (if different from the main title) Fugue (2. Ricercare) a 6 voices

22 SubtitleFR 254 The French subtitle of the work (if different from the main

title)

de L'Offrande musicale

23 TitleIT 254 The Italian title of the work (if different from the main title)

24 SubtitleIT 254 The Italian subtitle of the work (if different from the main

title)

25 TitleXX 254 The title of the work in any other language (if different from

the main title)

Note: The language MUST be defined in the language column

below and should not include english, french italian or

german

フーガ

26 SubtitleXX 254 The subtitle of the work in any other language (if different

from the main title)

音楽の捧げもの

27 XXLang 2 The 2-letter ISO 639-1 language code (see

http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes)

ja

28 Duration 4 The duration in minutes

Note: Only numbers 0-9 are permissible. Any other text will

mean no information is imported. When the duration is not

know, use the Circa option below.

11

29 Circa 1 Indicates that the duration is provisional.

Note: Any text in this column will mark this as true – if the

duration is known, leave the field empty.

30 Opus 50 The opus number for the work

Note: Include the opus designator (eg. Op.78)

BWV 1079/5

31 DateComposed 50 The year of composition of the work

Note: for best results enclose the date in brackets

(1935)

32 Editor 100 The name of the editor of the work

Note: the Editor name is also used for searching by composer

using a literal search and so the most common form of the

name is advisable

Herbert Karajan

33 EditorType 4 The type of Editor represented as a number using the addition

of the values below:

Editor (1)

Arranger (2)

Orchestrator (4)

Critical Edition (8)

Translator (16)

Co-author (32)

Revisor (64)

Adapted by (128)

Completed by (256)

Reconstructed by (512)

Note: If no type is entered, the Editor name will be displayed

by itself. You can combine types and so Editor/Arranger

would be: Editor(1)+Arranger(2) = 3

2

34 Description 4000 A description of the work eg. Cantata for mixed voices and

large orchestra

Note: You can use the Paragraph marker ¶ CR

(B6hex|182decimal)to start text on a new line

for orchestra

35 Orchestration 4000 The orchestration of the work and any additional information

Note: You can use the Paragraph marker ¶ CR

(B6hex|182decimal)to start text on a new line

1 2 2 1 - 1 1 1 0 - Pk, Hf, Str

36 Premiere 4000 Information about the first performance of the work

Note: You can use the Paragraph marker ¶ CR

(B6hex|182decimal)to start text on a new line

17.April 1966¶Berliner Philharmonisches

Orchester c. Karajan

37 Category 3 The Category of the work represented as a number using the

addition of the values below:

Works for the Stage (1)

Orchestral Works (2)

Large Ensemble > 24 Instruments (4)

Medium Ensemble (10-24 Instruments) (8)

Small Ensemble (2-9 Instruments) (16)

Solo (with or without accompaniment) (32)

Vocal and Choral Works (64)

Note: The category is optional. You can combine categories

and so a work for soloists, chorus and orchestra would be:

Orchestral Works(2)+Solo (32)+Vocal and Choral Works(64) =

98

2

38 WEMZ 1 The accessibility or difficulty of the work as represented by a

single uppercase letter:

E (Easy)

M (Moderate)

Z (Difficult)

Note: The accessibility value is optional should be left blank

if not specified.

Z

39 SRDistID 10 Small Rights Distribution ID Number (leave empty for

publisher distribution rules)

1000000

40 GRDistID 10 Small Rights Distribution ID Number (leave empty for

publisher distribution rules)

1000000

41 v1.3C 1 Normally empty but can include a letter S,H or D:

(S)how a previously hidden title

(H)ide a title from public view

(D)elete a title if no orders, otherwise hide it from view

Link Import File Format The link import file must be a Unicode* text file with specific columns separated by a TAB (09hex|9decimal) character and each record separated by a CR

(0Dhex|13decimal) or CR/LF (0D/0Ahex|13/10decimal) combination.

Every record must have a valid WORKID

The first line MUST contain tab-separated Column Headings in the exact same order and representation as the table below. Any information that is greater than

the max size will be truncated. Any information which is not applicable may be left blank.

Records MUST contain a Link TYPE and link ITEM. There can only be 1 link for the same TYPE and ITEM and LANGUAGE. The displayed text is a combination of

the TYPE and ITEM text. When adding links, you MUST add all links for a particular work at the same time (any existing entries will be removed).

NOTE: If no URL is entered, the request will be processed using the default Zinfonia Request Materials/Ask a Question options and the TYPE option will be

ignored.

IMPORTANT: For any title that you want to be processed by the Zinfonia order system, it is very important that if you are adding other links that you include

a line item for the Zinfonia Request Materials option which is represented as follows:

# COLUMN DESCRIPTION

1 WORKID Your Work ID Reference

2 TYPE -15

3 ITEM 1

The rest of the columns are not required

*A standard ASCII file can also be used so long as there are no extended characters.

Change Log v.1.3C: Removed ZinfoniaID column

Link Record Field Columns Mandatory Fields are marked in RED

# COLUMN MAX WIDTH DESCRIPTION SAMPLE

1 WORKID 20 Your Work ID Reference

Note: This MUST be Unique for all of your titles

BACH1234

2 TYPE 3 The type of Link represented as a number from the list below:

Hire/Rent (1)

Quote (2)

Purchase (3)

Information (4)

Perusal/Inspection (5)

Print on Demand (6)

Programme Notes (7)

Download (8)

Sample (9)

Digital Delivery (10)

View (11)

License (12)

Listen to (14)

Recording (16)

1

NOTE: to add

3 ITEM 3 The type of Part represented as a number from the list below:

Full Score and Parts (1)

Full Score (2)

Parts (3)

www (4)

Vocal Scores (5)

Choral Scores (6)

Libretto (7)

Recording (8)

Various (9)

Complete Work (10)

Music (11)

Text/Lyrics (12)

Solo Part (13)

Piano Reduction (14)

1

NOTE: use 0 when NO Item is required

4 URL 1024 The fully qualified link to the URL of an external website http://www.boosey.com/shop/Item1234

5 Lang 2 The 2-letter ISO 639-1 language code of the external

reference (see http://en.wikipedia.org/wiki/List_of_ISO_639-

1_codes)

en

6 Part 40 An identifier for the line item which is displayed in the link NR 131825

7 v1.3C 1 Normally empty but can include a letter S,H, D or A:

(S)how Link

(H)ide Link

(D)elete ALL Links

Restrictions The import files must be smaller than 4.0Mb, and a maximum of 1000 records per file is recommended. You can though import more than one file to build up

large catalogues.

Using Excel If you use the Unicode Text option of the Excel, with the correct columns you should get an import file in the correct format.

Using Google Sheets If you use the Download as Tab-separated values with the correct columns you should get an import file in the correct format.

Sample Files You can download a sample XLS and import file from here http://zinfonia.info/zindocs/ZinfoniaImportSample.zip

Please Note: While correct at time of publication, these specifications may change without notice.