Gestione degli attributi

Tutti i tipi di oggetto (identità, strutture, dotazioni, account) sono composti da attributi. Un attributo può essere di diversi tipi (stringa di caratteri, Identity, Allocation, Structure e così via).

Creare/modificare/eliminare un attributo

Per accedere alla gestione degli attributi, aprire il menu «Configuration \ Attribute Definition».

Si arriva alla prima scheda, «Identity», che contiene l'elenco degli attributi esistenti.

Questa pagina comprende quattro schede:

• Identity
• Strutture
• Dotazioni
• Account

In ogni scheda gli attributi sono elencati in una tabella.

È prevista una paginazione per visualizzare per impostazione predefinita solo 10 attributi, ma è possibile modificare il numero di elementi visualizzati.

In alto a destra della tabella è disponibile un campo di ricerca. La ricerca riguarda i codici, i nomi e le descrizioni degli attributi.

Per creare un nuovo attributo, fare clic sul pulsante «».

La configurazione di un attributo è suddivisa in tre parti:

• General

  • Personal data: selezionare la casella per identificare l'attributo come dato personale. Solo per gli attributi di tipo Identity.
  • Category: selezionare la categoria predefinita in cui sarà collocato l'attributo. È possibile modificare la categoria per ogni tipo di oggetto.
  • Icon name: selezionare l'icona da un elenco di opzioni. Comparirà nei record delle persone. Facoltativo.
  • Icon color: consente di personalizzare il colore dell'icona.
  • Code: codice dell'attributo. Deve essere univoco per ogni tipo di oggetto, senza spazi né caratteri speciali. Obbligatorio.
  • Name: nome dell'attributo. Etichetta che sarà visualizzata nelle diverse maschere dell'applicazione. Obbligatorio.
  • Description: campo per immettere una descrizione dell'attributo. Facoltativo.
  • Data type: scegliere nell'elenco seguente. Obbligatorio.
    • Character string
    • Number
    • Boolean
    • Date
    • Enumerated
    • Identity
    • Organization: consente di aggiungere un tipo di struttura, senza essere obbligatorio.
    • Allocation: è obbligatorio indicare un tipo di dotazione (risorsa).
  • Multi-valued: casella da selezionare se l'attributo può assumere più valori. Per impostazione predefinita la casella non è selezionata.
  • Structure type o Allocation type: visualizzato se il tipo di dato è «Allocation» o «Structure». Indicare il tipo dell'oggetto desiderato. Obbligatorio solo se il tipo di dato è Allocation.
  • Default value(s): valore che sarà assegnato per impostazione predefinita se all'attributo non viene assegnato alcun valore alla creazione di un oggetto. Il valore predefinito è utilizzato solo alla creazione. Facoltativo.
  • Formula type: scegliere una modalità di calcolo nell'elenco seguente se l'attributo deve essere calcolato:
    • No formula: l'attributo non viene calcolato.
    • Formula calculated once: l'attributo viene calcolato solo alla creazione di un oggetto.
    • Formula recalculated if necessary: l'attributo viene ricalcolato quando viene modificato un attributo dipendente (attributo utilizzato nella formula).
    • Formula recalculated with each modification: l'attributo viene ricalcolato a ogni aggiornamento dell'oggetto, indipendentemente dalle dipendenze.
  • Formula: occorre creare una formula se il campo «Calculation mode» non è impostato su «None». Se il campo «Calculation mode» è impostato su «None», questo campo deve restare vuoto. Consultare la sezione Configurare una formula di calcolo di un attributo per la configurazione delle formule.
  • Number of bevel days: numero intero che definisce la durata del periodo di sovrapposizione del valore di un attributo. Utilizzato per gestire le autorizzazioni concesse dalle regole di autorizzazione.
  • Quick search: selezionare la casella per consentire le ricerche sull'attributo nella barra di ricerca rapida delle diverse tabelle di oggetti (identità, dotazioni, strutture, account).
  • Advanced search: selezionare la casella per consentire le ricerche avanzate, tramite le maschere di ricerca.
  • Supported by authorization rules: selezionare la casella per includere l'attributo nei criteri di filtro delle regole di autorizzazione.
  • Homonym: selezionare la casella se si desidera che l'attributo venga confrontato durante la creazione manuale delle identità.

