For a better understand the mechanism of retrieving metadata through the Z39.50 extension, the information from the chapter about importing metadata in the bibliographic description editor will be useful, as well as acquaintance with the Z39.50 protocol.


The programming library for that extension is .

Many library systems make metadata available through the Z39.50 protocol. The Editor Application extension discussed here makes it possible to retrieve metadata from systems which make them available through the Z39.50 protocol. The Z39.50 protocol is a very complex standard for sending metadata in various formats. The extension in question only allows metadata retrieval from the MARC 21 communication format (specifically, the USMARC format). The metadata retrieved with the use of that extension can be imported by means of an extension for importing files in the MARC format.

In order to retrieve metadata with the use of the Z39.50 protocol:

  1. In the metadata editor, in the “Metadata import/export” panel, click the “Import...” button. The metadata import window will appear (see the image below). The metadata import window contains the Z39.50 option which determines the use of the Z39.50 extension for selecting the file with the metadata to be imported.


  2. In order to select the metadata to be imported, click the “Select...” button. The metadata search window will be displayed (see the image below). In that window, the user can select the server and the base to which search queries will be directed. A search query is built on the basis of three values/phrases which are entered by a user in fields on the “Search” panel. The attribute search can be adjusted by a user by selecting appropriate attributes from the expandable lists. In the image below, the attributes selected for the search are “Author”, “Title”, and “Publisher”. In order to start the search, click the “Search” button. Once the search has finished, the results can be viewed with the use of the “Previous” and “Next” buttons, which lead, respectively, to the previous or next page of the search results. The editor can also select a particular page from the search results directly, by means of the expandable list located between the “Previous” and “Next” buttons.


  3. Aby wybrać metadane należy zaznaczyć konkretną pozycję na liście wyników wyszukiwania a następnie wybrać przycisk Wybierz. Plik zostanie pobrany na lokalny dysk komputera, okno wyszukiwania Z39.50 zostanie zamknięte, a w oknie importu metadanych zostanie automatycznie wprowadzona ścieżka do pobranego pliku metadanych. Kolejne kroki należy wykonać zgodnie z informacjami zawartymi w sekcji import metadanych (w najprostszym przypadku wystarczy wybrać przycisk Importuj na oknie importu metadanych).

Rozszerzenie Z39.50 może być dostosowane do potrzeb konkretnej instalacji poprzez odpowiednią jego konfigurację. Konfiguracja rozszerzenia znajduje się w pliku konfiguracyjnym z3950_servers.xml. Plik ten definiuje m. in. serwery oraz bazy danych w których redaktor będzie mógł wyszukiwać metadane, atrybuty po jakich redaktor będzie mógł przeszukiwać konkretny serwer oraz operator logiczny jaki będzie użyty do połączenia zapytań z poszczególnych pól wyszukiwawczych. Poniżej przedstawiono domyślny plik konfiguracyjny rozszerzenia Z39.50.

<?xml version="1.0" encoding="UTF-8"?>
<servers>
	<server>
		<name>Library of Congress</name>
		<name lang="en">Library of Congress</name>
		<name lang="pl">Biblioteka Kongresu Stanów Zjednoczonych</name>
		<host>z3950.loc.gov</host>
		<port>7090</port>
		<databases>
			<database>Voyager</database>
		</databases>
		<recordencoding>MARC-8</recordencoding>
		<queries>
			<attrset>@attrset bib-1</attrset>
			<operator>@and</operator>
			<query>
				<name>Author</name>
				<name lang="pl">Autor</name>
				<name lang="en">Author</name>
				<searchquery>@attr 1=1003 $1</searchquery>
			</query>
			<query>
				<name>Title</name>
				<name lang="pl">Tytuł</name>
				<name lang="en">Title</name>
				<searchquery>@attr 1=4 $1</searchquery>
			</query>
			<query>
				<name>Publisher</name>
				<name lang="pl">Wydawca</name>
				<name lang="en">Publisher</name>
				<searchquery>@attr 1=1018 $1</searchquery>
			</query>
			<query>
				<name>Everywhere</name>
				<name lang="pl">Wszędzie</name>
				<name lang="en">Everywhere</name>
				<searchquery>@attr 1=1035 $1</searchquery>
			</query>
		</queries>
	</server>
</servers>

Plik konfiguracyjny zapisany jest w formacie XML. Głównym węzłem w pliku jest <servers>, w którym znajdują się definicje serwerów Z39.50 (liczba serwerów nie jest ograniczona). Każdy serwer zdefiniowany jest w ramach znacznika <server> w którym znajdować się powinny następujące informacje w poszczególnych znacznikach:

Aby zmienić konfigurację rozszerzenia Z39.50 należy postępować zgodnie z informacjami zawartymi w sekcji konfiguracja aplikacji.