Mensagens e métodos da entidade SystemUser (usuário)

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Um usuário do sistema é uma pessoa que tem acesso para fazer login no Microsoft Dynamics 365 local ou no Microsoft Dynamics 365 (online). Gerenciar usuários do sistema envolve muitas atividades diferentes. Isso inclui adicionar usuários do sistema, definir direitos de acesso e colocar usuários do sistema em uma hierarquia de relatório. O acesso para cada um desses recursos é protegido pelos privilégios de segurança que usuário do sistema tem. Esses privilégios são com base no direito de acesso do usuário do sistema. Um perfil de usuário do sistema deve ser criado e salvo antes que direitos de acesso possam ser atribuídos a ele e antes que ele possa ser associado a equipes. O nome do esquema desta entidade é SystemUser.Para exibir os metadados de entidade da sua organização, instale a solução Navegador dos Metadados descrita em Procurar os metadados da sua organização. Também é possível exibir os metadados de uma organização não personalizada no arquivo do Excel chamado EntityMetadata.xlsx, incluído na pasta de nível superior do download do SDK.

Uma conta do usuário do sistema Dynamics 365 pode ser habilitada ou desabilitada. O Dynamics 365 permite que apenas usuários do sistema habilitados com uma licença paga se conectem ao aplicativo.

Uma conta de usuário do sistema pode ser definida como desabilitada para manter informações do histórico, como a conta de um vendedor que tenha deixado a empresa. Definir uma conta de usuário do sistema para desabilitar e remover o usuário dos processos de fluxo de trabalho, como por exemplo durante férias. Desabilitar um usuário do sistema contribui para a conta de licença disponível, uma vez que usuário do sistema desabilitados não são obrigados a pagar por licenças.

Observação

Para criar uma instância de uma entidade de usuário do sistema em uma instância local do Microsoft Dynamics 365, o usuário do sistema deve primeiramente existir no Active Directory.

Para criar uma instância de uma entidade de usuário do sistema no local Microsoft Dynamics 365 (online), o usuário do sistema deve primeiramente existir no Conta da Microsoft. Além disso, não existe uma maneira programática de enviar um convite a um usuário para o Microsoft Dynamics 365 (online). Você deve envie convites de usuário por meio do aplicativo web.

A tabela a seguir descreve as mensagens desta entidade, utilizadas com o método IOrganizationService.Execute.

Mensagem

Descrição

AssociateRequest

Cria um link entre um registro e um ou mais registros que participam de um relacionamento. Também é possível usar o método IOrganizationService.Associate.Para obter mais informações, consulte 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords. Para obter uma lista de relacionamentos padrão dessa entidade, consulte SystemUser os metadados da entidade.Você pode encontrar essas informações nos metadados da sua organização. Consulte as informações anteriores sobre metadados de navegador.

CreateRequest

Crie um usuário de sistema. Também é possível chamar o método IOrganizationService.Create.

DisassociateRequest

Remove um link entre um registro e um ou mais registros que participam de um relacionamento. Também é possível usar o método IOrganizationService.Disassociate.Para obter mais informações, consulte 8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords. Para obter uma lista de relacionamentos padrão dessa entidade, consulte SystemUser os metadados da entidade.Você pode encontrar essas informações nos metadados da sua organização. Consulte as informações anteriores sobre metadados de navegador.

InitializeFromRequest

Inicializa um novo registro a partir de um registro existente, contanto que um mapa de atributo seja definido para as duas entidades. Para obter mais informações, consulte Personalizar mapeamentos de entidade e atributos.

RetrieveDuplicatesRequest

Detecta e recupera registros duplicados do registro especificado, contanto que a detecção de duplicidades esteja habilitada e haja regras de detecção de duplicidades publicadas para a entidade. Para obter mais informações, consulte Detectar dados duplicados.

ReassignObjectsSystemUserRequest

Reatribua todas as entidades de um usuário de um sistema especificado para um usuário ou equipe de outro sistema.

RetrieveRequest

Recupere um usuário do sistema. Também é possível chamar o método IOrganizationService.Retrieve.

RemoveParentRequest

Remove o pai de um registro.

RetrieveAllChildUsersSystemUserRequest

Recupere a coleção de usuários do sistema que reportem ao usuário especificado do sistema.

RetrieveMultipleRequest

Recupere uma coleção de usuário de sistema. Também é possível chamar o método IOrganizationService.RetrieveMultiple.

RetrievePrincipalAttributePrivilegesRequest

Recupera todos os privilégios de atributo protegidos que um usuário ou uma equipe possui por associações diretas ou indiretas (por associação de equipe) com a entidade FieldSecurityProfile.

RetrieveTeamsSystemUserRequest

Preterido. Use a classe RetrieveMultipleRequest. Recupere a coleção de equipes das quais o usuário do sistema especificado é membro.

RetrieveUserPrivilegesRequest

Recupera todos os privilégios que um usuário do sistema (usuário) tem por meio de suas funções na unidade de negócios especificada.

RetrieveUserSettingsSystemUserRequest

Preterido. Use a classe RetrieveMultipleRequest. Recupere as configurações do usuário do sistema para o usuário especificado do sistema.

SetBusinessSystemUserRequest

Define a unidade de negócios para o usuário especificado do sistema.

SetParentSystemUserRequest

Define o (gerenciador) primário para o usuário especificado do sistema.

SetStateRequest

Defina o estado de um usuário do sistema. Os possíveis estados são definidos no atributo SystemUser.Statecode. Se você estiver usando tipos associados precocemente, use a enumeração SystemUserState. Para obter uma lista dos valores de estado, consulte os metadados da entidade SystemUser.Você pode encontrar essas informações nos metadados da sua organização. Consulte as informações anteriores sobre metadados de navegador.

UpdateRequest

Atualize um usuário de sistema. Também é possível chamar o método IOrganizationService.Update.

UpdateUserSettingsSystemUserRequest

Preterido. Use a classe UpdateRequest. Atualize as configurações do usuário de sistema para um usuário do sistema.

Confira Também

Entidades de usuário e de equipe
Privilégios por entidade
Mensagens e métodos da entidade UserSettings

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais