Note | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
The programming library for that extension is Biblioteka programistyczna dla tego rozszerzenia to
|
Informacje ogólne
General information
By default, attributes from the MARC 21 communication format are imported on the basis of the configuration built into the extension. Instead of the default configuration, a configuration defined in external text files can be used. Their format is a simple set of properties. In order to indicate new configuration files for the extension, its configuration should be displayed (see the image below; displaying the configuration window is described in the configuration section). After the configuration has been displayed, the source of the new configuration (a file on the drive or a URL address) should be indicated and the “Use the configuration from the given source” option should be selected. Additionally, the character encoding for the MARC files to be imported should be specified. MARC character encoding depends on the information technology system from which such a file is importedImport atrybutów z formatu komunikacyjnego MARC 21 w rozszerzeniu MARC domyślnie opiera się na konfiguracji wbudowanej w rozszerzenie. Zamiast domyślnej konfiguracji można używać innej, zdefiniowanej w zewnętrznych plikach tekstowych. Pliki te mają format prostego zbioru właściwości. Aby wskazać nowe pliki konfiguracyjne rozszerzenia należy wyświetlić jego konfigurację (rysunek poniżej, wyświetlanie okna konfiguracji opisane jest w sekcji konfiguracja). Po wyświetleniu konfiguracji należy wskazać źródło nowej konfiguracji (plik na dysku lub adres URL) oraz zaznaczyć opcję Używaj konfiguracji z podanego źródła. Dodatkowo należy wyspecyfikować kodowanie plików MARC, które będą importowane. Kodowanie pliku MARC zależy od systemu informatycznego z którego taki plik pochodzi.
Anchor | ||||
---|---|---|---|---|
|
labelimg | ||||
---|---|---|---|---|
| ||||
Format pliku marcImport.properties
Code Block |
---|
Title=245:${a} ${b} ${n};130;210;222;240;246;730;740;en.Title=210;222;240;246;730;740; Creator=100;110;111; Subject= Description=6XX; Publisher=260a;260b;260f; Contributor=700;710;711; Date=260c; Type= Identifier=920;856u; Source= Language=041;546;008/35-37 Relation=250;534;440;490;800;810;811;830; Coverage= Rights=506;540;"PAN"; |
...
100;
- przykład użycia numeru pola.
Taki zapis spowoduje w przypadku pola specjalnego import wartości tego pola (należy pamiętać, że pola specjalne w formacie MARC, czyli te o wartości mniejszej niż 010, nie posiadają nigdy identyfikatorów podpól) do danego atrybutu, a w przypadku pozostałych pól import wszystkich wartości występujących we wszystkich podpolach tego pola do danego atrybutu. Każda wartość podpola będzie zaimportowana jako oddzielna wartość atrybutu.260c;
- przykład użycia numeru pola oraz identyfikatora podpola.
Taki zapis spowoduje import do atrybutu tylko wartości konkretnego podpola (w tym przypadkuc
danego pola (w tym przypadku pola260
).6XX;
- przykład użycia identyfikatora wielowartościowego.
Taki zapis spowoduje import do atrybutu wszystkich wartości pól i ich podpól z zakresu 600 - 699. W tym przypadku nie można wyspecyfikować konkretnych podpól. Możliwy jest także przykładowo zapis 65X;, który spowoduje analogiczny import wartości pól z zakresu 650 - 659.245:${a} ${b} ${n};
- przykład łączenia podpól pola MARC w jedną wartość.
Zapis ten możemy podzielić na dwie części, które oddzielone są od siebie znakiem : (dwukropkiem):245
- jest to numer pola, którego podpola będą łączone w jedną wartośćAnchor subfields subfields ${a} ${b} ${n}
- jest to szablon, który definiuje w jaki sposób łączyć podpola.
Zapis${a}
oznacza, że w jego miejsce ma zostać wstawiona wartość podpolaa
z pola o numerze zapisanym przez znakiem:
- w tym przypadku pola245
. Zatem zapis ten spowoduje, że podpolaa
,b
orazn
zostaną połączone w jedną wartość i będą oddzielone spacją. Przykładowo jeśli podpole245a
ma wartość wartość pierwsza, podpole245b
ma wartość wartość druga oraz podpole245n
ma wartość wartość trzecia to wynikiem takiego zapisu będzie wartość wartość pierwsza wartość druga wartość trzecia. Jeżeli chcielibyśmy aby podpola te oddzielał jakikolwiek inny znak lub ciąg znaków, wystarczy je wpisać (np.245:${a}-${b} popdole n: ${n};
). Wyjątkami są znaki ; (średnik), ukośnik \ oraz $ - aby te znaki zostały poprawnie zinterpretowane należy poprzedzić je ciągiem dwóch ukośnikówverbatim \\
(np.
verbatim 245:${a}${b}\\;${n};
). Polskie znaki diakrytyczne, oraz inne znaki spoza standardowego zestawu ASCII, muszą zostać przekonwertowane do kodów utf-8 w formacie
\uXXXX
, gdzie znakiX
to cyfry szesnastkowe (konwerter jest dostępny np. pod adresem http://rishida.net/tools/conversion/ - część JavaScript escapes).
008/35-37
- dotyczy tylko pól kontrolnych - oznacza pobranie zakresu znaków z pola kontrolnego.
Zapis ten składa się z dwóch części oddzielonych od siebie znakiem/
(ukośnik):008
- jest to numer pola kontrolnego z którego pobrane zostaną wartości35-37
- jest to zakres znaków jaki zostanie pobrany z pola o numerze, który występuje przed znakiem/
.
Zapis ten oznacza, że znaki 35, 36 oraz 37 z pola008
będą wartością tego zapisu. Jeśli pole008
na pozycji 35 ma znak p, na pozycji 36 ma znak o a na pozycji 37 ma znak l to wartością takiego zapisu będzie pol. Jeśli chcemy pobrać tylko jeden znak z okeślonej pozycji wystarczy ją wyspecyfikować po znaku/
, np.008/30
.
"PAN";
- jest wartość stała, dodawana do atrybutu niezależnie od zawartości wczytywanego pliku marc. Stałe wartości muszą być umieszczone w cudzysłowie"
. Podobnie jak w przypadku szablonów dla łączenia podpól, niektóre znaki muszą być poprzedzone dwoma ukośnikamiverbatim \\
: tym razem jest to cudzysłów
"
oraz ukośnik\
. Również potrzebna jest konwersja polskich liter i innych niestandardowych znaków do kodów utf-8.
Format pliku marcImpRemChars.properties
Code Block |
---|
end-245b=a|b begin-245a=OS/2 end-260c=c |
...
Przeanalizujmy następujący przykład: begin-245a=ab
. Zapis ten spowoduje, że program redaktora usunie z początku podpola 245a
ciąg znaków ab
o ile taki ciąg zostanie znaleziony na początku wartości tego podpola. Jeśli zatem w pliku MARC pole 245a
będzie miało wartość abBajki to po zastosowaniu mechanizmu usuwania znaków otrzymamy Bajki i taka właśnie wartość zostanie zaimportowana do opisu bibliograficznego.
Domyślna konfiguracja
Domyślnie rozszerzenie skonfugurowane jest następującymi plikami:
...