This chapter is about the functions and operations which make it possible to manage an attribute synonym dictionary, with step by step instructions for how to perform the operations

General information

Niniejszy podrozdział omawia szczegółowo funkcje i operacje umożliwiające zarządzanie słownikiem synonimów dla atrybutów, oraz opisuje kroki jakie należy podjąć, aby te operacje wykonać.

...

Anchor
attributesValuesManagement attributesValuesManagement

labelimg
Zarządzanie wartościami atrybutów Zarządzanie wartościami atrybutów
Image Removed

Interfejs do zarządzania wartościami atrybutów (rysunek powyżej) jest dostępny po wybraniu węzła pojedynczego atrybutu na Drzewie Biblioteki i wejściu na zakładkę Wartości. Jeśli biblioteka obsługuje wiele języków metadanych, wartości dla poszczególnych języków dostępne są po kliknięciu w odpowiednią zakładkę po lewej stronie. Wartości w obrębie języka również podzielone są na zakładki, aby ułatwić przeglądanie dużych słowników. Tytuł zakładki jest skróconą wersją pierwszej wartości należącej do tej zakładki (wszystkie wartości są posortowane w kolejności alfabetycznej). W przypadku bardzo dużych słowników, grupowanie wartości w zakładkach może odbywać się na kilku poziomach, tak jak to widać na przykładowym rysunku - zakładek z konkretnymi wartościami jest tak dużo, że same muszą być rozdzielone pomiędzy kilka zakładek. Wtedy tytuł zakładki nadrzędnej odpowiada tytułowi pierwszej zakładki podrzędnej.

Aby szybko znaleźć zakładkę zawierającą konkretną wartość, można wpisać całą wartość lub kilka pierwszych liter w pole tekstowe znajdujące się nad zakładkami z wartościami i kliknąć przycisk Szukaj. Jeśli wpisanej wartości nie ma w słowniku, zostanie otworzona zakładka, na której powinna się ona znaleźć (zgodnie z kolejnością alfabetyczną).

Każda zakładka z wartościami podzielona jest na dwie części - listę grup synonimów po lewej stronie oraz listę wartości w grupie po stronie prawej. Lista wartości wypełnia się wartościami po wyborze jednej z grup na liście z lewej strony. Każda lista ma dodatkowo zestaw przycisków umożliwiających wykonanie pewnych czynności na słowniku. Wszystkie dostępne akcje są omówione dokładnie w dalszej części tego rozdziału.

Zarządzanie grupami synonimów

Aby stworzyć nową grupę synonimów:

1. W polu edycji znajdującym się na samym dole zakładki z wartościami należy wpisać wartość, która stanie się wartością bazową w nowej grupie i jednocześnie stanowić będzie nazwę tej grupy. Nazwa nie może być już używana przez inną grupę.
2. Aby grupa została utworzona należy nacisnąć przycisk Dodaj znajdujący się na prawo od pola edycji.

Aby usunąć grupę synonimów:

1. Na liście grup należy wybrać pojedynczą grupę.
2. Należy nacisnąć przycisk Usuń, znajdujący się obok listy grup. Po potwierdzeniu chęci usunięcia, grupa i wszystkie jej wartości zostaną usunięte z listy i z systemu.

Uwaga! Jeżeli którakolwiek z wartości znajdujących się w grupie jest powiązana z opisem bibliograficznym jakiegoś elementu biblioteki, to system nie usunie tej grupy tylko wyświetli komunikat o konieczności usunięcia wszystkich powiązań.

Aby połączyć dwie grupy synonimów:

The interface for managing attribute values (see the image above) is available after the user has selected a single attribute node in the library tree and clicked the “Values” tab. If the library supports many metadata languages, the values for a particular language are accessed by clicking the appropriate tab on the left. Values within a language are also divided into tabs, in order to facilitate browsing big dictionaries. A tab title is a shortened version of the first value belonging to that tab (all values are sorted in alphabetical order). In the case of very big dictionaries, values can be grouped in tabs at several levels, as shown in the sample image: there are so many tabs with particular values that the tabs themselves must be divided among several tabs. In such a case, the superordinate tab title corresponds to the title of the first subordinate tab.

In order to quickly find a tab with a specific value, the user can enter the whole value or just a few of its initial letters in the text field below the tabs with values and click the “Search” button. If the dictionary does not contain the entered value, the tab in which that value should (alphabetically) be placed will be opened.

