Imposta valori gruppo di attributi utente

Versione 4.0.23.6 (più recente)

Definisci i valori per un attributo utente in un insieme di gruppi, in ordine di priorità.

Questa funzione definisce tutti i valori di un attributo utente definito dai gruppi di utenti. Si tratta di un'impostazione globale che potrebbe interessare tutti gli utenti del sistema. Questa funzione sostituisce qualsiasi definizione esistente di valore di gruppo per l'attributo utente indicato.

Il valore di un attributo utente per un determinato utente viene determinato cercando le seguenti posizioni, in questo ordine:

  1. Le impostazioni dell'account dell'utente
  2. I gruppi di cui l'utente è membro
  3. Il valore predefinito dell'attributo utente, se presente

L'utente può essere membro di più gruppi che definiscono valori diversi per l'attributo in questione. L'ordine degli elementi nel parametro group_values determina quale gruppo ha la priorità per quell'utente. Vince l'indice di array più basso.

Un metodo alternativo per indicare la precedenza di selezione dei valori di gruppo consiste nell'assegnare i numeri alla proprietà "ranking" di ciascun oggetto del valore del gruppo nella matrice. Vince il valore "ranking" più basso. Se utilizzi questa tecnica, devi assegnare un valore di ranking a ogni oggetto valore di gruppo nell'array.

Per impostare il valore di un attributo utente per un singolo utente, consulta Impostare il valore utente per gli attributi utente. Per impostare il valore di un attributo utente per tutti i membri di un gruppo, vedi Impostare il valore del gruppo di attributi utente.

Richiesta

POST /user_attributes/{user_attribute_id}/group_values
Tipo di dati
Descrizione
Richiesta
HTTPRequest
percorso
Percorso HTTP
Espandi definizione HTTPPath...
id_attributo_utente
string
ID dell'attributo utente
body
HTTPBody
Espandi definizione HTTPBody...
Espandi definizione UserAttributeGroupValue...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco di questa relazione tra attributi di gruppo
group_id
string
ID del gruppo
id_attributo_utente
string
ID dell'attributo utente
valore_nascosto
boolean
Se true, il campo "value" sarà null, perché le impostazioni dell'attributo bloccano l'accesso a questo valore
ranking
integer
Priorità per la determinazione del valore per l'utente
valore
string
Valore dell'attributo utente per il gruppo

Risposta

200: array di valori di gruppo.

Tipo di dati
Descrizione
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco di questa relazione tra attributi di gruppo
group_id
string
ID del gruppo
id_attributo_utente
string
ID dell'attributo utente
valore_nascosto
boolean
Se true, il campo "value" sarà null, perché le impostazioni dell'attributo bloccano l'accesso a questo valore
ranking
integer
Priorità per la determinazione del valore per l'utente
valore
string
Valore dell'attributo utente per il gruppo

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

409: Risorsa già esistente

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

422: Errore di convalida

Tipo di dati
Descrizione
messaggio
string
Error details (Dettagli errore)
Espandi definizione ValidationErrorDetails...
campo
string
Campo con errore
codice
string
Codice di errore
messaggio
string
Messaggio informativo sull'errore
documentazione_url
string
Link alla documentazione
documentazione_url
string
Link alla documentazione

429: Troppe richieste

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione