Integracje słowników
Importuj wartości i wzorce z CSV do istniejącego słownika, określając kolumny klucza, wartości i kolejności.
Integracja importuje z CSV wartości słowników oraz ich wzorce, zamiast wymagać ręcznego wpisywania danych.
W systemie musi istnieć słownik docelowy. Utworzysz go w sekcji Ustawienia pól → Słowniki.
Otwórz Ustawienia pól → Integracje słowników. Główny widok przedstawia tabelę konfiguracji z kolumnami:
- Nazwa: nazwa konfiguracji.
- Nazwa definicji: krótka nazwa typu wybranego podczas tworzenia.
- Typ definicji: opis wybranego typu konfiguracji.
- Działanie: przyciski i .
Aby utworzyć konfigurację, kliknij przycisk w prawym górnym rogu.
W formularzu tworzenia integracji wpisz nazwę i wybierz typ konfiguracji w polu definicji.
Po zapisaniu danych otworzą się ustawienia konfiguracji.
Zacznij od sekcji konfiguracji słownika.
W polu słownika do aktualizacji wybierz istniejący słownik docelowy.
Następnie uzupełnij pola:
- Typ klucza słownika: kolumna bazy danych służąca do rozpoznawania, czy wartość już istnieje. Dostępne opcje: DictionaryValueId, Value i Pattern.
- Nazwa kolumny klucza: nazwa kolumny pliku odpowiadającej wybranemu kluczowi w bazie.
- Nazwa kolumny wartości: kolumna pliku, której dane trafią do kolumny Value w bazie.
- Nazwa kolumny kolejności wartości: kolumna pliku odpowiadająca PositionOrder w bazie.
Jeżeli słownik nie ma wzorców, w sekcji konfiguracji wzorców pojawi się komunikat informujący o ich braku.
Przykład konfiguracji i wykonania integracji
W Mint Service Desk istnieje pusty słownik HARDWARE.
Chcemy zaimportować trzy wartości: computer, laptop, smartphone, dokładnie w tej kolejności. Wiemy, że wartości w kolumnie Value są unikalne i mogą służyć jako klucz.
Najpierw przygotuj plik CSV. W pierwszym wierszu określ nazwy kolumn:
- Kolumna klucza: dane odpowiadające kolumnie bazy wybranej jako typ klucza słownika.
- Kolumna wartości: dane odpowiadające kolumnie value w bazie.
- Kolumna kolejności wartości: dane odpowiadające kolumnie PositionOrder w bazie.
Nazwy rozdziel ustalonym separatorem. W przykładzie używamy średnika.
Przykładowy pierwszy wiersz pliku:
key;value;positionOrder
W kolejnych wierszach wpisz dane do kolumn określonych w nagłówku.
Dla słownika HARDWARE plik ma postać:
- Wiersz 1: key;value;positionOrder
- Wiersz 2: computer;computer;1
- Wiersz 3: laptop;laptop;2
- Wiersz 4: smartphone;smartphone;3
Przykładowy plik powinien wyglądać jak poniżej:
Po przygotowaniu pliku przejdź do konfiguracji słownika i wybierz:
- Typ klucza słownika: Value, ponieważ wartości są unikalne i nie będą się powtarzać.
Uzupełnij nazwy zgodnie z pierwszym wierszem pliku:
- Nazwa kolumny klucza: key
- Nazwa kolumny wartości: value
- Nazwa kolumny kolejności wartości: positionOrder
W sekcji separatora pliku ustaw znak rozdzielający dane CSV. Domyślnie jest to średnik.
Kliknij „Aktualizuj”, aby zapisać konfigurację.
Następnie kliknij „Wybierz plik” i dołącz CSV. Synchronizacja rozpocznie się automatycznie.
Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły z informacjami o przebiegu i ewentualnych błędach.
Po poprawnym zakończeniu synchronizacji słownik zawiera nowe wartości z pliku CSV.
WZORCE
Jeśli słownik zawiera wzorce, w sekcji ich konfiguracji pojawia się przycisk .
Kliknięcie dodaje wiersz z kluczem wzorca i nazwą kolumny jego wartości. W pierwszym polu wybierz nazwę wzorca ze słownika, a w drugim podaj kolumnę pliku zawierającą importowane wartości wzorca.
Przykładowo do słownika HARDWARE dodajemy wzorzec TEST PATTERN.
Plik CSV musi zawierać dodatkową kolumnę. Jego pierwszy wiersz może wyglądać tak:
key;value;positionOrder;columnPattern1
Kolejne wiersze uzupełniamy jak wcześniej, dodając dane w columnPattern1. Przykładowy plik:
- Wiersz 1: key;value;positionOrder;columnPattern1
- Wiersz 2: computer;computer;1;Pattern 1
- Wiersz 3: laptop;laptop;2;Pattern 2
- Wiersz 4: smartphone;smartphone;3;Pattern 3
Przykładowy plik powinien wyglądać jak poniżej:
Konfiguracja powinna wyglądać następująco:
Ustaw średnik jako separator i kliknij „Aktualizuj”, aby zapisać konfigurację.
Kliknij „Wybierz plik” i dołącz odpowiedni CSV. Synchronizacja rozpocznie się automatycznie.
Postęp pobierania wartości można śledzić na bieżąco. Kliknięcie synchronizacji otwiera szczegóły przebiegu i ewentualnych błędów.
Po poprawnym zakończeniu słownik zostanie zaktualizowany danymi z CSV, a pola wzorców otrzymają nowe wartości.