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 | Popis |
|---|---|
| /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:
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ů
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.
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 dokumentu s nejmenším ID, která jsou spojena s softwarovou licencí (obvykle složka Všechny dokumenty).
| 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
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.;Item cost center;Item inv. no.;Item rquest;Item note;Invoice no.;Invoice no. 2;Issue date;Attachement path;Supplier;Invoice note
Microsoft Windows 2000 Professional;Win2k;1;per device;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;per device;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;per device;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;per device;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;per device;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.;Item cost center;Item inv. no.;Item request;Item note
Microsoft Windows XP Professional;;3;per device;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;per device;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;per device;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
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:
- Všechny licence, které chcete synchronizovat,
- bylo nastaveno na ID licence v externím systému, které se používá k přiřazení licence k externímu zdroji (záznamy pro neexistující ID jsou přeskočeny),
- mít nastavený licenční model na uživatele a
- automatické přidělování zakázáno.
- Šablona objektu User obsahuje vlastnost Email. Tato vlastnost porovnává uživatele v CSV s uživateli v Alvao.
- 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á.
- Neexistující uživatelé jsou automaticky vytvořeni ve složce Read Objects.
- Když je nalezeno více uživatelů se stejným e-mailem, licence je přiřazena tomu s nižším ID.
- 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ů
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