Partilhar via

getEntityMetadata (API do cliente)

Retorna definições de tabela para a tabela especificada.

Sintaxe

Xrm.Utility.getEntityMetadata(entityName,attributes).then(successCallback, errorCallback)

Parâmetros

Nome Tipo Obrigatório Description
entityName String Yes O nome lógico da tabela.
attributes Matriz de cadeias de caracteres Não As colunas para as quais obter definições.
successCallback função Não Uma função a ser chamada quando as definições de tabela são retornadas.
errorCallback função Não Uma função para chamar quando a operação falhar.

Devoluções

Tipo: Objeto

Descrição: um objeto que contém as informações de definições de tabela com os seguintes valores.

Nome Tipo Description
ActivityTypeMask Número Se uma atividade personalizada deve aparecer nos menus de atividade no aplicativo Web. 0 indica que a atividade personalizada não aparece; 1 indica que aparece.
AutoRouteToOwnerQueue booleano Indica se os registros devem ser movidos automaticamente para a fila padrão do proprietário quando um registro desse tipo é criado ou atribuído.
CanEnableSyncToExternalSearchIndex booleano Apenas para uso interno.
CanTriggerWorkflow booleano Indica se a tabela pode disparar um processo de fluxo de trabalho.
Description String Descrição da tabela.
DisplayCollectionName String Nome de exibição plural para a tabela.
DisplayName String Nome para exibição da tabela.
EnforceStateTransitions booleano Indica se a tabela imporá transições de estado personalizadas.
EntityColor String O código hexadecimal para representar a cor a ser usada para esta tabela no aplicativo.
EntitySetName String O nome da tabela de API Web definida para esta tabela.
HasActivities booleano Indica se as atividades estão associadas a esta tabela.
IsActivity booleano Indica se a tabela é uma atividade.
IsActivityParty booleano Indica se as mensagens de email podem ser enviadas para um endereço de email armazenado em um registro desse tipo.
IsBusinessProcessEnabled booleano Indica se a tabela está habilitada para fluxos de processos de negócios.
IsBPFEntity booleano Indica se a tabela é uma tabela de fluxo de processo comercial.
IsChildEntity booleano Indica se a tabela é uma tabela filho.
IsConnectionsEnabled booleano Indica se as conexões estão habilitadas para esta tabela.
IsCustomEntity booleano Indica se a tabela é uma tabela personalizada.
IsCustomizable booleano Indica se a tabela é personalizável.
IsDocumentManagementEnabled booleano Indica se o gerenciamento de documentos está habilitado.
IsDocumentRecommendationsEnabled booleano Indica se as recomendações do documento estão habilitadas.
IsDuplicateDetectionEnabled booleano Indica se a deteção de duplicados está habilitada.
IsEnabledForCharts booleano Indica se os gráficos estão habilitados.
IsImportable booleano Indica se a tabela pode ser importada usando o Assistente de Importação.
IsInteractionCentricEnabled booleano Indica que a tabela está habilitada para experiência interativa.
IsKnowledgeManagementEnabled booleano Indica se o gerenciamento de conhecimento está habilitado para a tabela.
IsMailMergeEnabled booleano Indica se a mala direta está habilitada para esta tabela.
IsManaged booleano Indica se a tabela faz parte de uma solução gerenciada.
IsOneNoteIntegrationEnabled booleano Indica se a integração com o OneNote está habilitada para a tabela.
IsOptimisticConcurrencyEnabled booleano Indica se a simultaneidade otimista está habilitada para a tabela.
IsQuickCreateEnabled booleano Indica se a tabela está habilitada para formulários de criação rápida.
IsStateModelAware booleano Indica se a tabela oferece suporte à configuração de transições de estado personalizadas.
IsValidForAdvancedFind booleano Indica se a tabela será mostrada em Localização Avançada.
IsVisibleInMobileClient booleano Indica se os usuários do Microsoft Dynamics 365 para tablets podem ver os dados desta tabela.
IsEnabledInUnifiedInterface booleano Indica se a tabela está habilitada para Interface Unificada.
LogicalCollectionName String O nome da coleção lógica.
LogicalName String O nome lógico da tabela.
ObjectTypeCode Número O código de tipo de tabela.
OwnershipType String O tipo de propriedade da tabela: UserOwned ou OrganizationOwned.
PrimaryIdAttribute String O nome da coluna que é a id primária da tabela.
PrimaryImageAttribute String O nome da coluna de imagem primária de uma tabela.
PrimaryNameAttribute String O nome da coluna primária de uma tabela.
Privileges Matriz de objetos Objetos que definem o privilégio de segurança para acesso a uma tabela. Consulte Objeto Privilege
Attributes Collection Uma coleção de objetos de definições de coluna. Consulte Objetos de atributo