• Display format

  • Display index: indice di visualizzazione predefinito nelle diverse maschere (creazione, consultazione, modifica).

  • Display format: indicare un valore da un elenco dinamico costruito in base al tipo di dato:

    • Character string:
      • Default display format: stringa di caratteri semplice
      • Link display format: stringa di caratteri convertita in un link
    • Boolean:
      • Default display format: 1 o 0 in base al valore.
      • Button display format: consente di definire un'icona e un'etichetta in base al valore dell'attributo. Consente di eseguire azioni sul pulsante.
    • Date:
      • Scegliere il formato nell'elenco: Short date, Medium date, Long date o Custom (formato da definire con i caratteri d, M e y per definire rispettivamente i giorni, i mesi e gli anni).
    • Persona/dotazione/struttura
      • Single string
      • Link to object (with logo)

  • Display in results table: casella che consente di visualizzare il valore dell'attributo nella tabella che elenca gli oggetti corrispondenti.

  • Display index in results table: indice di visualizzazione nelle tabelle dei risultati degli oggetti

  • Display as information: selezionare «Displayed» per visualizzare l'attributo nel riquadro in alto a destra delle identità.

    • Displayed
    • Hidden

  Per impostazione predefinita, gli attributi visualizzati sono:

  + Display name
  + UID
  
      * Display for consultation
  
  + Displayed
  + Hidden
  
      * Display size in view mode: indicare la percentuale della riga da assegnare alla visualizzazione dell'attributo in modalità di consultazione. Esempi:
  
  + 100: l'attributo viene visualizzato su tutta la riga
  + 50: consente di visualizzare 2 attributi su una stessa riga
  
      * Display during creation
  
  + Displayed
  + Hidden
  
      * Display size in view mode: indicare la percentuale della riga da assegnare alla visualizzazione dell'attributo in modalità di creazione.
  
      * Display in edition mode
  
  + Displayed: visualizzato e modificabile
  + Read-only: visualizzato ma non modificabile
  + Hidden
  
      * Display size in view mode: indicare la percentuale della riga da assegnare alla visualizzazione dell'attributo in modalità di consultazione.
  

• Validations

  • Required: selezionare la casella se l'attributo è obbligatorio in modalità di creazione o di modifica.
  • In base al tipo di dato è possibile configurare dei controlli:
    • Character string:
      • Minimum length
      • Maximum length
      • Data model: consente di scegliere Mail o Custom. Con la seconda opzione occorre scrivere un'espressione regolare.
    • Number:
    • Minimum value
    • Maximum value
  • Dall'SP3 di CyberElements Identity 7.0 è stata aggiunta un'opzione di univocità:
    • None: l'opzione di univocità non è abilitata (valore predefinito);
    • By type: l'opzione di univocità è abilitata. I valori controllati saranno filtrati per tipo di oggetto;
    • Complete: l'opzione di univocità è abilitata e non tiene conto del tipo di oggetto.

  Esempio

  • Se l'opzione di univocità è impostata su «By type», un'identità «Employee» può avere lo stesso valore di un'identità «External» per lo stesso attributo. Due identità «Employee» non possono avere lo stesso valore di attributo.
  • Se l'opzione di univocità è impostata su «Complete», un'identità «Employee» non può avere lo stesso valore di un'identità «External» per lo stesso attributo.

Se un attributo è calcolato, occorre indicare una formula da applicare nel caso in cui il primo valore calcolato con la formula principale restituisca un valore già esistente. Si raccomanda di utilizzare la parola chiave §INDEX_DOUBLON§ nella seconda formula per garantire l'univocità del valore.

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

È possibile passare alla modalità di modifica direttamente dalla pagina di consultazione dell'attributo.

In modalità di modifica è possibile modificare tutti i campi.

Azioni dei pulsanti in modalità di modifica o di creazione:

• Cancel: annulla l'immissione in corso e riporta alla pagina dell'elenco degli attributi.
• Save: convalida la maschera e riporta la pagina in modalità di consultazione
• Save and quit: convalida la maschera e riporta alla pagina dell'elenco degli attributi

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

Prima dell'eliminazione dell'attributo viene visualizzato un messaggio di conferma.

Attenzione: non è possibile eliminare un attributo finché è collegato a oggetti.

Popolare un attributo enumerato

Un attributo enumerato è un attributo che dispone di un elenco di valori predeterminato. Il valore dell'attributo deve figurare nell'elenco per poter essere assegnato.

Un attributo enumerato viene popolato tramite l'interfaccia oppure tramite un connettore di provisioning ascendente.

Per popolare un attributo enumerato tramite l'interfaccia, aprire la pagina di configurazione dell'attributo in modalità di consultazione.

