I valori dei dati di riferimento in una serie sono generalmente identificati da un codice univoco. Tuttavia, potrebbe essere necessario identificare i dati utilizzando più di una colonna. Una chiave composta è una combinazione della colonna di codice e di un massimo di 5 colonne personalizzate in un dataset di riferimento. La chiave composita viene quindi utilizzata per identificare in modo univoco ciascun valore di dati di riferimento.

Autorizzazioni richieste Per creare, modificare o eliminare i dataset di riferimento, è necessario disporre di questa autorizzazione utente:

• Accedi alle risorse utente di governance

Inoltre, è necessario disporre di uno di questi ruoli di collaboratore di categoria nella categoria principale per il dataset di riferimento:

• Admin
• Proprietario
• Redattore
• Un ruolo personalizzato con l'autorizzazione a creare dataset di riferimento.

Una chiave composita viene utilizzata per identificare in modo univoco ciascun valore di dati di riferimento. Con una chiave composta, i valori nella colonna di codice non devono più essere univoci. L'univocità è garantita solo quando i valori di tutte le colonne specificate sono combinati - i valori nelle singole colonne non sono necessariamente univoci.

Quando si definisce una chiave composita per la serie, ogni valore dei dati di riferimento in tale serie viene identificato nel sistema da una rappresentazione fisica della chiave composita, che è una concatenazione della colonna di codice e delle colonne personalizzate della chiave composita nell'ordine specificato quando la serie è stata inizialmente creata. I valori sono delimitati da |, ad esempio: CODE|CC1|CC2|CC3. Questa rappresentazione fisica viene utilizzata per identificare i valori dei dati di riferimento nel sistema (ad esempio, per tenere traccia delle relazioni) e non può essere modificata.

Le seguenti limitazioni si applicano alle colonne personalizzate utilizzate per la creazione di una chiave composita:

• Le colonne di chiavi composite possono essere aggiunte solo a dataset di riferimento nuovi o vuoti. Se una serie dispone già di valori di dati di riferimento aggiunti, non è possibile definire una chiave composita.
• Le colonne personalizzate che si desidera convalidare devono essere di tipo Testo.
• È possibile aggiungere fino a 5 colonne personalizzate alla colonna Codice per comporre una chiave composita. La colonna di codice è sempre la prima.
• Se la colonna personalizzata fa parte della chiave composita, deve essere impostata come obbligatoria.
• Quando i valori dei dati di riferimento vengono aggiunti alla serie, la chiave composita non può più essere modificata. Se è necessaria una modifica, è necessario creare un nuovo dataset di riferimento.
• La colonna chiave composta può avere una lunghezza massima di 200 caratteri. Le colonne personalizzate che non fanno parte della chiave composita hanno il limite impostato su 2000.
• I caratteri | e UNIT SEPARATOR (codice ASCII 0x31) non devono essere utilizzati nella colonna di codice o nelle colonne personalizzate utilizzate per creare la chiave composita. Questo carattere viene utilizzato per separare i valori della chiave composita quando si crea una rappresentazione fisica della chiave composita nel database. Questa limitazione si applica solo all'API v4.

Per creare un dataset di riferimento con una chiave composta utilizzando un file CSV con valori:

1. Scegliere Governance> Dati di riferimento, quindi fare clic su Aggiungi dataset di riferimento.

2. Fare clic su Nuovo dataset di riferimento e specificare quanto segue nel pannello Dettagli:

   1. Caricare il file CSV.
   2. Fornire un nome per il dataset di riferimento.
   3. Specificare il tipo di valori: Testo, Numero o Data.
   4. Selezionare la categoria in cui creare il dataset di riferimento.
   5. Facoltativamente, fornire una descrizione.

3. Nel pannello Associa colonne , associare le colonne dal proprio file CSV alle colonne di destinazione:

   1. Specificare se la prima riga in un file CSV deve essere utilizzata come intestazione di colonna invece del primo valore di dati di riferimento.

   2. Associare le colonne dal file una alla volta. Viene visualizzata l'anteprima della colonna caricata. Se le colonne predefinite non soddisfano le proprie esigenze, selezionare Nuova colonna personalizzata.

   3. Per ogni colonna personalizzata, specificare:

      • Nome: il nome colonna deve essere univoco all'interno di un determinato dataset di riferimento.
      • Tipo: Testo, Numero o Data.
      • Descrizione: facoltativa.
      • Il numero massimo di caratteri da utilizzare per un record in una colonna. Il limite per una colonna chiave composta è 200. Per tutte le altre colonne il limite è 2000. Questo limite può essere cambiato solo quando il dataset di riferimento è vuoto. Quando i valori vengono aggiunti nella serie, è possibile solo aumentare il limite.
      • Facoltativamente, selezionare il dataset di riferimento che si desidera utilizzare per la convalida - i valori nella colonna verranno convalidati rispetto alla colonna CODE nel dataset di riferimento selezionato. Se un valore di colonna personalizzato non è valido per un qualsiasi motivo, il valore dei dati di riferimento non viene creato o importato e al report viene aggiunta un'avvertenza.

      Nota:

      • Il dataset di riferimento scelto per essere un programma di convalida non può più essere rimosso a meno che non venga rimossa la convalida rispetto a questa serie.
      • Il programma di convalida per una colonna può essere impostato o modificato solo se il dataset di riferimento è vuoto.
      • È possibile convalidare solo le colonne di tipo Testo, poiché la colonna CODE con cui si sta eseguendo la convalida è sempre di questo tipo.

   4. Se si desidera che la colonna personalizzata faccia parte della chiave composita, selezionare Parte della chiave composita. La colonna viene quindi contrassegnata automaticamente come Obbligatorio, il che significa che i valori non possono essere vuoti.

4. Quando tutte le colonne sono associate, rivedere le informazioni nel riquadro Revisione . Tenere presente che a questo punto è possibile riordinare le colonne di chiavi composite in modo che corrispondano ai requisiti. L'ordine delle colonne impostate in questo pannello influenza il modo in cui la rappresentazione fisica della chiave composita è formata nel sistema. Ad esempio, se le colonne in questo pannello sono elencate in questo ordine:

   • colonna personalizzata 1
   • colonna personalizzata 2
   • colonna personalizzata 3

   Quindi, la rappresentazione fisica della chiave composita per questi valori di dati di riferimento è formata come CODE|CC1|CC2|CC3. Quando si aggiungono valori al dataset di riferimento, questo ordine non può più essere modificato. È possibile riorganizzare le colonne nell'interfaccia utente quando si visualizza la serie, ma ciò non influisce sulla composizione effettiva della chiave composita. Confrontare l'ordine delle colonne con quello specificato nel file CSV e modificarlo, se necessario.

5. Fare clic su Crea. Il dataset di riferimento viene salvato come bozza.

Nota: quando si utilizzano i file CSV con i valori dei dati di riferimento, assicurarsi che la relazione principale tra i valori sia rappresentata come concatenazione di CODE e dei valori della colonna personalizzata della chiave composita delimitati da |. Il codice va sempre per primo, quindi i valori della colonna chiave composita. Verificare che l'ordine di queste colonne sia lo stesso nel file CSV e nel pannello di riepilogo della procedura guidata di creazione o importazione.

Una volta terminato, decidere se:

• Chiudere il nuovo dataset di riferimento nello stato di bozza.
• Fare clic su Elimina bozza per eliminare il nuovo dataset di riferimento.
• A seconda della propria definizione di flusso di lavoro , fare clic su Pubblica o su Invia per approvazione per elaborare il dataset di riferimento.