Integracja CSV
Dodawaj i aktualizuj zasoby z pliku CSV, wybierając klucz identyfikujący zasób oraz sposób mapowania kategorii i kolumn.
Import zasobów z pliku CSV pozwala dodawać nowe zasoby i aktualizować istniejące w Mint Service Desk. Poniżej opisano konfigurację mapowania danych i przykłady obu operacji.
KONFIGURACJA
Przed konfiguracją integracji utwórz kategorię zasobów w panelu administratora, w sekcji Zasoby → Definicja zasobów. W razie potrzeby dodaj do niej pola niestandardowe. W poniższym opisie zakładamy istnienie kategorii i dwóch pól niestandardowych.
Otwórz sekcję Zasoby → Integracje zasobów. Główny widok zawiera tabelę zapisanych konfiguracji z kolumnami:
- Nazwa: nazwa konfiguracji.
- Nazwa definicji: krótka nazwa typu wybranego podczas tworzenia konfiguracji.
- Typ definicji: opis wybranego typu konfiguracji.
- Działanie: przyciski edycji i usuwania.
Aby utworzyć konfigurację, kliknij plus w prawym górnym rogu strony.
W formularzu tworzenia integracji wpisz dowolną nazwę i wybierz typ definicji CSV, czyli integrację zasobów z pliku CSV.
Po zapisaniu danych otworzą się ustawienia konfiguracji.
W sekcji Konfiguracja zasobów dostępne są następujące pola:
-
Typ mapowania zasobów: określa kolumnę lub pole niestandardowe używane do rozpoznania unikalności zasobu w Mint Service Desk. Jeśli podana wartość już istnieje, importer aktualizuje odpowiadający jej zasób. Jeśli nie, tworzy nowy. Dostępne opcje:
-
Id: unikalny identyfikator zasobu w Mint Service Desk.
-
Subject: nazwa zasobu.
-
CustomField: wyświetla dodatkowe pole wyboru identyfikatora atrybutu jako klucza.
Wybierz istniejące pole niestandardowe jako klucz zasobu. Najpierw wskaż kategorię, a następnie przypisane do niej pole.
-
Wybrane pole staje się kluczem głównym używanym przez importer.
-
Nazwa kolumny klucza: kolumna CSV odpowiadająca kluczowi wybranemu w typie mapowania zasobów.
-
Typ mapowania kategorii: sposób przypisywania zasobu do kategorii:
-
Constant: ręcznie wybrana kategoria z Mint Service Desk. Importer dodaje i aktualizuje zasoby wyłącznie w tej kategorii.
-
FieldsValue: wskazana kolumna CSV zawiera wartości kategorii w formacie GUID, na przykład a816f0ec-15d6-40fd-818a-fc9687c4c77c. Muszą one odpowiadać identyfikatorom kategorii w bazie Mint Service Desk.
-
FieldsValueWithMapping: mapowanie nazw kategorii z CSV na kategorie systemowe, także gdy nazwy się różnią. Pojawia się sekcja mapowania z polem wartości zewnętrznej kategorii i przyciskiem nowego wiersza.
W polu wartości zewnętrznej kategorii wskaż kolumnę CSV zawierającą kategorię. Kliknięcie nowego wiersza dodaje wpis nr 1 z polami wartości zewnętrznej, kategorii zasobu i przyciskiem usuwania.
We wpisie nr 1 podaj wartość z kolumny CSV, a z listy kategorii zasobów wybierz odpowiadającą jej kategorię. Przykładowo plik zawiera kolumnę IT Hardwares z wartością Computers, której ma odpowiadać systemowa kategoria Laptops. Konfiguracja wygląda następująco:
Konfiguracja wraz z plikiem CSV:
Oznacza to: pobierz dane z kolumny AssetCategories w CSV, a jeśli wartość jest równa Computers, przypisz zasób z tego wiersza do kategorii Laptops w Mint Service Desk. Tak można jednocześnie przypisywać wiele zasobów do wielu kategorii.
-
-
Nazwa kolumny nazwy zasobu: kolumna CSV odpowiadająca nazwie zasobu w systemie.
-
Nazwa kolumny opisu: kolumna CSV odpowiadająca opisowi zasobu.
Następna sekcja, Konfiguracja pliku, zawiera ustawienia CSV:
- Separator: domyślnie średnik (;).
- Przycisk importu pliku: przesłanie pliku CSV do importu.
Ostatnia sekcja przedstawia historię synchronizacji, w tym:
- Czas rozpoczęcia
- Wynik
- Datę wykonania
- Błędy, jeśli wystąpiły
PRZYKŁADY
Poniżej opisano import nowych zasobów oraz aktualizację istniejących.
Import nowych zasobów
W przykładzie istnieje definicja zasobów Laptops.
Baza zasobów jest początkowo pusta.
Chcemy zaimportować pięć zasobów: Asset1, Asset2, Asset3, Asset4 i Asset5. Każdy ma otrzymać opis Sample description.
Kroki
Najpierw tworzymy plik CSV z danymi zasobów.
Następnie dodajemy konfigurację na karcie integracji zasobów, zgodnie z wcześniejszym opisem, i uzupełniamy sekcję konfiguracji zasobów.
W typie mapowania kategorii wybieramy Constant i kategorię Laptops.
Pozostawiamy średnik jako separator i klikamy „Aktualizuj”, aby zapisać dane.
Klikamy przycisk importu i wybieramy plik CSV z dysku. Po przesłaniu w prawym górnym rogu pojawiają się poniższe komunikaty i rozpoczyna się synchronizacja.
Jeśli inna synchronizacja już działa w tle, otrzymamy powiadomienie:
W sekcji Synchronizacje widoczny jest wpis ze statusem W toku.
Kliknięcie wpisu otwiera szczegóły i podgląd postępu.
Po zakończeniu status zmienia się na sukces, a zasoby zostają utworzone w systemie.
Modyfikacja istniejących zasobów
Po imporcie chcemy zaktualizować nazwy i opisy zasobów. Przed aktualizacją plik CSV wygląda następująco:
Po aktualizacji ma wyglądać tak:
Jako klucz główny wybieramy identyfikator zasobu. Identyfikator w CSV musi odpowiadać identyfikatorowi w Mint Service Desk.
Nieprawidłowe identyfikatory spowodują utworzenie nowych zasobów zamiast aktualizacji istniejących.
Importujemy zmieniony plik tak samo jak przy dodawaniu nowych zasobów. Po zakończeniu na karcie zarządzania zasobami zobaczymy zaktualizowane dane.