L'elenco dei valori enumerati è precaricato in una tabella, senza alcun filtro applicato, e viene visualizzato in fondo alla pagina.

È prevista una paginazione per visualizzare solo 10 valori.

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

Per aggiungere un nuovo valore all'elenco dell'attributo enumerato, fare clic sul pulsante «» situato nella tabella «Enumerated value list».

Immettere le informazioni dell'enumerato:

• Code: codice del valore enumerato. Deve essere univoco, senza spazi né caratteri speciali. Obbligatorio.
• Name: nome dell'enumerato. Etichetta che sarà visualizzata nelle diverse maschere dell'applicazione. Obbligatorio.
• Description: campo che consente di immettere una descrizione dell'enumerato. Facoltativo.

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

È possibile modificare tutti i campi.

Azioni dei pulsanti in modalità di modifica o di creazione:

• Cancel: annulla l'immissione in corso e riporta alla pagina di consultazione dell'attributo.
• Save: convalida la maschera e aggiunge il valore alla tabella dell'elenco degli enumerati

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

Prima dell'eliminazione dell'enumerato viene visualizzato un messaggio di conferma.

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

Per popolare un attributo enumerato tramite il motore Systancia Identity Provisioning (SIP), occorre creare un connettore di provisioning ascendente: a partire da una fonte autorevole esterna, i valori di enumerato che soddisfano le regole di sincronizzazione saranno creati, aggiornati ed eliminati in Systancia Identity secondo le regole definite nelle regole di importazione.

La sequenza di provisioning deve includere almeno gli elementi seguenti:

• Un'esportazione del repository autorevole
• Un'esportazione del repository Identity di tipo «ENUMERATIONS»
• Una regola di sincronizzazione
• Una regola di importazione nel repository Identity di tipo «ENUMERATIONS»

Consultare la pagina Gestione dei connettori di provisioning automatico per creare un connettore.

Configurare una formula di calcolo di un attributo

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

Per gli attributi collegati al tipo di oggetto identità, le query saranno eseguite sulle tabelle che contengono i dati di identità.

Per gli attributi collegati al tipo di oggetto struttura, le query saranno eseguite sulle tabelle che contengono i dati di struttura.

Per gli attributi collegati al tipo di oggetto dotazione, le query saranno eseguite sulle tabelle che contengono i dati di dotazione.

Per gli attributi collegati al tipo di oggetto account, le query saranno eseguite sulle tabelle che contengono i dati di account.

Per fare riferimento a determinati oggetti occorre utilizzare parole chiave.

Salvo indicazione contraria, le parole chiave seguenti e le loro varianti possono essere utilizzate negli attributi di tutti i tipi di oggetto (identità, struttura, dotazione, account):

• §ATTRIBUTE§

  • §ATTRIBUTE§[attribute_code]§: recupera il valore dell'attributo il cui codice è passato come secondo parametro.

  • §ATTRIBUTE§IS_MASTER§: questa variante può essere utilizzata solo negli attributi degli oggetti di tipo Identity. Recupera la posizione dell'identità principale in una catena di riconciliazione. I valori possibili sono i seguenti:

    • 0: se l'identità è secondaria in una catena di riconciliazione
    • 1: se l'identità è principale 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 da primary_attribute_code. Può essere utilizzato solo negli attributi (principali) di tipo Identity, Structure o Allocation, in base al tipo di oggetto che utilizza la formula:

    • Un'identità può essere collegata ad attributi di tipo Identity, Structure e Allocation.
    • Una Structure può essere collegata ad attributi di tipo Identity e Allocation.
    • Una dotazione può essere collegata ad attributi di tipo Identity e Structure.
    • Un account può essere collegato ad attributi di tipo Identity, Structure e Allocation.

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

  + Code per recuperare il codice dell'enumerato
  + Name per recuperare il nome dell'enumerato
  + Description per recuperare la descrizione dell'enumerato
  
      * §ATTRIBUTE§[attribute_code].parent§: variante utilizzata solo negli attributi di tipo struttura. Consente di recuperare la struttura padre della struttura passata come parametro. È possibile ripetere l'uso di «.parent» per risalire di più livelli.
  

• §ACCOUNT§: parola chiave che può essere utilizzata solo negli attributi collegati al tipo di oggetto identità

  • §ACCOUNT§[account_type_code]§: consente di recuperare il login dell'account, collegato all'identità sulla quale viene eseguita la formula, il cui tipo di codice è passato come secondo parametro.

  Esempio: §ACCOUNT§Account_Type_AD§

