Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Instead of using the admin web interface, you can upload files via FTP for ingestion. The root directory of the FTP account is processed on regular basis. The files will appear in the ingestion list if properly processed. The file naming convention determines how the file is processed (see table below). If the file does not adhere to the naming convention, the ingestion associated with the file will be marked as failed.

Important:

  • Be certain to follow the general FTP ingestion rules.
  • Product data must exist in the TitleLeaf database prior to ingestion of assets (eg, covers, spreads, ebooks) to be associated with the products. The assets are named by ISBN or proprietary_id. If TitleLeaf doesn't have the ISBN or proprietary_id in its database, then it will fail to ingest the asset, marking it as "unrecognized".

Contact info@titleleaf.com for FTP account credentials.

Data files

Templates for the data files listed below are available via Google Docs.

File NameIngestion TypeDescription
default.csvDefaultTo create/update products and their associated formats. As indicated by the name, it is the most widely used template.
awards.csvAwardsTo create/update awards conferred to products.
assembly_assignments.csvAssembly AssignmentsAssembly is the internal TitleLeaf term for Sets. This file associates titles to sets.
bestsellers-products.csvProducts OnlyTo define the sales rate of products. The sales rate is used to compose the best sellers list.
bisac_subjects.csvBisac SubjectsInternal use only
categories.csvCategoriesThe internal TitleLeaf term for Subjects.
categories_products.csvCategories to ProductsTo associate products to categories.
collections.csvCollectionsThe internal TitleLeaf term for Series.
common_core_ela.xmlCommon Core ELAInternal use only
common_core_math.xmlCommon Core MathInternal use only
contributors.csvContributorsTo create/update contributors (eg, Authors, Illustrators, Editors, etc).
contributor_assignments.csvContributor AssignmentsTo associate products to contributors.
editorial_reviews.csvEditorial ReviewsTo create/update editorial reviews.
editorial_reviews_products.csvEditorial Review ProductsTo associate products to editorial reviews.
links.csvLinksTo create/update website links.
links_products.csvLink ProductsTo associate products to website links.
postal_codes.csvPostal CodesTo create/update postal codes.
price_changes.csvPrice ChangesInternal use only.
products.csvProducts OnlyTo update product data only (as opposed to product format data). See also default.csv.
product_formats.csvProduct FormatsTo update product format data only (as opposed to product data). See also default.csv.
products_standards.csvProduct StandardsTo associate products to standards such as the Common Core.
related_product_assignments.csvRelated Product AssignmentsTo create a relation between 2 products.
testimonials.csvTestimonialsTo create/update testimonials.

Image files

File Name Ingestion Type
DOE_JOHN_pic.jpgContributor Portraits
ISBN_fc.jpgFront Covers
ISBN_bc.jpgBack Covers
ISBN_int.jpgSpreads
DESCRIPTION_web.jpg, DESCRIPTION_web.pngWeb Images

Ebook/Draft files

File NameIngestion TypeDescription
ISBN_draft.pdfDraftsA draft file in PDF format containing multiple pages of the designated title.
ISBN.epubEbooksAn Epub file to be distributed and sold.
ISBN.mobiEbooksA Mobi or KF8 file to be distributed and sold.
ISBN.mp3EbooksA MP3 file to be distributed and sold.
ISBN.wavEbooksA WAV file to be distributed and sold.
ISBN_ebook.pdfEbooksA PDF file to be distributed and sold.
ISBN_ebook_cvr.pdfEbook CoversA one-page PDF file of the front and back cover combined. It should contain crop marks. Along with the interior, it is used to create a final, salable PDF ebook.
ISBN_ebook_int.pdfEbook InteriorsA multi-page PDF file of the interior of a book. It should NOT contain crop marks. Along with the cover, it is used to create a final, salable PDF ebook.
ISBN_excerpt.pdfExcerptsAn excerpt file in PDF format containing multiple pages of the designated title.

Layout files

These are InDesign or Quark Xpress packages. The package directory must be zipped. The cover and interior packaged files can either be zipped together or separately. That choice dictates the following file naming.

File NameIngestion TypeDescription
ISBN_layout.zipLayoutsA zip file containing both the packaged cover and interior of a given title.
ISBN_layout_cvr.zipLayout CoversA zip file containing the packaged cover only of a given title. The interior must also be provided to comprise a complete archive of the given title.
ISBN_layout_int.zipLayout InteriorsA zip file containing the packaged interior only of a given title. The cover must also be provided to comprise a complete archive of the given title.

Other files

File NameIngestion TypeDescription
PID_tg.[txt|rtf|pdf|doc|docx|csv|xml|xls|xlsx|xltx|zip]Teaching GuidesA teaching guide document.
PID_ho.[txt|rtf|pdf|doc|docx|csv|xml|xls|xlsx|xltx|zip]HandoutsA handout document.