Introduction
Welcome to Edelweiss+! This document explains and defines the various data feeds that may be used to populate catalog data within the Edelweiss+ platform.
Edelweiss has many types of content that can be uploaded and displayed for a title within a specific market. All of the content can be broken out into three basic types:
- Core bibliographic data
- Marketing assets (jacket cover images, interior illustrations, PDFs, etc.)
- Ancillary marketing metadata
Content Management Steps
Here’s an overview of the steps needed to create a catalog within Edelweiss, listed in order of priority. The first three are the only that are required. They form thefoundation of your catalog. The additional steps add ancillary data.
- Create catalog, assign it to all relevant markets, and add EANs.
- Populate bibliographic title data, ideally via ONIX. You may use our Treeline_Biblio_Data Template, which is similar to Ingram’s Excel File Biblio Template, or you can use the admin interface to manually input your data. (This can be done before step 1 if needed.)
- Upload cover images by batch upload via FTP… OR use the admin interface.
- Upload comparative title data. (This data is very important to stores that will use your catalog for planning frontlist purchasing!)
- Add ancillary metadata to enhance the listing (if not already coming from ONIX), including product description (not required but very important!), author bio (highly recommended!), quotes & reviews, book excerpts, key selling points, marketing plans, Table of Contents, interior images, links to external websites, related products, and publicity events.
- Upload catalog cover image.
- Upload PDF of catalog (optional, if it exists).
- Upload catalog page numbers and sort order (Excel).
Bibliographic Data Feeds
The following fields are the core bibliographic data elements that represent products in Edelweiss. Ideally, this data is populated via an ONIX feed and the fields below match standard data elements within ONIX. Publishers who don’t use ONIX should contact Above the Treeline for alternate means of importing this data.
The next table outlines the primary field names and any supporting data elements. The primary fields also have an indication as to whether this data can be updated via the Edelweiss Admin tool or via an ancillary (non-ONIX) feed. Those data elements required for a title to work fully within Edelweiss are indicated under the “Required” column. Finally, the last column indicates whether that attribute can be market-specific in terms of content displayed for a single ISBN that is available in more than one market, (e.g. US Trade/Academic/Christian, Canada, UK, Germany, Australia, Global, etc.).
For more information on updating title content so that it’s market specific using our online Catalog Administration tools, refer to Publisher Administrator Help – in particular the materials about creating a catalog and managing title attributes.
ONIX Feeds
ONIX is the preferred method for submitting and updating bibliographic title data. Publishers that do not have ONIX feeds available will need to contact Above the Treeline to discuss other options for populating title data, including using our Treeline Biblio Data Template, which is an Excel file that needs to be submitted via our Ancillary Data feed process (see the next sections for details). ONIX feeds should be made available via FTP or pushed to Above the Treeline’s FTP server on a regular basis (e.g. daily or weekly). Feed processing includes adding any new records from ONIX into the Edelweiss database as well as updating existing records with information that has changed. ONIX files are processed at night so all ONIX-processed changes should appear on Edelweiss the following day.
Edelweiss ONIX processing will update all of the fields in the above grid unless the elements are not available in a publisher’s ONIX file or the publisher has explicitly asked Treeline to not process them (e.g. Age Range may not be a relevant field for a publisher that only publishes adult books). We can accept distinct ONIX feeds for specific types of products – e.g. print vs. ebooks – as well as for specific markets. This also allows us to process these ONIX feeds uniquely based on the relevant nodes and posting schedule. Ideally, each ONIX feed contains unique ISBNs so data overriding (for the same ISBN) does not become an issue.
Please name each ONIX feed in a consistent manner, beginning with the same
naming convention and ending with the date created or posted:
[YourPublisherName]_ONIX_print_20190429.xml
Feel free to send us ONIX data for all of your active titles. Publishers are not actually charged for posting ONIX title data - just for featuring a set number of titles in Edelweiss catalogs each year.
Post all of your ONIX files to the /ONIX/ folder within your FTP account/folder on our server.
Our FTP Address: na-ftp.abovethetreeline.com
Treeline_Biblio Feed
If your company does not use ONIX and you prefer to submit your core bibliographic data via spreadsheet rather than using Edelweiss’s online cataloging tools, please use the Treeline_Biblio_Data Excel Template.
Note: The particular data formatting requirements are annotated in each column header field found within this template. Also, all number values should be formatted as text. Include all columns found in this template and do NOT add any additional columns.
Please adhere to the Ancillary Data feed specifications that follow:
File Format: Excel (2007 or earlier) or DOS-formatted Text
File Name: Treeline_Biblio_1.xls
or Treeline_Biblio_[YYYYMMDD].xls
FTP Drop Folder: Your /edelweiss/import_data/
folder on our server at
ftp.abovethetreeline.com
Ancillary Data
Some publishers may provide ancillary data within ONIX (product descriptions, quotes, etc) and some may choose to send this data in non-ONIX feeds. If ancillary data is to be provided outside of ONIX, it may be delivered in one of three ways:
- Manually via the Catalog Administrative interface on a record by record basis
- Via the Catalog Administrative interface via batch Excel uploads (only available for some data types)
- Via FTP delivered delimited text or Excel feeds
Administrative Interface
The Edelweiss Catalog Administrative Interface may be used to update almost all types of catalog content. Publishers wishing to use the Admin Interface should attend a one hour Webex training session in order to understand all the various steps required in creating a catalog. Help documents are also available at http://help.edelweiss.plus/?article_category=pub-admin.
Ancillary Data Feeds
For ancillary data that can't be included in ONIX, publishers can set up automated ancillary data feeds using flat tab-delimited files delivered via FTP.
For the technical details on using ancillary data feeds, as well as a list of available feeds, see the Ancillary Feeds page.
Asset Feeds
All catalog assets (images, PDFs, etc.) should be made available via FTP or
transmitted to the Edelweiss FTP server. Assets may be sent compressed or
uncompressed. Compressed files should not contain sub-folders. All image files
should be placed in the specific edelweiss/images/jacket_covers
or
edelweiss/images/illustrations
subfolder within their FTP folder, as
described below.
Image Specifications
For all jacket cover, author and interior images the following image guidelines
should be used:
Supported Formats: GIF, PNG or JPG
Size: preferred size is 1000px width. This is the largest size we will
display.
Resolution: preferred resolution is 72 dpi. This is the highest definition
we will display.
Note that as of March 2015, all images may be market-specific in Edelweiss. So, for instance, a different cover image can be displayed in the US market than one in the UK market for the same ISBN.
Jacket Cover Images
FTP Folder: /edelweiss/images/jacket_covers
Naming Convention: Name must contain the ISBN or ISBN13 of the associated
product. Dashes within the name are acceptable.
We process jacket covers every hour at the top of each hour; they should begin to appear on the site shortly after processing, though site caching may delay their display.
Author Images
FTP Folder: /edelweiss/images/author_images
Naming Convention: The filename must contain the ISBN or ISBN13 of the
associated product followed by an underscore character and a sequence number.
The sequence number should be incremented when multiple images are sent per
product. Example: 978012345678_1.jpg 978012345678_2.jpg
We process author images every night, and they should display on Edelweiss the following day.
Interior Illustrations
FTP Folder: /edelweiss/images/illustrations
Naming Convention: The filename must contain the ISBN or ISBN13 of the
associated product followed by an underscore character and a sequence number.
The sequence number should be incremented when multiple images are sent per
product. Example: 978012345678_1.jpg 978012345678_2.jpg
Interior Illustrations from a PDF Sample Spread
We can read multiple interior illustrations for a title from a single PDF file.
File Format: PDF
Naming Convention: [ISBN]_[Sequence]_p[ThumbnailPageNumber].pdf
- Example:
9781584799207_1_p2.pdf
- The Sequence is the order in which the thumbnails will be displayed if there is more than one PDF for a title
- The ThumbnailPageNumber contains the page within the PDF that should be used to generate the thumbnail.
- So as a 2nd example, if you posted a PDF containing 11 individual pages,
this naming convention would result in watermarked thumbnails for pages 2-11 of
the pdf:
9781584799573_1_p2_p3_p4_p5_p6_p7_p8_p9_p10_p11.pdf
We process interior images every night, and they should display on Edelweiss the following day.