Automatyczna reorganizacja

Wprowadzenie

W przypadku utworzenia systemu poprzez skopiowanie z istniejącego systemu, w celu jego konfiguracji, konieczne jest uruchomienie kilku narzędzi w systemie źródłowym w ramach reorganizacji przed przystąpieniem do kopiowania. Po zakończeniu kopiowania na skopiowanym systemie również należy uruchomić kilka narzędzi.

Aplikacja Automatyczna reorganizacja wspomaga przeprowadzenie tych reorganizacji.

Grupa docelowa

• Programiści
• Konsultanci techniczni
• Administratorzy

Opis aplikacji

Aplikacja może wykonywać kroki reorganizacji, które zostały wcześniej zdefiniowane w pliku XML w Knowledgestore. Krok reorganizacji polega na wykonaniu narzędzia z określonymi parametrami. Po załadowaniu pliku poszczwególne kroki są wyświetlane na liście.

Reorganizacja nowego systemu utworzonego z kopii jest procesem czasochłonnym. Z tego powodu aplikacja oferuje opcję uruchamiania narzędzi za pośrednictwem aplikacji działającej w tle. Czynność tę można wybrać dopiero po odnotowaniu zapisu wykonania w pliku XML. Po ponownym załadowaniu pliku wyświetlane są narzędzia, które zostały pomyślnie wykonane.

System dostarcza dwa pliki reorganizacji jako plik obiektu deweloperskiego:

• com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationSourceScript – jako plik reorganizacji do przygotowania kopii
• com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationTargetScript – jako plik reorganizacji do reorganizacji skopiowanego systemu

Pliki są w formacie XML i pełnią rolę szablonu, zawierając narzędzia systemowe wymagane dla odpowiednich przypadków użycia. Przed każdą reorganizacją należy sprawdzić, czy plik reorganizacji wymaga dostosowania do danego systemu. Dostosowanie zazwyczaj obejmuje parametry narzędzi, ale konieczne jest również sprawdzenie, czy wszystkie narzędzia powinny zostać uruchomione, czy też należy je np. dodać.

Narzędzia są wykonywane na serwerze aplikacji systemu, na który zalogowany jest użytkownik. Dane wyjściowe narzędzi są zatem również zapisywane w plikach dziennika serwera aplikacji. Jeśli narzędzia nie są wykonywane w tle, dane wyjściowe są również wyświetlane w polu Wydruk w obszarze roboczym.

Aplikacja Automatyczna reorganizacja składa się z nagłówka i obszaru roboczego.

Nagłówek

Nagłówek zawiera pole pozwalające na dodanie pliku reorganizacji i pole opisu pliku reorganizacji.

Dostępne pola:

• Plik reorganizacji – należy wprowadzić ścieżkę do pliku reorganizacji w Knowledgestore.
• Oznaczenie – pole zawiera opis wczytanego pliku reorganizacji.

Obszar roboczy

Obszar roboczy składa się z listy poleceń wczytanego pliku reorganizacji i pola Wydruk.

Lista poleceń

Lista zawiera polecenia wczytanego pliku reorganizacji. Dostępne kolumny:

• Oznaczenie – opis narzędzia
• Polecenie – wyświetla pełną linię poleceń narzędzia
• Status – informacja w formie graficznej, czy narzędzie zostało wykonane pomyślnie (kolor zielony), czy nie (kolor czerwony).

Wydruk

Pole danych wyjściowych prezentuje dane wyjściowe wykonanych narzędzi, jeśli narzędzia nie są wykonywane za pośrednictwem aplikacji działającej w tle.

Akcje związane z aplikacją

W aplikacji Automatyczna reorganizacja dostępne są następujące akcje związane z aplikacją:

• Wykonaj wszystkie polecenia
• Automatyczna reorganizacja w tle

Wykonaj wszystkie polecenia

Wszystkie narzędzia w załadowanym pliku są wykonywane sekwencyjnie. Jeśli wykonanie zakończy się powodzeniem, status odpowiedniego wiersza zmieni kolor na zielony. Wynik działania narzędzi jest wyświetlany w polu Wydruk. Podczas przetwarzania pliku interwał odświeżania przeglądarki jest zmniejszony do dwóch sekund. Po przetworzeniu pliku interwał odświeżania zostanie zresetowany do wartości domyślnej.

Automatyczna reorganizacja w tle

Aplikacja działająca w tle wykonuje sekwencyjnie wszystkie narzędzia załadowanego pliku. Tę czynność można wybrać tylko wtedy, gdy załadowany plik odnotował zapisanie wykonania.

Opis formatu XML

Oprócz linii poleceń narzędzi, format XML skryptów reorganizacji oferuje również możliwość określenia opisów narzędzi, które są wyświetlane w kolumnie Oznaczenie na liście poleceń. Opisy te mogą być pobierane z tabeli ciągów znaków lub wprowadzane bezpośrednio w XML.

Element: script

Element XML tworzy nawias wokół wywołań narzędzi. Atrybut logging służy do określenia, czy wykonanie narzędzi powinno być zapisywane, czy nie:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<!--logging="true" dla przechowywania w bazie danych -->