• §COUNTER§

  • §COUNTER§[counter_code]§: recupera il valore del contatore, incrementato di un'unità, il cui codice è passato come secondo parametro.

  Esempio: §COUNTER§External_ID_Number§

• §CONTEXT§

  • §CONTEXT§Code§: consente di recuperare il codice del 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 popolare un attributo di tipo enumerato a partire dal suo codice.

  • §ENUM§[enum_type_attribute_code]§[secondary_attribute_code]§: consente di popolare l'attributo di tipo enumerato il cui codice è uguale al parametro [enum_type_attribute_code] a partire dal valore dell'attributo il cui codice è passato come secondo parametro [secondary_attribute_code]. Ciò presuppone che il secondo attributo abbia come valore il codice di un enumerato.

  Questa variante è spesso utilizzata quando il codice di un enumerato viene recuperato da una tabella di corrispondenza.

  Esempio: nell'attributo con il codice «Code_grade_table», il codice dell'enumerato di grado corrispondente viene calcolato a partire da una tabella di corrispondenza. Ha il valore GRADE_MANAGER.

  Esiste un attributo con il codice «grade», di tipo enumerato, al quale si desidera assegnare il valore corrispondente 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 popolare l'attributo di tipo enumerato il cui codice è uguale al parametro [enum_type_attribute_code] con il codice di enumerato passato nel secondo parametro [enumeration_code].

  Questa variante è spesso utilizzata quando il valore dell'enumerato viene calcolato in funzione del valore di un altro attributo.

  Esempio: esiste un attributo con il codice «access_type», di tipo enumerato, con i valori seguenti:

  • Code = accès_intranet / Valeur = Intranet
  • Code = accès_externe / Valeur = Externe

  L'attributo deve assumere il valore «Intranet» quando il tipo di persona è «agent» e il valore «External» quando il tipo di persona è «service provider».

  La formula sarà:

  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
  

• §IDENTITY§

  • §IDENTITY§uid_identity§attribute_code§: recupera il valore dell'attributo passato come secondo parametro dell'identità il cui UID è indicato nel primo parametro. L'UID deve essere passato come valore fisso.

• §MAPPING§: parola chiave che recupera i valori dalle tabelle di corrispondenza a partire da una chiave data.

  • §MAPPING§[mapping_table_code].[table_key_code]§: recupera il valore o i valori della tabella con il codice [mapping_table_code] e il valore di chiave passato nel secondo parametro [table_key_code].

  Questa variante è spesso utilizzata quando la chiave impiegata differisce in base al valore di un altro attributo.

  • §MAPPING§[mapping_table_code]§[secondary_attribute_code]§: recupera il valore o i valori della tabella con il codice [mapping_table_code] a partire dal valore dell'attributo il cui codice è passato nel secondo parametro [secondary_attribute_code]. Ciò presuppone che il secondo attributo abbia come valore una chiave di una tabella di enumerati.

  In tal caso, se l'attributo secondario è di tipo identità, struttura o dotazione, è possibile estendere la variante nel modo seguente: §MAPPING§[cross-reference_table_code]§[secondary_attribute_code].[tertiary_attribute_code]§. Viene recuperato il valore dell'attributo [tertiary_attribute_code] collegato all'attributo [secondary_attribute_code].

  Questa variante è spesso utilizzata quando la chiave di una tabella di enumerati viene popolata o calcolata in un attributo.

• §PERSON_STATE§: parola chiave che può essere utilizzata solo nell'attributo di sistema Status (code=person_status) e che consente di assegnargli un valore.

  • §PERSON_STATE§[status_code]§: assegna il valore il cui codice è passato come secondo parametro.

Le parole chiave seguenti e le loro varianti possono essere utilizzate negli attributi collegati al tipo di oggetto account:

• §RIGHTS§

  • §RIGHTS§[right_parameter_code]§: consente di recuperare un valore, un codice, uno stato di provisioning, uno stato teorico e così via (parametro passato come secondo parametro, [right_parameter_code]) di tutte le autorizzazioni collegate all'account. Questa parola chiave deve essere utilizzata in un attributo multivalore.
  • §RIGHTS. [right_code]§[right_parameter_code]§: consente di recuperare un valore, un codice, uno stato di provisioning, uno stato teorico e così via (parametro passato come terzo parametro, [right_parameter_code]) dell'autorizzazione il cui codice è definito nel secondo parametro, [right_code]. Il valore può essere monovalore o multivalore.

• §ROLES§

  • §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 multivalore.
  • §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].

