Przegląd tematu
Narzędzie rgzrep umożliwia reorganizację bazy danych repozytorium zgodnie z określonymi parametrami. Jest to konieczne, na przykład, jeśli nowa baza danych repozytorium jest tworzona poprzez kopiowanie istniejącej bazy danych.
Grupa docelowa
- Administratorzy systemu
Opis
Po wykonaniu opcji wyświetlana jest tylko liczba obiektów, których dotyczy reorganizacja. Rzeczywiste usunięcie wybranych danych jest wykonywane tylko przy użyciu opcji commit. Aby ograniczyć liczbę danych, których dotyczy reorganizacja, można użyć określonych filtrów.
Polecenie
Poniżej znajduje się polecenie zawierające wszystkie możliwe parametry.
| rgzrep | [-updateOriginalSystemFlags] [-lockedObjects][-deleteOpenJobs] [-jobs] [-refreshes][-convertExported] [-oldVersions] [-killObjects] [-testObjects] [-internalUseOnlyObjects][-javaSources] [-helpSources] [-oldJavaClasses] [-adaptedTexts] [reorganiseLanguages] [-job:<str-1> … -job:<str-n>].
[-refresh:<str-1> … -refresh:<str-n>]. [-release:<str-1> … -release:<str-n>]. [-killObject:<str-1> … -killObject:<str-n>]. [-objectType:<int-1> … -objectType:<int-n>]. [-p:<str-1> … -p:<str-n>]. [-r] [-applicationCode] [-systemCode] [-imported] [-exported] [-convertExportedToImported] [-deleteArchiveNLS] [-testProtocols] [-userProperties] [-verbose] [-blockSize:<int>] [-commit] [-displayInformation] [-isDeliverable] [-ignoreWarnings] [-setObjectsToOriginal] |
Parametry
Parametry polecenia zostały wyjaśnione w poniższej tabeli. Parametry w nawiasach kwadratowych są opcjonalne, podczas gdy pozostałe są parametrami obowiązkowymi. Gwiazdka (*) może być określona jako symbol zastępczy dla niektórych parametrów, aby móc wyświetlić wszystkie możliwe wartości. Nie wszystkie parametry mogą być nazwane więcej niż jeden raz, tylko te z następującym dodatkiem do zmiennych parametrów są dozwolone do wielokrotnego nazywania: „<str-1> …. <str-n>”.
| Parametry | Wyjaśnienie |
| [-updateOriginal SystemFlags] | Oprócz identyfikatora GUID repozytorium, wartość logiczna jest przechowywana nadmiarowo w ObjectDirEntry, aby wskazać, czy obiekt deweloperski jest oryginalny w tym repozytorium. Jeśli ta opcja zostanie wywołana, wszystkie wartości logiczne są aktualizowane na podstawie bieżącego i wprowadzonego identyfikatora GUID repozytorium. |
| [-lockedObjects] | Usuwa wszystkie obiekty rozwojowe przetwarzane w zadaniu programistycznym. Przywracana jest jego poprzednia wersja. Nowo utworzone obiekty programistyczne są całkowicie usuwane. Zadania programistyczne muszą zostać usunięte oddzielnie. Ta opcja jest wymagana w przypadku konfigurowania nowego systemu jako kopii bieżącego systemu. Niedokończone prace rozwojowe są usuwane z kopii. |
| [-deleteOpenJobs] | Usuwa wszystkie otwarte zadania programistyczne. Wszystkie obiekty programistyczne powinny zostać wcześniej usunięte z zadań (lockedObjects). |
| [-jobs] | Całkowicie usuwa wszystkie zadania programistyczne systemu.Filtr: [-systemCode], [-applicationCode] |
| [-refreshes] | Usuwa wszystkie aktualizacje oprogramowania, w tym zależności i etykiety. Pliki w katalogu importu i eksportu nie są usuwane. Filtr: [-systemCode],[-applicationCode], [-imported],[-exported]. |
| [-convertExported] | Usuwa wszystkie zaimportowane aktualizacje oprogramowania i konwertuje wyeksportowane aktualizacje oprogramowania na zaimportowane. |
| [-oldVersions] | Usuwa stare wersje wszystkich obiektów deweloperskich z archiwum. Aktywna wersja i wersja aktualnie edytowana nie są usuwane. Usuwane są dane wersji, etykiety i archiwum.Filtr: [-systemCode],[-applicationCode], [ -objectType:<int-1> … -objectType:<int-n>], [-p:<str-1> … -p:<str-n>],[-r] |
| [killObjects] | Całkowicie usuwa wszystkie usunięte obiekty deweloperskie. ObjectDirEntry, wersja, etykieta i dane archiwum są usuwane. Filtr: [-systemCode],[-applicationCode], [-objectType:<int-1> … -objectType:<int-n>], [-p:<str-1> … -p:<str-n>],[-r] |
| [-testObjects] | Całkowicie usuwa wszystkie obiekty deweloperskie utworzone w testowej przestrzeni nazw. ObjectDirEntry, wersja, etykieta, archiwum i dane systemowe są usuwane.Filtr: [-systemCode],[-applicationCode], [-objectType:<int-1> … -objectType:<int-n>], [-p:<str-1> … -p:<str-n>], [-r] |
| [-internalUse OnlyObjects] |
Całkowicie usuwa wszystkie obiekty deweloperskie, które zostały utworzone w wewnętrznej przestrzeni nazw. ObjectDirEntry, wersja, etykieta, archiwum i dane systemowe są usuwane. Filtr: [-systemCode],[-applicationCode], [ -objectType:<int-1> … -objectType:<int-n>], [-p:<str-1> … -p:<str-n>], [-r] |
| [-javaSources] | Usuwa wszystkie pliki źródłowe Java z bazy danych repozytorium. Pliki w systemie plików nie są usuwane. |
| [-helpSources] | Usuwa wszystkie pliki źródłowe pomocy z bazy danych repozytorium. Pliki w systemie plików nie są usuwane. |
| [-oldJavaClasses] | Usuwa stare wersje klas Java z archiwum. Aktywna wersja i wersja aktualnie edytowana nie są usuwane. |
| [-adaptedTexts] | Usuwa wszystkie teksty dostosowane na poziomie wersjonowania 7 lub za pośrednictwem okna dialogowego właściwości technicznych. |
| [reorganizacja języków] |
Usuwa teksty i pliki pomocy dla wszystkich języków, które nie są skonfigurowane w bazie danych repozytorium. Powoduje to również usunięcie plików pomocy w systemie plików. |
| [-job:<str>] | Usuwa określone zadanie deweloperskie. Musi być ono już aktywowane lub nie może zawierać żadnych obiektów programistycznych. Wprowadzone instrukcje OQL są usuwane. |
| [-refresh:<str-1> … -refresh:<str-n>]. | Usuwa określoną aktualizację oprogramowania. Jako parametr należy podać identyfikator GUID aktualizacji oprogramowania. |
| [-release:<str-1> … -release:<str-n>]. | Usuwa określone wydanie ze wszystkimi powiązanymi etykietami. Jako parametr można podać nazwę wydania (np.: 1.1.0) lub identyfikator GUID wydania. |
| [-killObject:<str-1> … -killObject:<str-n>]. | Analogicznie do opcji [-killObjects]. Określony obiekt rozwojowy jest tutaj jawnie usuwany. Jako parametr można podać pełną nazwę obiektu rozwojowego wraz z typem obiektu (<nazwa obiektu rozwojowego>#<type-id>) lub identyfikator GUID obiektu rozwojowego. |
| [-objectType:<int-1> … -objectType:<int-n>]. | Filtrowanie typów obiektów deweloperskich. |
| [-p:<str-1> … -p:<str-n>]. | Filtrowanie przestrzeni nazw. |
| [-r] | Jeśli filtr jest używany na przestrzeniach nazw, brane są pod uwagę podstawowe przestrzenie nazw. |
| [-applicationCode] | Filtrowanie obiektów rozwojowych lub aktualizacji oprogramowania z kodu aplikacji. |
| [-systemCode] | Filtrowanie obiektów rozwojowych lub aktualizacji oprogramowania z kodu systemu. |
| [-imported] | Uwzględnia tylko zaimportowane aktualizacje oprogramowania. |
| [-exported] | Uwzględnia tylko wyeksportowane aktualizacje oprogramowania. |
| [-convertExported ToImported |
Konwertuje wszystkie wyeksportowane aktualizacje oprogramowania na zaimportowane aktualizacje oprogramowania. |
| [-deleteArchiveNLS] | Usuwa z bazy danych repozytorium teksty, które nie są już potrzebne. |
| [-testProtocols] | Usuwa wszystkie dzienniki przebiegu testów. |
| [-userProperties] | Usuwa wszystkie wpisy specyficzne dla użytkownika z bazy danych repozytorium: zapisane wyszukiwania, ulubione i przypisania użytkowników do ról autoryzacji. |
| [-verbose] | Wyjście w wierszu poleceń. |
| [-blockSize:<int>] | Ustawia rozmiar bloku dla transakcji bazy danych. Domyślną wartością jest 100. Wpis ma znaczenie tylko z opcją [-commit]. |
| [-commit] | Usuwa określone dane z bazy danych repozytorium. Bez tej opcji wyniki są wyświetlane tylko w konsoli. |
| [-displayInformation] | Wyświetla następujące informacje:·
|
| [-isDeliverable] | Wymagania jakie muszą zostać spełnione:
|
| [-ignoreWarnings] | Wszystkie ostrzeżenia są ignorowane. |
| [-setObjectsToOriginal] | ObjectDirEntry rejestruje dla każdego obiektu deweloperskiego, w którym systemie został utworzony i czy obiekt deweloperski jest oryginalny w tym repozytorium. Atrybuty te są dostosowywane dla wszystkich obiektów deweloperskich, które znajdują się w przestrzeniach nazw należących do bieżącego prefiksu deweloperskiego. RepositoryGuid jest zastępowany przez bieżący RepositoryGuid, a obiekty rozwojowe są oznaczane jako oryginalne w tym systemie. Polecenie to jest szczególnie przydatne po przeniesieniu adaptacji z poprzedniej wersji. Jeśli prefiks deweloperski pozostaje taki sam, oznacza to dokładnie te adaptacje jako oryginalne w nowej wersji. |
Uwagi:
- Podczas usuwania obiektów deweloperskich system nie sprawdza, czy istnieją odniesienia do tych obiektów. Dane repozytorium mogą być niespójne po usunięciu. Można to sprawdzić za pomocą narzędzia chkrep.
- Żaden obiekt deweloperski ze wskaźnikiem usunięcia nie może zostać trwale usunięty z systemu deweloperskiego, jeśli został dostarczony przy użyciu aktualizacji oprogramowania lub istnieje już jako kopia bazy danych repozytorium w innym systemie. W przeciwnym razie istnieje ryzyko, że obiekt zostanie utworzony w systemie deweloperskim z tą samą tożsamością. Prowadzi to do nierozwiązywalnego konfliktu podczas importu (ta sama przestrzeń nazw i nazwa, inny identyfikator GUID).
- Zaimportowane aktualizacje oprogramowania nigdy nie powinny być usuwane, ponieważ wskazują status kodu systemu. Wyjątkiem od tej zasady jest konfigurowanie systemu deweloperskiego dla nowej wersji. Może to również uniemożliwić importowanie kolejnych aktualizacji oprogramowania, ponieważ zależności nie są już poprawnie rozwiązywane.
- Stare wersje nie mogą być usuwane z archiwum w systemach korekty i rozwoju, ponieważ istniejące aktualizacje oprogramowania nie mogą być już eksportowane. Zarchiwizowane dane można usuwać z systemów testowych, dostawczych i produkcyjnych.
