Przejdź do końca metadanych
Przejdź do początku metadanych

Wyświetlasz starszą wersję (v. /wiki/spaces/KB/pages/11698265/Import+danych+z+.CSV) tej strony.

pokaż różnice pokaż historię strony

« Pokaż poprzednią wersję Wyświetlasz aktualną wersję tej strony. (v. 8) pokaż następną wersję »

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

  1. Otwórz Ustawienia, z menu bocznego wybierz CMDB > Import zasobów z plików > Wybrany zasób.

  2. Wybierz Pobierz wzorcowy plik i zapisz plik na dysku.

  3. Wypełnij plik według wzoru podanego w panelu ustawień.

Zasady wypełniania pliku

  1. Plik musi być zapisany w formacie CSV z kodowaniem UTF-8 z separacją za pomocą znaku średnika. 

  2. Nagłówki kolumn muszą być zgodne z nazwami zawartymi w tabelach poszczególnych zasobów. 

  3. Klucz identyfikujący musi być unikatowy i jednoznaczny. 

  4. Dostępne wartości pól: 

    1. Dowolny ciąg znaków – oznacza dowolny tekst 

    2. Słownik sztywny – oznacza jedną z wartości wskazaną w tabeli. Słownik jest zablokowany dla użytkownika i nie można go zmieniać. 

    3. 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ć. 

    4. Wartość True lub False – pole może przyjąć tylko wartość „True” lub „False”. 

    5. Dowolna liczba – oznacza dowolną liczbę całkowitą. 

    6. Dowolna data – oznacza dowolną datę zapisaną w formacie RRRR-MM-DD. 

    7. Dowolna liczna zmiennoprzecinkowa – oznacza dowolną liczbę zmiennoprzecinkową 

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

  6. Wartość NULL z danego pola, nie będzie nadpisywała wartości zapisanej w systemie. 

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

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

  2. Każdy typ zasobu posiada określone, inne warunki tworzenia nowego zasobu za pomocą pliku CSV. 

  3. Warunki są opisane w wariantach. Każdy typ zasobu może mieć od jednego do wielu wariantów. 

  4. Pojedynczy wariant zawiera grupę wymaganych pól, która musi być poprawnie uzupełniona danymi, aby zasób został utworzony. 

  5. 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: 

  1. Otworzyć plik CSV zawierający Klucz identyfikujący zasób nadrzędy i Klucz identyfikujący zasób/obiekt podrzędny (dołączany). 

  2. Tabela możliwych powiązań jest opisana poniżej w sekcji Tabela możliwych relacji zasobów.

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

  1. Pobierz i wypełnij prawidłowo plik wzorcowy.

  2. Otwórz Ustawienia, z menu bocznego wybierz CMDB > Import zasobów z plików > Wybrany zasób.

  3. Wybierz Wgraj uzupełniony plik, wgraj wypełniony plik z dysku.

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

  • Annual

  • Monthly

  • OneTime

Monthly

ServiceCustomer-LogService-status

Status

  • Active

  • Inactive

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

  • Annual

  • Monthly

  • OneTime

Monthly

ServiceCustomer-LogService-status

Status

  • Active

  • Inactive

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

  • Person

  • Computer

  • NetworkDevice

  • MobileDevice

  • Monitor

  • Printer

  • DataCarrier

  • License

 

 

Wymagany lub opcjonalny rodzaj zasobu

  • Required

  • Optional

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

  • Brak etykietek