Every tab with values is divided into two parts: a list of synonym groups on the left and a list of group values on the right. The value list is populated with values once a group is selected on the left. Additionally, both lists have sets of buttons for performing certain actions on a dictionary. All available actions are discussed in detail further in this chapter.

Managing Synonym Groups

In order to create a new synonym group:

1. In the edition field at the very bottom of a “Values” tab, type in the value which will become both the base value and name of the new group. The name cannot be the name of another group.
2. To save the group, click the “Add” button on the right side of the edition field.

In order to remove a synonym group:

1. Select a group from the group list.
2. Click the “Remove” button next to the group list. After you have confirmed that you want to remove the group, it will be removed, together with all its values, from the list and from the system.

Caution! If any value in a group is related to a bibliographic description of a library element, the system will not remove that group; instead, it will display a message about the necessity to remove all relations.

In order to merge two synonym groups:

1. On the list, select the group to be merged with another group.
2. Click the “Merge” button. Once you have confirmed the action, the window for selecting the target group will be displayed.

3. In the window (see the image below), select the group to which the previously chosen group is to be added. Just like in the main value edition window, when there are many groups, they can be divided among several tabs. In order to quickly open a tab with a specific value, the user can enter the whole value or just a few of its initial letters and click the “Search” button

4. Należy z listy wybrać grupę, która ma zostać połączona z inną.
5. Należy nacisnąć przycisk Połącz. Po potwierdzeniu pojawi się okno wyboru grupy docelowej .
6. W oknie (rysunek poniżej) należy wybrać grupę, do której wcześniej wybrana grupa ma zostać dołączona. Tak jak w głównym oknie edycji wartości, w przypadku dużej liczby grup mogą one zostać rozdzielone na wiele zakładek. Wpisanie wartości (lub kilku pierwszych liter) i kliknięcie przycisku Szukaj pozwoli szybko otworzyć wymaganą zakładkę

   .
   

   Anchor
   chooseGroup chooseGroup

   labelimgWybieranie grupy do połączeniaWybieranie grupy do połączenia

   Image Removed

7. Aby zakończyć proces łączenia grup należy nacisnąć przycisk Zatwierdź. Pierwotnie wybrana grupa zostanie połączona z nową w tym sensie, że stara grupa zostanie usunięta a jej wszystkie wartości zostaną dołączone do nowej.
   Uwaga! Jeżeli w docelowej grupie już znajduje się wartość o takiej samej nazwie jak którakolwiek z wartości z grupy wybranej do połączenia, to system nie połączy tych grup tylko wyświetli komunikat, że ta operacja nie mogła być wykonana. Należy przed połączeniem zadbać, aby w obu grupach nie powtarzały się nazwy wartości.

Zarządzanie wartościami atrybutów

Wszystkie operacje są wykonywane po wybraniu konkretnej grupy na liście z lewej strony.
Aby dodać wartość do grupy:

1. W polu edycji znajdującym się pod listą z wartościami należy wpisać wartość, która ma zostać dodana do grupy. Nazwa nie może być już używana przez inną wartość w tej grupie.
2. Aby wartość została dodana należy nacisnąć przycisk Dodaj znajdujący się obok pola edycji lub wcisnąć klawisz enter w polu edycji.

Aby usunąć wartość z grupy:

1. Należy wybrać z listy wartość, która ma zostać usunięta.
2. Należy nacisnąć przycisk Usuń znajdujący się obok listy. Wartość zostanie usunięta z listy i z systemu.
   Uwaga! Jeżeli wartość ta jest powiązana z opisem bibliograficznym jakiegoś elementu biblioteki, to system nie usunie tej wartości tylko wyświetli komunikat o konieczności usunięcia wszystkich powiązań.

Aby zmienić wartość (spowoduje to zmianę opisu bibliograficznego wszystkich publikacji powiązanych z tą wartością):

1. Należy wybrać z listy wartość, która ma być zmieniona.
2. Należy nacisnąć przycisk Edytuj. Pojawi się okienko umożliwiające edycję wartości atrybutu.
3. Należy podać nową frazę dla wartości i nacisnąć przycisk Zatwierdź. Jeżeli edytowana wartość była wartością bazową w grupie, to nazwa grupy również ulegnie zmianie na nową.

