Wdrażanie masowe opcji konfiguracji

Aby utworzyć lub zmodyfikować opcje konfiguracji, można przekazać plik z wartościami rozdzielonymi przecinkami (CSV) zawierający informacje o nowych i/lub zmienionych opcjach oraz wartościach. Opcje i wartości można wprowadzić lub zmodyfikować w odpowiednich kolumnach. Po przekazaniu pliku do aplikacji GAX następuje utworzenie lub zmodyfikowanie uwzględnionych w nim opcji na podstawie działania wskazanego w kolumnie Działanie.

Aplikacja GAX umożliwia też pobranie (lub wyeksportowanie) informacji o wybranych opcjach. Pobrany plik może służyć do utworzenia „szablonu” przekazywania danych.

Funkcja importu/eksportu opcji konfiguracji jest dostępna dla wszystkich typów obiektów.

Opcje eksportu

Aplikacja GAX umożliwia eksportowanie wybranych opcji do arkusza kalkulacyjnego. W zależności od potrzeb można odpowiednio zmodyfikować arkusz, zapisać go jako plik .csv lub .cfg i przekazać z powrotem do aplikacji GAX. Można też usunąć z niego dane (poza nagłówkami kolumn), a następnie używać tego „pustego” szablonu do przekazywania zaktualizowanych opcji konfiguracji w przyszłości.

Aby wyeksportować opcje, wykonaj następujące czynności:

1. W składniku Configuration Manager otwórz kartę Opcje obiektu, którego opcje chcesz wyeksportować.
2. Wybierz sekcje i opcje do wyeksportowania.
3. Kliknij opcję Eksportuj w menu Więcej znajdującym się nad listą opcji w prawym rogu.
4. W oknie dialogowym Eksportowanie opcji wybierz format pliku wyjściowego (CFG lub CSV) i kliknij przycisk Eksportuj.
   Plik wyjściowy zostanie utworzony, a następnie pobrany w przeglądarce z nazwą i formatem
        <object type>_annex_<object DBID>.csv lub cfg
   Na przykład:
        CfgPerson_annex_6378.cfg lub CfgPerson_annex_6378.cfg

Przekazywanie pliku

Przed przekazaniem aktualizacji masowych należy wprowadzić dane w arkuszu kalkulacyjnym i zapisać go jako plik CSV. Warto pamiętać o następujących zaleceniach:

• Jeśli większość aktualizacji polega na dodaniu nowych opcji do obiektu, należy utworzyć pusty szablon i wypełnić go odpowiednimi wartościami.
• Jeśli przede wszystkim są zmieniane istniejące opcje, należy wyeksportować tylko zmieniane opcje i wprowadzić zmiany.

Aby przekazać dane do aplikacji GAX, wykonaj następujące czynności:

1. W składniku Configuration Manager otwórz kartę Opcje obiektu, do którego chcesz przekazać opcje.
2. Kliknij opcję Importuj w menu Więcej znajdującym się nad listą opcji w prawym rogu.
3. W oknie dialogowym Importowanie obiektów:
   1. Kliknij opcję Wybierz plik i wybierz plik .csv lub .cfg zawierający zmiany.
   2. Jeśli masz pewność, że plik zawiera dokładne i najbardziej aktualne wartości opcji, które już mogą istnieć w obiekcie, wybierz opcję Nadpisz istniejące opcje. W przeciwnym razie nie wybieraj jej.
   3. Kliknij przycisk Przekaż.
4. Po przetworzeniu rekordów zostanie wyświetlone okno dialogowe Operacja zakończona z podsumowaniem wyników. Kliknij przycisk Zamknij, aby wrócić do karty Opcje.

Plik źródłowy

W aplikacji GAX pliki .csv (wartości rozdzielone przecinkami) i .cfg służą do importowania i eksportowania opcji konfiguracji. Oba formaty umożliwiają importowanie i eksportowanie opcji wyłącznie w postaci ciągu znaków. Opcje konfiguracji innych typów są ignorowane. Wszystkie ciągi w tym pliku muszą być zakodowane w standardzie UTF-8.

Ważne

Zawartość pliku dotyczy tylko jednego obiektu.

Każdy wiersz pliku źródłowego CSV reprezentuje jedną opcję konfiguracji. Dana opcja może się pojawiać w pliku źródłowym tylko jeden raz. Jeśli sekcji opcji konfiguracji jeszcze nie ma w konfiguracji obiektu, zostaje utworzona. Unikatowym identyfikatorem opcji w zakresie pliku źródłowego jest połączenie pól Sekcja i Klucz. Plik ma trzy kolumny — sekcji opcji konfiguracji, nazwy opcji (klucz) i wartości opcji. Nazwy kolumn znajdują się w pierwszym wierszu pliku — odpowiednio Section (sekcja), Key (klucz) i Value (wartość). Kolejność kolumn nie jest ważna. Po każdym wpisie kolumny jest wstawiany przecinek. Plik źródłowy zawiera następujące informacje dla każdej opcji:

Nazwa	Typ	Obowiązkowe	Opis
Sekcja	Ciąg	Tak	Nazwa pliku konfiguracji.
Klucz	Ciąg	Tak	Nazwa opcji.
Wartość	Ciąg	Nie	Nowa wartość opcji.

W pliku CFG każda sekcja i opcja znajduje się w oddzielnym wierszu, a nazwy sekcji są umieszczone w nawiasach kwadratowych. W każdej sekcji znajduje się lista opcji oraz towarzyszących im odpowiednich wartości, takich jak:

[section_name1]
option-name1=option_value2
...
option_nameN=option_valueN

[section_name2]
option-nameN+1=option_valueN+1
...

Przykład

Poniższe dane należy przekazać do aplikacji GAX w celu dodania dwóch nowych opcji do istniejącego obiektu Użytkownik:

Sekcja	Klucz	Wartość
gaxproperties	datemodified	1478163902397
htcc	roles	Agent

Plik CSV z takimi danymi wygląda następująco:

Section,Key,Value
gaxproperties,datemodified,1478163902397
htcc,roles,Agent

Te same informacje wyeksportowane z aplikacji GAX jak plik CFG wyglądają następująco:

[gaxproperties]
datemodified=1478163902397
[htcc]
roles=Agent