Skip to Content

API for sending queries to the catalogue

2840  Online catalogue

The online catalog can be queried via forms published on the library's website. It is also possible to create links containing the desired query parameters to obtain a response from the catalog.

This article explains the syntax of query links.

Note: elements in green must be substituted with the desired value.

 

To search for documents using a simple search :

http://[Address:port number]/BM.CGI?BM_QUERY=WORDS&BM_ENDUSER_LNG=Generic&BM_SEARCH_WORDS=OK&BM_RESULT_PAGE=ListTitl.htm&BM_MAX_NB_REC=50&BM_WORDS=[search terms]

 

To search for documents using words from the title :

http://[Address:port number]/Generic/BM.CGI?BM_QUERY=TITLE&BM_ENDUSER_LNG=Generic&BM_SEARCH_DOCUMENT=OK&BM_DOC_TITLE=[words from the title]&BM_DOC_ACQUISITION_DAY=[Day of acquisition]&BM_DOC_ACQUISITION_MONTH=[Month of acquisition]&BM_DOC_ACQUISITION_YEAR=[Year of acquisition]&BM_DOC_TYPE=[Type name]&BM_DOC_LANGUAGE=[Language]&BM_MAX_NB_REC=50

 

To search for document with their ISBN :

http://[Address:port number]/Generic/bm.cgi?BM_QUERY=MULTI&BM_ENDUSER_LNG=Generic&BM_SEARCH_MULTI=OK&BM_DOC_ISBN=[ISBN or EAN]&BM_MAX_NB_REC=50

 

To search for documents with multiple-criteria :

http://[Address:port number]/Generic/bm.cgi?BM_QUERY=MULTI&BM_ENDUSER_LNG=Generic&BM_SEARCH_MULTI=OK&BM_DOC_TITLE=[Words from the tite or keywords]&BM_DOC_AUTHOR=[Author's name]&BM_AUTHOR_FIRST_NAME=[Author's first name]&BM_SUBJECT1=[Subject]&BM_SERIES_TITLE=[Words from the series title]&BM_DOC_CATEGORY=[Category]&BM_DOC_YEAR_PUBLISHED=[Publication year]&BM_DOC_ACQUISITION_DAY=[Day of acquisition]&BM_DOC_ACQUISITION_MONTH=[Month of acquisition]&BM_DOC_ACQUISITION_YEAR=[Year of acquisition]&BM_DOC_TYPE=[Type name]&BM_DOC_LANGUAGE=[Language]&BM_MAX_NB_REC=50

 

To search for authors :

http://[Address:port number]/Generic/BM.CGI?BM_QUERY=AUTHOR&BM_ENDUSER_LNG=Generic&BM_SEARCH_AUTHOR=OK&BM_AUTHOR=[Author's name]&BM_AUTHOR_FIRST_NAME=[Author's first name]&BM_DOC_ACQUISITION_DAY=[Day of acquisition]&BM_DOC_ACQUISITION_MONTH=[Month of acquisition]&BM_DOC_ACQUISITION_YEAR=[Year of acquisition]&BM_DOC_TYPE=[Type name]&BM_DOC_LANGUAGE=[Language]&BM_MAX_NB_REC=50

 

To search for class marks :

http://[Address:port number]/Generic/BM.CGI?BM_QUERY=CLASSMARK&BM_ENDUSER_LNG=Generic&BM_SEARCH_CLASSMARK=OK&BM_CLASSMARK=[Class mark]&BM_CLASSMARK_DEF=[Class mark definition]&BM_DOC_ACQUISITION_DAY=[Day of acquisition]&BM_DOC_ACQUISITION_MONTH=[Month of acquisition]&BM_DOC_ACQUISITION_YEAR=[Year of acquisition]&BM_DOC_TYPE=[Type name]&BM_DOC_LANGUAGE=[Language]&BM_MAX_NB_REC=50

 

To search for subjects :

http://[Address:port number]/Generic/BM.CGI?BM_QUERY=SUBJECT&BM_ENDUSER_LNG=Generic&BM_SEARCH_SUBJECT=OK&BM_SUBJECT1=[Subject 1]&BM_SUBJECT2=[Subject 2]&BM_SUBJECT3=[Subject 3]&BM_SUBJECT_AND_OR=[AND|OR]&BM_DOC_ACQUISITION_DAY=[Day of acquisition]&BM_DOC_ACQUISITION_MONTH=[Month of acquisition]&BM_DOC_ACQUISITION_YEAR=[Year of acquisition]&BM_DOC_TYPE=[Type name]&BM_DOC_LANGUAGE=[Language]&BM_MAX_NB_REC=50

 

