Definir valores dos grupos de atributos do usuário

Versão 3.1.23.6

Defina os valores de um atributo de usuário em um conjunto de grupos, em ordem de prioridade.

Esta função define todos os valores de um atributo de usuário definido por grupos de usuários. Essa é uma configuração global, que pode afetar todos os usuários do sistema. Essa função substitui as definições de valor do grupo existentes para o atributo de usuário indicado.

O valor de um atributo de usuário para um determinado usuário é determinado pesquisando pelos seguintes locais, nesta ordem:

  1. as configurações da conta do usuário
  2. os grupos de que o usuário é membro
  3. o valor padrão do atributo do usuário, se houver

O usuário pode ser membro de vários grupos que definem valores diferentes para esse atributo de usuário. A ordem dos itens no parâmetro group_values determina qual grupo tem prioridade para esse usuário. O índice de matriz mais baixo vence.

Um método alternativo para indicar a precedência de seleção de valores de grupo é atribuir números à propriedade "classificação" de cada objeto de valor de grupo na matriz. O menor valor de "classificação" ganha. Se você usar essa técnica, precisará atribuir um valor de classificação a cada objeto de valor do grupo na matriz.

Para definir um valor de atributo de usuário para um único usuário, consulte Definir valor do usuário do atributo do usuário. Para definir um valor de atributo de usuário para todos os membros de um grupo, consulte Definir um valor de grupo de atributos de usuário.

Solicitação

POST /user_attributes/{user_attribute_id}/group_values
Tipo de dados
Descrição
Solicitação
HTTPRequest
path
HTTPPath
Expandir definição HTTPPath...
ID do atributo de usuário
integer
ID do atributo do usuário
body
Corpo HTTP
Expandir definição HTTPBody...
Expandir definição UserAttributeGroupValue...
pode
objeto
Operações que o usuário atual pode realizar neste objeto
id
integer
ID exclusivo desta relação de atributo de grupo
group_id
integer
ID do grupo
ID do atributo de usuário
integer
ID do atributo do usuário
valor_é_oculto
booleano
Se for verdadeiro, o campo "valor" será nulo, porque as configurações do atributo bloqueiam o acesso a esse valor
rank
integer
Precedência para resolver o valor para o usuário
valor
string
Valor do atributo do usuário para o grupo

Resposta

200: matriz de valores de grupo.

Tipo de dados
Descrição
pode
objeto
Operações que o usuário atual pode realizar neste objeto
id
integer
ID exclusivo desta relação de atributo de grupo
group_id
integer
ID do grupo
ID do atributo de usuário
integer
ID do atributo do usuário
valor_é_oculto
booleano
Se for verdadeiro, o campo "valor" será nulo, porque as configurações do atributo bloqueiam o acesso a esse valor
rank
integer
Precedência para resolver o valor para o usuário
valor
string
Valor do atributo do usuário para o grupo

400: Solicitação inválida

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

404: não encontrado

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

409: recurso já existe

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação

422: erro de validação

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
Expandir a definição de ValidationErrorDetail...
campo
string
Campo com erro
código
string
Código do erro
mensagem
string
Mensagem de erro
url_da_documentação
string
Link da documentação
url_da_documentação
string
Link da documentação

429: Solicitações demais

Tipo de dados
Descrição
(objeto)
mensagem
string
Detalhes do erro
url_da_documentação
string
Link da documentação