Gestione degli attributi¶

Tutti i tipi di oggetto (identità, strutture, allocazioni, account) sono composti da attributi. Identity, Allocazione, Struttura, ecc.).

Creazione/modifica/eliminazione di un attributo¶

Per accedere alla gestione degli attributi, accedere al menu Configurazione \ Definizione degli attributi.

Arriverete alla prima scheda, Identity, che contiene l'elenco degli attributi esistenti.

Ci sono quattro schede in questa pagina:

Identità
Strutture
Affidabilità
Conto

In ogni scheda, gli attributi sono elencati in una tabella.

La paginazione è impostata per visualizzare solo 10 attributi di default, ma è possibile modificare il numero di elementi visualizzati.

In alto a destra della tabella è disponibile un campo di ricerca che comprende codici, nomi e descrizioni degli attributi.

Per creare un nuovo attributo, fare clic sul pulsante .

La configurazione degli attributi è divisa in tre parti:

Generale
- Dati personali: selezionare la casella per identificare l'attributo come dati personali. Solo per gli attributi di tipo Identity.
- Categoria: selezionare la categoria predefinita in cui l'attributo sarà inserito. È possibile modificare la categoria per ogni tipo di oggetto.
- Nome dell'icona: selezionare l'icona da un elenco di opzioni. Verrà inclusa nei file della persona. Opzionale.
- Colore dell'icona: opzione per personalizzare il colore dell'icona.
- Codice: codice di attributo, deve essere unico per ogni tipo di oggetto, senza spazi o caratteri speciali.
- Nome: nome dell'attributo. Etichetta che verrà visualizzata nelle varie forme dell'applicazione. Obbligatorio.
- Description: campo per inserire una descrizione dell'attributo.
- Tipo di dati: scegliere dall'elenco seguente.
  - Stringa di caratteri
  - Numero
  - Boolean
  - Data
  - Numerato
  - Identità
  - Organizzazione: aggiungere un tipo di struttura è opzionale, ma non obbligatorio.
  - Allocazione: è obbligatorio inserire un tipo di allocazione (risorsa).
- Multi-value: casella di controllo se l'attributo può assumere più valori. Per impostazione predefinita, la casella non è selezionata.
- Tipo struttura o tipo allocazione: viene visualizzato se il tipo di dati è allocazione o struttura. Inserire il tipo dell'oggetto desiderato.
- Valore predefinito ((s): valore che verrà assegnato di default se non viene assegnato alcun valore all'attributo durante la creazione di un oggetto. Il valore predefinito viene utilizzato solo durante la creazione.
- Tippo di formula: scegliere un metodo di calcolo se l'attributo deve essere calcolato dall'elenco seguente:
  - Nessuna formula: l'attributo non è calcolato.
  - Formula calcolata una volta: l'attributo viene calcolato solo quando viene creato un oggetto.
  - Formula ricalcolata se necessario: l'attributo viene ricalcolato quando viene modificato un attributo dipendente (attributo utilizzato nella formula).
  - Formula ricalcolata con ogni modifica: l'attributo viene ricalcolato ogni volta che l'oggetto viene aggiornato, indipendentemente dalle dipendenze.
- Formula: la formula deve essere creata se il campo Modalità di calcolo non è impostato su Nessuno. Se il campo Modalità di calcolo è impostato su Nessuno, allora questo campo deve essere vuoto. Per la configurazione della formula, fare riferimento alla sezione Configurare una formula per il calcolo di un attributo.
- Numero di giorni di bevel: numero intero per definire il tempo del periodo di bevel di un valore di attributo. Utilizzato per gestire le autorizzazioni fornite dalle regole di autorizzazione.
- Cerca rapida: selezionare la casella per consentire la ricerca dell'attributo nella barra di ricerca rapida delle varie tabelle di oggetti (identità, allocazioni, strutture, account).
- Ricerca avanzata: selezionare la casella per consentire ricerche avanzate, sia tramite moduli di ricerca.
- Sostenuto da regole di autorizzazione: selezionare la casella per includere l'attributo nei criteri di filtraggio per le regole di autorizzazione.
- Omonimo: selezionare la casella se si desidera che l'attributo sia confrontato quando le identità vengono create manualmente.

Formato di visualizzazione

Indice di visualizzazione: indice di visualizzazione predefinito nelle varie forme (creazione, consultazione, modifica).
Formato di visualizzazione: inserire un valore da un elenco dinamico costruito in base al tipo di dati:
- Stringa di caratteri:
  - Formato di visualizzazione predefinito: stringa di caratteri semplice
  - Formato di visualizzazione del collegamento: stringa di caratteri convertita in un collegamento
- Boolean:
  - Formato di visualizzazione predefinito: 1 o 0 a seconda del valore.
  - Formato di visualizzazione del pulsante: consente di definire un'icona e un'etichetta in base al valore dell'attributo. Consente di eseguire azioni sul pulsante.
- Data:
  - Scegliere il formato dall'elenco: Data breve, Data media, Data lunga o Personalizzazione (format da definire utilizzando i caratteri d, M e y per definire rispettivamente giorni, mesi e anni).
- Person/allocazione/struttura
  - Cordone singolo
  - Legame all'oggetto (con il logo)
Mostra nella tabella dei risultati: casella di controllo per visualizzare il valore dell'attributo nella tabella che elenca gli oggetti corrispondenti.
Indice di visualizzazione nella tabella dei risultati: indice di visualizzazione nelle tabelle dei risultati degli oggetti
Mostra come informazione: selezionare Mostra per visualizzare l'attributo nella casella in alto a destra delle identità.
- Mostrato
- Nascosto

In default, gli attributi visualizzati sono:

+ Nome di visualizzazione
+ UID

    * Display per la consultazione

+ Mostrato
+ Nascosto

    * Dimensione del display in modalità visiva: inserire la percentuale della linea da assegnare per la visualizzazione dell'attributo in modalità visiva.

+ 100: l'attributo verrà visualizzato su tutta la riga
+ 50: consente di visualizzare 2 attributi su una riga

    * Mostra durante la creazione

+ Mostrato
+ Nascosto

    * Dimensione del display in modalità vista: inserire la percentuale di righe da assegnare per visualizzare l'attributo in modalità creazione.

    * Display in modalità edizione

+ In visualizzazione: visualizzabile e modificabile
+ Solo lettura: visualizzato ma non modificabile
+ Nascosto

    * Dimensione del display in modalità visiva: inserire la percentuale della linea da assegnare per la visualizzazione dell'attributo in modalità visiva.

Validazioni
- Obbligatorio: verificare se l'attributo è obbligatorio in modalità di creazione o modifica.
- In base al tipo di dati, è possibile configurare i controlli:
  - Stringa di caratteri:
    - Lunghezza minima
    - Lunghezza massima
    - Modello di dati: opzione per scegliere Mail o Custom. Con la seconda opzione, deve essere scritta un'espressione regolare.
  - Numero:
  - Valo minimo
  - Valore massimo
- Dal momento che SP3 di cyberelements Identity 7.0 è stata aggiunta un'opzione di unicità:
  - Nessuna: l'opzione di unicità non è abilitata (valore predefinito);
  - Per tipo: l'opzione di unicità è abilitata. I valori controllati saranno filtrati per tipo di oggetto;
  - Complete: l'opzione di unicità è abilitata e non tiene conto del tipo di oggetto.
!!! example “Example” - Se l'opzione di unicità è impostata su Per tipo, un'identità Employee può avere lo stesso valore di un'identità External per lo stesso attributo. - Se l'opzione di unicità è impostata su Complete, un'identità Employee non può avere lo stesso valore di un'identità External per lo stesso attributo.

Se un attributo è calcolato, è necessario specificare una formula da applicare nel caso in cui il primo valore calcolato utilizzando la formula principale restituisca un valore esistente.

Per visualizzare e modificare un attributo, fare clic sull'icona situata a destra nella riga della tabella corrispondente.

È possibile passare alla modalità di modifica direttamente dalla pagina di visualizzazione degli attributi.

In modalità di modifica, tutti i campi possono essere modificati.

Azioni sui pulsanti in modalità di modifica o creazione:

Cancel: cancella l'entrata corrente e ritorna alla pagina dell'elenco degli attributi.
Salvare: convalidare il modulo e passare alla pagina in modalità di visualizzazione
Salvare e uscire: convalidare il modulo e tornare alla pagina dell'elenco degli attributi

Per eliminare un attributo, fare clic sull'icona situata a destra della riga della tabella corrispondente.

Prima di eliminare l'attributo, verrà visualizzato un messaggio di conferma.

Avvertimento: non è possibile eliminare un attributo finché è collegato ad oggetti.

Disponibilità di un attributo enumerato¶

Un attributo enumerato è un attributo con un elenco predeterminato di valori. Il valore dell'attributo deve essere presente nell'elenco per essere assegnato.

Un attributo enumerato viene inserito tramite l'interfaccia o tramite un connettore di provisioning a monte.

** Per inserire un attributo enumerato tramite l'interfaccia **, aprire la pagina di configurazione dell'attributo in modalità vista.

L'elenco dei valori enumerati è precaricato in una tabella senza l'applicazione di filtri e viene visualizzato in fondo alla pagina.

La pagination è implementata per visualizzare solo 10 valori.

In alto a destra della tabella è disponibile un campo di ricerca che comprende i codici, i nomi o le descrizioni dei valori enumerati, ossia i campi visualizzati nella tabella.

Per aggiungere un nuovo valore all'elenco degli attributi enumerati, fare clic sul pulsante situato nella tabella Enumerated value list.

Indicare le informazioni dell'enumeratore:

Codice: codice del valore enumerato. Deve essere unico, senza spazi o caratteri speciali. Obbligatorio.
Nome: nome dell'elencato, etichetta che sarà riportata nelle varie forme della domanda, obbligatorio.
Description: campo che consente di inserire una descrizione dell'elemento enumerato.

Per modificare un elenco, fare clic sull'icona situata a destra nella riga della tabella corrispondente.

Tutti i campi possono essere modificati.

Azioni sui pulsanti in modalità di modifica o creazione:

Cancel: cancella l'entrata corrente e ritorna alla pagina di visualizzazione dell'attributo.
Salvare: convalidare il modulo e aggiungere il valore alla tabella dell'elenco di enumerazione

Per eliminare una voce, fare clic sull'icona situata a destra della riga della tabella corrispondente.

Prima di eliminare l'enumerazione, verrà visualizzato un messaggio di conferma.

Avvertimento: non è possibile eliminare un valore enumerato finché è assegnato a un attributo collegato a un oggetto (identità, struttura, provisioning o account).

Per inserire un attributo enumerato tramite il motore di provisioning (SIP) di Systancia Identity, è necessario creare un connettore di provisioning a monte: da una fonte autorevole esterna, i valori di enumerazione che soddisfano le regole di sincronizzazione verranno creati, aggiornati e eliminati in Systancia Identity secondo le regole definite nelle regole di importazione.

La sequenza di approvvigionamento deve comprendere almeno i seguenti elementi:

Esportazione del repository autorizzato
Un'esportazione del repository Identity del tipo ENUMERATIONS
Una regola di sincronizzazione
Una regola di importazione nel repository Identity del tipo ENUMERATIONS

Per creare un connettore, consultare la pagina Gestione del connettore di approvvigionamento automatico.

Configurare una formula per il calcolo di un attributo¶

La formula per il calcolo di un attributo corrisponde a una query SELECT che verrà eseguita nel database. L'operazione SELECT non deve essere inclusa nella formula.

Per gli attributi collegati al tipo di oggetto di identità, le query saranno eseguite su tabelle contenenti dati di identità.

Per gli attributi collegati al tipo di oggetto struttura, le query verranno eseguite su tabelle contenenti dati strutturali.

Per gli attributi collegati al tipo di oggetto di allocazione, le query saranno eseguite sulle tabelle contenenti i dati di allocazione.

Per gli attributi collegati al tipo di oggetto account, le query saranno eseguite sulle tabelle contenenti i dati dell'account.

Per fare riferimento a determinati oggetti, occorre utilizzare parole chiave.

Salvo diversa indicazione, le seguenti parole chiave e le relative variazioni possono essere utilizzate negli attributi di tutti i tipi di oggetto (identità, struttura, allocazione, account):

E' un'altra cosa.
§ATTRIBUTE§[attribute_code]§: recupera il valore dell'attributo il cui codice è passato come secondo parametro.
§ATTRIBUTE§IS_MASTER§: Questa variazione può essere utilizzata solo per gli attributi di oggetti di tipo Identity. Ritrova la posizione dell'identità primaria in una catena di riconciliazione. I possibili valori sono i seguenti:
- 0: se l'identità è secondaria in una catena di riconciliazione
- 1: se l'identità è primaria in una catena di riconciliazione
- 2: se l'identità non è in alcuna catena di riconciliazione
§ATTRIBUTE§[primary_attribute_code].[secondary_attribute_code]§: consente di recuperare il valore dell'attributo (secondario) collegato all'oggetto definito dal codice primario_attributo. Questo può essere utilizzato solo per gli attributi (primari) del tipo Identity, Struttura o Allocazione, a seconda del tipo di oggetto che utilizza la formula:
- Un'identità può essere collegata agli attributi del tipo Identity, Struttura e Allocazione.
- Una struttura può essere collegata ad attributi del tipo Identity e all'allocazione.
- Una assegnazione può essere collegata ad attributi del tipo Identity e Struttura.
- Un account può essere collegato ad attributi di tipo Identity, Struttura e Allocazione.

È anche possibile utilizzare questa variazione per recuperare i valori del codice, del nome o della descrizione degli attributi enumerati. In questo caso, il valore di [secondary_attribute_code] deve essere:

+ Codice per recuperare il codice di enumerazione
+ Nome per recuperare il nome di enumerazione
+ Descrizione per recuperare la descrizione dell'enumerazione

    * §ATTRIBUTE§[attribute_code].parent§: variazione che viene utilizzata solo per gli attributi di tipo struttura. Ti consente di recuperare la struttura genitore della struttura che viene passata come parametro. È possibile moltiplicare l'uso di .parent se si desidera salire di diversi livelli.

§ACCOUNT§: parola chiave che può essere utilizzata solo negli attributi collegati al tipo di oggetto di identità
- §ACCOUNT§[account_type_code]§: consente di recuperare il login dell'account, collegato all'identità su cui viene eseguita la formula e il cui tipo di codice viene passato come secondo parametro.
Esempio: §CONTO§Account_Type_AD§
- "Contra".
- §COUNTER§[counter_code]§: recupera il valore del contatore, incrementato di un'unità, il cui codice viene passato come secondo parametro.
Esempio: §COUNTER§External_ID_Number§

§CONTESTO§

§CONTEXT§Code§: consente di recuperare il codice per il contesto corrente.

Esempio:

CASE §CONTEXT§Code§ 
WHEN ‘Standard’ THEN ‘Accès ouvert’
WHEN ‘Plan blanc’ THEN ‘Accès limité’
ELSE ‘Accès fermé’ END

§ENUM§: parola chiave che consente di compilare un attributo di tipo di enumerazione dal suo codice.
- §ENUM§[enum_type_attribute_code]§[secondary_attribute_code]§: consente di compilare l'attributo di tipo enumerazione il cui codice è uguale al parametro [enum_type_attribute_code] dal valore dell'attributo il cui codice è passato come secondo parametro [secondary_attribute_code]. Ciò significa che il secondo attributo ha come valore il codice di un enumerazione.
Questa variazione viene spesso utilizzata quando il codice di un enumerazione viene recuperato da una tabella di riferimento incrociato.

Esempio: nell'attributo con il codice Code_grade_table, il codice per l'enumerazione del grado corrispondente è calcolato da una tabella di riferimento incrociato.

Ho un attributo con il codice grade, di tipo enumerazione, in cui voglio assegnare il valore che corrisponde al codice calcolato nell'attributo Code_grade_table.

La formula sarà: §ENUM§grade§Code_grade_table§
- §ENUM§[enum_type_attribute_code].[enumeration_code]§: consente di fornire l'attributo di tipo di enumerazione il cui codice è uguale al parametro [enum_type_attribute_code] con il codice di enumerazione passato nel secondo parametro [enumeration_code].
Questa variazione viene spesso utilizzata quando il valore dell'enumerazione viene calcolato in base al valore di un altro attributo.

Esempio: ho un attributo con il codice access_type, che è un tipo di enumerazione con i seguenti valori:
- Codice = accès_intranet / Valeur = Intranet
- Codice = accès_externe / Valeur = Externe
Il mio attributo deve assumere il valore Intranet quando il tipo di persona è uguale a agent e il valore External quando il tipo di persona è uguale a service provider.

La mia formula sarà:
1 2 3 4
CASE §ATTRIBUT§type_personne_enum.code§ WHEN ‘agent’ THEN §ENUM§type_accès.accès_intranet§ WHEN ‘prestataire’ THEN §ENUM§type_accès.accès_externe§ ELSE ‘’ END
§IDENTITÀ§
- §IDENTITY§uid_identity§attribute_code§: recupera il valore dell'attributo passato come secondo parametro dell'identità il cui UID è specificato nel primo parametro. L'UID deve essere passato come valore codificato.
§MAPPING§: parola chiave che recupera valori da tabelle di mappatura basate su una determinata chiave.
- §MAPPING§[mapping_table_code].[table_key_code]§: recupera il valore o i valori nella tabella con il codice [mapping_table_code] e il valore chiave passato nel secondo parametro [table_key_code].
Questa variazione è spesso utilizzata quando la chiave utilizzata è diversa a seconda del valore di un altro attributo.
- §MAPPING§[mapping_table_code]§[secondary_attribute_code]§: recupera il valore o i valori nella tabella con il codice [mapping_table_code] dal valore dell'attributo il cui codice è passato nel secondo parametro [secondary_attribute_code]. Ciò significa che il secondo attributo ha come valore una chiave da una tabella di enumerazione.
In questo caso, se l'attributo secondario è di tipo identità, struttura o allocazione, è possibile estendere la variazione come segue: §MAPPING§[cross-reference_table_code]§[secondary_attribute_code][tertiary_attribute_code]§. Il valore dell'attributo [tertiary_attribute_code] collegato all'attributo [secondary_attribute_code] viene recuperato.

Questa variazione viene spesso utilizzata quando la chiave di una tabella di enumerazione è inserita o calcolata in un attributo.
§PERSON_STATE§: parola chiave che può essere utilizzata solo nell'attributo sistema Status (code=person_status), che consente di assegnare un valore a questo attributo.
- §PERSON_STATE§[status_code]§: assegna il valore il cui codice viene passato come secondo parametro.

Le seguenti parole chiave e le relative variazioni possono essere utilizzate negli attributi relativi al tipo di oggetto account:

§DIRITTI§
- §RIGHTS§[right_parameter_code]§: consente di recuperare un valore, un codice, lo stato di provisioning, lo stato teorico, ecc. (parametro passato come secondo parametro, [right_parameter_code]) per tutte le autorizzazioni collegate all'account. Questa parola chiave deve essere utilizzata in un attributo a valori multipli.
- §RIGHTS. [right_code]§[right_parameter_code]§: consente di recuperare un valore, un codice, uno stato di provisioning, uno stato teorico, ecc. (parametro passato come terzo parametro, [right_parameter_code]) per l'autorizzazione il cui codice è definito nel secondo parametro, [right_code]. Il valore può essere a valore singolo o a valore multiplo.
§ROLI§
- §ROLES§[role_parameter_code]$: recupera il nome o il codice (parametro passato come secondo parametro, [role_parameter_code]) di tutti i ruoli collegati all'account. Questa parola chiave deve essere utilizzata in un attributo a valori multipli.
- §ROLES.[role_code]§[role_parameter_code]§: recupera il nome o il codice (parametro passato come terzo parametro, [role_parameter_code]) del ruolo il cui codice è definito nel secondo parametro, [role_code].
§Proprietario§ / §Identità§
- §OWNER§[attribute_code]§: recupera il valore di un attributo il cui codice è passato come secondo parametro ([attribute_code]) della persona principale della catena di riconciliazione, indipendentemente dal fatto che sia collegato all'account.
- §IDENTITIES§[attribute_code]§: recupera il valore di un attributo il cui codice è passato come secondo parametro ([attribute_code]) per tutte le identità collegate all'account, cioè sia primarie che secondarie.
Se l'attributo è di tipo identità, struttura o allocazione, è possibile estendere la variazione come segue: §[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]. Il valore dell'attributo [secondary_attribute_code] collegato all'attributo [attribute_code] viene recuperato.
§CONCAT§ / §MIN§ / §MAX§: parole chiave che possono essere utilizzate solo con le parole chiave §Proprietario§ / §IDENTITA'.
- §CONCAT§[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]§[separator]§: recupera una stringa di caratteri il cui valore è una concatenazione del valore dell'attributo passato nel 3° e 4° parametro ([attribute_code][secondary_attribute_code]) per tutte le identità identificate dal secondo parametro. Ogni valore è separato da un carattere specificato nel quinto parametro.
- §MIN§[OWNER/IDENTITIES]§[attribute_code]§: recupera il valore più alto tra i valori dell'attributo passato come terzo parametro ([attribute_code]) per tutte le identità identificate dal secondo parametro.
- §MAX§[OWNER/IDENTITIES]§[attribute_code]§: recupera il valore più alto tra i valori dell'attributo passato come terzo parametro ([attribute_code]) per tutte le identità identificate dal secondo parametro.
§PASSWORD§
- §PASSWORD§[numero]§[case minore]§[case maiuscole]§[speciale]§[elenco_di_caratteri_speciali]§[numero_di_caratteri]§: consente di generare password casuali per gli account.
  - [numero]: consente di definire se la password deve contenere almeno un numero. Il valore 1 attiva il vincolo. Per disattivare il vincolo, inserire il valore 0.
  - [case minore]: consente di definire se la password deve contenere almeno una lettera minuscola. Il valore 1 attiva il vincolo. Per disattivare il vincolo, immettere il valore 0.
  - [majuscolo]: consente di definire se la password deve contenere almeno una lettera maiuscola. Il valore 1 attiva il vincolo. Per disattivare il vincolo, inserire il valore 0.
  - [special]: consente di definire se la password deve contenere almeno un carattere speciale. Il valore 1 attiva il vincolo. Per disattivare il vincolo, immettere il valore 0.
  - [special_characters_list]: consente di specificare i caratteri speciali consentiti dall'elenco seguente: !#$%&()*+,./:;<>?@[]^_|~.
  - [numero_di_caratteri]: definisce il numero di caratteri della password.
!!! example "Esempio " §PASSWORD§1§1§1§1§!#$%&()*+§8§ Questa riga definisce una password di 8 caratteri che richiede almeno un numero, almeno una lettera minuscola, almeno una lettera maiuscola e almeno un carattere speciale dall'elenco seguente: !#$%&()*+
§INDEX_DUPLICATE§
- §INDEX_DUPLICATE§: aggiunge un indice alla posizione in cui la parola chiave è posizionata nel valore dell'attributo.
!!! warning “Warning”
Questa parola chiave può essere utilizzata solo per gli attributi calcolati e solo quando è abilitata l'opzione di unicità.
§UNION§
- §UNION§<attribute1> Inyandiko...§: permette di concatenate valori da più attributi in un altro attributo.
- §UNION§<attribute1>
  harad...§<value1> harad<value2> harad...§: permette di concatenate valori da più attributi in un altro attributo specificando valori fissi.
  - I valori codificati in forma rigida nella formula possono assumere la forma seguente:
    - Per gli attributi booleani: true o false
      
      "Falso"
    - Per gli attributi data: deve essere utilizzato il formato SQL_DATE_FORMAT_SHORT nella tabella dbo.CONFIGURATION (default aaaa-mm-dd)
      
      §UNION§start_date e end_date§2025-05-15§
    - Per gli attributi di tipo, struttura, risorse o enumerazione: deve essere specificato l'ID
      
      §UNIONE§manager§1885
    - Per gli attributi di tipo stringa di caratteri: non è possibile includere spazi nelle stringhe di caratteri, né utilizzare i caratteri | o §. I caratteri speciali consentiti sono: !#$%&'() *+,./:;<>?@[]^_{}~
      
      Non lo so.
§RANDOM§
- §RANDOM.[object_type]§[code]§: consente di selezionare in modo casuale un valore da un elenco di valori in un oggetto di tipo Table de correspondance, énumérations o attributs multivalués.
  - [object_type] consente di specificare il tipo di oggetto; può assumere i seguenti valori:
    - MAPPING per tabelle di mappatura
    - ENUM per gli attributi elencati
    - ATTRIBUTO per un attributo a valori multipli
  - [code] consente di specificare il codice dell'attributo o dell'oggetto desiderato