Pour chercher des matières dans un thesaurus multilingue :

http://[Address:port number]/Generic/BM.CGI?BM_QUERY=SUBJECT&BM_ENDUSER_LNG=Generic&BM_SEARCH_SUBJECT=OK&BM_SUBJECT1=[Subject 1]&BM_SUBJECT2=[Subject 2]&BM_SUBJECT3=[Subject 3]&BM_THESAURUS_LNG=[Thesaurus language]&BM_SUBJECT_AND_OR=[AND|OR]&BM_DOC_ACQUISITION_DAY=[Day of acquisition]&BM_DOC_ACQUISITION_MONTH=[Month of acquisition]&BM_DOC_ACQUISITION_YEAR=[Year of acquisition]&BM_DOC_TYPE=[Type name]&BM_DOC_LANGUAGE=[Language]&BM_MAX_NB_REC=50

 

To search for series :

http://[Address:port number]/Generic/BM.CGI?BM_QUERY=SERIES&BM_ENDUSER_LNG=Generic&BM_SEARCH_SERIES=OK&BM_SERIES_TITLE=[series title]&BM_DOC_ACQUISITION_DAY=[Day of acquisition]&BM_DOC_ACQUISITION_MONTH=[Month of acquisition]&BM_DOC_ACQUISITION_YEAR=[Year of acquisition]&BM_DOC_TYPE=[Type name]&BM_DOC_LANGUAGE=[Language]&BM_MAX_NB_REC=50

 

To display a specific document record :

http://[Address:port number]/Generic/BM.CGI?BM_ZOOM=DOCUMENT&BM_GET_DOCUMENT=[Document number]&BM_QUERY=TITLE&BM_ENDUSER_LNG=Generic

 

To search for new acquisitions :

http://[Address:port number]/Generic/ListTitl.htm?BM_GET_DOCUMENT_NEWS=&BM_RESULT_PAGE=[rss.xml or other file]&BM_ENDUSER_LNG=Generic&BM_Sort=3

Notes: New acquisitions are documents recently added to the catalog. The period during which a document is considered a new acquisition is defined in the Web OPAC server parameters.

 

Details on query parameters :

  • Address : IP number (for instance 192.168.12.34) or server name (for instance cloud12.bibliomaker.ch) followed by the port number (for instance 8080). The address and the port number are separated by a semi-colon (":").
  • BM_AUTHOR: Author's name, either only the family name or the name followed by a comma and the first name (example : Shakespeare, William).
  • BM_AUTHOR_FIRST_NAME : Author's first name.
  • BM_CLASSMARK : Class mark (numbers or letters)
  • BM_CLASSMARK_DEF : Words from the class mark définition, separated by the + or %20 characters.
  • BM_DOC_ACQUISITION_DAY : day number from 1 to 31. Leave blank if necessary.
  • BM_DOC_ACQUISITION_MONTH : month number from 1 to 12. Leave blank if necessary.
  • BM_DOC_ACQUISITION_YEAR : 4-digit year number. Leave blank if necessary.
  • BM_DOC_AUTHOR : Author's name, either only the family name or the name followed by a comma and the first name (example : Shakespeare, William).
  • BM_DOC_ISBN : 10- or 13-character ISBN, with or without separator between blocks.
  • BM_DOC_LANGUAGE : Name of desired document language. Leave blank if necessary.
  • BM_DOC_TITLE : Words from the title separated by the + or %20 characters.
  • BM_DOC_TYPE : Name of desired document type. Leave blank if necessary.
  • BM_GET_DOCUMENT : Record number as shown in the Document record Number field.
  • BM_MAX_NB_REC : maximum number of records to display (if result is greater, result is displayed on several pages).
  • BM_RESULT_PAGE : name of the file to be used to display the result. This file must be located in the OPAC_Web folder on the web server.
  • BM_SERIES_TITLE : Words from the series title separated by the + or %20 characters.
  • BM_SORT : number indicating the desired sort order :
    • 1 = Title
    • 2 = Author/Title
    • 3 = Acquisition date/Title
    • 4 = Publication year/Title
    • 5 = Document type/Title
    • 6 = Category /Title
    • 7 = Shelf mark/Title
  • BM_SUBJECT_AND_OR : Relationship between subjects entered :
    • AND = all terms entered must appear in the same subject record.
    • OR = one or other of the terms must appear in the subjects sought
  • BM_WORDS : Words separated by the + or %20 characters.

 
API for sending queries to the catalogue