getEntityMetadata (API de cliente)

Devuelve las definiciones de tabla para la tabla especificada.

Sintaxis

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

Parámetros

Nombre Tipo Obligatorio Descripción
entityName String Nombre lógico de la tabla.
attributes matriz de cadenas No Las columnas para las que se obtienen las definiciones.
successCallback función No Una función para llamar cuando se devuelven las definiciones de la tabla.
errorCallback función No Una función para llamar cuando la operación tiene error.

Devoluciones

Tipo: Objeto

Descripción: un objeto que contiene la información de las definiciones de la tabla con los siguientes valores.

Nombre Tipo Descripción
ActivityTypeMask Número Si una actividad personalizada debe aparecer en los menús de la actividad en la aplicación web. 0 indica que la actividad personalizada no aparece; 1 indica que aparece.
AutoRouteToOwnerQueue Valor booleano Indica si mover los registros de forma automática a la cola predeterminada del propietario cuando se cree o asigne un registro de este tipo.
CanEnableSyncToExternalSearchIndex Valor booleano Para uso interno.
CanTriggerWorkflow Booleana Indica si la tabla puede desencadenar un proceso de flujo de trabajo.
Descripción String Descripción de la tabla.
DisplayCollectionName String Nombre para mostrar en plural de la tabla.
Nombre para mostrar String Nombre para mostrar para la tabla.
EnforceStateTransitions Booleana Indica si la tabla aplicará transiciones de estado personalizadas.
EntityColor String El código hexadecimal para representar el color que se utilizará para esta tabla en la aplicación.
EntitySetName String El nombre de la tabla de API web establecida para esta tabla.
HasActivities Booleana Indica si las actividades están asociadas con esta tabla.
IsActivity Booleana Indica si la tabla es una actividad.
IsActivityParty Booleana Indica si los correos electrónicos se pueden enviar a una dirección de correo electrónico almacenada en un registro de este tipo.
IsBusinessProcessEnabled Booleana Indica si la tabla está habilitada para los flujos de procesos de negocio.
IsBPFEntity Booleana Indica si la tabla es una tabla de flujos de procesos de negocio.
IsChildEntity Booleana Indica si la tabla es una tabla secundaria.
IsConnectionsEnabled Booleana Indica si las conexiones están habilitadas para esta tabla.
IsCustomEntity Booleana Indica si la tabla es una tabla personalizada.
IsCustomizable Booleana Indica si la tabla es una tabla que se puede personalizar.
IsDocumentManagementEnabled Booleana Indica si está habilitada la administración de documentos.
IsDocumentRecommendationsEnabled Booleana Indica si las recomendaciones de documentos están habilitadas.
IsDuplicateDetectionEnabled Valor booleano Indica si la detección de duplicados está habilitada.
IsEnabledForCharts Valor booleano Indica si los gráficos están habilitados.
IsImportable Booleana Indica si la tabla se puede importar mediante el asistente para importación.
IsInteractionCentricEnabled Booleana Indica si la tabla está habilitada para la experiencia interactiva.
IsKnowledgeManagementEnabled Valor booleano Indica si la administración del conocimiento está habilitada para la tabla.
IsMailMergeEnabled Booleana Indica si las combinar correspondencia está habilitada para esta tabla.
IsManaged Booleana Indica si la tabla forma parte de una solución administrada.
IsOneNoteIntegrationEnabled Booleana Indica si la integración de OneNote está habilitada para la tabla.
IsOptimisticConcurrencyEnabled Booleana Indica si la simultaneidad optimista está habilitada para la tabla.
IsQuickCreateEnabled Booleana Indica si la tabla está habilitada para formularios de creación rápida.
IsStateModelAware Booleana Indica si la tabla admite establecer transiciones de estado personalizadas.
IsValidForAdvancedFind Booleana Indica si la tabla se mostrará en Búsqueda avanzada.
IsVisibleInMobileClient Booleana Indica si Microsoft Dynamics 365 para usuarios de tabletas puede ver los datos de esta tabla.
IsEnabledInUnifiedInterface Booleana Indica si la tabla del conocimiento está habilitada para la interfaz unificada.
LogicalCollectionName Cadena El nombre lógico de la colección.
LogicalName String Nombre lógico para la tabla.
CódigoDeTipoDeObjeto Número El código de tipo de tabla.
OwnershipType String El tipo de propiedad para la tabla: "UserOwned" o "OrganizationOwned".
PrimaryIdAttribute String El nombre de la columna que es el identificador principal de la tabla.
PrimaryImageAttribute String El nombre de la columna de la imagen principal para la tabla.
PrimaryNameAttribute String El nombre de la columna principal para la tabla.
Privilegios Matriz de objetos Las definiciones de privilegios para la tabla donde *cada* objeto contiene los siguientes valores para definir el privilegio de seguridad para acceder a una tabla:
  • CanBeBasic: booleano. Si el privilegio puede ser un nivel de acceso básico.
  • CanBeDeep: booleano. Si el privilegio puede ser un nivel de acceso exhaustivo.
  • CanBeEntityReference: booleano. Si el privilegio para una parte externa puede ser un nivel de acceso básico.
  • CanBeGlobal: booleano. Si el privilegio puede ser un nivel de acceso global.
  • CanBeLocal: booleano. Si el privilegio puede ser un nivel de acceso local.
  • CanBeParentEntityReference: booleano. Si el privilegio para una parte externa puede ser un nivel de acceso principal.
  • Nombre: cadena. El nombre del privilegio.
  • PrivilegeId: cadena. El identificador del privilegio.
  • PrivilegeType: número. El tipo de privilegio, que es una de las alternativas siguientes:
    • 0: Ninguno
    • 1: Crear
    • 2: Leer
    • 3: Escribir
    • 4: Eliminar
    • 5: Asignar
    • 6: Compartir
    • 7: Anexar
    • 8: AppendTo