Uwaga 1: Nowa fraza dla wartości nie może być taka sama jak wartość już istniejąca w tej samej grupie. Jeśli wszystkie publikacje powiązane z edytowaną wartością mają zostać powiązane z istniejącą wartością, należy skorzystać z funkcji połącz (zostało to opisane poniżej).

1. 
   Image Added

2. In order to finish the group merging process, click the “Confirm” button. The initially selected group will be merged with the target group, that is, the former group will be removed and all its values will be added to the latter.

Caution! If the target group already contains a value with the same name as any of the values of the initially selected group, the system will not merge the two groups; instead, it will display a message informing you that the operation was unsuccessful. For that reason, before a merger, the value names of the groups to be merged should be verified with respect to possible overlaps.

Managing Attribute Values

All operations are performed once a group has been selected on the list on the left.

In order to add a value to a group:

1. In the edition field under the value list, enter the value which is to be added to the group. The name cannot be the name of another value in that group.
2. In order to add the value, click the “Add” button next to the edition field or press the “Enter” key while the cursor is in the edition field.

In order to remove a value from a group:

1. Select the value to be removed from the list.
2. Click the “Remove” button next to the list. The value will be removed from the list and from the system.

Caution! If the value is related to a bibliographic description of an element of the library, the system will not remove the value; instead, it will display a message about the necessity of removing all those relations.

In order to change a value (which will cause a change of bibliographic descriptions of all publications related to that value):

1. Select the value to be changed from the list.
2. Click the “Edit” button. The attribute value edition window will be displayed.
3. Enter the new phrase for the value and press the “Confirm” button. If the edited value was the base value of its group, the name of the group will also be changed to the new phrase.

Caution no. 1: The new phrase for a value cannot be the same as another value in the same group. If all publications related to the edited value are to remain related to the existing value, use the “Merge” function (for a description of that process, see below).

Caution no. 2: When the base value of a group is edited, it should be verified if the target value is not the base value of another group. In the case of a duplication, since two groups cannot have the same base value, the system will suggest a merger of the edited group with the group which has the same valueUwaga 2: W przypadku edycji wartości bazowej w grupie, należy uważać, czy docelowa wartość nie jest wartością bazową innej grupy. Ponieważ dwie grupy nie mogą mieć takiej samej wartości bazowej, w przypadku duplikacji system zaproponuje połączenie edytowanej grupy z grupą odpowiadającą nowej frazie.

...

Image Removed

...

In order to merge two values in a group:

1. On the list, select the value to be merged with another value.
2. Click the “Merge” button next to the value list. Once you have confirmed the action, there will appear a window constructed in the same way as the window for selecting the target group. It will contain a list of values with which the initially selected value can be merged.
3. On that new list, select the value with which the initially selected value is to be merged.
4. In order to finish the value merging process, click the “Confirm” button. The initially selected value will be merged with the target value, that is, the former value will be removed and all references to it will be replaced with references to the latter value.

In order to move a value to a new group:

1. Select the value which is to be moved to another group.
2. Click the “Move” button. Once you have confirmed the action, there will appear a window with a list of groups to which the selected value can be moved.
3. On that new list, select the group to which the initially selected value is to be added.
4. In order to finish the value moving process, click the “Confirm” button. The initially selected value will be moved to the new group.

Caution! If the target group already contains a value with the same name, the transfer will not be possible. In such a case, the name of either of the former or the latter value must first be changed.

In order to remove value relations:

1. Select the value the relations of which are to be removed.

2. Click the “Editions...” button. There will appear a new window, with a list of editions and directories the bibliographic descriptions of which are related to the selected value. If you click the “Cancel” button at any time, the changes will be undone

1. Z listy należy wybrać wartość, która ma zostać połączona z inną wartością.
2. Należy nacisnąć przycisk Połącz znajdujący się obok listy z wartościami. Po potwierdzeniu chęci połączenia wartości, pojawi się nowe okienko (zbudowane tak samo jak okno wyboru grupy) zawierające listę wartości, do których można połączyć wybraną wcześniej wartość.
3. Z nowej listy należy wybrać wartość, do której wcześniej wybrana wartość ma zostać dołączona.
4. Aby zakończyć proces łączenia wartości należy nacisnąć przycisk Zatwierdź . Pierwotnie wybrana wartość zostanie połączona z nową w tym sensie, że stara wartość zostanie usunięta a wszystkie do niej odwołania zostaną zastąpione odwołaniami do nowej wartości.

