Repozytoria tenantów

Podsumowanie:

W trybie obsługi wielu tenantów obowiązują specjalne zasady dotyczące repozytoriów plikowych.

W nowych środowiskach repozytoria dyskowe wszystkich tenantów znajdują się w ścieżce określonej przez wartość parametru Directory location for relative paths of file repositories (TenantAdminSPA > Global settings).

Podkatalog dla każdego tenanta jest określony przez wartość klucza SubDirName w sekcji FileStorageConfiguration w ustawieniach konfiguracyjnych tenanta (TenantAdminSPA > Edit tenant > Configuration > Settings). Domyślnie ta wartość jest równa identyfikatorowi GUID tenanta.

Dodatkowo, drugi parametr w sekcji FileStorageConfiguration, AllowUseRepoFullDir, określa, czy konsultanci danego tenanta mogą definiować repozytoria, używając ścieżek względnych, czy bezwzględnych.

Dla nowych tenantów wartość domyślna to false — konsultanci mogą definiować repozytoria używając wyłącznie ścieżek względnych odnoszących się do podkatalogu tenanta w katalogu głównym repozytoriów.

W przypadku aktualizacji nAxiom z wersji sprzed obsługi wielu tenantów parametr ten ma wartość true. W takim przypadku konsultanci tego tenanta będą mogli określać repozytoria dyskowe, używając tylko ścieżek bezwzględnych.

Tabela core.AttachmentRepositories zawiera trzy kolumny do obsługi repozytoriów tenantów:

• TableName: nazwa tabeli w przypadku repozytorium bazodanowego.
• AbsoluteDirectory: ścieżka bezwzględna do repozytorium dyskowego.
• RelativeDirectory: ścieżka względna do repozytorium dyskowego.

Instalator ustawia wartość parametru AllowUseRepoFullDir na podstawie danych z kolumny AbsoluteDirectory w bazie danego tenanta. Jeśli ta kolumna jest pusta, parametr ma wartość false.

Aby dla konkretnego tenanta przejść ze ścieżek bezwzględnych na ścieżki względne, należy wykonać następujące kroki:

1. Utwórz katalog główny repozytoriów dyskowych (jeśli nie istnieje) zgodnie z wartością parametru Directory location for relative paths... na stronie Global settings w aplikacji TenantAdminSPA.
2. W katalogu głównym utwórz podkatalog o nazwie określonej przez klucz SubDirName w sekcji FileStorageConfiguration w ustawieniach konfiguracyjnych tenanta.
3. Skopiuj do tego podkatalogu katalogi repozytoriów wraz z zawartością.
4. Usuń dane z kolumny AbsoluteDirectory w tabeli core.AttachmentRepositories w bazie danych tenanta.
5. Zmień wartość klucza AllowUseRepoFullDir z true na false.
6. Uruchom ponownie witrynę.
7. Poleć konsultantom tenanta utworzenie repozytoriów o nazwach odpowiadających przenoszonym repozytoriom.

Przykład:

W wyniku aktualizacji witryny nAxiom z repozytoriami dyskowymi tworzony jest pierwszy tenant o identyfikatorze GUID 82229a18-dbd5-44b7-8266-c892a369676a, dla którego klucz AllowUseRepoFullDir ma wartość true. Strukturę katalogów repozytoriów przedstawiono poniżej.

Aby przełączyć tego tenanta na korzystanie ze ścieżek względnych, należy skopiować katalogi repozytoriów z zawartością do katalogu jak na ilustracji poniżej oraz wykonać pozostałe kroki powyższej procedury.

Ścieżka C:\inetpub\n155_1100nax\SystemRepositories\ to wartość parametru Directory location for relative paths....

---