Import zawartości obszaru pracy (impwspcnt)

Wprowadzenie

Narzędzie expwspcnt może być używane do eksportowania zawartości obszaru roboczego do pliku archiwum. Wraz z narzędziem impwspcnt możliwe jest przeniesienie zawartości z jednego obszaru pracy do innego obszaru pracy. Taki transfer jest również możliwy między różnymi systemami Comarch ERP Enterprise i/lub różnymi statusami wydania. Innym możliwym zastosowaniem tych dwóch narzędzi jest tworzenie kopii zapasowych zawartości obszaru pracy.

W porównaniu z opcją kopiowania zawartości obszaru pracy za pośrednictwem protokołu WebDAV, narzędzia te działają wydajniej i oprócz danych mogą również przesyłać metadane (atrybuty) plików i folderów. Kopiowanie danych między dwoma obszarami pracy jest również możliwe za pomocą narzędzia cpywspfld, ale zaangażowane obszary pracy muszą wtedy należeć do tego samego systemu i być dostępne w tym samym czasie.

Narzędzia expwspcnt i impwspcnt używają własnego formatu archiwum (*.sar) do zapisywania danych. Ten format jest porównywalny do skompresowanego archiwum tar, ale został opracowany specjalnie dla wymagań obszarów pracy Comarch ERP Enterprise. Zapewnia to, że oprócz rzeczywistych danych, wszystkie metadane (atrybuty) mogą być zapisywane i przywracane bez utraty. Ponadto duże archiwa mogą być automatycznie dzielone na kilka mniejszych pojedynczych plików w celu uniknięcia ewentualnych ograniczeń dotyczących używanych systemów plików lub nośników.

Grupa docelowa

  • Administratorzy systemu
  • Konsultanci techniczni

Definicje terminów

  • Repozytorium wiedzy — pliki dokumentów, tj. pliki fizyczne, są przechowywane w repozytorium wiedzy Knowledge Store. Knowledge Store należy rozumieć jako wirtualny dysk na komputerze, który umożliwia dostęp do zawartości baz danych. W szczególności ten wirtualny dysk jest folderem internetowym, który reprezentuje zawartość bazy danych przechowywaną za pośrednictwem serwera internetowego systemu.
  • Obszar roboczy — repozytorium wiedzy Knowledge Store jest podzielone na obszary robocze. Istnieje oddzielna przestrzeń robocza dla repozytorium i dla każdej bazy danych OLTP, która zawsze nosi nazwę odpowiedniej bazy danych.

Opis narzędzia

Narzędzie impwspcnt, służy do importu folderów i plików zapisanych w pliku archiwum do obszaru roboczego. Odpowiednie pliki archiwum można utworzyć za pomocą narzędzia expwspcnt. Połączenie narzędzi expwspcnt i impwspcnt może być używane zarówno do zapisywania i przywracania zawartości obszaru roboczego, jak i do przenoszenia/kopiowania zawartości między różnymi obszarami roboczymi.

Podczas wywoływania narzędzia można wybrać, czy ma zostać zaimportowana cała zawartość archiwum, czy tylko określone foldery i/lub pliki. Można także określić, w którym folderze docelowym ma być przechowywana zawartość.

Przykład
Importowanie całej zawartości pliku archiwum „C:\Archive\abc1.sar” do folderu głównego (/) obszaru roboczego ABC:

impwspcnt -archive:C:\Archive\abc1 -workspace:ABC

Przykład
Importowanie folderu „Delivery notes/” z pliku archiwum „C:\Archive\abc.sar2” do folderu „/Documents/Test/” obszaru roboczego ABC.

impwspcnt -archive:C:\Archive\abc2 -path:Delivery notes

-workspace:ABC -folder:/Documents/Test/

Uwaga
Zdalne obszary pracy nie są obsługiwane przez to narzędzie. Powinny one być eksportowane/importowane bezpośrednio do systemu, w którym są fizycznie przechowywane.
Uwaga
Narzędzie to może importować/przywracać tylko te informacje, które zostały zapisane w pliku archiwum (zobacz odpowiednie ostrzeżenie w opisie narzędzia expwspcnt). Zapisane informacje związane z użytkownikami („utworzony przez”, „ostatnio zmodyfikowany przez”, …) mogą być przywrócone tylko wtedy, gdy odpowiedni użytkownicy istnieją również w systemie docelowym. Jeśli zapisany użytkownik jest nieznany w systemie docelowym, automatycznie używana jest nazwa użytkownika, wykonującego import (zazwyczaj ADMINISTRATOR).
Uwaga
Foldery i pliki używają zarówno swojej unikalnej nazwy (ścieżki), jak i wewnętrznego identyfikatora GUID jako funkcji identyfikacyjnej. Chociaż te wewnętrzne identyfikatory GUID są również zapisywane w archiwach, zazwyczaj nie są one przywracane podczas importu, ale zastępowane istniejącymi lub nowymi identyfikatorami GUID (w zależności od tego, czy plik lub folder istnieje już w docelowym obszarze roboczym, czy nie). Identyfikator GUID jest przywracany z archiwum tylko wtedy, gdy archiwum zostało utworzone z parametrem -absolute-names i żaden obiekt o identycznym identyfikatorze GUID nie istnieje w docelowym obszarze roboczym.