Objeto de privilégio

Os objetos de privilégio têm as seguintes propriedades para definir o privilégio de segurança para acesso a uma tabela:

Nome Tipo Description
CanBeBasic booleano Se o privilégio pode ser nível de acesso básico.
CanBeDeep booleano Se o privilégio pode ser o nível de acesso profundo.
CanBeEntityReference booleano Se o privilégio para uma parte externa pode ser o nível de acesso básico.
CanBeGlobal booleano Se o privilégio pode ser nível de acesso global.
CanBeLocal booleano Se o privilégio pode ser nível de acesso local.
CanBeParentEntityReference booleano Se o privilégio para uma parte externa pode ser o nível de acesso pai.
Name String O nome do privilégio.
PrivilegeId String A ID do privilégio.
PrivilegeType Número O tipo de privilégio, que é um dos seguintes:
0 : Nenhum
1 : Criar
2 : Ler
3 : Escreva
4 : Excluir
5 : Atribuir
6 : Partilhar
7 : Apêndice
8 : Apêndice

Objetos de atributo

O objeto retornado depende do tipo de definições de coluna.

Colunas Base (AttributeMetadata)

Todas as definições de coluna têm estas propriedades compartilhadas:

Nome Tipo Description
AttributeType Número Tipo de coluna. Para obter uma lista de valores de tipo de coluna, consulte Enum AttributeTypeCode
DisplayName String Nome para exibição da coluna
EntityLogicalName String Nome lógico da tabela que contém a coluna.
LogicalName String Nome lógico para a coluna.

Colunas Sim/Não (BooleanAttributeMetadata)

As colunas Sim/Não têm estas propriedades:

Nome Tipo Description
DefaultFormValue booleano Valor padrão para uma coluna Sim/Não.
OptionSet Objeto Opções para a coluna booleana onde cada opção é um par chave:valor.

Colunas Choice (PicklistAttributeMetadata)

As colunas de escolha têm esta propriedade:

Nome Tipo Description
OptionSet Objeto Opções para a coluna onde cada opção é um par chave:valor.

Colunas Choices (MultiSelectPicklistAttributeMetadata )

As colunas de opções têm estas propriedades:

Nome Tipo Description
DefaultFormValue booleano Valor padrão para a coluna.
OptionSet Objeto Opções para a coluna booleana onde cada opção é um par chave:valor.

Colunas de Estado (StateAttributeMetadata)

As colunas de estado têm esta propriedade:

Nome Tipo Description
OptionSet Objeto Opções para a coluna onde cada opção é um par chave:valor.

As colunas de estado também têm esses métodos que aceitam o valor de um dos valores de OptionSet opção como parâmetro arg .

Nome Tipo de Retorno Description
getDefaultStatus(arg) Número Retorna o status padrão (número) com base no valor de estado passado para uma tabela. Para obter os valores de estado e status padrão de uma tabela, consulte as informações de definições de tabela da tabela em Dataverse table/entity reference.
getStatusValuesForState(arg) Matriz de números Retorna valores de status possíveis (matriz de números) para um valor de estado especificado. Para valores de estado e status para uma tabela, consulte as informações de definições de tabela da tabela em Dataverse table/entity reference.

Colunas Status (StatusAttributeMetadata)

As colunas de status têm esta propriedade:

Nome Tipo Description
OptionSet Objeto Opções para a coluna onde cada opção é um par chave:valor.

As colunas de status também têm esse método que aceita o valor de um dos valores de OptionSet opção como parâmetro arg .

Nome Tipo de Retorno Description
getState(arg) Número Retorna o valor de estado (número) para o valor de status especificado (número). Para obter os valores de estado e status padrão de uma tabela, consulte as informações de definições de tabela da tabela em Dataverse table/entity reference.

Xrm.Utility

  • Last updated on