Import licencí

Popis funkce

Aplikace ImportLic slouží k importu licencí ze souboru CSV, včetně přiřazení k jednotlivým počítačům nebo uživatelům. Lze jej také spustit v režimu synchronizace přiřazených licencí s externím systémem. Tato funkce je k dispozici pouze pro zákazníky v místě instalace.

Syntaxe příkazového řádku

Importovat. xe /input*"cesta a název souboru CSV"* { /conn*"connection string"| /server"database server name"/db"database name"*} [ /import] [ /mode {ImportLicenses | UpdateItems}] [ /force] [ /headers] [ /help]

Parametry

Parametr	L 343, 22.12.2009, s. 1).
/input	Cesta a název souboru CSV, ze kterého se má importovat.
/conn /server /db	Tyto parametry slouží k nastavení připojení k databázi Alvao. Lze použít řetězec připojení (např. /conn "Zdroj dat=.\sqlexpress;Počáteční katalog=test;Integrované zabezpečení = True;TrustServerCertificate=True ") nebo jednoduše zadat konkrétní SQL server a DB (např. /server ".\sqlexpress " /db "test "). Pokud použijete parametry /server a /db, připojení k databázi se uskuteční pomocí integrovaného ověřování systému Windows. Pokud zadáte všechny tyto parametry,použije se pouze parametr /conn, parametry /server a /db budou ignorovány.
/import	Import dat. Pokud tento přepínač nepoužijete, provede se pouze kontrola syntaxe dat v souboru CSV.
/režim	Režim importu: ImportLicenses - import nových licencí. Jedná se o výchozí režim. UpdateItems - import licenčních položek v licenčním modelu na uživatele, tj. přiřazení nebo odebrání licencí konkrétním uživatelům. Podrobný popis režimů naleznete níže.
/force	Vynutí import dat, i když jsou v nich chyby.
/headers	Použijte, pokud první řádek souboru obsahuje názvy sloupců.

ImportLicenses

Importovat nové licence včetně dokumentů a přiřadit vytvořené licence počítačům nebo uživatelům.

Popis všech podporovaných sloupců

Varování

Pořadí sloupců je pevné, nezávisí na názvu sloupce. Proto musí importovaný soubor obsahovat všechny sloupce, pouze hodnoty v některých z nich mohou být prázdné. To platí i v případě použití parametru force.

Varování

Data musí být zadána ve správném formátu, např. "1.12.2014" nebo "2015-12-01".

Licence

Název sloupce v CSV	Možnosti	Podívejte se na stránky .	Povinné
Produkt	Přesný název produktu z knihovny produktů softwaru ALVAO.	Ano	Ano
Název licence	Název existující licence v databázi nebo prázdná hodnota (název licence pak bude stejný jako název produktu).	Ne	Ne
Číslo	Počet zakoupených licencí - číslo INT, musí být zadáno.	Ano	Ano
Typ licence	Musí být zadána jedna z následujících hodnot: na zařízení, na uživatele, na připojení, na procesor nebo na jádro.	Ano	Ano
Aktivita od	Datum, od kterého je licence platná - datum musí být zadáno ve správném formátu.	Ano	Ano
Platí do	Datum, do kterého je licence platná - může to být prázdná hodnota nebo správný formát data.	Ano	Ne
Podpora	Datum, do kterého je licence podporována - může to být prázdná hodnota nebo správný formát data.	Ano	Ne
Typ licence	Typ licence - musí nabývat jedné z následujících hodnot. Float, Multi nebo OEM.	Ano	Ano
Aktivační klíč licence	Aktivační klíč licence - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Inventární číslo licence	Inventární číslo licence - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Číslo certifikátu	Libovolný text nebo prázdná hodnota - pokud je zadána, program vyhledá certifikát podle tohoto čísla v DB. Pokud jej najde, přiřadí vytvořenou licenci k nalezenému certifikátu z DB, jinak vytvoří dokument typu "Certifikát" a přiřadí jej k aktuálně vytvořené licenci.	Ne	Ne
Licenční nákladové středisko	Nákladové středisko licence - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Organizace	Název organizace, která vlastní licenci. Pokud zadáte prázdnou hodnotu, lze licenci přiřadit počítačům nebo uživatelům z libovolné organizace.	Ano	Ne
Poznámka	Poznámka k licenci - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne

Licenční položky

Tento oddíl není nutné vyplňovat pro licenci - v tomto případě bude licence vytvořena bez licenčních položek.

Název sloupce CSL	Možnosti	Podívejte se na stránky .	Povinné
Počítač	Síťový název konkrétního počítače v DB - počítač musí v databázi existovat.	Ano	Ne
Aktivační klíč položky	Aktivační klíč položky licence - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Nákladové středisko položky	Nákladové středisko licenční položky - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Inventární číslo položky	Inventární číslo licenční položky - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Položka Ticket	Licenční požadavek - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Poznámka k položce	Poznámka k položce licence - zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne

Dokument

Tento oddíl opět není třeba vyplňovat. V tomto případě se pro nově vytvořenou licenci nevytvoří žádný dokument. Dokumenty jsou uloženy ve složce document-folder s nejmenším ID, které je spojeno s licencí softwaru (obvykle složka All Documents).

Název sloupce v CSV	Možnosti	Podívejte se na stránky .	Povinné
Číslo faktury	Zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Faktura číslo 2	Zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne
Datum vydání	Datum vystavení faktury - datum musí být zadáno ve správném formátu.	Ano	Ne
Cesta k příloze	Cesta k příloze dokumentu (hledá se ve sdílených dokumentech) nebo prázdná hodnota.	Ne	Ne
Dodavatel	Vyhledá se název dodavatele v DB, pokud je nalezen, přiřadí se nalezený záznam, jinak se vytvoří nový dodavatel s tímto názvem. Může to být také prázdná hodnota.	Ne	Ne
Poznámka k dokumentu	Zadejte libovolný text nebo prázdnou hodnotu.	Ne	Ne

Scénáře

Ukázkový soubor CSV

Produkt;Název licence;Číslo;Druh licence;Platí od;Platí do;SupportUntil;Typ licence;Asset. licenční klíč;Licenční inv. č.;Cert. číslo;Nákl. středisko;Organizace;Poznámka k licenci;Počítač;Item activ. key.;Item cost center;Item inv. č.;Item rquest;Item note;Invoice no.;Invoice no. 2;Datum vystavení;Cesta k příloze;Dodavatel;Poznámka k faktuře
Microsoft Windows 2000 Professional;Win2k;1;na zařízení;30.01.2007;15.12.2030;15.05.2008;float;AK-1234;IC-ALL-1234;Cert1;Strd1;Organizace;Poznamka k licenci1;PC1;AK-PC-1;StredPc1;IC-PC-1;REQ-ITM-1;Pozn PC1;CF-1234;CF-2-1234;15.08.2006;Faktury\f01.doc;DOD1;Pozn. doc. 1
Microsoft Windows XP Professional;WinXP;1;na zařízení;15.01.2007;15.08.2030;15.05.2008;normal;AK-1234;IC-ALL-1234;Cert1;Strd1;;Poznámka k licenci1;PC1;AK-PC-1;StredPc1;IC-PC-1;REQ-ITM-2;Pozn PC1;CF-1234;CF-2-1234;15.08.2006;Faktury\f01.doc;DOD1;Pozn. doc. 1
Microsoft Windows 2000 Professional;Win2k;1;na zařízení;15.01.2007;15.08.2030;15.05.2008;normal;AK-1234;IC-ALL-1234;Cert1;Strd1;;Poznámka k licenci1;PC2;AK-PC-2;StredPc2;IC-PC-2;REQ-ITM-3;Pozn PC2;CF-1234;CF-2-1234;15.08.2006;Faktury\f01.doc;DOD2;Pozn. doc. 2
Microsoft Windows XP Professional;;2;na zařízení;15.01.2008;;15.01.2010;multi;AK-888;IC-ALL-8888;Cert2;Strd1;;Poznámka k licenci2;PC1;AK-PC-1;StredPc1;IC-PC3;REQ-ITM-4;Pozn PC1;CF-8888;CF-2-1237;15.08.2008;Faktury\f02.doc;DOD1;Pozn. doc. 2
Microsoft Windows XP Professional;;2;na zařízení;15.01.2008;;15.01.2010;multi;AK-888;IC-ALL-8888;Cert2;Strd1;;Poznámka k licenci2;PC2;AK-PC-2;StredPc2;IC-PC2;REQ-ITM-4;Pozn PC2;CF-8888;CF-2-1237;15.08.2008;Faktury\f02.doc;DOD1;Pozn. doc. 2

Import CSV s doporučenou strukturou

CSV obsahuje záhlaví s názvy sloupců. Údaje v souboru budou před importem zkontrolovány. Pokud jsou údaje nesprávné, import se neprovede. Import z příkazového řádku:

ImportLic.exe /input "c:\data\license.csv" /server server\sql2008 /db alvao /import /headers

Import více licenčních položek do jedné licence

To provedete tak, že zkopírujete řádek s údaji v části "Licence" a změníte pouze část "Položky licence". Příklad importu CSV jedné licence se 3 položkami:

Product;License Name;Number;License kind;Valid From;Valid until;SupportUntil;License Type;Asset. license key;License inv. no.;Cert. number;Cost. center;Organization;License note;Computer;Item activ. key.;Nákladové středisko;Inv. č. položky;Požadavek na položku;Poznámka k položce
Microsoft Windows XP Professional;;3;na zařízení;15.01.2008;;15.01.2010;multi;AK-888;IC-ALL-8888;Cert2;Strd1;;Poznámka k licenci2;PC1;AK-PC-1;StredPc1;IC-1;REQ-ITM-4;Pozn. 1
Microsoft Windows XP Professional;;3;na zařízení;15.01.2008;;15.01.2010;multi;AK-888;IC-ALL-8888;Cert2;Strd1;;Poznámka k licenci2;PC2;AK-PC-2;StredPc2;IC-2;REQ-ITM-4;Pozn. 2
Microsoft Windows XP Professional;;3;na zařízení;15.01.2008;;15.01.2010;multi;AK-888;IC-ALL-8888;Cert2;Strd1;;Poznámka k licenci2;PC3;;StredPc2;IC-3;REQ-ITM-4;Pozn. 3

Poznámka

CSV obsahuje 2 položky licence, které budou přiřazeny k PC1 a PC2, a poslední položka nebude přiřazena k žádnému počítači.

Nemáme k dispozici kompletní údaje

Prozatím chceme nahrát neúplné údaje, které budou opraveny, jakmile budou k dispozici podpůrné informace. Nahráváme hodnoty pouze do několika sloupců, které jsme definovali v záhlaví. Soubor nebude kontrolován a vynutíme si import i neúplných a nesprávných údajů. Import z příkazového řádku:

ImportLic.exe /input "c:\data\license.csv" /server server\sql2008 /db alvao /force /headers

Režim UpdateItems

Synchronizace přiřazených licencí uživatelům s externím systémem (např. M365).

Vstupní CSV obsahuje seznam licencí a uživatelů, kterým mají být tyto licence přiděleny.

Nastavení a kontrola vstupních dat

V externím systému nastavte export do souboru CSV tak, aby přesně odpovídal popisu níže uvedených sloupců.

Před zahájením importu do systému Alvao se ujistěte, že:

1. Všechny licence, které chcete synchronizovat,
   1. byly nastaveny na Identita licence v externím systému, která se používá k přiřazení licence k externímu prostředku (záznamy pro neexistující ID se přeskočí),
   2. mít nastavený licenční model na uživatele a
   3. automatické přidělování zakázáno.
2. Šablona objektu User obsahuje vlastnost Email. Tato vlastnost porovnává uživatele v CSV s uživateli v Alvao.
3. Všichni uživatelé uvedení v CSV existují v systému AM jako objekty ve stromu a jejich e-mailová adresa je v rámci aktivního záznamu jedinečná.
   1. Neexistující uživatelé se automaticky vytvoří ve složce Read Objects .
   2. Pokud je nalezeno více uživatelů se stejným e-mailem, je licence přiřazena tomu s nižším Id.
4. Vstupní CSV obsahuje všechny uživatele, kterým je licence přiřazena. Ostatním bude licence automaticky odebrána.

Popis všech podporovaných sloupců

Varování

Pořadí sloupců je pevné, nezávisí na názvu sloupce. Proto musí importovaný soubor obsahovat všechny sloupce, pouze hodnoty v některých z nich mohou být prázdné. To platí i v případě použití parametru force.

Název sloupce v CSV	Možnosti	Podívejte se na stránky .	Povinné
UId	ID licence v externím systému. Viz Konzola AM - Registr licencí - Upravit licenci.	Ne	Ano
LicCount	Celkový počet zakoupených licencí.	Ano	Ne
UserEmail	E-mail uživatele	Ano	Ano
Uživatelské jméno	Uživatelské jméno	Ne	Ne

Ukázkový soubor CSV

UId;LicCount;UserEmail;UserName Alvao:POWER_BI_PRO;10;james.smith@contoso.com;James Smith Alvao:POWER_BI_PRO;10;david.cooper@contoso.com;David Cooper Alvao:FLOW_FREE;;john.david.cooper@contoso.com;David Cooper

Kód si stáhněte zde.

Import CSV s doporučenou strukturou

CSV obsahuje záhlaví s názvy sloupců. Údaje v souboru budou před importem zkontrolovány. Pokud jsou údaje nesprávné, import se neprovede. Importovat z příkazového řádku:

ImportLic.exe /input "c:\data\licenseItems.csv" /server server\sql /db alvao /import /mode UpdateItems /headers