Polecenie

Poniżej znajduje się polecenie wraz ze wszystkimi możliwymi parametrami:

impwspcnt -archive:<str> [-path:<str-1> … -path:<str-n>] [-exclude:<str-1> … -exclude:<str-n>][-noRecursion]

-workspace:<str> [-folder:<str>] [-overwrite:<vs>]

[-verbose] [-show-progress] [-simulate]

impwspcnt -archive:<str> -info

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ć określone więcej niż jeden raz; tylko te z następującym dodatkiem do zmiennych parametrów są dozwolone do wielokrotnego określenia: „<str-1> … <str-n>”.

Parametr Opis
-archive:<str> Nazwa i lokalizacja przechowywania (katalog) pliku archiwum, którego zawartość ma zostać zaimportowana. Musi to być prawidłowa ścieżka pliku dla lokalnego serwera aplikacji. Rozszerzenie .sar jest dołączane automatycznie i może zostać pominięte. Jeśli archiwum jest podzielone na kilka pojedynczych plików, muszą one być zgodne z konwencjami nazewnictwa, które są również używane przez narzędzie expwspcnt.
[-path:<str-1>

-path:<str-n>]

Ten parametr może być użyty do ograniczenia, które foldery i pliki są importowane z archiwum. Żądane pliki lub podfoldery można określić za pomocą ich nazw ścieżek. Nazwy działają jak filtr i mogą również zawierać znaki wieloznaczne (*, ?).

Jeśli opcja -path nie zostanie użyta, wszystkie foldery i pliki zostaną zaimportowane z archiwum.

[-exclude:<str-1>

-exclude:<str-n>]

Ten parametr może być użyty do wykluczenia określonych folderów i plików z importu. Określone ciągi znaków mogą zawierać symbole wieloznaczne (*, ?) i są stosowane jako filtr do ścieżki każdego folderu i każdego pliku.

Specyfikacja -exclude:*.bak, na przykład, wpływa nie tylko na wszystkie pliki kończące się na .bak, ale także na całe foldery wraz z ich zawartością. Należy również zauważyć, że w filtrach rozróżniana jest wielkość liter.

[-noRecursion] Standardowo wszystkie foldery (lub foldery wybrane przez -path) są importowane rekurencyjnie. Określając parametr -noRecursion, można wpłynąć na to zachowanie, tak aby importowane były tylko pliki znajdujące się bezpośrednio w wybranych folderach.
-workspace:<str> Nazwa obszaru roboczego, do którego ma zostać zaimportowana zawartość pliku archiwum.
[-folder:<str>] Nazwa bezwzględnej ścieżki folderu, który ma zostać użyty jako miejsce docelowe dla importowanych danych. Wszystkie względne ścieżki w archiwum są następnie rozwiązywane względem ścieżki tego folderu.

Jeśli ten parametr nie jest ustawiony, wszystkie pliki i foldery są przechowywane względem folderu głównego (/) obszaru roboczego.

Uwaga
Parametr jest ignorowany, jeśli archiwum zostało utworzone z opcją -absolute-names.
[Overwrite:<vs>] Ten parametr może być użyty do określenia, jak narzędzie powinno się zachować, jeśli plik lub folder do zaimportowania już istnieje w docelowej przestrzeni roboczej. Do wyboru są trzy opcje:

1 — zastąp wszystko (ustawienie domyślne). Zawartość i metadane istniejących plików i folderów są nadpisywane danymi z archiwum.

2 — pozostaw bez zmian. Zawartość istniejących plików i folderów zostanie zachowana.

3 — nadpisz tylko starsze pliki. Zawartość i metadane istniejących plików i folderów są nadpisywane tylko wtedy, gdy dane z archiwum mają nowszą datę.

[-verbose] Ten parametr może być użyty do aktywowania dodatkowych wyjść na konsoli. Dla każdego zaimportowanego pliku/folderu wyświetlany jest jeden wiersz.
[-show-progress] Ten parametr może być użyty do aktywacji dodatkowego wyjścia na konsoli, które informuje o postępie w regularnych odstępach czasu (około 30 sekund).
[-simulate] Symuluje import bez zmiany docelowego obszaru roboczego.
[-info] Wyświetla ogólne informacje o archiwum na konsoli.

Czy ten artykuł był pomocny?