Przejdź do treści

Integracje zasobów

Podręcznik Mint Service Desk 3.4.2: instalacja, administracja oraz praca agentów i klientów.

Integracja przez API

W tej części można zintegrować zasoby z Lansweeper. Kliknij przycisk .

W polu nazwy wpisz nazwę widoczną na liście integracji. W polu definicji wybierz Lansweeper.

Zakończ pierwszy etap konfiguracji przyciskiem .

Wróć do listy integracji zasobów i otwórz wybraną konfigurację do edycji.

Dalsza konfiguracja jest podobna do integracji użytkowników opisanej w części Użytkownicy → Integracje użytkowników.

Integracja CSV

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.

      zobacz zrzut ekranu

      Wybierz istniejące pole niestandardowe jako klucz zasobu. Najpierw wskaż kategorię, a następnie przypisane do niej pole.

      zobacz zrzut ekranu

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.

      zobacz zrzut ekranu

    • 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.

      zobacz zrzut ekranu

    • 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.

      zobacz zrzut ekranu

      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.

      zobacz zrzut ekranu

      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:

      zobacz zrzut ekranu

      Konfiguracja wraz z plikiem CSV:

      zobacz zrzut ekranu

      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.