Versions Compared

Key

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

...

Table of Contents
maxLevel3
What is a call number?

A call number is a book identifier that helps librarians and patrons locate the book in the library. In general, the call number usually consist of a part related to classification, a part related to authors and a part of publication year.  If the library has multiple copies of the same publication, the copy number will also be added. How the elements are represented in the call number depends on the call number type. There are several call numbers types, with Library of Congress, Dewey Decimal, SuDoc being the most common in American libraries.  Many libraries have also their own local call number, that are often a variation of other call number types.

...

  • Populating generating shelving order on item level records
  • Rendering records when users browse

Call number browse in FOLIO

Generating shelving order

FOLIO call number implementation relies on item record's effectiveShelvingOrder - a system generated normalization of the call number that was introduced for for call number sorting purposes. The value is populated using the algorithm that was originally design to support Library of Congress Classification schema (MODINVSTOR-381) and extended to Dewey call numbers (MODINVSTOR-876) and other call numbers types (MODINVSTOR-877) that covers SuDoc  and local call numbers.  

Rendering records

(to be added)

...

When users browse call numbers in the Inventory app, the records are ordered by the item record's shelving order using the algorithm described here..   The Call Number column on the result list is populated with the indexed fullCallNumber value that consists from call number prefix, call number and call number suffix as implemented in  MSEARCH-12 (for items) and MSEARCH-81 (for holdings records). 

Image Added

When the user clicks on a row the browse list, the record is identified by the item record shelving  order:

Image Added

Additional information

Browse example for the call number DE11.U7 that will return one preceding record and one matching record:   /browse/call-numbers/instances?query=callNumber>= de11.u7 or callNumber < de11.u7&expandAll=true&highlightMatch=true&limit=2&precedingRecordsCount=1

