Przejdź do treści

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.