• §OWNER§ / §IDENTITIES§

  • §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 collegata o no all'account.
  • §IDENTITIES§[attribute_code]§: recupera il valore di un attributo il cui codice è passato come secondo parametro ([attribute_code]) di tutte le identità collegate all'account, ovvero sia quella principale sia quelle secondarie.

  Se l'attributo è di tipo identità, struttura o dotazione, è possibile estendere la variante nel modo seguente: §[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]. Viene recuperato il valore dell'attributo [secondary_attribute_code] collegato all'attributo [attribute_code].

• §CONCAT§ / §MIN§ / §MAX§: parole chiave che possono essere utilizzate solo con le parole chiave §OWNER§ / §IDENTITIES§.

  • §CONCAT§[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]§[separator]§: recupera una stringa di caratteri il cui valore è la concatenazione del valore dell'attributo passato nel 3° e nel 4° parametro ([attribute_code].[secondary_attribute_code]) di tutte le identità identificate dal secondo parametro. Ogni valore è separato da un carattere indicato nel quinto parametro.
  • §MIN§[OWNER/IDENTITIES]§[attribute_code]§: recupera il valore più alto tra i valori dell'attributo passato come terzo parametro ([attribute_code]) di 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]) di tutte le identità identificate dal secondo parametro.

• §PASSWORD§

  • §PASSWORD§[number]§[lowercase]§[uppercase]§[special]§[special_characters_list]§[number_of_characters]§: consente di generare password casuali per gli account.
    • [number]: consente di definire se la password deve contenere almeno una cifra. Il valore 1 abilita il vincolo. Per disabilitarlo, immettere il valore 0.
    • [lowercase]: consente di definire se la password deve contenere almeno una minuscola. Il valore 1 abilita il vincolo. Per disabilitarlo, immettere il valore 0.
    • [uppercase]: consente di definire se la password deve contenere almeno una maiuscola. Il valore 1 abilita il vincolo. Per disabilitarlo, immettere il valore 0.
    • [special]: consente di definire se la password deve contenere almeno un carattere speciale. Il valore 1 abilita il vincolo. Per disabilitarlo, immettere il valore 0.
    • [special_characters_list]: consente di indicare i caratteri speciali autorizzati dell'elenco seguente: !#$%&()*+,./:;<>?@[]^_|~.
    • [number_of_characters]: 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 una cifra, almeno una minuscola, almeno una maiuscola e almeno un carattere speciale dell'elenco seguente: !#$%&()*+

• §INDEX_DUPLICATE§

  • §INDEX_DUPLICATE§: aggiunge un indice nel punto in cui la parola chiave è collocata nel valore dell'attributo.

  Attenzione

  Questa parola chiave può essere utilizzata solo negli attributi calcolati e unicamente quando l'opzione di univocità è abilitata.

• §UNION§

  • §UNION§<attribute1>|<attribute2>|...§: consente di concatenare in un altro attributo i valori di più attributi.
  • §UNION§<attribute1>|<attribute2>|...§<value1>|<value2>|...§: consente di concatenare in un altro attributo i valori di più attributi indicando valori fissi.
    • I valori fissi della formula possono assumere la forma seguente:
      • Per gli attributi booleani: true o false
        • §UNION§active_person§false§
      • Per gli attributi di tipo data: occorre utilizzare il formato SQL_DATE_FORMAT_SHORT della tabella dbo.CONFIGURATION (per impostazione predefinita «yyyy-MM-dd»)
        • §UNION§start_date|end_date§2025-05-15§
      • Per gli attributi di tipo, struttura, risorse o enumerato: occorre indicare l'ID
        • §UNION§manager§1885|1886§
      • Per gli attributi di tipo stringa di caratteri: non è possibile includere spazi nelle stringhe di caratteri, né utilizzare i caratteri | o §. I caratteri speciali autorizzati sono: !#$%&'()*+,./:;<>?@[]^_{}~
        • §UNION§firstname§Jean-Pierre|Marie§

• §RANDOM§

  • §RANDOM.[object_type]§[code]§: consente di selezionare casualmente un valore da un elenco di valori di un oggetto di tipo Table de correspondance, énumérations o attributs multivalués.
    • [object_type] consente di indicare il tipo di oggetto; può assumere i valori seguenti:
      • MAPPING per le tabelle di corrispondenza
      • ENUM per gli attributi enumerati
      • ATTRIBUTE per un attributo multivalore
    • [code] consente di indicare il codice dell'attributo o dell'oggetto desiderato