> Source: https://docs.cyberelements.io/identity/7.0/cs/UserDocumentation/AutomaticProvisioningConnectorsManagement/CreateModifyExportRules/

# Vytvoření/úprava pravidel exportu

Účelem pravidla exportu je na základě úložiště definovat objekty, které se mají exportovat, a jejich umístění. Například u úložiště typu adresář budete muset definovat objekty, které se mají exportovat, a OU, ve kterých bude probíhat vyhledávání.

Každý export vygeneruje datový soubor ve formátu XML.

Existují dva možné režimy exportu, které lze zvolit podle případu použití:

- Úplný: všechny objekty, které vyhovují pravidlům exportu, se exportují do výstupního souboru. Výstupní soubor je ve formátu XML.
- Jednotkový: Export jediného objektu filtrovaného podle hodnoty atributu.

Pravidla exportu, která je třeba nakonfigurovat, se liší podle typu úložiště.

## Export úložiště typu adresář (LDAP, AD, AD/LDS, OpenLDAP atd.)

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportReferentielAnnuaire.png)

- Typ objektu: zadejte typ objektu, který se má exportovat (např. user, classes atd.).
- Filtr vyhledávání: volitelné pole pro použití filtrů na objekty, které se mají exportovat (např. „employeeID“ není prázdné).
- Jednotkový filtr: atribut, který umožňuje filtrovat objekt definováním jeho hodnoty.
- Atributy: seznam atributů objektů, které se mají exportovat.
- OU: zadejte OU, do kterých budou objekty exportovány.
- Filtry skupin: Seznam skupin, které se mají spravovat nebo vyloučit při akcích odstranění:
    - Pokud není zaškrtnuta možnost „Remove the groups instead of keeping them“: seznam skupin uvádí ty, které se nemají odstraňovat.
    - Pokud je zaškrtnuta možnost „Remove the groups instead of keeping them“: seznam skupin uvádí ty, které lze odstranit.

**Výsledky a možnosti:**

Každý atribut se exportuje do značky XML, jejímž názvem je název atributu adresáře. Výchozím formátem exportovaných dat je řetězec znaků.

Pro každý atribut je možné zadat jiný typ s následujícími možnostmi:

- Binary
- Date
- Date_Filetime

Chcete-li změnit formát exportu, vyberte požadovaný atribut a klikněte na tlačítko „Modify“.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportReferentielAnnuaireModification.png)

## Export úložiště typu plochý soubor (CSV)

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportReferentielCSV.png)

- Atributy: seznam sloupců, které tvoří plochý soubor (soubor se definuje při vytváření úložiště).
    - Klikněte na „Add“ a přidejte položku.
    - Vyberte atribut, který chcete upravit nebo odstranit.
    - Pokud má soubor CSV záhlaví sloupců, můžete kliknout na tlačítko „Get Column Name“ a automaticky načíst názvy sloupců.
- Atribut porovnání pro filtrované vyhledávání: sloupec, který umožňuje exportovat jediný objekt definováním jeho hodnoty.

**Výsledky a možnosti:**

Každý atribut se exportuje do značky XML, jejímž názvem je zadaný název atributu. Výchozím formátem exportovaných dat je řetězec znaků.

Pro každý atribut je možné zadat jiný typ s následujícími možnostmi:

- Binary
- Date
- Date_Filetime

Chcete-li změnit formát exportu, vyberte požadovaný atribut a klikněte na tlačítko „Modify“.

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportReferentielCSVModification.png)

## Export úložiště typu databáze (SQL Server, Oracle atd.)

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportReferentielBDD.png)

- Typ objektu: orientační hodnota, nemá vliv na konfiguraci
- Dotaz SQL: dotaz, který extrahuje všechny požadované informace
- Jednotkový filtr: dotaz, ve kterém je zadán filtr, aby vrátil pouze jeden výsledek
- Atributy: oddíl určený pro přidání dotazů SQL, které exportují další informace. Každý dotaz může exportovat pouze jeden atribut, ten však může být vícehodnotový (dotazy vracející více řádků)
- Možnost více řádků: možnost, kterou je třeba zaškrtnout, pokud je jeden z exportovaných atributů hlavního dotazu vícehodnotový. Název tohoto atributu je nutné uvést v poli „Multiline Matching Attribute“. V hlavním dotazu může být pouze jeden vícehodnotový atribut.

**Důležitá poznámka:** pokud je tato možnost zaškrtnuta, je nezbytné provést v dotazu „order by“ pro řazení podle atributu zadaného v poli „Multiline Matching Attribute“.

**Výsledky a možnosti:**

Každý sloupec definovaný v dotazu se exportuje do značky XML s názvem zadaného sloupce. Formátem exportovaných dat je řetězec znaků.

## Export úložiště typu API (REST – protokol SIM)

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportReferentielAPI.png)

- Typ objektu: klikněte na tlačítko „Get Object Type List“ a načtěte seznam objektů dostupných k exportu z úložiště aplikace.
- Atribut mapování: klikněte na tlačítko „Get Attributes List“ a načtěte seznam dostupných atributů. Seznam atributů závisí na vybraném typu objektu.
- Klikněte na tlačítko „Set“ a potvrďte aktualizace.

**Výsledky a možnosti:**

Každý atribut definovaný v typu objektu vráceném rozhraním API se exportuje do značky XML. Formátem exportovaných dat je řetězec znaků.

## Export úložiště XML

Chcete-li exportovat úložiště XML, musíte provést akci XSLT.

Soubory XML mohou mít různé struktury, proto je nutné vytvořit soubor transformace, který je převede do formátu XML kompatibilního s modulem zřizování SIP.

## Export Identity: identity

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityIdentites.png)

- Typ objektu: Zadejte hodnotu „USERS“
- Typ osoby: zadejte kód typů osob, které se mají exportovat z úložiště Identity
- Atribut porovnání pro jednotkový export: „personne_uid“

**Výsledky a možnosti:**

Pro každou identitu se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

## Export Identity: výčty

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityEnumerations.png)

- Typ objektu: Zadejte hodnotu „ENUMERATIONS“
- Seznam kódů: Kód výčtů, které se mají exportovat z úložiště Identity; současně lze exportovat několik výčtů.

Pro výčty není jednotkový export podporován.

**Výsledky a možnosti:**

Pro každý výčet se exportují následující značky:

- Type = Kód atributu (nebo kód typu výčtu) obsahujícího seznam hodnot
- Code = Kód hodnoty výčtu
- Name = Popisek přiřazený ke kódu
- Description = Popis hodnoty výčtu. Tato informace je volitelná a exportuje se pouze v případě, že není prázdná.

Formátem exportovaných dat je řetězec znaků.

## Export Identity: převodní tabulky

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityTablesCorrespondance.png)

- Typ objektu: Zadejte hodnotu „MATCHINGTABLE“
- Seznam kódů: Kód převodních tabulek, které se mají exportovat z úložiště Identity; současně lze exportovat několik převodních tabulek.

Pro převodní tabulky není jednotkový export podporován.

**Výsledky a možnosti:**

Pro každou převodní tabulku se exportují následující značky:

- Type = Kód typu převodní tabulky
- Key = Klíč převodní tabulky
- Value = Hodnota nebo hodnoty přiřazené ke klíči. Hodnota může být vícehodnotová.
- Description = Popis hodnoty převodní tabulky. Tato informace je volitelná a exportuje se pouze v případě, že není prázdná.

Formátem exportovaných dat je řetězec znaků.

## Export Identity: přidělení (prostředky)

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteursExportIdentityDotations.png)

- Typ objektu: Zadejte hodnotu „OBJECTS“
- Seznam kódů: zadejte kód typů přidělení (prostředků), které se mají exportovat z úložiště Identity
- Možnost exportovat struktury, které mají vazbu na přidělení
- Možnost exportovat identity, které mají vazbu na přidělení
- Atribut porovnání pro jednotkový export: „object_instance_code“

**Výsledky a možnosti:**

Pro každé přidělení (prostředek) se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

## Export Identity: stavy zřízení

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityEtatsProvisioning.png)

- Typ objektu: Zadejte hodnotu „STATUS“
- Repository: kód úložiště, ze kterého chcete exportovat osoby a jejich přidružené účty. Upozorňujeme, že pro správné fungování musí být jedinečný.
- Atribut porovnání pro jednotkový export: „Account.login“

**Výsledky a možnosti:**

Pro každý účet v úložišti se exportují následující značky:

- Account.Id: ID účtu
- Account.login: Přihlašovací jméno účtu. Bude použito pro účely porovnání
- Account.state: Stav zřízení účtu (0: nezřízeno, 1: zřízeno)
- Person.Id: ID primární osoby
- Person.uniqueId: UID primární osoby
- Pro každou autorizaci propojenou s účtem:
    - [code_mapping_right]#right.id: informační značka pro načtení seznamu ID práv, která mají hodnotu kódu mapování uvedenou v první části značky. Je možné více hodnot.
    - [code_mapping_right]#[right.id]: Značka tohoto typu pro každou autorizaci, která má hodnotu kódu mapování uvedenou v první části značky. Obsahuje hodnotu autorizace
    - [code_mapping_right]: informační značka pro načtení seznamu hodnot autorizací, které mají hodnotu kódu mapování uvedenou v první části značky. Je možné více hodnot.
    - [code_mapping_right]#state: Seznam stavů zřízení pro každou autorizaci, která má hodnotu kódu mapování uvedenou v první části značky.

Formátem exportovaných dat je řetězec znaků.

## Export Identity: struktury

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityStructure.png)

- Typ objektu: Zadejte hodnotu „STRUCTURES“
- Seznam kódů: zadejte kód typů struktur, které se mají exportovat z úložiště Identity
- Atribut porovnání pro jednotkový export: „structure_code“

**Výsledky a možnosti:**

Pro každou strukturu se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

## Export Identity: identity + autorizace

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityIdentitesHabilitations.png)

- Typ objektu: Zadejte hodnotu „USERS+ACCESS“
- Repository: kód úložiště, ze kterého chcete exportovat osoby a jejich přidružené účty. Upozorňujeme, že pro správné fungování musí být jedinečný.
- Typ osoby: zadejte kód typů osob, které se mají exportovat z úložiště Identity
- Atribut porovnání pro jednotkový export: „personne_uid“

**Výsledky a možnosti:**

Pro každou identitu se všechny atributy, které mají hodnotu, automaticky exportují do značky XML, jejímž názvem je kód atributu. Formátem exportovaných dat je řetězec znaků.

Pokud má identita účet v zadaném úložišti, exportují se další značky XML:

- HPPAccountLogin
- HPPAccountPwd
- HPPAccountState

Pokud má identita oprávnění v zadaném úložišti, exportují se další značky XML:

- HPPAccessRight, který bude obsahovat všechny hodnoty oprávnění „Group“ a „Dynamic Group“
- Jedna značka XML pro každý odlišný kód definovaný v mapování oprávnění „Attribute“ nebo „Dynamic Attribute“. Pokud je několik autorizací nakonfigurováno se stejným kódem mapování, exportuje se jediná značka XML s několika hodnotami uvnitř.

## Export Identity: účty + autorizace

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityComptesHabilitations.png)

- Typ objektu: vyberte hodnotu „ACCOUNT“
- Repository: zadejte kód úložiště, ze kterého se mají exportovat účty a autorizace. Upozorňujeme, že i když je technicky možné zadat více kódů úložišť, pro správné fungování konektoru zřizování je nezbytné zadat pouze jeden.

**Výsledky a možnosti:** Exportují se všechny účty ve vybraném úložišti.

Pro každý účet se exportují následující značky:

- ID = ID účtu, které se používá pro aktualizace a odstranění
- Account_login = Přihlašovací jméno účtu
- password = Heslo účtu exportované v zašifrované podobě
- Account_provisioning = Stav zřízení účtu:
    - 1: pouze teoretický účet
    - 2: osiřelý účet
    - 3: teoretický a zřízený účet
- Account_state = Stav teoretického účtu
    - -1: Žádný účet (hodnota v exportu není možná)
    - 0: pouze teoretický účet
    - 1: aktivní účet
    - 2: zakázaný účet
- Account_type = ID typu účtu
- roles = Role přidružené k účtu
- Atributy a oprávnění se exportují do značek pojmenovaných podle konfigurace.

## Export Identity: role

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityRoles.png)

- Typ objektu: vyberte hodnotu „ROLE“
- Repositories: zadejte kódy úložiště, jehož existující související role se mají exportovat. Volitelné.

**Výsledky a možnosti:** Exportují se všechny existující role. Pokud je zadáno jedno nebo více úložišť, exportují se pouze role související s těmito úložišti.

Pro každou roli se exportují následující značky:

- id = ID role
- code = kód role
- name = název role
- description = popis role
- repositories = kód úložišť propojených s rolí
- accountTypes = kód typů účtů propojených s rolí

## Export Identity: autorizace

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityHabilitations.png)

- Typ objektu: vyberte hodnotu „RIGHT“
- Repositories: zadejte kódy úložiště, jehož existující související autorizace se mají exportovat. Volitelné.

**Výsledky a možnosti:** Exportují se všechny existující autorizace. Pokud je zadáno jedno nebo více konkrétních úložišť, exportují se pouze autorizace související s těmito úložišti.

Pro každou autorizaci se exportují následující značky:

- Id = ID autorizace
- code = Kód autorizace
- name = Název autorizace
- category = Kód kategorie autorizace
- application = Kód aplikace autorizace
- repository = Kód úložiště autorizace
- type = Typ autorizace
    - 3 = group. Upozorňujeme, že použití tohoto typu autorizace je od verze 7.0 zastaralé. Upřednostňujte typ „attribute“.
    - 6 = attribute
- mode = Režim autorizace
    - 0 = Statický. Statická hodnota, která se zadává ve značce „value“
    - 1 = dynamický: hodnota atributu zadaného ve značce s názvem „template#[object_type_code]“
- Název atributu pro export autorizací propojených s účty nebo osobami ve značce „mappingCode“

## Export Identity: identity + role

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_SIPDesactiverCalculComptesImport.png)

- Typ objektu: vyberte hodnotu „PERSON_ROLES“
- Repositories: zadejte kódy úložiště, jehož existující související role se mají exportovat.

**Výsledky a možnosti:** exportují se všechny vazby identita-role související s vybranými úložišti.

Pro každou vazbu identita-role se exportují následující značky:

- person = UID identity
- role = kód role, která se má přiřadit
- startdate = datum začátku role
- enddate = datum konce role
- id = ID vazby identita-role

## Export Identity: identity + role + autorizace

![](https://docs.cyberelements.io/identity/7.0/img/Identity/IdU_ConnecteurExportIdentityIdentitesRolesHabilitations.png)

- Typ objektu: vyberte hodnotu „PERSON_RIGHTS“
- Repositories: zadejte kódy úložišť, pro které chcete vytvořit vazby identita/role-autorizace.

**Výsledky a možnosti:** exportují se všechny vazby identita/role-autorizace související s vybranými úložišti.

Pro každou vazbu identita/role-autorizace se exportují následující značky:

- person = UID identity
- role = kód role
- right = kód autorizace
- startdate = datum začátku autorizace
- enddate = datum konce autorizace
- id = ID vazby identita-role-autorizace
