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 uživatele v instalacích on-prem.
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 má být proveden import. |
| /conn /server /db | Tyto parametry se používají k nastavení připojení k databázi Alvao. Připojovací řetězec může být použit (např. /conn "Zdroj dat=.\sqlexpress;Počáteční katalog=test;Integrované zabezpečení=True;Důvěřovat certifikátu serveru=True"), nebo jednoduše zadejte konkrétní SQL server a databázi (např. /server ".\sqlexpress" /db "test"). V případě, že používáte parametry /server a /db, je databázové připojení vytvořeno pomocí Integrované autentizace systému Windows. Pokud zadáte všechny tyto parametry,použije se pouze parametr /conn, parametry /server a /db budou ignorovány. |
| /import | Importovat data. Pokud tento přepínač nepoužijete, provádí se pouze kontrola syntaxe dat v souboru CSV |
| /mode | Režim importu:
Podrobný popis režimů naleznete níže. |
| /force | Vynutí import dat i v případě, že jsou v datech 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 | Kontrola | Povinné |
|---|---|---|---|
| Product | Přesný název produktu z knihovny softwarových produktů ALVAO. | Ano | Ano |
| License name | Název existující licence v databázi, nebo prázdná hodnota (název licence bude pak stejný jako název produktu). | Ne | Ne |
| Number | Počet zakoupených licencí - celé číslo, 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 |
| Platnost od | Datum od kterého je licence platná - musí být zadáno datum ve správném formátu. | Ano | Ano |
| Platí do | Datum, do kdy je licence platná - může být prázdná hodnota nebo datum ve správném formátu. | Ano | Ne |
| Podpora do | Datum, do kdy je licence podporována - může být prázdná hodnota nebo datum ve správném formátu. | 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 |
| Nákladové středisko licence | 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 | Kontrola | Povinné |
|---|---|---|---|
| Počítač | Síťový název konkrétního počítače v databázi - 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 položky licence - zadejte libovolný text nebo prázdnou hodnotu. | Ne | Ne |
| Inventární číslo položky | Inventární číslo položky licence - zadejte libovolný text nebo prázdnou hodnotu. | Ne | Ne |
| Požadavek položky | Požadavek položky licence - zadejte libovolný text nebo prázdnou hodnotu. | Ne | Ne |
| Poznámka položky | Poznámka položky 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 | Kontrola | Povinné |
|---|---|---|---|
| Číslo faktury | Zadejte libovolný text nebo prázdnou hodnotu. | Ne | Ne |
| Číslo faktury 2 | Zadejte libovolný text nebo prázdnou hodnotu. | Ne | Ne |
| Datum vystavení | Datum vystavení faktury - musí být zadáno datum ve správném formátu. | Ano | Ne |
| Cesta k příloze | Cesta k dokumentu přílohy (hledáno ve sdílených dokumentech), nebo prázdná hodnota. | Ne | Ne |
| Dodavatel | V databázi se hledá název dodavatele; pokud je nalezen, je přidělen nalezený záznam, jinak je vytvořen nový dodavatel s tímto názvem. Může 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,
- byly nastaveny 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 vynechány),
- 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 | Kontrola | Povinné |
|---|---|---|---|
| UId | ID licence v externím systému. Viz část Software - Licence - Licence - Upravit - Rozšířené. | No | Yes |
| LicCount | Total number of licenses purchased. | Ano | Ne |
| UserEmail | User email | Yes | Yes |
| UserName | UserName | No | No |
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.
Importovat 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\licenseItems.csv" /server server\sql /db alvao /import /mode UpdateItems /headers