<script logging="false">

</script>

Atrybut description jest używany, aby opis skryptu był wyświetlany w aplikacji Automatyczna reorganizacja:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<script description="Reorganizacja systemu źródłowego" log-ging="false">

</script>

Oznaczenie można również określić na podstawie tabeli łańcuchów. W pełni kwalifikowana nazwa obiektu deweloperskiego musi być określona w atrybucie stringtable. Atrybut tableid musi zawierać odpowiednią stałą tekstową z tabeli łańcuchowej, do której należy tekst opisu:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<script tableid="SCRIPT_DESCRIPTION" string-ta-ble="com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationSourceScript" logging="false">

</script>

Element: action

Element XML action służy do określenia narzędzia, które ma zostać wykonane. Atrybut command zawiera rzeczywistą linię poleceń:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<script logging="false">

<action command="dltdbt -oltp -olap -table:%"/>

</script>

Aby wyświetlić opis narzędzia w aplikacji Automatyczna reorganizacja, element action musi posiadać atrybut description:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<script logging="false">

<action description="Usuwanie tabel, które nie są wymagane" command="dltdbt -oltp -olap -table:%"/>

</script>.

Element action może również odtwarzać opisy z tabeli łańcuchowej. Stałe tekstowe określone w atrybucie elementu script są wyszukiwane w tabeli ciągów znaków. Poniżej znajduje się szablon reorganizacji w systemie źródłowym jako kompletny przykład:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<script tableid="SCRIPT_DESCRIPTION" string-ta-ble="com.cisag.sys.tools.automaticreorganization.AutomaticReorganizationSourceScript" logging="false">

<!-zamiast używać tabeli string do opisu polecenia możesz użyć atrybutu description -->

<!-- przykład: -->

<!-- <action description="Usuń nieużywane tabele" command="dltdbt -oltp -olap -table:%"/> -->

<action tableid="DELETE_NOT_USED_TABLES" command="dltdbt -oltp -olap -table:%"/>

<action tableid="MAKE_TABLES_CONSISTENT" command="rgzdbt -SBLOBs -configuration -repository -oltp -olap -modify"/>

<action tableid="CHECK_IS_DELIVERABLE" command="rgzrep -isdeliverable -verbose"/>

<action tableid="CHECK_GENERATION_ERRORS" command="chkdbt -analysetables -oltp -olap -repository -all"/>

</script>

Konfiguracja

Dla aplikacji Automatyczna reorganizacja nie ma potrzeby definiowania ustawień w aplikacji Konfiguracja.

Jednostki biznesowe

Jednostka biznesowa com.cisag.sys.tools.automaticreorganisation.obj.AutomaticReorganisation wykorzystywana jest w aplikacji Automatyczna reorganizacja, między innymi w celu:

• Przyporządkowywania uprawnień
• Definiowania działań
• Importu i eksportu danych

Uprawnienia

Uprawnienia mogą zostać przypisane za pomocą ról uprawnień jak również poprzez przyporządkowanie organizacji. Szczegółowe informacje można znaleźć w artykule Uprawnienia.

Możliwości specjalne

Dla aplikacji Automatyczna reorganizacja nie ma specjalnych możliwości.

Przyporządkowania organizacji

Przyporządkowania organizacji nie jest wymagane dla aplikacji Automatyczna reorganizacja.

Funkcje specjalne

Dla aplikacji Automatyczna reorganizacja nie są dostępne żadne funkcje specjalne.

Uprawnienia dla partnerów biznesowych

Aplikacja Automatyczna reorganizacja nie jest dostępna dla partnerów biznesowych.

Instrukcje

Poniżej przedstawiono wykorzystanie aplikacji Automatyczna reorganizacja.

Reorganizacja systemu w ramach przygotowań do kopiowania

1. Zapisać lokalnie plik obiektu tworzenia plików com.cisag.sys.tools.automaticreorganisation.AutomaticReorganisationSourceScript.
2. Sprawdzić, czy plik wymaga dostosowania: parametry narzędzi, w razie potrzeby należy dodać brakujące narzędzia.
3. Zapisać zmodyfikowany plik w Knowledgestore systemu, który ma zostać skopiowany.
4. Otworzyć aplikację Automatyczna reorganizacja.
5. Wczytać plik zapisany wcześniej w Knowledgestore.
6. Wybrać akcję: Wykonaj wszystkie polecenia.

Reorganizacja systemu utworzonego jako kopia

1. Zapisać lokalnie plik obiektu deweloperskiego: com.cisag.sys.tools.automaticreorganisation.AutomaticReorganisationTargetScript.
2. Sprawdzić, czy plik wymaga dostosowania: parametry narzędzi, w razie potrzeby należy dodać brakujące narzędzia.
3. Zapisać zmodyfikowany plik w Knowledgestore systemu, który ma zostać skopiowany.
4. Otworzyć aplikację Automatyczna reorganizacja.
5. Wczytać plik zapisany wcześniej w Knowledgestore.
6. Wybrać akcję: Automatyczna reorganizacja w tle.