Skip to main content
ExLibris

Knowledge Assistant

BETA
 
  • Subscribe by RSS
  • Back
    Alma

     

    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. Alma
    3. Implementation and Migration
    4. Migration Guides and Tutorials
    5. ERM to Alma Data Delivery Specification (Generic)

    ERM to Alma Data Delivery Specification (Generic)

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1. Licenses
        1. Further explanations
      1. License Terms and Types
    2. Interfaces (Vendor Access/Admin Data)
    3. ERM Linking Prerequisite: Identifying E-Inventory
      1. Identifying the match point for e-inventory
        1. E-resources from SFX
        2. Retreiving SFX resource identifiers using exported files
        3. E-resources from the E-Resource Activation Form
        4. E-resources which were transformed using P2E
    4. E-inventory Fields and Linking (ERM Linking)
      1. Matching Algorithm
    5. FTP Drop Point Delivery and Form
    If you want to migrate from an Electronic Resource Management system whose migration is not supported in the Ex Libris migration process, you may use this generic method.  All files described below must be provided in the format required for loading directly into Alma.  The migration team does not manipulate or otherwise fix data for this generic migration process.
    Migration from any ERM is supported if a premium migration package is purchased.
    Customers who have purchased the migration add-on must develop their own programs to generate the required XML files in the exact format required.  The XML files may be validated for structure against Ex Libris' XSDs for ERM (generic) migration.   The valid files are then submitted along with the test or cutover file deliveries, and subsequently processed and loaded to Alma by Ex Libris.
    Customers are reminded that XML files have special characters that are used for special purposes, for example the <, >, and & characters (there may be more).  These should be escaped as &lt;, &gt;, and &amp;.
    Ex Libris strongly recommends that cusotmers provide files to Ex Libris project staff early on in the process to make sure they are on the right track regarding file content and linking between entities.
    The potential scope for Generic ERM migration is separated into three main areas:
    • Licenses
    • Interfaces (Vendor-level administrative and access information)
    • E-inventory fields and linking (ERM linking)

    If desired, licenses or interfaces may be provided as standalone data.    The ERM linking form is primarily used to link e-inventory to licenses, so this form is only useful if licenses are provided.

    Licenses

    Licenses are implemented in Alma using the DLF-ERMI standard. The exchange format between your current ERM system licenses and Alma is via an XML format. Each license record is represented by a single output XML file and must be validated according to the data definition defined by Ex Libris.
    The output XML files provided must be validated according to the ERM License XSD.
    The following is the general structure of the license XML:
    • License details (core license attributes such as license code, start date, and vendor)
      The license code is the link between e-inventory and the license
    • Terms (the DLF-ERMI terms which represent the license terms) – non-repeatable
      Alma supports a fixed list of license terms, as listed in the XSD. The type of enumeration for the license terms is listed below in the License Terms and Types table.
    • Notes (repeatable)
    • License attachments (optional designation of related file attachments for the license)

    Further explanations

    Attachments: License attachments should be provided in a separate directory called 'attachments', on the same level as the license XMLs.  As indicated in the XSD, the attachments should be located in license/attachments/1/{license_code}.zip, under sequential folder, like 1, 2, 3, etc.  Example: attachments/1/LICCODE.zip, and all attachments for license with code LICCODE are in that zip. For negotiation_details the attachment will be located in license/negotiations/attachments/{license_code}_{member_code}.zip, under sequential folder. File name should be of format {unique_sequence_folder}/{filename}</xs:documentation>

    Amendments: as indicated in the license, there is field called 'parent_code'.  When that field is filled with a different license code, then the current license (the license that has the parent_code filled in) is considered an amendment.   In other words, an amendment is a license which has another license as its parent.

    Vendor as licensor: When a license is migrated to Alma, any vendor it lists is marked as a licensor. This makes it available to be a licensor for other licenses in Alma.

    Licensing Agent: In the XSD, the field licensing_agent should be an Alma vendor code.  This field is not mandatory.

    License Terms and Types

    In the following table, the enumeration type is one of the following.
    • LicenseTermsYesNo = Yes, No
    • LicenseTermsPermittedProhibited = Prohibited, Permitted, Silent
    • LicenseTermsUOM = CALENDARDAY, BUSINESSDAY, WEEK or free text
    • FREE-TEXT = note field
    License Term License Term Code Type of Enumeration

    Accessibility Compliance Indicator

    ACCESSIBILITY

    LicenseTermsYesNo

    All Rights Reserved Indicator

    ALLRIGHTS

    LicenseTermsYesNo

    Applicable Copyright Law

    APPCLAW

    FREE-TEXT

    Archiving Right

    ARCHIVE

    LicenseTermsYesNo

    Archiving Format

    ARCHIVEFMT

    FREE-TEXT

    Archiving Note

    ARCHIVEN

    FREE-TEXT

    Authorized Users

    AUTHUSERDEF

    FREE-TEXT

    Citation Requirement Detail

    CITREQD

    FREE-TEXT

    Clickwrap Modification Clause Indicator

    CLICKWRAPI

    LicenseTermsYesNo

    Completeness of Content Clause Indicator

    COMPLETENESSI

    LicenseTermsYesNo

    Concurrency with Print Version Clause Indicator

    CONCURRPRINTI

    LicenseTermsYesNo

    Concurrent Users

    CONCURUSER

    FREE-TEXT

    Concurrent Users Note

    CONCURUSERN

    FREE-TEXT

    Confidentiality of Agreement

    CONFA

    FREE-TEXT

    Confidentiality of Agreement Note

    CONFAN

    FREE-TEXT

    Confidentiality of User Information Indicator

    CONFUSERI

    LicenseTermsYesNo

    Consortial Agreement Indicator

    CONSORTIALAGREEMENT

    LicenseTermsYesNo

    Content Warranty

    CONTWARR

    FREE-TEXT

    Course Pack Electronic

    COURSEPACKELEC

    LicenseTermsPermittedProhibited

    Course Pack Note

    COURSEPACKN

    FREE-TEXT

    Course Pack Print

    COURSEPACKPRINT

    LicenseTermsPermittedProhibited

    Course Reserve

    COURSERES

    LicenseTermsPermittedProhibited

    Course Reserve Note

    COURSERESNOTE

    FREE-TEXT

    Course Reserve Print

    COURSERESPRINT 

    LicenseTermsPermittedProhibited

    Cure Period for Breach (Number)

    CUREBREACH

    FREE-TEXT

    Cure Period for Breach (Unit)

    CUREBREACHUOM

    LicenseTermsUOM

    Database Protection Override Clause Indicator

    DATAPROTOVERC

    LicenseTermsYesNo

    Digitally Copy

    DIGCOPY

    LicenseTermsPermittedProhibited

    Digitally Copy Note

    DIGCOPYN

    FREE-TEXT

    Distance Learning

    DISTANCE

    LicenseTermsPermittedProhibited

    Distance Learning Note

    DISTANCEN

    FREE-TEXT

    Electronic Link

    ELECLINK

    LicenseTermsPermittedProhibited

    Electronic Link Note

    ELECLINKNOTE

    FREE-TEXT

    Fair Use Clause Indicator

    FAIRUSE

    LicenseTermsYesNo

    Governing Jurisdiction

    GOVJUR

    FREE-TEXT

    Governing Law

    GOVLAW

    FREE-TEXT

    ILL Electronic (email)

    ILLELEC

    LicenseTermsPermittedProhibited

    ILL Record Keeping Note

    ILLN

    FREE-TEXT

    ILL General

    ILLPRINTFAX

    LicenseTermsPermittedProhibited

    ILL Record Keeping

    ILLRKRI

    LicenseTermsYesNo

    ILL Secure Electronic

    ILLSET

    LicenseTermsPermittedProhibited

    Incorporation of Images Figures and Tables Note

    IMAGESNOTE

    FREE-TEXT

    Incorporation of Images Figures and Tables Right

    IMAGESRIGHT

    LicenseTermsPermittedProhibited

    Indemnification by Licensee Clause

    INDEMLEEC

    FREE-TEXT

    Indemnification by Licensor Clause

    INDEMLORC

    FREE-TEXT

    Indemnification Note

    INDEMN

    FREE-TEXT

    Intellectual Property Warranty Indicator

    IPWARRI

    LicenseTermsYesNo

    License Replaced By

    LICENSREPLACEDBY

    FREE-TEXT

    License Replaces

    LICENSEREPLACES

    FREE-TEXT

    Licenses Reviewer Note

    LICENSEREVIEWERNOTE

    FREE-TEXT

    Local Authorized Users 

    LAUTHUSERDEF

    FREE-TEXT

    Licensee Notice Period for Termination (Number)

    LEENOTICE

    FREE-TEXT

    Licensee Notice Period for Termination (Unit)

    LEENOTICEUOM

    LicenseTermsUOM

    Licensee Termination Condition

    LEETERMCON

    FREE-TEXT

    Licensee Termination Right

    LEETERMRIGHT

    LicenseTermsYesNo

    Licensor Notice Period for Termination (Number)

    LORNOTICE

    FREE-TEXT

    Licensor Notice Period for Termination (Unit)

    LORNOTICEUOM

    LicenseTermsUOM

    Licensor Termination Condition

    LORTERMCON

    FREE-TEXT

    Licensor Termination Right

    LORTERMRIGHT

    FREE-TEXT

    Maintenance Window

    MAINTWIN

    FREE-TEXT

    Non-Renewal Notice Period (Number)

    NONRNOTICE

    FREE-TEXT

    Non-Renewal Notice Period (Unit)

    NONRNOTICEUOM

    LicenseTermsUOM

    Other User Restriction

    OTHERUSERRSTRN

    FREE-TEXT

    Other Use Restrictions (Staff Note)

    OTHERUSERSTRN

    FREE-TEXT

    Performance Warranty Indicator

    PERFWARRIND

    LicenseTermsYesNo

    Performance Warranty Uptime Guarantee

    PERWARRUPTIME

    FREE-TEXT

    Perpetual Access Right

    PERPETUAL

    LicenseTermsYesNo

    Perpetual Access Holdings

    PERPETUALH

    FREE-TEXT

    Perpetual Access Note

    PERPETUALN

    FREE-TEXT

    Pooled Concurrent Users

    PCONCURUSER

    NUMERIC

    Print Copy

    PRINTCOPY

    LicenseTermsPermittedProhibited

    Print Copy Note

    PRINTCOPYN

    FREE-TEXT

    Remote Access

    REMOTE

    LicenseTermsYesNo

    Renewal Type

    RENEWTYPE

    FREE-TEXT

    Scholarly Sharing

    SCHOLSHARE

    LicenseTermsPermittedProhibited

    Scholarly Sharing Note

    SCHOLSHAREN

    FREE-TEXT

    Termination Requirements

    TERMREQS

    FREE-TEXT

    Termination Requirements Note

    TERMREQSN

    FREE-TEXT

    Termination Right Note

    TERMRIGHTN

    FREE-TEXT

    UCITA Override Clause Indicator

    UCITAOVERI

    LicenseTermsYesNo

    Usage Data Set Up Status

    USAGEDATASETUPSTATUS

    FREE-TEXT

    Walk-In User Term Note

    WALKIN

    FREE-TEXT

     

    If you cannot find a license term type, it is possible to add a new one.  For more information, see Managing License Term Types.  You can add the new term before or after loading the xml.

    Interfaces (Vendor Access/Admin Data)

    Interfaces are attached to the vendor record in Alma.  They generally provide connection information for all e-resources attached to the interface.  Inventory which is connected to the CZ is automatically connected to a CZ-controlled vendor interface.  The list of vendor interfaces provided by Alma can be found here.
    If you have local e-inventory with a shared access mechanism, you may provide interface information in XML files described in this section.  This is relatively uncommon since most e-inventory is linked to the CZ. 
    It is not recommended to provide interface records if your admin, access, and/or statistical information is e-inventory (package or portfolio) specific, since Alma’s design intends the interface record to be encompassing across all packages and constituents it serves. In such cases, it is recommended instead to provide additional e-inventory level notes via the E-inventory fields and linking Excel file noted in E-inventory Fields and Linking.
    When an interface is migrated to Alma, it and all of its related field information is linked to a vendor in Alma. The vendor is then marked as an access provider, which makes it available for use by packages or standalone portfolios.
    Interfaces are implemented in Alma as a vendor sub-attribute. The exchange format between your current ERM system interfaces and Alma is via an XML format. Each vendor record is represented by a single output xml file. One or more interface records may be represented in each vendor XML file provided. These XML files must be validated according to the data definition defined by Ex Libris.
    The output XML files provided must be validated according to the Vendor Interface XSD.
    The following is the structure of the vendor interface XML:
    • Vendor / Vendor account details (core vendor/vendor account attributes such as codes and names)
      The vendor code is mandatory. It is used to match the vendor code loaded from your ILS. If the vendor codes match, the details from the vendor are ignored, and ONLY the interface section is added to Alma. If the vendor code does not match any ILS vendor code, the vendor information is loaded. In this case, the vendor account is also mandatory.
    • Contact information/Contact persons - Optional
      Do not enter valid email addresses for vendors during the testing period to prevent emails from being sent to the vendors. Common practice is to put the word SCRUBBED in the email address, for example, vendor.name@SCRUBBED_vendor.com.
    • Interface list (one or more interfaces)
      The interface name is the match key to match e- inventory to your vendor interface records. Each specific interface name must be unique across ALL interface names in your institution.
    • Admin fields
    • Access fields
    • Statistics fields
    • Notes (repeatable)

    ERM Linking Prerequisite: Identifying E-Inventory

    After you have created licenses and/or vendor interfaces, you may wish to link them to your e-inventory.
    E-inventory can come from multiple places: SFX, 360Link, the E-Resource Activation Form, or p2e (an ILS bib record which has been converted to electronic). If the data from SFX is represented in your local ERM it must be active.  
    Identify which electronic inventory record (and in some cases which order record) to enrich with ERM data. This will be done by populating an Excel sheet which contains relevant ERM e-product and related e-product fields (one e-product is listed per row). The enrichment process includes the following:
    • Linking the license to the e-resource
    • Linking the interface to the e-resource
    • Enriching the e-resource with ERM e-resource fields
    • Enriching ILS-originated orders with ERM Acquisition record fields. 
    Relevant e-resources for which information migrates include the following:
    • Packages
    • Portfolios (standalone only)
    • Databases (zero title)
    It is not recommended to provide ERM enrichment information for large amounts of portfolios that are part of a package or managed as a group in an e-collection. If the ILS has bibliographic records for individual portfolios that are part of a larger package, it is recommended to start managing these resources at the package level in Alma, rather than the portfolio level. Post-migration, you can associate the standalone portfolios that were created as a result of the p2e process with the package (local e-collection) in Alma. The advantages of managing resources at the package level are that any information about the package that changes will affect all resources, such as license and access information. You need only manage this information once at the package level instead of multiple times at the portfolio level.
    Ex Libris migrates your acquisitions data only if this service was purchased by your institution and is stipulated in your contract with Ex Libris.

    Identifying the match point for e-inventory

    E-resources from SFX

    !!  After you determine the resource's identifier, add '61' to the beginning of the string. !!

    Collections

    In SFX, the identifier needed for collections is listed here is 111095969632000, as shown in the image below.

    clipboard_ec1a36dfbaea01a99e8a275a444c6298a.png

    In the exported xml, this is in 866 $t

      <datafield tag="866" ind1="" ind2="">
       <subfield code="a">Available from 2010 volume: 13 issue: 1. </subfield>
       <subfield code="s">111095969632001</subfield>
       <subfield code="t">111095969632000</subfield>
       <subfield code="x">Mary Ann Liebert Online Subscription:Full Text</subfield>
       <subfield code="z">2500000000002129</subfield>
      <subfield code="11">0</subfield>
      <subfield code="1">N</subfield>
      </datafield>
     </record>

    The final identifier to put in the form is '61' + what is above, so 61111095969632000

    Portfolios

    In SFX, the identifier needed for portfolios can be found here, on the Additional details tab.

    clipboard_ea17fc9f674eb27d1b68d339e37b75f1a.png

    It can be found in the exported record, in subfield $z.

      <datafield tag="866" ind1="" ind2="">
       <subfield code="a">Available from 1973 volume: 1 issue: 1. </subfield>
       <subfield code="s">111016833201001</subfield>
       <subfield code="t">111016833201000</subfield>
       <subfield code="x">Ejournal Publishers:Full Text</subfield>
       <subfield code="z">1000000000672864</subfield>
      <subfield code="1">N</subfield>
      <subfield code="11">0</subfield>

    The final identifier to put in the form is '61' + what is above, so 611000000000672864.

    Retreiving SFX resource identifiers using exported files
    There are multiple methods to export information from SFX, as described in the SFX Advanced User's Guide.
    However, you may also consult the files that are exported specifically for import to Alma.  For information on these files, see the SFX to Alma AutoExtract Migration Guide.
    In the exported XML files, as mentioned above, there is an 866 field which contains information about the package and portfolio.
     - portfolio:  the value from 866 $z
     - collection: the value from 866 $t
    In the Excel form, use 'sfx_id' for the match_id column, the value indicated above in the sfx_id column, and either PORTFOLIO or PACKAGE in the resource_type column.

      <datafield tag="866" ind1="" ind2="">

       <subfield code="a">Available from 2015. </subfield>

       <subfield code="s">111016833201001</subfield>

       <subfield code="t">111016833201000</subfield>

       <subfield code="x">Ejournal Publishers:Full Text</subfield>

       <subfield code="z">111030366935000</subfield>

      <subfield code="11">0</subfield>

      <subfield code="1">N</subfield>

    The final identifier is '61' plus the above identifiers, so 

     - portfolio:  866 $z  --> 61111030366935000
     - collection:  866 $t --> 61111016833201000
    E-resources from the E-Resource Activation Form
    When you use the E-Resource Activation form, the only thing you can link is packages or databases (which are zero-title collections).
    To link a package or database from the E-Resource activation form, use the value in column A, like so:
    clipboard_e5d6a56f9d677ce0131bfcb66c1aaf3de.png
    If you need assistance to be able to see column A, contact your Ex Libris representative.
    In this case, the match_id column should say 'non_sfx_id', the sfx_id column should be 611000000000001464, and resource type column is PACKAGE.
    Resources on the DATABASE tab also use column A, but in this case the resource type column is DATABASE.
    E-resources which were transformed using P2E
    If you have resources which were managed in your previous ILS and they are coming to Alma as a bib record, which are then transformed to electronic using the p2e process, then resources should be listed this way: 
    The match_id column should say 'ils_bib_id', and the ils_bib_id column should contain the bib ID as it was in your former system.
    The resource_type column can be PORTFOLIO or DATABASE, whatever you listed for this bib in the p2e file.

    E-inventory Fields and Linking (ERM Linking)

    The primary function of the ERM Linking form is to link inventory to licenses. Additionally, customers may link e-inventory to vendor interfaces, and provide note information for e-inventory or related orders.
    Each inventory record is represented by a single row in the output Excel representing the relevant linking / field information. Best practice dictates that a row be provided only if the specific inventory record has its own unique information. For example, a license related to a package whose constituents inherit this license reference is not considered unique information for the portfolio constituent and is not a sufficient reason to add the portfolio constituent line in the Excel. Also, you may decide to omit specific fields of an e-product if those fields already exist elsewhere, even if the rest of the e-product information is migrated.
    A sample ERM linking form is provided from the Alma Migration Guides main page.  The form should contain all columns, even if they are empty.  Meaning, even if you are only providing information for 4 or 5 different columns, fill in those columns and leave the rest of the columns blank. 
    The process enriches relevant Alma e-inventory records with relevant fields and related license information, and optionally enriches related po_line information. In addition, it creates license related notes. Each Excel row line specifies matching criteria for an e-inventory record and optional po_line record.

    In the following table

    • The Alma note records linked to e-inventory become Inventory notes
    • The Alma note records linked to po_lines become Poline notes.
    Matching Algorithm

    If Excel.match_id is equal to sfx_id or non_sfx_id (non case sensivite) – use SFX Matching algorithm. 

    If the E-INVENTORY record is not found - use PO Matching algorithm.

    If the E-INVENTORY record is not found – use ILS Matching algorithm.

    If Excel.match_id is equal to po_id or poline_id (not case sensitive) – use PO Matching algorithm.
    If the E-INVENTORY record is not found – use ILS Matching algorithm.

    If Excel.match_id is equal to ils_bib_id (not case sensitive) – use ILS Matching algorithm.
     

    Fields

    Field name Description Alma location
    match_id

    MANDATORY
    Options:   sfx_id, poline_id, po_id,ils_bib_id, non_sfx_id 

    This represents the e-inventory id which will be enriched. That e-inventory may have originated in your SFX system or in your ILS system. If it originated in your ILS system, it may be determined via an order referencing that e-inventory or directly via a Bibliographic id.  The non_sfx_id is the Alma resource ID. 

     
    sfx_id

    Used by SFX Matching Algorithm. 

    ID from SFX (Target ID for Packages/E-collections or Portfolio ID for Portfolios) plus a prefix of '61';  Should be equal to the E-INVENTORY ORIGINATING_SYSTEM_ID for an sfx record.  If Poline is matched, the Process creates Poline note with text: “ERM Linking SFX orig id = <sfx_id>”

    Shoud be equal to HDEMETADATA.ORIGINATING_SYSTEM_ID for an sfx record. 

    As stated above, the SFX identifier found in SFX should be modified to have a prefix of '61'.

    poline_id Used by PO Matching Algorithm. Should be equal to PO_LINE.PO_LINE_REFERENCE.
    If poline_id is not empty, the process creates an Inventory note with text: “ERM Linking PO Line Ref = <poline_id>”
    The poline_id is stored in the E-INVENTORY POLINEID attribute
    This is the primary orderid to which the relevant information will be mapped. associated_po lines if provided will be related to the primary one.The primary should be considered the most recent open order.

    PO_LINE.PO_LINE_REFERENCE: This is the PO Line Number in PO Line screens: PO Line details

    po_id If provided, will match PO.PO_NUMBER and will automatically determine this order's electronic PO_LINE. Do not use if poline_id is provided. Should be equal to PO.PO_NUMBER 
    If po_id is not empty, the loader creates an Inventory note  with text: “"ERM Linking PO Num = <po_id>”  This is the PO  Number in PO Line that were packed: 
    PO Line details - PO number
    ils_bib_id

    Only relevant if no sfx_id (or poline_id/po_id) was provided

    This is the bib ID from your incoming ILS.

    Should be equal to MMS_RECORD.ORIGINATION_SYSTEM_ID

    PO Line list >> MMS_ID

    resource_type

    MANDATORY.  Possible values:   PACKAGE, DATABASE, PORTFOLIO

    This is used for:

    1. determining if the resource is a package or portfolio along with sfx_id
    or
    2. determining if the resource is a DATABASE, in case the resource did not have an sfx_id, and instead an ils_bib_id was provided.

     

    associated_poline_id Will match the PO_LINE_REFERENCE in Alma

    Multiple associated_poline_ids may be passed with comma separation and will relate to the primary poline_id. 
     
    associated_po_id Will match PO.PO_NUMBER and will automatically determine this order's electronic POL witihn Alma. Do not use if asociated_poline_id was populated.  
    interface_id Interface name from Alma Interface List

    The interface_id is the name, for example 'ACM Digital Library'
    If matched E-INVENTORY is an e-collection/package , store interface_id in Package.INTERFACEPUBLICNAME;
    If matched E-INVENTORY is of type PORTFOLIO, store interface_id in Package.VENDORNAME of corresponding e-collection/package record.
    license_id Matches the LICENSE.CODE in Alma

    The process looks for Alma LICENSE where LICENSE.CODE = excel.license_id
    If found:
     if matching E-INVENTORY is  E-Collection/Package – store Alma LICENSE.ID as Package.LICENSEID; store <start_date> as Package.LICENSESTARTDATE
      if Alma LICENSE.LICENSE_BEGINS is defined use it as <start_date>,  otherwise use current data as <start_date>
      if matching E-INVENTORY is PORTFOLIO  - store Alma LICENSE.ID as  Portfolio.LICENSEID; store <start_date>  Portfolio.LICENSESTARTDATE;


     License details >> Start date

    original_resource_id For potential matches in future - the key used to match the e-inventory in the ERM system. If original_resource_id is not empty:
    Inventory note is created with content “ERM Linking original resource id = <original_resource_id>”
    If Poline is matched, Poline note is created with content “ERM Linking original resource id = <original_resource_id>”
    pol_subscr_start_date Subscription start date for E-subscription orders in format: YYYYMMDD

    If PO_LINE record is matched,
      The process stores pol_subscr_start_date in PO_LINE.  SUBSCRIPTION_FROM_DATE,
    otherwise Inventory Note with text: “pol_subscr_start_date:<the column content>” is created.

    This is the Subscription from date in Continuous PO Lines screen:PO Line details >> Summary tab >> Subscription from date

    pol_subscr_end_date Subscription end date for E-subscription orders in format: YYYYMMDD
    Important note: Filling this field and providing a pol_id or po_id will set the actual order subscription end date. In Alma, this field will cause automatic closure of the order when passed.

    If PO_LINE record is matched,
      The process stores pol_subscr_end_date in PO_LINE.  SUBSCRIPTION_END_DATE,
    otherwise Inventory Note with text: “pol_subscr_end_date:<the column content>” is created.

    This is the Subscription to date in Continuous PO Lines screen:PO Line details >> Summary tab >> Subscription to date

    pol_renewal_date Next date to renew the E-subscription in format: YYYYMMDD

    If PO_LINE record is matched,
    the process stores pol_renewal_date in PO_LINE. RENEWAL_DATE,
    otherwise Inventory Note with text: “pol_renewal_date:<the column content>” is created.

    This is the renewal date in Continuous PO Lines screen:PO Line details >> Summary tab >> Renewal date

    pol_renewal_reminder Numeric (days). The number of days before which the order, if matched, will appear in Alma's renewal task list.

    If PO_LINE record is matched,
      the process stores pol_renewal_reminder in PO_LINE. RENEWAL_REMINDER_PERIOD,
    otherwise Inventory Note with text: “pol_renewal_reminder:<the column content>” is created.

    This is the Renewal reminder period (days) in Continuous PO Lines screen:PO Line details >> Summary tab >>  Renewal reminder period (days)

    vendor_reference_number Text

    If PO_LINE record is matched,
      The process stores pol_renewal_date in PO_LINE. VENDOR_REFERENCE_NUMBER,
    otherwise Inventory Note with text: “vendor_reference_number:<the column content>” is created.

    This is the  Vendor reference number in PO Lines screen:PO Line details >> Summary tab >>   Vendor reference number

    pol_note_code_1 Text  
    pol_note_value_1 Text  
    pol_note_code_x and pol_note_value_x up through 200 Up to 200 pairs of columns pol_note_code_<num>, pol_note_value_<num> can be defined.
    For each pair of pol_node_code_<num>, pol_node_value_<num> columns:
    If PO_LINE record is matched, Poline note is created with content
    <CODE>:<VALUE> where <CODE> comes from pol_note_code_<num> and <VALUE> comes from pol_note_value_<num>
    If PO_LINE record is not matched, Inventory note with the same text is created.
     
    inv_note_code_1 Text  
    inv_note_value_1 Text  
    inv_note_code_x and inv_note_value_x up though 200 Up to 200 pairs of columns inv_note_code_<num>, inv_note_value_<num> can be defined.
    For each pair of inv_node_code_<num>, inv_node_value_<num> columns:
    Inventory note is created with content
    <CODE>:<VALUE> where <CODE> comes from inv_note_code_<num> and <VALUE> comes from inv_note_value_<num>.
     
    aggregator Enum: 0, 1
    (0 = Selective,1 = Aggregator)
    Only relevant for non-SFX packages
    Stored in Package.AGGREGATOR. Not visible in Acq
    active (not processed)  
    db_source Text
    Used in conjunction with db_source_id

    Stored in Package.SOURCE

    Not visible in Acq

    db_source_id Text
    Used in conjunction with db_source

    Stored in PackageEntityIECKB.SOURCEID

    Not visible in Acq

    id_type Text

    Stored in InternalIdentifier.INTERNALIDENTIFIERTYPE

    Not visible in Acq

    id_value Text

    Stored in InternalIdentifier.INTERNALIDENTIFIERVALUE

    Not visible in Acq

    is_free Boolean
    Only relevant for non-SFX e-products

    Stored in Package.ISFREE

    Not visible in Acq

    embargo_operator ENUM: &lt/&gt
    Only relevant for non-SFX e-products

    Stored in MovingwallInventory.OPERATOR

    Not visible in Acq

    embargo_month Numeric (# of months)
    Only relevant for non-SFX e-products

    Stored in MovingwallInventory.MONTH

    Not visible in Acq

     

    coverage_from_year Numeric (YYYY)
    Only relevant for non-SFX e-products

    Stored in DateInfoInventory.FROMYEAR

    Not visible in Acq

    coverage_from_month Numeric (MM)
    Only relevant for non-SFX e-products
     
    coverage_from_day Numeric (DD)
    Only relevant for non-SFX e-products
     
    coverage_to_year Numeric (YYYY)
    Only relevant for non-SFX e-products

    Stored in DateInfoInventory.TOYEAR

    Not visible in Acq

    coverage_to_month Numeric (MM)
    Only relevant for non-SFX e-products
     
    coverage_to_day Numeric (DD)
    Only relevant for non-SFX e-products
     
    coverage_from_vol Numeric
    Only relevant for non-SFX e-products

    Stored in DateInfoInventory.FROMVOLUME

    Not visible in Acq

    coverage_to_vol Numeric
    Only relevant for non-SFX e-products

    Stored in DateInfoInventory.TOVOLUME

    Not visible in Acq

    coverage_from_issue Numeric
    Only relevant for non-SFX e-products

    Stored in DateInfoInventory.FROMISSUE

    Not visible in Acq

    coverage_to_issue Numeric
    Only relevant for non-SFX e-products

    Stored in DateInfoInventory.TOISSUE

    Not visible in Acq

    public_note Text

    if matched E-INVENTORY is E-COLLECTION (PACKAGE or DATABASE)
      stored in Package.PUBLICNOTE;
    if matched E-INVENTORY is PORTFOLIO 
     store in  Portfolio.GENERALNOTE;

    Not visible in Acq

    cancellation_restriction Text If PO_LINE is matched
      If the column contains yes (case ignored) – set PO_LINE.CANCEL_RESTRICTION to true
      If the column contains no (case ignored) – set
    PO_LINE.CANCEL_RESTRICTION to false
    cancellation_restriction_note Text

    If PO_LINE is matched
      Stored in PO_LINE.CANCEL_RESTRICTION_NOTE

    This is the  Cancellation restriction note in PO Lines screen: PO Line details >> Summary tab >>   Cancellation restriction note

    access_type Text If matched E-INVENTORY is of type E-COLLECTION (PACKAGE or DATABASE)) and access_type is not empty:
      if access_type is "perpetual" (ignore case)
            store “perpetual” in  PackageEntityIEInventory.ACCESSTYPE
          else store “current” in  PackageEntityIEInventory.ACCESSTYPE
             add PackageEntityIEInventory.ACCESSTYPE = "current"
    cross_ref Boolean
    Only relevant for non-SFX e-products

    Stored in Dnx.PackageEntityServiceInventory.CROSSREFENABLED

    Not visible in Acq

    activate_from YYYYMMDD
    Only relevant for non-SFX e-products

    Stored in Dnx.PackageEntityServiceInventory.ACTIVATEFROM

    Not visible in Acq

    activate_to YYYYMMDD
    Only relevant for non-SFX e-products

    Stored in Dnx.PackageEntityServiceInventory.ACTIVATETO

    Not visible in Acq

    auto_active Boolean
    Only relevant for non-SFX e-products

    Stored in Dnx.PackageEntityServiceInventory.AUTOACTIVE

    Not visible in Acq

    service_down_reason Text

    Stored in Dnx.PackageEntityServiceInventory.SITEDOWNREASON

    Not visible in Acq

    FTP Drop Point Delivery and Form

    Each time data files are provided to Ex Libris in the formats indicated in the specification section above, place them on the MFT server specified to you by your Ex Libris project manager.
    The following is the default naming convention:
    CustomerName+DataType+sequence+date+[.<file_extension>].
    For example: centralu_bib_01_20200420.mrc, centralu_bib_02_20200420.mrc, centralu_bib_03_20200420.mrc, etc.
    Additionally, provide the 360 and Intota Migration Form along with your data.
    View article in the Exlibris Knowledge Center
    1. Back to top
      • Electronic Resource Migration Overview
      • Extracting Records from Millennium and Sierra (III) for Migration to Alma
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Content Type
      Documentation
      Language
      English
      Product
      Alma
    2. Tags
      This page has no tags.
    1. © Copyright 2025 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved