Order Data Mapping: Aleph to Alma

Purpose:  This page describes data value crosswalks and data element mapping for the migration of Order data from Aleph to Alma.  This video from ExLibris provides instructions to complete the migration form that we need to complete prior to the automated migration of Aleph data to Alma.  The decisions we'll need to make about order data migration are outlined on this page.



Alma Order Structure

In Alma, all orders (PO line/s) are grouped into a PO (purchase order). In Aleph, there may be one (or more) orders per bibliographic record. Based on this structure, the migration creates a PO and a PO line for each Aleph order (Z68) and enriches the order with any Z16 subscription linked to it.

In addition, subscriptions from Aleph's Z16 (subscriptions) with no order reference and still active will be migrated as basic Alma orders since subscriptions are implemented as orders in Alma. It is recommended that Z16 active subscriptions are linked to Z68 orders prior to migration in Aleph as not doing so will yield Alma orders which, although will be waiting for renewal status upon migration, will require additional manual handling post-migration in order to continue working with those orders (for instance requiring adding mandatory funding and copies information which isn't managed on the Z16-level in Aleph, but is mandatory in Alma).



Crosswalks: Aleph code values to Alma code values

The following sections describe the crosswalk of Aleph code values for key order data elements to the target Alma code value.


 Ordering Unit

Ordering Unit

According to the Aleph to Alma migration guide, Aleph Ordering units are treated by the migration as regular libraries (sublibraries). Relationships can be determined in Alma configuration to set the relevant libraries these ordering units serve. This mapping enables them to migrate our ordering units by their associated sub-libraries. If an ordering unit is not mapped, it is used as is and becomes an Alma library, like all other Alma libraries. The concept of ordering units doesn't exist in Alma.

Crosswalk

Aleph Ordering UnitAlma Library
FORDOFORD
LAWOLAW
MCLOMCL
PERKOPERKN
 Method of Acquisition

Method of Acquisition

Notes: Alma doesn't support adding, editing, or deleting Acquisition Methods. For each acquisition method, there are two records, one that sends a letter to the vendor and one that does not. By default, one of each is disabled.  These may be enabled to display both options in the Acquisition method drop-down box in the Purchase Order Line Details.  See Configuring Acquisition Methods for more information.

We will need to decide which values to enable, decide on the "Description" labels that are seen by users, and choose a default value. The screenshot below shows the screen where we can configure those values.


Crosswalk

Aleph Method of AcquisitionDescription

Count 6/28/23

Alma Acquisition Method


Behavior in Alma

Approval574,556 Approval PlanOrder will not be sent to the vendor, invoice expected (Pricing and fund information mandatory)
Purchase477,360 Purchase at Vendor SystemOrder will not be sent to the vendor, invoice expected (Pricing and fund information mandatory); use with direct ordering such as from Amazon/independent booksellers/publishers
Gift60,701 GiftOrder will not be sent to the vendor, no invoice expected (Pricing and fund information optional)
Credit Card28,858 Purchase at Vendor Systemsee description above
DPDelayed Publication3,890 Purchase at Vendor Systemsee description above
STSublibrary Transfer2,108 Giftsee description above
Exchange1,225 Exchange

(i.e. received on exchange) - order will not be sent to the vendor, invoice not expected (Pricing and fund information optional)

Membership1,212 Purchase at Vendor Systemsee description above
PKPackage1,202 Purchase at Vendor Systemsee description above
Proforma891 Purchase at Vendor Systemsee description above
SCShared Collections839 Purchase at Vendor Systemsee description above
PFFree772 Technical

Order will not be sent to the vendor, invoice not expected (Pricing and fund information optional).

  • Use technical for any order that does not need to be sent to the vendor and that does not fit into the other categories.
  • This can be used for membership payment, series standing order payment, payment of materials sent on exchange, etc.
Other347 Technicalsee description above
Deposit252 Depository(for government depository items) Order will not be sent to the vendor, invoice not expected (Pricing and fund information optional)
Prepaid152 Purchase at Vendor Systemsee description above
Transfer SCL ONLY10 Giftsee description above
Null-45 Purchase at Vendor Systemsee description above
 Order Type and Order Material Type

Order Type and Order Material Type

There isn't a direct parallel to the Aleph Order Type in Alma.  The Alma PO Line Type (also referred to as "Order type") is used to identify the order type and the out-of-the-box automated migration from Aleph uses the crosswalk listed in the three-row table below. If this set of three values isn't granular enough for our needs, there are 38 PO Line Type values available in Alma since they fold in material type. 


 Background information