Aby przenieść wartość do nowej grupy:

1. Należy wybrać wartość, która ma zostać przeniesiona do innej grupy.
2. Należy nacisnąć przycisk Przenieś. Po potwierdzeniu chęci przeniesienia wartości, pojawi się okno z listą grup, do których można przenieść wybraną wcześniej wartość.
3. Z nowej listy należy wybrać grupę, do której wcześniej wybrana wartość ma zostać dołączona.
4. Aby zakończyć proces przenoszenia wartości do nowej grupy, należy nacisnąć przycisk Zatwierdź. Pierwotnie wybrana wartość zostanie przeniesiona do nowej grupy.
   Uwaga! Jeżeli w docelowej grupie już znajduje się wartość o takiej samej nazwie, to przeniesienie będzie niemożliwe. W takim przypadku przeniesienie wymaga uprzedniej zmiany nazwy wartości przenoszonej lub wartości powodującej konflikt w grupie docelowej.

Aby usunąć powiązania wartości:

1. Należy wybrać z listy wartość, której powiązania mają zostać usunięte.

2. Należy nacisnąć przycisk Wydania.... Pojawi się nowe okienko zawierające listę wydań i katalogów, których opisy bibliograficzne są powiązane z wybraną wartością. Naciśnięcie w dowolnym momencie przycisku Anuluj cofnie poczynione zmiany.

   labelimg
   Lista wydań i katalogów powiązanych z wartością Lista wydań i katalogów powiązanych z wartością

   Image Removed

   Należy nacisnąć przycisk Usuń powiązania. Wszystkie wydania i katalogi znikną z listy.
   Uwaga! W przypadku braku praw do modyfikacji któregokolwiek z wydań bądź katalogów, pojawi się komunikat o braku uprawnień i żadne z powiązań nie zostanie usunięte

   Image Added

   
   

3. Click the “Remove relations” button. All editions and directories will disappear from the list. Caution! When the user does not have permissions for modifying any of the editions or directories, there will appear a message about the lack of permissions, and no relation will be removed.

4. Należy nacisnąć przycisk Zatwierdź w celu zakończenia procesu usuwania powiązań.

Importowanie grup wartości do słownika

Na panelu zarządzania słownikiem atrybutu znajduje się przycisk Importuj..., który pozwala redaktorowi lub administratorowi na importowanie grup wartości z zewnętrznych źródeł. Program zakłada, że wszystkie zaimportowane wartości należą do tego języka, który jest wybrany spośród zakładek z językami. Analogicznie, przycisk Eksportuj... pozwala na wyeksportowanie wartości w aktualnie wybranym języku, na przykład do pliku na dysku. Mechanizm importowania/eksportowania grup wartości słownika działa na podstawie rozszerzeń, które takie funkcje udostępniają. Domyślnie w systemie dLibra znajdują się następujące rozszerzenia:

• Import słownika z plików w formacie MARC 21
• Import i eksport słownika - zapisuje i odczytuje proste pliki xml.

Szczegółowe informacje działaniu i konfiguracji rozszerzeń odpowiedzialnych za import i eksport grup wartości można znaleźć tutaj

...

Importing Value Groups to a Dictionary

In the attribute dictionary management panel, there is a button labeled “Import...”. The editor or administrator can use it to import value groups from external sources. In the program, it is assumed that all imported values belong to the language selected from the language tabs. Similarly, the “Export...” button makes it possible to export values in the currently selected language – to, for example, a file on the drive. The mechanism for importing and exporting dictionary value groups operates on the basis of extensions which offer such functionalities. The default dLibra extensions with those functionalities are:

• dictionary import from files in the MARC 21 format, and
• importing and exporting a dictionary – for saving and reading simple XML files.

For detailed information about the functioning and configuration of extensions for importing and exporting value groups, see here.

If the application only has one extension for managing a particular operation, the control is transferred to that extension when the “Import...” or “Export...” button is clicked, and then the user should follow the instructions given in the description of that extension. If there are more such extensions, the user should first select the extension to be used and then follow the instructions given in the description of the selected extension.