Atributos Recogida Una colección de objetos de definiciones de columna. El objeto devuelto depende del tipo de definiciones de columna.

Definiciones de columna para el tipo base
Un objeto devuelto con las siguientes propiedades:

  • AttributeType: número. Tipo de una columna. Para obtener una lista de valores de tipo de columna, consulte AttributeTypeCode
  • DisplayName: cadena. Nombre para mostrar de la columna.
  • EntityLogicalName: cadena. Nombre lógico de la tabla que contiene la columna.
  • LogicalName: cadena. Nombre lógico de la columna.

Definiciones de columna para el tipo booleano
Un objeto devuelto con las siguientes propiedades además de las propiedades del tipo de definiciones de la columna base:

  • DefaultFormValue: booleano. Valor predeterminado para una columna Sí/No.
  • OptionSet: objeto. Opciones para la columna booleana donde cada opción es un par clave-valor.

Definiciones de columna para el tipo enumeración
Un objeto devuelto con las siguientes propiedades, además de las propiedades del tipo de definiciones de la columna base:

  • OptionSet: objeto. Opciones para la columna donde cada opción es un par clave:valor.

Definiciones de columna para el tipo opción
Un objeto devuelto con las siguientes propiedades además de las propiedades del tipo de definiciones de la columna base:

  • DefaultFormValue: número. Valor del formulario predeterminado para la columna.
  • OptionSet: objeto. Opciones para la columna donde cada opción es un par clave:valor.

Definiciones de columna para el tipo estado
Un objeto devuelto con las siguientes propiedades, además de las propiedades del tipo de definiciones de la columna base:

  • OptionSet: objeto. Opciones para la columna donde cada opción es un par clave:valor.

El objeto también contiene los siguientes métodos:

  • getDefaultStatus(arg): devuelve el estado predeterminado (número) basado en el valor de estado pasado para una tabla. Para conocer el estado predeterminado y los valores de estado de una tabla, consulte la información sobre definiciones de la tabla en la referencia de tabla/entidad.
  • getStatusValuesForState(arg): devuelve los posibles valores del estado (matriz de números) para un valor especificado de estado. Para conocer el estado y los valores de estado de una tabla, consulte la información sobre definiciones de la tabla en la referencia de tabla/entidad.

Definiciones de columna para el tipo estado
Un objeto devuelto con las siguientes propiedades, además de las propiedades del tipo de definiciones de la columna base:

  • OptionSet: objeto. Opciones para la columna donde cada opción es un par clave:valor.

El objeto también contiene el siguiente método:

  • getState(arg): devuelve el valor de estado (número) por el valor de estado especificado (número). Para conocer el estado predeterminado y los valores de estado de una tabla, consulte la información sobre definiciones de la tabla en la referencia de tabla/entidad.

Xrm.Utility

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).