Dane w CMDB mogą być uzupełnione za pomocą plików .CSV wypełnionego według wzoru.
Spis treści:
Pobieranie i wypełnianie pliku wzorcowego
Otwórz Ustawienia, z menu bocznego wybierz CMDB > Import zasobów z plików > Wybrany zasób.
Wybierz Pobierz wzorcowy plik i zapisz plik na dysku.
Wypełnij plik według wzoru podanego w panelu ustawień.
Zasady wypełniania pliku
Plik musi być zapisany w formacie CSV z kodowaniem UTF-8 z separacją za pomocą znaku średnika.
Nagłówki kolumn muszą być zgodne z nazwami zawartymi w tabelach poszczególnych zasobów.
Klucz identyfikujący musi być unikatowy i jednoznaczny.
Dostępne wartości pól:
Dowolny ciąg znaków – oznacza dowolny tekst
Słownik sztywny – oznacza jedną z wartości wskazaną w tabeli. Słownik jest zablokowany dla użytkownika i nie można go zmieniać.
Słownik użytkownika – oznacza wartość zgodną z nazwą wpisaną w słowniku. Słownik nie jest zablokowany dla użytkownika i można go zmieniać.
Wartość True lub False – pole może przyjąć tylko wartość „True” lub „False”.
Dowolna liczba – oznacza dowolną liczbę całkowitą.
Dowolna data – oznacza dowolną datę zapisaną w formacie RRRR-MM-DD.
Dowolna liczna zmiennoprzecinkowa – oznacza dowolną liczbę zmiennoprzecinkową
Część z pól może przyjmować wartość domyślną, wskazaną w tabeli danego zasobu, w chwili kiedy występuje dany nagłówek w pliku CSV, a pole nie posiada żadnej wartości.
Wartość NULL z danego pola, nie będzie nadpisywała wartości zapisanej w systemie.
Czas importu zależy od wielkości bazy danych oraz od wielkości importowanych danych z pliku.
Mechanizm dodawania nowego zasobu
Mechanizm polega na dodaniu do bazy danych nowego zasobu przy wykorzystaniu wszystkich danych zawartych w pliku CSV.
W procesie tworzenia zasobu musi być spełniony warunek poprawnie wprowadzonych danych w określonych polach zgodnych z formatem opisanym w tabelach dla danego zasobu.
Każdy typ zasobu posiada określone, inne warunki tworzenia nowego zasobu za pomocą pliku CSV.
Warunki są opisane w wariantach. Każdy typ zasobu może mieć od jednego do wielu wariantów.
Pojedynczy wariant zawiera grupę wymaganych pól, która musi być poprawnie uzupełniona danymi, aby zasób został utworzony.
Do tworzenia zasobu danego typu można używać tylko jednego wariantu. Warianty nie mogę być używane łącznie dla pojedynczego wpisu.
Mechanizm tworzenia relacji pomiędzy zasobami
Mechanizm importowania relacji z pików płaskich umożliwia masowe tworzenie relacji pomiędzy istniejącymi zasobami.
Aby utworzyć relację pomiędzy zasobami należy:
Otworzyć plik CSV zawierający Klucz identyfikujący zasób nadrzędy i Klucz identyfikujący zasób/obiekt podrzędny (dołączany).
Tabela możliwych powiązań jest opisana poniżej w sekcji Tabela możliwych relacji zasobów.
Każdy zasób posiada opisany Klucz identyfikacyjny. Jeżeli klucz składa się z więcej niż jednej wartości można używać tych wartości łącznie w dowolnej konfiguracji w celu zapewnienia jednoznaczności.
Import pliku .csv z zasobami
Pobierz i wypełnij prawidłowo plik wzorcowy.
Otwórz Ustawienia, z menu bocznego wybierz CMDB > Import zasobów z plików > Wybrany zasób.
Wybierz Wgraj uzupełniony plik, wgraj wypełniony plik z dysku.
Kliknij Zapisz.
W przypadku gdy wartości kluczy identyfikujących z pliku CSV pokryją się z istniejącymi wpisami w bazie danych, zostaną one zaktualizowane. W przeciwnym razie zostanie dodany nowy zasób na podstawie danych w CSV.
Tabela możliwych relacji zasobów
Zasób / Obiekt dołączany | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Osoba | Komputer | Urządzenie sieciowe | Urządzenie mobilne | Monitor | Drukarka | Nośnik Danych | Licencja | Umowa | Załącznik | Usługa | Dział | Lokalizacja | Kontrahent /Konto | |
Osoba | X | X | X | X | X | X |
| X | X |
| X | X |
| |
Komputer | X |
| X | X | X | X | X |
| X | X |
| X | X |
|
Urządzenie sieciowe | X |
| SR3 |
|
|
|
| SR6 | X | X |
| X | X | X |
Urządzenie mobilne | X |
|
|
|
|
|
|
| X | X |
| X | X | X |
Monitor | X | X |
|
|
|
|
|
| X | X |
| X | X | X |
Drukarka | X | X |
|
|
|
|
|
| X | X |
| X | X | X |
Nośnik danych | X | X |
|
|
|
|
|
| X | X |
| X | X | X |
Licencja | X | X | X |
|
|
|
|
| X | X |
| X | X | X |
Umowa | X | X | X | X | X | X | X | X | SR4 | X |
| X | X | X |
Usługa |
| SR5 | SR5 | SR5 | SR5 | SR5 | SR5 | SR5 |
|
|
|
|
| SR1 / SR2 |
Legenda: X – istnieje możliwość powiązania, SR1-4 – powiązanie specjalne opisane poniżej, SR5-6 – będzie istniała możliwość powiązania w przyszłości
Tabele relacji specjalnych
Relacja Usługa < Klient Usługi (Kontrahent) – SR1
Do utworzenia relacji wymagane jest wpisanie klucza identyfikującego Usługę i Kontrahenta
Nazwa Pola nagłówka pliku CSV | Opis | Dostępne wartości | Domyślna wartość |
LogService-uniqueCommercialCode | Klucz identyfikujący Usługę (jeden lub oba) | Dowolny ciąg znaków |
|
LogService-ownld | |||
ServiceCustomer-Contractor-name | Klucz identyfikujący Kontrahenta (jeden lub więcej) | Dowolny ciąg znaków |
|
ServiceCustomer-Contractor-vatId | |||
ServiceCustomer-Contractor-crmIdentifier | |||
ServiceCustomer-LogService-activeSince | Aktywna od | Dowolna data w formacie rrrr-mm-dd |
|
ServiceCustomer-LogService-activeTo | Aktywna do | Dowolna data w formacie rrrr-mm-dd |
|
ServiceCustomer-LogService-contractPrice | Cena usługi | Dowolna liczba zmiennoprzecinkowa |
|
ServiceCustomer-LogService-paymentMethod | Metoda płatności |
| Monthly |
ServiceCustomer-LogService-status | Status |
| Active |
Relacja Usługa < Klient Usługi (Konto Kontrahenta) – SR2
Do utworzenia relacji wymagane jest wpisanie klucza identyfikującego Usługę, Kontrahenta i Konta Kontrahenta.
Nazwa Pola nagłówka pliku CSV | Opis | Dostępne wartości | Domyślna wartość |
LogService-uniqueCommercialCode | Klucz identyfikujący Usługę (jeden lub oba) | Dowolny ciąg znaków |
|
LogService-ownld | |||
ServiceCustomer-Contractor-name | Klucz identyfikujący Kontrahenta (jeden lub więcej) | Dowolny ciąg znaków |
|
ServiceCustomer-Contractor-vatId | |||
ServiceCustomer-Contractor-crmIdentifier | |||
ServiceCustomer-Contractor-client-name | Klucz identyfikujący Konto Kontrahenta | Dowolny ciąg znaków |
|
ServiceCustomer-LogService-activeSince | Aktywna od | Dowolna data w formacie rrrr-mm-dd |
|
ServiceCustomer-LogService-activeTo | Aktywna do | Dowolna data w formacie rrrr-mm-dd |
|
ServiceCustomer-LogService-contractPrice | Cena usługi | Dowolna liczba zmiennoprzecinkowa |
|
ServiceCustomer-LogService-paymentMethod | Metoda płatności |
| Monthly |
ServiceCustomer-LogService-status | Status |
| Active |
Relacja Urządzenie Sieciowe < Urządzenie Sieciowe – SR3
Do utworzenia relacji wymagane jest wpisanie klucza identyfikującego pierwsze i drugie urządzenie sieciowe.
Nazwa Pola nagłówka pliku CSV | Opis | Dostępne wartości | Domyślna wartość |
NetworkDevice-serialNumber | Klucz identyfikujący urządzenie sieciowe 1 (jeden lub oba) | Dowolny ciąg znaków |
|
NetworkDevice-inventoryNumber | |||
NetworkDevice-networkDeviceProduct-productCode | |||
Self-NetworkDevice-serialNumber | Klucz identyfikujący urządzenie sieciowe 2 (jeden lub oba) | Dowolny ciąg znaków |
|
Self-NetworkDevice-inventoryNumber | |||
Self-NetworkDevice-networkDeviceProduct-productCode |
Relacja Umowa < Umowa – SR4
Do utworzenia relacji wymagane jest wpisanie klucza identyfikującego pierwszą i drugą umowę.
Nazwa Pola nagłówka pliku CSV | Opis | Dostępne wartości | Domyślna wartość |
Agreement-name | Klucz identyfikujący umowę 1 (jeden lub oba) | Dowolny ciąg znaków |
|
Agreement-agreementNumber | |||
Self-Agreement-name | Klucz identyfikujący umowę 2 (jeden lub oba) | Dowolny ciąg znaków |
|
Self-Agreement-agreementNumber |
Relacja Usługa < Zasób Wymagany lub Zasób Opcjonalny – SR5
Do utworzenia relacji wymagane jest wpisanie klucza identyfikującego Usługę oraz wskazania rodzaju zasobu, wymagalności lub opcjonalności, numeru slotu oraz Klucza identyfikującego zasobu dołączanego.
Nazwa Pola nagłówka pliku CSV | Opis | Dostępne wartości | Domyślna wartość |
LogService-uniqueCommercialCode | Klucz identyfikujący Usługę (jeden lub oba) | Dowolny ciąg znaków |
|
LogService-ownld | |||
| Rodzaj zasobu |
|
|
| Wymagany lub opcjonalny rodzaj zasobu |
| Required
|
| Numer slotu | Sloty numerowane są od 1 w górę. Jeżeli wprowadzona liczba będzie większa niż liczba slotów w profilu, wówczas pozycja nie zostanie dodana. | 1 |
| Klucz Identyfikujący zasób dołączany | Dowolny ciąg znaków |
|
Relacja Urządzenie Sieciowe < Licencja – SR6
Do utworzenia relacji wymagane jest wpisanie klucza identyfikującego urządzenie sieciowe i licencję. Dodatkowo licencja dołączana musi posiadać prawo Per NetworkDevice oraz dodatnie saldo licencji.
Nazwa Pola nagłówka pliku CSV | Opis | Dostępne wartości | Domyślna wartość |
NetworkDevice-serialNumber | Klucz identyfikujący urządzenie sieciowe 1 (jeden lub oba) | Dowolny ciąg znaków |
|
NetworkDevice-inventoryNumber | |||
NetworkDevice-networkDeviceProduct-productCode | |||
License-serialNumber | Klucz identyfikujący Licencje (jeden lub wiele) | Dowolny ciąg znaków |
|
License-licenseNumber | |||
License-inventoryNumber |