Out of the box/default crosswalk - if we don't define anything on the migration form, these are the PO Line types that are assigned:

Aleph Order TypeAlma Default values used by automated migration
MPRINTED_BOOK_OT
SPRINTED_JOURNAL_CO
OPRINTED_BOOK_SO


The migration form comes pre-loaded with a list of order types that we can crosswalk to.  In this list, CO = Continuous, SO = Standing order, OT = One time

The following order types behave like serials and receive like serials:

  • PRINT_CO
  • PRINT_SO_NONMON

The following order types behave like one-time orders and receive like one-time orders

  • PRINTED_BOOK_OT
  • PRINT_OT

The following order types behave like monographic series standing orders and do not receive via Alma's receiving workbench

  • PRINTED_BOOK_SO
  • PRINT_SO

The following order types are intended for one-time and ongoing services - not related to inventory:

  • OTHER_SERVICES_OT
  • OTHER_SERVICES_CO

PRINTED_JOURNAL_CO = 'Print Journal - Subscription'

  • Use for journal subscriptions.  A continuous order may be received and invoiced on many times; it remains open until actively closed.  A continuous order is attached to a holdings record.

PRINTED_JOURNAL_OT = 'Print Journal - One Time

  • One-time purchase of a physical journal issue.

Chana from EL's comments about this crosswalk from 10/6: "What's most important for Alma's acquisition workflow is whether an order is continuous, one-time or standing, and the format of electronic or physical. In the migration form you will only see the physical acquisition types for book, journal or physical item and only whether continuous, standing or one-time. You also see a type of services which are for orders without inventory. For orders connected to electronic inventory, they will be converted to electronic acquisition types as part of the P2E process, so you would pick the physical order type equivalent. We haven't talked fully about the P2E process, but there is a table in the P2E guide so that you can see how the physical order will be converted to an electronic order type. "

Here's the table from the P2E guide that Chana referenced:


 Alma PO Line Types

We will likely use a small subset of these values. To see examples from other institutions (Harvard, SUNY-Binghamton, CARLI), check out this spreadsheet - open the "Alma PO Line Types tab" to see the usage of each value.

Alma PO Line TypesContinuityInventory TypeDo we want to use this value? Draft review 2/20/24
Access Service - SubscriptionContinuousGenericYes - use for annual access fees (ongoing)
Database Service - One TimeOne-timeGeneric
Digital - Non ArchivingOne-timeGeneric
Digital - One Time


Digital - Subscription


Electronic Book - One TimeOne-timeElectronic
Electronic Book - Standing OrderStanding OrderElectronic
Electronic Book - SubscriptionContinuousElectronic
Electronic Collection - One TimeOne-timeElectronic
Electronic Collection - SubscriptionContinuousElectronic
Electronic Journal - One TimeOne-timeElectronic
Electronic Journal - SubscriptionContinuousElectronic
Electronic Title - One TimeOne-timeElectronic
Electronic Title - Standing OrderStanding OrderElectronic
Electronic Title - SubscriptionContinuousElectronic
License UpgradeOne-timeElectronic
ManuscriptOne-timePhysical
MapOne-timePhysical
MicroformOne-timePhysical
Mixed MaterialOne-timePhysical
Musical ScoreOne-timePhysical
Other Service - One TimeOne-timeGeneric
Other Service - SubscriptionContinuousGeneric
Physical - ArchivingOne-timeGeneric
Physical - One TimeOne-timePhysicalYes
Physical - Standing Order MonographStanding OrderPhysicalYes
Physical - Standing Order Non MonographStanding OrderPhysicalYes (for serials standing orders)
Physical - SubscriptionContinuousPhysicalYes
Physical Computer File - One TimeOne-timePhysical
Physical Computer File - SubscriptionContinuousPhysical
Print Book - One TimeOne-timePhysical
Print Book - Standing OrderStanding OrderPhysical
Print Journal - One TimeOne-timePhysical
Print Journal - SubscriptionContinuousPhysical
Remote Computer File - One TimeOne-timeElectronic
Remote Computer File - SubscriptionContinuousElectronic
Sound RecordingOne-timePhysical
Visual MaterialOne-timePhysical
 Crosswalk of Order Type and Order Material Type

The Aleph record counts from June 2023 are from the Aleph Production environment.

Order TypeAleph Order Material TypeDescriptionCount (6/28/23)

Target Alma PO Line Type

(must choose either print or other for the initial migration)

Expected Alma PO Line Type after P2E for Electronic orders - this is a best guess

