Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
preparing_books_and_magazines_for_use_with_gutenberg_and_klas_uids_e-documents [2021/09/07 12:28]
mn1a [Creating an E-Document]
preparing_books_and_magazines_for_use_with_gutenberg_and_klas_uids_e-documents [2022/09/13 10:43] (current)
mn1a [UID Locations]
Line 1: Line 1:
-===== Introduction =====+= Introduction =
  
-In most cases, books and magazines should be formatted for use with Gutenberg if NLS guidelines for metadata are followed during resource creation. However, in some cases it may be necessary to reformat older book and/or magazine Unique Identifiers (UIDs) So that they can be used with Gutenberg and KLAS. Locations that require attention and formatting guidelines have been included in the sections below.  
-(( Information in this guide is primarily based on procedures/suggestions from [[ https://myctbl.cde.state.co.us/ | Colorado Talking Book Library]] and [[ https://www.klas.com/ | Keystone Systems]].)) ((Procedures below are explained using Gutenberg and KLAS and may differ slightly depending on the software/hardware combination used.)) ((while formatting the UID can often enable a book to be duplicated onto cartridges using Gutenberg, additional checks/changes may be necessary when submitting books for distribution through BARD.)) 
-===== Working with UIDs ===== 
  
-In order to enable recognition by Gutenberg and KLAS, formatted UIDs must be added to/appear in component files (''.opf'', ''.ppf'', etc.in 10 specific locations +In most casesbooks and magazines should be formatted for use with Gutenberg if NLS guidelines for metadata are followed during resource creation. However, in some cases it may be necessary to reformat older book and/or magazine Unique Identifiers (UIDsto enable use with Gutenberg and KLAS
-==== UID Format ====+
  
-Formatting examples are included in each of the sub-sections below.+Information on the formatting process is contained in the following sections.(( Information in this guide is primarily based on procedures/suggestions from [[ https://myctbl.cde.state.co.us/ | Colorado Talking Book Library]] and [[ https://www.klas.com/ | Keystone Systems]].)) ((Procedures below are explained using Gutenberg and KLAS and may differ slightly depending on the software/hardware combination used.)) ((while formatting the UID can often enable a book to be duplicated onto cartridges using Gutenberg, additional checks/changes may be necessary when submitting books for distribution through BARD.))
  
-=== Book UIDs ===+ 
 +UID Locations = 
 + 
 +In order to enable recognition by Gutenberg and KLAS, formatted UIDs must be added to/appear in 10 specific locations of component files (.opf, .ppf, etc.).   
 + 
 +The ten locations and their associated file extensions have been listed in the table below. Each location can be changed manually by opening the files in a text editor (such as [[ https://en.wikipedia.org/wiki/TED_Notepad | Ted Notepad]], or [[ https://www.vim.org/ | Vim]]) and pasting/entering the formatted UID.  
 +Automation/partial automation of the process is possible, and a program written in C ([[ http://xmlsoft.org/ | libxml]]) is used for changing UIDs at the Minnesota Braille and Talking Book Library (MBTBL/MN1A). 
 + 
 + 
 +^ File extension      ^ Location      ^ 
 +| .ncx     |dtb:uid | 
 +| .opf     |dc:Identifier 
 +| :::    | .ao file name | 
 +| .pncx   | dtb:uid | 
 +| .ppf     |dc:Identifier | 
 +| :::    | .ao file name  | 
 +| .smil ((In this case .smil ONLY refers to the .smil file associated with the item itself, NOT pdtb_protected.smil))     | dtb:uid | 
 +| .ao    | File name (needs to match UID) | 
 +| :::    | Book uid | 
 +| :::    | odrld:uid | 
 + 
 + 
 + 
 + 
 +Formatting examples are included for individual material types in the sub-sections below. 
 + 
 +== Book UIDs ==
  
 Example of formatted book UID: Example of formatted book UID:
Line 17: Line 39:
  
 ^Component ^ Explanation ^ ^Component ^ Explanation ^
-''us-''  | US prefix | +| us-  | US prefix | 
-''nls-'' | NLS prefix | +| nls- | NLS prefix | 
-''ll1a-'' | library ID ((‘''ll''’ will be the first two letters of your library ID.))| +| ll1a- | library ID ((‘ll’ will be the first two letters of your library ID.))| 
-''dbc#####''   | DBC number ((A prefix other than ‘''dbc''’ could also be used in-house book numbers))|+| dbc#####   | DBC number ((A prefix other than ‘dbc’ could also be used in-house book numbers))|
  
  
  
-=== Magazine UIDs ===+== Magazine UIDs ==
  
-1) Example of formatted magazine UID (single month) ((According to Keystone, cases where dashes and underscores are not interchangeable exist, and, while combinations other than those appearing below may be possible, it is highly recommended to format based on the examples from this guide.)):+'''PLEASE NOTE:'''  
 +* For magazines, final formatting will vary depending on issue naming conventions in the KLAS Serials module. 
 +* Examples in the following sections assume that Issue names in the Issues tab of the KLAS Serials module are formatted as <tt>YYYY-MM </tt>(monthlyor <tt>YYYY_MM_MM</tt> (bi-monthly) 
 + 
 + 
 +'''1.''' Example of formatted magazine UID (monthly) ((According to Keystone, cases where dashes and underscores are not interchangeable exist, and, while combinations other than those appearing below may be possible, it is highly recommended to format based on the examples from this guide.)):
 <code> us-nls-ll1a-SER_TTT9-YYYY_MM </code> <code> us-nls-ll1a-SER_TTT9-YYYY_MM </code>
  
-2Example of formatted magazine UID (multiple months) ((According to Keystone, cases where dashes and underscores are not interchangeable exist, and, while combinations other than those appearing below may be possible, it is highly recommended to format based on the examples from this guide.)):+'''2.''' Example of formatted magazine UID (bi-monthly) ((According to Keystone, cases where dashes and underscores are not interchangeable exist, and, while combinations other than those appearing below may be possible, it is highly recommended to format based on the examples from this guide.)):
 <code> us-nls-ll1a-SER_TTT9-YYYY_MM_MM </code> <code> us-nls-ll1a-SER_TTT9-YYYY_MM_MM </code>
  
  
 ^Component ^ Explanation ^ ^Component ^ Explanation ^
-''us-''  | US prefix | +| us-  | US prefix | 
-''nls-'' | NLS prefix | +| nls- | NLS prefix | 
-''ll1a-'' | library ID ((‘ll’ will be the first two letters of your library ID.))| +| ll1a- | library ID ((‘ll’ will be the first two letters of your library ID.))| 
-''SER_''   | Serial prefix | +| SER_   | Serial prefix | 
-''TTT9-''   | Serial ID | +| TTT9-   | Serial ID | 
-''YYYY_''   | 4-digit year| +| YYYY_   | 4-digit year| 
-''MM''   | 2-digit month |+| MM   | 2-digit month |
  
  
-==== UID Locations ==== 
  
-The ten locations and their associated file extensions have been listed in the table below. Each location can be changed manually by opening the files in a text editor (such as [[ https://en.wikipedia.org/wiki/TED_Notepad | Ted Notepad]], or [[ https://www.vim.org/ | Vim]]) and pasting/entering in the formatted UID.  
-Automation/partially automation of the process is possible, and a program written in C ([[ http://xmlsoft.org/ | libxml]]) is used for changing UIDs at MBTBL. 
  
 += Uploading Books to Gutenberg =
  
-^ File extension      ^ Location      ^ +After the UID has been properly formatted, simply adding the book or magazine to the <tt>Local Books</tt> directory on Gutenberg should result in auto-generation of an E-DocumentThe KLAS Batch Manager can be used to Synchronize Gutenberg Edocs, resulting in near-instantaneous updatesHowever, if use of the Batch Manger is not desirable/possible, E-Document generation can also be confirmed by viewing the E-Document tab in the Catalog or Serials module 24 – 48 hours after uploading the book file to Gutenberg.
-| ''.ncx''     |''dtb:uid''+
-| ''.opf''     |''dc:Identifier'' +
-| :::    | ''.ao'' file name | +
-| ''.pncx''    | ''dtb:uid''+
-| ''.ppf''     |''dc:Identifier''+
-| :::    | ''.ao'' file name  | +
-| ''.smil''     | ''dtb:uid''+
-| ''.ao''    | File name (needs to match UID) | +
-| :::    | ''Book'' uid | +
-| :::    | ''odrld:uid'' |+
  
 +In some cases, an E-Document may not be generated automatically. While this can be caused by UID formatting errors, it can also occur even if the UID has been formatted correctly. In these cases, it may be necessary to manually create an E-Document and its associated E-Package. For more information on the process, please refer to ''Manually Generating E-Documents in KLAS'' below.
  
-===== Uploading books to Gutenberg =====+Synchronize Gutenberg E-Documents with KLAS Batch Manager =
  
-After fixing the UID, simply adding the book or magazine to the ''Local Books'' directory on Gutenberg should result in an E-Document being auto-generatedIt will be possible to confirm whether an E-Document has been generated in KLAS by checking the ''E-Document'' tab in the ''Catalog'' or ''Serials'' module 24 – 48 hours after uploading the book file to Gutenberg.+New E-Documents are often available in KLAS approximately 24 48 hours after .zip files are uploaded to Gutenberg. However, in some cases, quickly confirming that E-Documents have been successfully generated may be desirable. The KLAS Batch Manager enables users to run the process on demand.
  
-In some casesan E-Document may not be generated automatically. While this can be caused by UID formatting errorsit can also occur even if the UID has been formatted correctly. In these casesit may be necessary to manually create an E-Document and its associated E-Package. For more information on the process, please refer to //Generating E-Documents in KLAS// below.+'''PLEASE NOTE:''' 
 +* Running the KLAS Batch Manager may require elevated user privileges. 
 +* For Keystone-hosted librariesit may take approximately 24 hours after new contents have been added to the Gutenberg workstation before E-Documents can be generated with KLAS Batch Manager 
 +UID formatting, correspondence (within tolerance) between file names in KLAS and UIDsand other system-level considerations may also be necessary to enable auto-generation of E-Documents.
  
 +== Displaying the KLAS Batch Manager ==
  
-===== Generating E-Documents in KLAS =====+After KLAS has been started,the KLAS Desktop Window should be displayed. click: 
 +\\ 
 +\\ 
 +'''1.''' View menu
  
-In the event that an E-Document is not generated after a book file has been uploaded to the ''Local Books'' directory on the Gutenberg workstation, it may be necessary to create one manually. +'''2.''' Administration
-The procedures for creating E-Documents (and associated E-Packages) are explained in the sections below.+
  
-==== Creating an E-Package ====+'''3.''' Batch Manager 
 + 
 +== Preparing and Running the Batch Job == 
 + 
 +When the KLAS Batch Manager is opened by a user for the first time, many of the fields may be empty. In this case, please proceed in order through the following steps. Users that have already worked through the steps for 'Synchronize Gutenberg Edocs', or a similar batch job in the past will be able to skip to step 6. 
 +\\ 
 +\\ 
 +'''1.''' Remove your username from the 'Created by:' field. 
 + 
 +'''2.''' Click the 'Filter' button.  
 +* All of the batch jobs run on your system will appear in the 'Job' column of the table. 
 + 
 +'''3.''' Click the job at the top of the table to select it. 
 +*After the job has been selected, it should be highlighted in blue. 
 + 
 +'''4.''' Press the End key on your keyboard. 
 +* The most recent job run on the system (at the bottom of the list) should now be highlighted. 
 + 
 +'''5.''' Use the arrow keys or the scroll bar to move up the list. 
 +   
 +'''6.''' Click the first instance of 'Synchronize Gutenberg Edocs' to select it. 
 + 
 +'''7.''' Click the 'Copy Record' button in the bottom-left of the KLAS Batch Manager window. 
 +* The 'Copy Record' button is located next to the 'Edit Record' button (which is indicated by a pencil icon). 
 + 
 +'''8.''' Next, click the 'Set Schedule' button. 
 + 
 +'''9.''' Click the radio button next to 'Immediately' in the 'Set Schedule' window, then click 'OK'
 +* The 'Set Schedule' window will close automatically after 'OK' has been clicked. 
 + 
 +'''10.''' To run the job, click the 'Save Record' button (disk icon) located in the lower-left of the KLAS Batch Manager window. 
 +* The job should start immediately, and takes approximately 3 minutes to complete. 
 +* It may be necessary to close and reopen the Serials or Catalog module in order to confirm changes. 
 + 
 + 
 + 
 + 
 + 
 + 
 + 
 += Manually Generating E-Documents in KLAS = 
 + 
 +In the event that an E-Document is not generated after a book file has been uploaded to the Local Books directory on the Gutenberg workstation, it may be necessary to create one manually. 
 +The procedures for creating E-Documents (and associated E-Packages) are explained in the following sections. 
 + 
 +'''PLEASE NOTE:''' 
 +* In some cases, manually created E-Documents may not be recognized, especially in cases where the Issue Title is manually changed prior to creating the E-Document. 
 +* Using the KLAS Batch Manager to Synchronize Gutenberg Edocs prior to attempting to manually create an E-Document is recommended.  
 + 
 +== Creating an E-Package ==
 In order to create an E-Document, an E-package must be created. In order to create an E-Document, an E-package must be created.
  
-1. Open KLAS, and click the ''E-Package'' tab for the desired book or magazine.+'''1.''' Open KLAS, and click the E-Package tab for the desired book or magazine.
  
-2. Add a new record.+'''2.''' Add a new record.
  
-3. Fill in the values for each item:+'''3.''' Fill in the values for each item:
  
 ^ Field      ^ Data      ^ ^ Field      ^ Data      ^
-|''Type'' |''NLS Audio / Audio Files from National Library Service'' +|Type |NLS Audio / Audio Files from National Library Service | 
-|''Description'' |''Local Copy of NLS Audio'' +|Description |Local Copy of NLS Audio | 
-|''Security'' |''Staff only/Only staff persons can view the package documents'' +|Security |Staff only/Only staff persons can view the package documents | 
-|''Source'' |''NLS RSync/RSync from the NLS Catalog to a local storage device'' +|Source |NLS RSync/RSync from the NLS Catalog to a local storage device | 
-|''Status'' |''Available/The documents are available for use'' +|Status |Available/The documents are available for use | 
-|''Usage'' |''Unlimited/No limit to how many items are ‘OUT’ at one time'' +|Usage |Unlimited/No limit to how many items are ‘OUT’ at one time | 
-|''Price'' |''0.0''|+|Price |0.0|
  
  
-==== Creating an E-Document ====+== Creating an E-Document ==
  
 After an E-Package has been created, it will be possible to create an E-document.  After an E-Package has been created, it will be possible to create an E-document. 
 For magazines, separate E-Documents will need to be created for each issue. ((Depending on the server method/settings, it may take up to 48 hours for a book file to be recognized after it has been added and an E-Document has been created.)) For magazines, separate E-Documents will need to be created for each issue. ((Depending on the server method/settings, it may take up to 48 hours for a book file to be recognized after it has been added and an E-Document has been created.))
  
-1. Click the ''E-Document'' tab for the desired book or magazine.+'''1.''' Click the E-Document tab for the desired book or magazine.
  
-2. In the ''Package Info'' section, choose the following values:+'''2.''' In the Package Info section, choose the following values:
  
 ^ Field      ^ Data      ^ ^ Field      ^ Data      ^
-|''Package''|''NLS Audio/Local Copy of NLS Audio''  | +|Package|NLS Audio/Local Copy of NLS Audio  | 
-|''Status'' |''Available/The documents are available for use'' |+|Status |Available/The documents are available for use |
  
-3. Fill in the values as shown below:+'''3.''' Then, enter the data for the desired resource type (book, or magazine) to complete the E-Document. 
 + 
 +=== Books ===
  
 ^ Field      ^ Data      ^ ^ Field      ^ Data      ^
-|''Issue Name ((This field only appears in magazine E-Documents.))''|''YYYY-MM''+|Short Desc.|Local Copy of NLS Audio| 
-|''Short Desc.''|''YYYY-MM'' (magazines)| +|Description|NLS Audio compressed file| 
-|:::|''Local Copy of NLS Audio'' (books)+|Seq|##| 
-|''Description''|''NLS Audio compressed file''+|File Type| Zip/application/zip| 
-|''Seq''|''##''+|Click Meaning| Circ/count the click as circulation| 
-|''File Type''''Zip/application/zip''+|Date Added| (Auto-generated)
-|''Click Meaning''''Circ/count the click as circulation''+|Host| Gutenberg| 
-|''Date Added''''MM/DD/YYYY''+|Path| /| 
-|''Host''''Gutenberg''+|Filename| .zip filename ((Will auto-update after the book/magazine has been recognized by Gutenberg.))| 
-|''Path''''/''+|URL| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))| 
-|''Filename''(leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))| +|File Size| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))| 
-|''URL''| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))| +|Playing Time| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))|
-|''File Size''| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))| +
-|''Playing Time''| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))|+
  
 +=== Magazines ===
 +
 +^ Field      ^ Data      ^
 +|Issue Name|YYYY_MM|
 +|Short Desc.|YYYY_MM|
 +|Description|NLS Audio compressed file|
 +|Seq|##|
 +|File Type| Zip/application/zip|
 +|Click Meaning| Circ/count the click as circulation|
 +|Date Added| (Auto-generated)|
 +|Host| Gutenberg|
 +|Path| /|
 +|Filename| .zip filename((Will auto-update after the book/magazine has been recognized by Gutenberg.))|
 +|URL| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))|
 +|File Size| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))|
 +|Playing Time| (leave blank)((Will auto-populate after the book/magazine has been recognized by Gutenberg.))|
  
  
  
preparing_books_and_magazines_for_use_with_gutenberg_and_klas_uids_e-documents.1631032116.txt.gz · Last modified: 2021/09/07 12:28 by mn1a