Code Block
titleResponse
collapsetrue
{
	"totalRecords": 20000,
	"prev": "DE 211 T86 C 11",
	"next": "DE 211 U7",
	"items": [
		{
			"fullCallNumber": "DE11.T86",
			"shelfKey": "DE 211 T86 C 11",
			"totalRecords": 1,
			"instance": {
				"id": "f13e5a53-a0ba-45f5-b69f-c3a82fd9d6f6",
				"hrid": "in1915160",
				"source": "MARC",
				"statisticalCodeIds": [],
				"statusId": "319fefa7-92bd-4d45-9746-4614555955c6",
				"title": "Studien zur geschichte der griechisch römischen ethnographie ...",
				"indexTitle": "Studien zur geschichte der griechisch römischen ethnographie ...",
				"series": [],
				"alternativeTitles": [],
				"identifiers": [
					{
						"value": "(OCoLC)10186012",
						"identifierTypeId": "01ca9cda-7027-4d64-abed-9e3c4943daf2"
					}
				],
				"contributors": [
					{
						"name": "Trüdinger, Karl, 1890-",
						"contributorNameTypeId": "35b01201-597f-4938-a0d1-110245ba9d67",
						"primary": true
					}
				],
				"subjects": [
					"Ethnology--Greece",
					"Ethnology--Italy",
					"Ethnology.",
					"Greece.",
					"Italy."
				],
				"instanceTypeId": "1c43b4c1-b138-4386-a91d-0d305e4ddf23",
				"instanceFormatIds": [],
				"languages": [],
				"metadata": {
					"createdDate": "1995-08-22T00:00:00.000+00:00",
					"updatedDate": "2018-10-18T12:52:18.000+00:00"
				},
				"administrativeNotes": [],
				"modeOfIssuanceId": "7b143a6c-84e8-4168-94b1-24220a3d14cc",
				"natureOfContentTermIds": [],
				"publication": [
					{
						"publisher": "E. Birkhäuser",
						"dateOfPublication": "1918"
					}
				],
				"staffSuppress": false,
				"discoverySuppress": false,
				"isBoundWith": false,
				"classifications": [
					{
						"classificationNumber": "DE73 .T8"
					}
				],
				"electronicAccess": [],
				"notes": [
					{
						"note": "Vita.",
						"staffOnly": false
					},
					{
						"note": "Inaug.-Diss.--Basel.",
						"staffOnly": false
					}
				],
				"items": [
					{
						"id": "a543aef0-2193-43b6-88a4-b81c218a769f",
						"hrid": "it3494918",
						"formerIds": [],
						"barcode": "20142063",
						"effectiveLocationId": "b9dc25a2-a7fb-48ad-8da5-8f68e35ba0af",
						"status": {
							"name": "Available"
						},
						"materialTypeId": "025ba2c5-5e96-4667-a677-8186463aee69",
						"discoverySuppress": false,
						"effectiveCallNumberComponents": {
							"callNumber": "DE11.T86"
						},
						"effectiveShelvingOrder": "DE 211 T86 C 11",
						"electronicAccess": [],
						"administrativeNotes": [],
						"notes": [],
						"statisticalCodeIds": [
							"c6de6928-bb6e-4458-97f4-9145b27abb24"
						],
						"circulationNotes": [],
						"metadata": {
							"createdDate": "2014-08-09T06:26:11.000+00:00",
							"updatedDate": "2018-02-02T09:38:24.000+00:00"
						}
					}
				],
				"holdings": [
					{
						"id": "75f7f115-3e33-4663-8aa7-5c991f9cd703",
						"permanentLocationId": "b9dc25a2-a7fb-48ad-8da5-8f68e35ba0af",
						"discoverySuppress": false,
						"hrid": "ho2340409",
						"sourceId": "f32d531e-df79-46b3-8932-cdd35f7a2264",
						"formerIds": [
							"hzn1915160"
						],
						"statisticalCodeIds": [],
						"holdingsTypeId": "6581dafa-e11a-4bc1-89ab-a3119e84f2ed",
						"electronicAccess": [],
						"administrativeNotes": [],
						"notes": [],
						"metadata": {
							"createdDate": "2014-08-09T06:26:11.000+00:00",
							"updatedDate": "2015-04-08T17:06:12.000+00:00"
						}
					}
				]
			}
		},
		{
			"fullCallNumber": "DE11.U7",
			"shelfKey": "DE 211 U7",
			"isAnchor": true,
			"totalRecords": 1,
			"instance": {
				"id": "bb0307f8-7181-4b98-8194-20cbbd7f3235",
				"hrid": "in1915161",
				"source": "MARC",
				"statisticalCodeIds": [],
				"statusId": "319fefa7-92bd-4d45-9746-4614555955c6",
				"title": "The origin of tyranny,by P. N. Ure.",
				"indexTitle": "origin of tyranny,by P. N. Ure.",
				"series": [],
				"alternativeTitles": [],
				"identifiers": [
					{
						"value": "   22009411",
						"identifierTypeId": "ddaf3d51-de81-4768-b1aa-a1e985d4e999"
					},
					{
						"value": "(OCoLC)7105576",
						"identifierTypeId": "01ca9cda-7027-4d64-abed-9e3c4943daf2"
					}
				],
				"contributors": [
					{
						"name": "Ure, P. N. (Percy Neville), 1879-1950",
						"contributorNameTypeId": "35b01201-597f-4938-a0d1-110245ba9d67",
						"primary": true
					}
				],
				"subjects": [
					"Despotism",
					"Civilization, Ancient",
					"Archaeology",
					"Wealth",
					"Greece--History",
					"Archaeology.",
					"Civilization, Ancient.",
					"Despotism.",
					"Wealth.",
					"Greece.",
					"To 146 B.C.",
					"History."
				],
				"instanceTypeId": "1c43b4c1-b138-4386-a91d-0d305e4ddf23",
				"instanceFormatIds": [],
				"languages": [],
				"metadata": {
					"createdDate": "1995-08-22T00:00:00.000+00:00",
					"updatedDate": "2018-10-18T12:52:18.000+00:00"
				},
				"administrativeNotes": [],
				"modeOfIssuanceId": "7b143a6c-84e8-4168-94b1-24220a3d14cc",
				"natureOfContentTermIds": [],
				"publication": [
					{
						"publisher": "The University press",
						"dateOfPublication": "1922"
					}
				],
				"staffSuppress": false,
				"discoverySuppress": false,
				"isBoundWith": false,
				"classifications": [
					{
						"classificationNumber": "DE11 .U8"
					}
				],
				"electronicAccess": [],
				"notes": [
					{
						"note": "Arguments in favor of the view that the earliest tyrannies were founded on wealth.",
						"staffOnly": false
					},
					{
						"note": "Bibliographical foot-notes.",
						"staffOnly": false
					}
				],
				"items": [
					{
						"id": "9b5f797d-4a04-43f9-baa9-c76328d73e90",
						"hrid": "it3494919",
						"formerIds": [],
						"barcode": "11164548",
						"effectiveLocationId": "b9dc25a2-a7fb-48ad-8da5-8f68e35ba0af",
						"status": {
							"name": "Available"
						},
						"materialTypeId": "025ba2c5-5e96-4667-a677-8186463aee69",
						"discoverySuppress": false,
						"effectiveCallNumberComponents": {
							"callNumber": "DE11.U7"
						},
						"effectiveShelvingOrder": "DE 211 U7",
						"tags": {
							"tagList": []
						},
						"electronicAccess": [],
						"administrativeNotes": [],
						"notes": [],
						"statisticalCodeIds": [
							"c6de6928-bb6e-4458-97f4-9145b27abb24"
						],
						"circulationNotes": [],
						"metadata": {
							"createdDate": "2014-08-09T06:26:11.000+00:00",
							"updatedDate": "2023-01-17T14:54:53.397+00:00",
							"updatedByUserId": "9eb67301-6f6e-468f-9b1a-6134dc39a684"
						}
					}
				],
				"holdings": [
					{
						"id": "6363c60a-e09d-410b-b976-dc8121d85f1a",
						"permanentLocationId": "b9dc25a2-a7fb-48ad-8da5-8f68e35ba0af",
						"discoverySuppress": false,
						"hrid": "ho2340410",
						"sourceId": "f32d531e-df79-46b3-8932-cdd35f7a2264",
						"formerIds": [
							"hzn1915161"
						],
						"statisticalCodeIds": [],
						"holdingsTypeId": "6581dafa-e11a-4bc1-89ab-a3119e84f2ed",
						"electronicAccess": [],
						"administrativeNotes": [],
						"notes": [],
						"metadata": {
							"createdDate": "2014-08-09T06:26:11.000+00:00",
							"updatedDate": "2014-08-09T06:26:11.000+00:00"
						}
					}
				]
			}
		}
	]
}


Helpful links

...