MAV123 

PRINT_OT

Print One-Time

MABAudio Book11 PRINT_OTPrint One-Time
MAFAnnual Access Fee10 OTHER_SERVICES_OTOther Service One-Time
MBOOK645,128 PRINTED_BOOK_OTPrint Book One-Time
MBGBoard GamePRINT_OT Print One-Time
MMFICH42 PRINT_OTPrint One-Time
MDVD31,182 PRINT_OTPrint One-Time
MDBDatabase515 PRINT_OTE-Collection One-Time
MDDDIGITAL DEVICE45 PRINT_OTElectronic One-Time
MDSData and DatasetsPRINT_OTPrint One-Time
MDBASE405 PRINT_OTE-Collection One-Time
MEBELECTRONIC BOOK87,879 PRINTED_BOOK_OTElectronic Book One-Time
MEJELECTRONIC JOURNAL93 PRINTED_JOURNAL_OTElectronic Title One-Time
MESELECTRONIC SERIAL21 PRINTED_JOURNAL_OTElectronic Title One-Time
MFILM36 PRINT_OTPrint One-Time
MFEMiscellaneous Fee61 OTHER_SERVICES_OTOther Service One-Time
MCONTINUATION40 PRINTED_JOURNAL_OTPrint Journal One-Time
MPAM22 PRINTED_BOOK_OTPrint Book One-Time
MISSUE875 PRINTED_JOURNAL_OTPrint Journal One-Time
MPRINT JOURNAL27 PRINTED_JOURNAL_OTPrint Journal One-Time
MCFILE106 PRINT_OT
MMFILM309 PRINT_OT
MMFORM307 PRINT_OT
MMCMiscellaneous CreditOTHER_SERVICES_OT
MMRMARC RECORDS66 OTHER_SERVICES_OT
MMSMonographic Series29 PRINTED_BOOK_OTPrint Book One-Time
MMSS1,614 PRINT_OT (Note: Would like to consider as a dedicated order type - talk to Johnny and Meghan)
MN3Electronic Newspaper11 PRINTED_JOURNAL_OTPrint Journal One-Time
MNENewspaper11 PRINTED_JOURNAL_OTPrint Journal One-Time
MCDROM383 PRINT_OT
MOAOPEN ACCESS15 PRINT_OT
MMAP746 PRINT_OT
MPBPrint Book267,226 PRINTED_BOOK_OTPrint Book One-Time
MPEPrint and Electronic JournalPRINTED_JOURNAL_OTPrint Journal One-Time
MPJPrint Journal235 PRINTED_JOURNAL_OTPrint Journal One-Time
MPSPrint serial412 PRINTED_JOURNAL_OTPrint Journal One-Time
MCDREC13,772 PRINT_OTPrint One-Time
MR2Print and Electronic SerialPRINTED_JOURNAL_OTPrint Journal One-Time
MSCORE25,445 PRINT_OTPrint One-Time
MSEELECTRONIC RECORD SCL ONLYPRINT_OT (talk to Johnny and Meghan)
MSMSTREAMING MEDIA261 PRINT_OT
MSTSets22 PRINTED_BOOK_OTPrint Book One-Time
MSVVISUAL MATERIAL SCL ONLY52 PRINT_OT (talk to Johnny and Meghan)
MTHES101 PRINTED_BOOK_OTPrint Book One-Time
MT3Electronic SetsPRINTED_BOOK_OT
MBOOKS ON CD3,125 PRINT_OTPrint One-Time
MVIDEO864 PRINT_OTPrint One-Time
MV3Streaming Video224 PRINT_OT
MP+ELEC JOURNALPRINTED_JOURNAL_OT
ME JOURNAL128 PRINTED_JOURNAL_OTElectronic Title One-Time
M
NULL946 PRINT_OT - See the list of these: https://duke.box.com/s/i41bl2is7cddxcpiclxe5q51yxlylyy7Print One-Time
OAFAnnual Access FeeOTHER_SERVICES_COOther Service - Subscription
OBOOK6,522 PRINTED_BOOK_SOSTOPPED HERE
OMFICH27 PRINT_SO
ODVDPRINT_SO
ODBDatabase70 PRINT_SO
ODSData and DatasetsPRINT_SO
ODBASE104 PRINT_SO
OE2Print and Electronic Monographic SeriesPRINTED_BOOK_SO
OE3Electronic Monographic Series10 PRINTED_BOOK_SO
OEBELECTRONIC BOOK74 PRINTED_BOOK_SO
OEGELECTRONIC CONTINUATION19 PRINT_SO_NONMON
OEJELECTRONIC JOURNAL18 PRINT_SO_NONMON
OESELECTRONIC SERIAL108 PRINT_SO_NONMON
OFEMiscellaneous Fee21 OTHER_SERVICES_CO
OCONTINUATION562 PRINT_SO_NONMON
OISSUE78 PRINT_SO_NONMON
OPRINT JOURNAL47 PRINT_SO_NONMON
OCFILE10 PRINT_SO
OMFILMPRINT_SO_NONMON
OMFORM57 PRINT_SO_NONMON
OMCMiscellaneous CreditOTHER_SERVICES_CO
OMRMARC RECORDSOTHER_SERVICES_CO
OMSMonographic Series4,527 PRINTED_BOOK_SO
OMSSPRINT_SO (talk to Johnny and Meghan )
ON1Print NewspaperPRINT_SO_NONMON
ONENewspaperPRINT_SO_NONMON
OCDROM10 PRINT_SO
OPBPrint Book140 PRINTED_BOOK_SO
OPJPrint Journal22 PRINT_SO_NONMON
OPSPrint serial1,570 PRINT_SO_NONMON
OCDRECPRINT_SO
OR2Print and Electronic SerialPRINT_SO_NONMON
OSCORE75 PRINT_SO
OSTSets3,949 PRINTED_BOOK_SO
OTHES432 PRINTED_BOOK_SO
OT2Print and Electronic SetsPRINTED_BOOK_SO
OT3Electronic SetsPRINTED_BOOK_SO
OBooks on CD 4 PRINT_SO
OP + Elect Journal 2 PRINT_SO_NONMON
OE JOURNAL41 PRINT_SO_NONMON
O
NULLPRINT_SO - See the list of these: https://duke.box.com/s/i41bl2is7cddxcpiclxe5q51yxlylyy7

SAVPRINT_CO
SAFAnnual Access Fee833 OTHER_SERVICES_CO
SBOOK9,978 PRINT_CO - Julie pull these for Bill
SMFICH16 PRINT_CO
SDVD27 PRINT_CO
SDBDatabase1,292 PRINT_CO
SDBASE540 PRINT_CO
SE3Electronic Monographic Series47 PRINT_CO
SEBELECTRONIC BOOK63 

PRINT_CO


SEGELECTRONIC CONTINUATION57 PRINTED_JOURNAL_CO
SEJELECTRONIC JOURNAL11,732 PRINTED_JOURNAL_CO
SESELECTRONIC SERIAL474 PRINTED_JOURNAL_CO
SFILMPRINT_CO
SFEMiscellaneous Fee97 OTHER_SERVICES_CO
SCONTINUATION1,586 PRINTED_JOURNAL_CO
SISSUE5,999 PRINTED_JOURNAL_CO
SPRINT JOURNAL1,119 PRINTED_JOURNAL_CO
SCFILE327 PRINT_CO
SMFILM33 PRINT_CO
SMFORM436 PRINT_CO
SMCMiscellaneous CreditOTHER_SERVICES_CO
SMRMARC RECORDS22 OTHER_SERVICES_CO
SMSMonographic Series167 

PRINT_CO


SMSSPRINT_CO (Talk to Johnny and Meghan)
SN3Electronic NewspaperPRINTED_JOURNAL_CO
SNENewspaper159 PRINTED_JOURNAL_CO
SCDROM82 PRINT_CO
SOAOPEN ACCESS38 PRINT_CO
SMAPPRINT_CO
SPBPrint Book98 

PRINT_CO


SPEPrint and Electronic Journal538 PRINTED_JOURNAL_CO
SPJPrint Journal5,935 PRINTED_JOURNAL_CO
SPSPrint serial7,579 PRINTED_JOURNAL_CO
SCDRECPRINT_CO
SR2Print and Electronic Serial31 PRINTED_JOURNAL_CO
SSCOREPRINT_CO
SSEELECTRONIC RECORD SCL ONLYPRINT_CO (talk to Johnny and Meghan)
SSMSTREAMING MEDIAPRINT_CO
SSTSets

PRINT_CO


SSVVISUAL MATERIAL SCL ONLYPRINT_CO  (talk to Johnny and Meghan)
ST3Electronic Sets

PRINT_CO


SBOOKS ON CDPRINT_CO
SP+ELEC JOURNAL265 PRINTED_JOURNAL_CO
SP+FREE JOURNAL37 PRINTED_JOURNAL_CO
SE JOURNAL3,029 PRINTED_JOURNAL_CO
S
NULL112 PRINT_CO - See the list of these: https://duke.box.com/s/i41bl2is7cddxcpiclxe5q51yxlylyy7
 3. Do we want to use reporting codes to track the order material type in Alma?

The Z68-MATERIAL-TYPE fields can be mapped to Alma Reporting Codes, "Order Reporting" tab on the Migration Form:


10/24/23: We've decided not to map any Aleph data to the Alma reporting code.  This requires that an object code be setup in Aleph and the current thinking is to use the APIs to update Alma order material type values if needed after the data is migrated rather than using the reporting code to track material type.

 Order Status

Order Status

The target field for the Aleph Order Status is the Alma PO Line Status.  

Next Steps

1. Review this list of Alma PO Line Status to become familiar with them.  See the Alma documentation for more info. 

Alma PO Line StatusDescription
In ReviewThe initial status of a newly created PO Line
Manual PackagingThe PO Line passed normalization, validation, and alert processing, and is ready to be manually packaged into a PO (see Packaging PO Lines into a PO)
Auto PackagingThe PO Line passed normalization, validation, and alert processing, and is ready to be automatically packaged into a PO (see Packaging PO Lines into a PO)
ReadyThe PO Line was packed into a PO and is ready to be sent. For a PO to be sent to a vendor, all of its PO Lines must have a status of Ready.
SentThe PO in which the PO Line is packed was approved and sent to the vendor (see Approving and Sending POs). This status is relevant for both electronic and physical one-time PO Lines and for inactive electronic continuous PO Lines. For more information, see Approving and Sending POs.
Waiting for Manual RenewalThe manual PO Line was fully processed and received/activated and its renewal date is the same as the current date, and is to be renewed manually (see Renewals). These PO Lines appear in the PO Lines to Review page. PO Lines with the status Recurring Renewal change to Waiting for Manual Renewal if they are marked for Manual Renew and the time to notify about the renewal arrives (this is configured as a certain number of days before the renewal date).
Recurring RenewalThe PO Line was fully processed and received/activated and will be renewed automatically. Continuous physical PO Lines that are sent to the vendor have Recurring Renewal status even if the renewal is done manually but the renewal date has not yet arrived (see Renewals). Continuous electronic PO Lines receive this status once they are activated and the user selects Done in the task list.
Waiting for InvoiceAll of the PO Line's associated items were received and the PO Line is ready to be associated with an invoice (see Invoicing). One-time PO Lines that are not fully invoiced receive this status once they have been activated or received.
ClosedThe PO Line was closed (see Closing PO Lines)
Under EvaluationIndicates that the PO Line is under evaluation (a trial was requested or started; see Evaluations and Trials). PO Lines with this status can be edited only by a Trial Manager/Operator.
Under Evaluation (Renewal)The PO Line renewal is being evaluated and has not yet been decided. PO Lines with this status can be edited only by a Trial Manager/Operator.
DeferredThe PO Line was set aside to be handled at a later date (see Deferrals). 
CanceledThe PO Line was canceled (see Canceling PO Lines)
DeletedThe PO Line is deleted from the system (see Deleting PO Lines). This status will not appear since the PO Line is deleted once the user selects to do so.


2.  Use the table below to identify whether any order cleanup in Aleph is needed prior to migration.  Create or confirm the target value in Alma for each of the Aleph Order Status values below. The Aleph record counts from June 2023 are from the Aleph Production environment.  The Aleph to Alma data migration guide says, "Provide a mapping for all the Z68-ORDER-STATUS as appear in the DB if it is not one of the following: "NEW","WP","PS","WB","QSV","RSV","ONW","CNB","VC","LC","REJ","RET","DNB","SV","CLS"."

Aleph Order StatusDescriptionCount (6/28/23)Target Alma PO Line StatusCleanup before migration?
BD Order 1148984 - Perkins 2020, Order Type M1Closed?Yes - Fixed during meeting on 10/19/23
CBRClosed Budget Restructuring9337Closed
CLSOrder Closed1091626Maps automatically
CNBCancelled - no budget1521Maps automatically
D04Order 856985  Perkins 2015 Order type M1Closed?Yes - Fixed during meeting on 10/19/23
DNBDelayed35Maps automatically (Harvard documentation: migrated as New then ends up being In Review )
LC Library Cancelled20589Maps automatically
LR Library Returned206Closed
NEWNew1110Maps automatically (Harvard's documentation says these start as NEW and are then set to IN REVIEW)First review showed that these are most likely gifts setup by Ford and Div - run a query to verify. What does NEW map to in Alma and is that the status value what we want to use for these gifts?
OO Out of Print20Closed
OP Out of Print7Closed
PS Processing Started8Maps automaticallyYes
QSVQuery before sending1Maps automaticallyYes
RSVReady to send to vendor2Maps automatically (Harvard:  NEW then ends up being In Review)
SU Suspended177SentYes
SV Sent to vendor20896Maps automatically (Harvard:  SENT (one-time orders) or WAITING FOR RENEWAL (continuous orders))
V. Order 1174556 Perkins 2021 Order Type M1Closed  Yes - Fixed during meeting on 10/19/23
VC Vendor Cancelled8669Maps automatically 
VOL

Order 1148189 Perkins 2020 Order Type M

Order 1123308 Perkins 2019 Order Type M

2ClosedYes - Fixed during meeting on 10/19/23
WP Waiting for processing 6Maps automatically
XXXSee list of orders here51ClosedYes
635Order 1108233 Law 2019 Order Type S, material type DB1ClosedYes - Sent to Sean on 10/20/23
978

Order 979159 Perkins 2017 Order Type M

Order 756763 Perkins 2013 Order Type M

2ClosedYes - Fixed during meeting on 10/19/23

Total1,154,270 

 Sublibrary

Sublibrary - no crosswalk, each sublibrary becomes a Library on the order in Alma

The target field for the Aleph Sublibrary is the Alma Library.  These automatically migrate to Alma and we aren't able to crosswalk them to different values.  Erin started a page here to discuss whether cleanup is needed for sublibraries.

Aleph SublibraryDescription

Count (8/9/23)

Data analysis

null - 1 space
105These orders don't contain an ordering unit and have status values of CNB, LC, or XXX
ARCH University Archives107
BES  Biol-Env. Sciences Library6591154 of these orders are open (SV) and all are assigned to the PERKO ordering unit
CHEM Perkins/Bockstock Library {C}1609
DIV  Divinity School Library60036
DKU  
2These orders are both closed
DKUS Duke Kunshan Library3922 of these orders are open, 12 closed, 5 set to 'LC'
DOCS Perkins Public Documents/Maps2153
DUKIRDuke Internet Resource6408199% of these orders are closed and all are assigned to the PERKO ordering unit
FORD Ford Library20167
LAW  Goodson Law Library61160
LILLYLilly Library127100
LSC  Library Service Center74
MARINMarine Lab Library1270
MCL  Medical Center Library11372
MUSICMusic Library60080
PERKNPerkins Library698468
SCL  Rubenstein Library31497
VESICPerkins/Bockstock Library {V}11175399 of these orders are in an open (SV) status.



 Local Currency

Local Currency

There are 1,078 order records containing 49 different invalid ISO values, 148 of which are in SV status. A question has been added to the question log to find out more info about our options for handling those records.  A spreadsheet containing the full Z68 order record for the 1078 orders is stored on box: orders with invalid currency 8_8_23.xlsx

From the Aleph to Alma migration guide:

Please list any non-standard ISO currencies you may manage for your orders and fund transactions and the standard ISO currency they should map to, if relevant.


Further Information: If your site does not work with ISO 4217 currency codes, map the code used in Aleph to the appropriate ISO currency code. This is currently applicable for both vendor and fund currency-related information. Empty currencies map to your default currency. For empty currencies that need to map to a different currency other than the default, fill in column D with <empty> and column E with an appropriate 3-letter ISO currency code.</empty>
For example:
Col D: <empty> Col E: AUD</empty>


Z68 E_CURRENCYCountIs this an ISO value?Notes from Aleph researchMap to ISO 4217 Code
ARS8YAlready standardAlready standard
AS31NThis order is from PEUROPEAN BK CTR which lists USD as currency USD
AU$42NAll of these are closed orders. USD
AUD34Y

Already standard

Already standard
BF03NThis one isn't showing up on the EL migration form. USD
BF116NAll of these are closed orders. USD
BF26NAll of these are closed orders. USD
BF38NAll of these are closed orders. USD
BF42NAll of these are closed orders. USD
BF53NAll of these are closed orders. USD
BF63NAll of these are closed orders. USD
BF84NAll of these are closed orders. USD
BRL50YAlready standardAlready standard
CA$33NOne open ongoing order with a canadian vendor - order 40186 CAD
CAD321YAlready standardAlready standard
CHF7YAlready standardAlready standard
CNY16852YAlready standardAlready standard
CR$2NOne open ongoing order 44169 with vendor PSUSAN BACHUSD
CZK127YAlready standardAlready standard
DKK32YAlready standardAlready standard
DKR11NAll of these are closed orders. USD
DM018NMostly Harrasowitz, some open orders from 2004.  USD
DM139N
USD
DM216N
USD
DM310N
USD
DM410N
USD
DM56N
USD
DM69N
USD
DM79N
USD
DM811N
USD
DM99N
USD
EUR35640YAlready standardAlready standard
FF015NMost of the FF ones are linked to  PEUROPEAN BK CTR which lists USD as currency USD
FF15N
USD
FF214N
USD
FF32N
USD
FF43N
USD
FF52N
USD
FF61N
USD
FF72N
USD
FF81N
USD
FF91N
USD
GBP8068YAlready standardAlready standard
GLD24NAll closed ordersUSD
HK$3NOne open order 55570 with PJOINT PUB HONG KONG from 1999CHN
HKD264YAlready standardAlready standard
ILS498YAlready standardAlready standard
INR7YAlready standardAlready standard
ISK1YAlready standardAlready standard
JPY14504YAlready standardAlready standard
KRW9357YAlready standardAlready standard
LIT48NSome open orders from 2004, mostly PCASALINI (italian)USD or EUR?
MAD44YAlready standardAlready standard
MAR1N1 closed record for LCOUTTSUSD
MXN79YAlready standardAlready standard
NKR2N2 closed orders for LNIJHUSD
NOK2YAlready standardAlready standard
NZ$31NAll of these are with vendor LNZ EXPORT based in New ZealandNZD
NZD10YAlready standardAlready standard
PES29NLaw orders from COMERCIAL CELIS LTDA and LBERENGUER, ChileanCLP
PKR73YAlready standardAlready standard
PLN3YAlready standardAlready standard
POU284NReview the SV orders with Bill and Virginia - some from Barcelona, some Great Britain?GBP
PSO61NFrom vendors based in MexicoMXN
PTA18NFrom vendors based in SpainEUR
RAN13NFrom LTHOROLD based in South AfricaZAR
RUH2NFrom LMARY MARTIN based in SingaporeSGD
SEK6YAlready standardAlready standard
SKR2NOne from LHARRASSOWITZ and one from LNIJHUSD
TRL179NTurkishTRY
TWD676YAlready standardAlready standard
USD1068803YAlready standardAlready standard
YEN74NFrom vendors based in JapanJPY
YUA35NFrom LCHINA INTL BOOK based in ChinaCNY
ZAR349YAlready standardAlready standard
sml3NFrom PLEILA BKS in 2018 in SV status (monograph) in Egypt. Send email to BillEGP
null45


Data Mapping

This table describes the Alma target field for each Order field in Aleph. Note:  Much of this content was copied from Harvard's data mapping guides, last updated in 2018. Please consider this page a draft until the Duke team verifies that this mapping information is current and concurs with Duke's migration decisions.


Aleph Field Name

Alma Field Name

Navigation Instructions

Additional Information

Order Number 1

 Order line

Purchase order line details Summary tab in the upper information pane: Order line


Order Number 2

Additional PO line reference

Purchase Order Line Details, Summary tab, Additional Information: Additional PO line reference 


Order Number 3NotesPurchase order line details, Notes tab
Order Status

Notes

Purchase order line details, Notes tab e.g.: "order status TX in Aleph"


Order ISSN/ISBNIdentifierPurchase order line details, summary tab, PO line details: Identifier 
Open Daten/a

Order DateSent datePurchase order line details Summary tab in the upper information pane, below the Status field: Sent date
ERM IDn/a

Order GroupNotesPurchase order line details, Notes tab e.g.: "Z68-ORDER-GROUP: an"
Material FormatOrder line typePurchase order line details, Summary tab in the upper information pane: Order line typeis now part of the Purchase type (print, physical or electronic). Update from Julie Brannon 3/8/24: Not sure what Harvard's documentation meant by "Purchase type", but it's probably referring to the Order line type value.
Status Date

Status

Purchase order line details, Summary tab in the upper information pane: Status


Invoice StatusInvoice statusPurchase order line details, summary tab, PO line details: Invoice status
Arrival Statusn/a
Some order statuses infer arrival status: i.e. Waiting for invoice status means that a one time order has been received but not yet paid
Material Type

Material Type

Material type in the Alma Purchase order line details, summary tab, PO line details indicates the Item material type

In terms of migration, the combination of Aleph order type and material type determines the Alma order type; the Alma order type dictates the item material type.  See Aleph to Alma Mapping.xls for detailed analysis on how Duke will migrate these values.
SublibraryLibraryPurchase order line details, summary tab, Ordered items: Library
Acquisition MethodAcquisition MethodPurchase order line details, summary tab, PO line details: Acquisition Method
Order UnitPO line owner
Purchase order line details, Information area: PO line owner
Initiator IDn/a

Initiator Namen/a

Actionn/a

Approver IDn/a

Library Note
Purchase order line details, Notes tab
Vendor Code/Name
Purchase order line details, summary tab, Vendor information: Material supplier

Vendor Reference


Purchase order line details, summary tab, PO line details: Vendor reference number
Vendor Note
Purchase Order Line Details, Summary tab, PO Line Details: Note to vendor
Vendor Contactn/a
Contact info stored in vendor record
Order Delivery Typen/a

Letter Typen/a

Delivery Typen/a

Send Letter Byn/a

RushRushPurchase order line details, summary tab, PO line details: Rush
Claim DateExpected receipt after ordering (days), OR, Expected receipt date PLUS: Claiming grace period (days)Purchase order line details, summary tab, Vendor information: Expected receipt after ordering (days), OR, Expected receipt date PLUS: Claiming grace period (days)
Max. Arrival DaysExpected receipt after ordering (days), OR, Expected receipt datePurchase order line details, summary tab, Vendor information: Expected receipt after ordering (days), OR, Expected receipt date
Subscription StartSubscription from dateOnly present for Continuous and Standing order Purchase types. Purchase order line details, summary tab, Renewal: Subscription from date
Subscription EndSubscription to dateOnly present for Continuous and Standing order Purchase types. Purchase order line details, summary tab, Renewal: Subscription to date
Budget Cyclen/a

Renewal DateRenewal dateOnly present for Continuous and Standing order Purchase types. Purchase order line details, summary tab, Renewal: Renewal date
Number of UnitsQuantity for PricingPurchase order line details, summary tab, Pricing: Quantity for Pricing
Unit PriceList pricePurchase order line details, summary tab, Pricing: List price
Total PriceNet pricePurchase order line details, summary tab, Pricing: Net price
Quantity Noten/a

Currency
Purchase order line details, summary tab, Pricing: List price (Currency options come from the Vendor record)
List PriceList pricePurchase order line details, summary tab, Pricing: List price
Terms Sign (+/-)n/a
debit amounts are preceded by a negative symbol 
Terms PercentDiscount (%)Purchase order line details, summary tab, Pricing: Discount (%)
Final PriceAmountPurchase order line details, summary tab, Funding: Amount
Local Pricen/a

Price Noten/a

Encumber BudgetFund namePurchase order line details, summary tab, Funding: Fund name

Order Data that doesn't migrate to Alma

  • Letter type (Z68-LETTER-TYPE)
  • Order delivery type (Z68-ORDER-DELIVERY-TYPE)
  • Send letter by (Z68-SEND-METHOD)
  • Initiator ID (Z68-TARGET-ID)
  • Initiator name (Z68-TARGET-TEXT)
  • Action (Z68-TARGET-FLAG)
  • Batch claiming (Z68-AUTO-CLAIM)
  • Status date (Z68-ORDER-STATUS-DATE)
  • Original claim date (Z68-ORIGINAL-EDA)
  • Unit price (Z68-UNIT-PRICE)
  • Total price (Z68-TOTAL-PRICE)
  • List price (Z68-E-LISTED-PRICE)
  • Local price (Z68-E-LOCAL-PRICE)
  • Z68-ERM-TYPE
  • Z68-ERM-ID
  • Z20 or any other Aleph claim information
  • Z71 (Order, subscription and Invoice Log)
  • Z18 (Routing List)

As indicated above, Order log notes do not migrate from Aleph to Alma and these contain very useful historical information for acquisitions staff.  We will ask ExLibris whether it would be possible to migrate specific types of order log notes, as we previously defined to move to FOLIO.  If this isn't possible, we'll likely need to store the notes in an external Library Data Service Center.

  • 00 General

  • 95 Subscription history 

  • 98 Correspondence with vendor

  • 99 Note to vendor

  • 01 Order Status

  • 08 Arrival

  • 10 Invoice

  • 15 Order moved from another ADM record

  • 31 Serial’s claim sent (we don’t need these for closed orders, just open ones)
  • 34 Change to issue arrival date
  • 35 Issue modified