Compartir a través de


Asignaciones de factores personalizados (vista previa)

Importante

Algunas o todas estas funciones están disponibles como parte de una versión preliminar. El contenido y la funcionalidad están sujetos a cambios.

Microsoft Sustainability Manager utiliza datos de referencia integrados en asignaciones de factores. Puede ampliar el conjunto disponible de asignaciones de factores con asignaciones de factores personalizadas. Por ejemplo, es posible que desee cambiar sus cálculos de actividad en función de factores como año fiscal o una región personalizada. Este artículo lo guía a través de esta configuración avanzada, que debe completar en el Centro de administración de Power Platform.

Nota

Los procedimientos de este artículo requieren experiencia avanzada en Microsoft Dataverse administración y API. Este artículo no describe en detalle las operaciones comunes de la plataforma. Solo los administradores autorizados con acceso completo al centro de administración Power Platform pueden completar estos pasos de configuración.

Para ampliar Sustainability Manager para utilizar asignaciones de factores personalizadas, siga estos pasos:

Crear datos de referencia personalizados

Crear nueva tabla

  1. En el Power Apps portal, cree la nueva tabla que desea utilizar en las asignaciones de factores como datos de referencia.

  2. Renombre la columna principal a Nombre.

    El siguiente ejemplo muestra una nueva tabla para Región personalizada.

    Captura de pantalla de una nueva tabla llamada Región personalizada.

    En nuestro ejemplo, también creamos una nueva tabla de factores personalizados para año fiscal.

  3. Establezca la columna Nombre como un clave alternativa llamada naturalkey.

    Captura de pantalla de cómo configurar la columna Nombre como naturalkey.

Añadir tabla a Sustainability Manager

Cuando agrega una nueva tabla en Power Apps, también debe agregarla al módulo de aplicación Sustainability Manager.

  1. En el Power Apps portal, Seleccionar Sustainability Manager.

  2. En el Sustainability Manager tile, Seleccionar los puntos suspensivos (...), y luego Seleccionar ABRIR EN EL DISEÑADOR DE APLICACIONES.

    Captura de pantalla de la apertura de la aplicación en el diseñador de aplicaciones.

  3. En el diseñador de aplicaciones, Seleccionar Datos y luego Seleccionar Buscar nombre de tabla.

  4. Seleccionar los puntos suspensivos (...), Seleccionar Agregar a la aplicación, Seleccionar Guardar y luego Seleccionar Publicar.

    Captura de pantalla de la adición de la tabla a la aplicación.

La tabla se agrega a Sustainability Manager y aparece en la lista de datos de referencia y en la navegación.

Si desea eliminarlo de la navegación, Seleccionar Páginas en el panel de navegación izquierdo. Seleccionar la tabla, Seleccionar Quitar de la navegación, Seleccionar Guardar y luego Seleccionar Publicar.

Captura de pantalla de la eliminación de la tabla de la navegación.

Crear solución para personalizaciones

Dado que las entidades predeterminadas están en un solución administrada, debe crear una nueva solución e importar entidades de actividad y nuevas entidades de datos de referencia personalizadas en ella.

  1. En la página Soluciones, seleccione Nueva solución. Especifique la información de su solución nueva y después seleccione Crear.

    Captura de pantalla de la creación de una solución nueva.

  2. En la página Objetos, seleccione Agregar existente y después seleccione Tabla.

    Captura de pantalla de cómo agregar tablas a la nueva solución.

  3. En la página Agregar tablas existentes , Seleccionar la actividad y las tablas de datos de referencia personalizadas que creó. En nuestro ejemplo, agregamos la tabla de actividad de Energía comprada y la tabla de datos de referencia de Región personalizada .

    Captura de pantalla de cómo agregar la tabla de energía comprada a la nueva solución.

    Captura de pantalla de cómo agregar la tabla de región personalizada a la nueva solución.

Ampliar la tabla de actividades con búsquedas

  1. Agregue una nueva relación de varios a uno desde la tabla de actividades a la tabla de factores extendidos. En nuestro ejemplo, estamos agregando una relación de varios a uno desde la tabla de actividad de Energía comprada a la tabla de datos de referencia de Región personalizada .

    Captura de pantalla de agregar la relación varios a uno.

Agregue la tabla de datos de referencia personalizada a la aplicación

Nota

Este es un paso obligatorio. Incluso si no desea incluir la tabla de datos de referencia personalizada en el menú de navegación, aún es necesario agregar la tabla a la aplicación. Si se omite este paso, los datos de referencia no estarán disponibles en la experiencia de importación o ingreso manual del factor asignación.

  1. Agregue el objeto de aplicación Sustainability Manager a la nueva solución.

    Captura de pantalla de cómo agregar Sustainability Manager.

    El siguiente ejemplo muestra la nueva solución y sus recursos.

    Captura de pantalla de la solución y sus recursos.

  2. Seleccionar Sustainability Manager, ábralo en modo de edición y luego Seleccionar Nuevo. En la ventana Agregar página, seleccione Tabla de Dataverse.

    Captura de pantalla para agregar la tabla Dataverse.

  3. Seleccione Seleccionar tabla existente. En el panel Seleccionar una tabla , Seleccionar cada una de las tablas de datos de referencia personalizadas que desea utilizar para asignaciones de factores. Seleccione Agregar.

    Nota

    Si no desea que las tablas de referencia personalizadas aparezcan en el menú de navegación, desmarque la casilla de verificación Mostrar en la navegación .

    Captura de pantalla para agregar tablas Dataverse para cada tabla de factores personalizados.

    En Todas las demás páginas, aparecen las nuevas tablas personalizadas agregadas.

  4. Guarde los cambios y publique.

Este procedimiento requiere experiencia del desarrollador porque solo está disponible a través de Dataverse API.

Debe personalizar las búsquedas en varias tablas para las asignaciones de factores para sus tablas personalizadas. Puede utilizar la API web de Power Apps con una herramienta como Insomnia o su cliente API preferido. Para obtener información sobre cómo enviar solicitudes POST autenticadas con Insomnia, vaya a Usar Insomnia con la API web de Dataverse.

Para cada tabla personalizada, debe habilitar las asignaciones de factores en los cálculos. En nuestro ejemplo, debemos hacer eso para las tablas Región personalizada y año fiscal. Necesita el nombre lógico para cada tabla. Por ejemplo, el nombre lógico de Región personalizada es cr040_newtable, y el nombre lógico de año fiscal es cr040_newtable1.

Para cada tabla personalizada, necesitamos actualizar cada una de las búsquedas polimórficas utilizadas para las asignaciones de factores, una tabla con el nombre lógico msdyn_emissionlookup. Estas búsquedas tienen los nombres lógicos siguientes:

  • msdyn_referencedataid
  • msdyn_referencedata2id
  • msdyn_referencedata3id
  • msdyn_referencedata4id

Para una única tabla personalizada, debe enviar cuatro solicitudes POST, una para cada una de las cuatro búsquedas utilizadas en las asignaciones de factores. Utilice una herramienta avanzada como Insomnia o su cliente de API preferido para realizar solicitudes POST a la API RelationshipDefinitions de su organización.

En nuestro caso, el punto de conexión es https://<orgurl>/api/data/v9.2/RelationshipDefinitions. Usamos la siguiente carga útil de muestra para cada una de las ocho solicitudes POST (dos tablas con cuatro solicitudes cada una):

Nota

"Nombre del esquema" Debe ser único dentro de su Dataverse ambiente.

{
  "SchemaName": "msdyn_msdyn_emissionlookup_<custom factor table name>",
  "@odata.type": "Microsoft.Dynamics.CRM.OneToManyRelationshipMetadata",
  "CascadeConfiguration": {
    "Assign": "NoCascade",
    "Delete": "RemoveLink",
    "Merge": "NoCascade",
    "Reparent": "NoCascade",
    "Share": "NoCascade",
    "Unshare": "NoCascade"
  },
  "ReferencedEntity": "<custom factor table logical name>",
  "ReferencingEntity": "msdyn_emissionlookup",
  "ReferencingAttribute": "<polymorphic lookup name>",
  "Lookup": {
    "AttributeType": "Lookup",
    "AttributeTypeName": {
      "Value": "LookupType"
    },
    "SchemaName": "<polymorphic lookup name>",
    "@odata.type": "Microsoft.Dynamics.CRM.LookupAttributeMetadata"
  }
}

La siguiente tabla muestra los valores que utilizamos para <nombre de la tabla de factores personalizados>, <nombre lógico de la tabla de factores personalizada>, y <nombre de búsqueda polimórfico> para nuestras ocho solicitudes POST.

Solicitar Nombre de tabla de factores personalizada Nombre de tabla lógica de factores personalizada Nombre de búsqueda polimórfica
1 FiscalYear_RDId cr040_newtable1 msdyn_referencedataid
2 FiscalYear_RDId2 cr040_newtable1 msdyn_referencedata2id
3 FiscalYear_RDId3 cr040_newtable1 msdyn_referencedata3id
4 FiscalYear_RDId4 cr040_newtable1 msdyn_referencedata4id
5 CustomRegion_RDId cr040_newtable msdyn_referencedataid
6 CustomRegion_RDId2 cr040_newtable msdyn_referencedata2id
7 CustomRegion_RDId3 cr040_newtable msdyn_referencedata3id
8 CustomRegion_RDId4 cr040_newtable msdyn_referencedata4id

Una solicitud POST exitosa le ofrece una respuesta HTTP 204.

Puede verificar estas operaciones inspeccionando las relaciones de la tabla Asignación de factores.

Captura de pantalla de Relaciones en la tabla de asignaciones de factores.

Si desea exportar sus cambios a un entorno diferente, puede incluir las relaciones que agregó anteriormente en una solución y exportarlas.

  1. En Tablas, seleccione la pestaña Todos y luego seleccione Datos de referencia (msdyn_referencedata ).

  2. Agregue la siguiente información para cada tipo de factor nuevo:

    Campo Descripción
    Asignar nombre Nombre en plural de su tabla. Por ejemplo, regiones personalizadas o años fiscales.
    Categoría Datos de referencia
    Nombre de entidad Nombre lógico de su tabla, todo en minúsculas (no el nombre del esquema de la tabla). Por ejemplo, cr040_newtable o cr040_newtable1.

Autorizar a Sustainability Manager para acceder a tablas externas

Si aún no se proporciona, Sustainability Manager debe tener acceso a tablas externas para que pueda usarlas en los cálculos.

  1. Vaya a Soluciones > Aplicación Microsoft Sustainability Manager.

  2. Seleccione Roles de seguridad y luego seleccione Rol de aplicación de servicio de sostenibilidad: personalizado. Se abre una nueva pestaña del explorador.

  3. En la pestaña navegador nuevo, seleccione la pestaña Entidades personalizadas.

  4. Para cada una de las tablas personalizadas que desee utilizar para las asignaciones de factores, proporcione los privilegios Leer y Anexar a en el nivel organizacional.

    Nota

    Para cada tabla personalizada, también debe otorgar privilegios de Lectura en toda la organización a cualquier tabla a la que apunte mediante una búsqueda. Por ejemplo, si Región personalizada tiene una búsqueda en la tabla Contoso SKU, debe darle privilegios de Lectura a la tabla Contoso SKU.

  5. Guarde y cierre.

Autorizar a los usuarios a acceder a las tablas

Para cada tabla personalizada, como regiones personalizadas o año fiscal, asegúrese de que el usuario de Power Apps que ingiere asignaciones de factores o ejecuta cálculos tiene los siguientes privilegios en toda la organización para la tabla:

  • Añadir a para ingestión

  • Leer para crear asignaciones de factores o usar asignaciones de factores dentro de un cálculo que utiliza una tabla personalizada

  1. Asegúrese de que todas las personalizaciones se publiquen en el Power Apps portal.

  2. Rellene las tablas de datos de referencia personalizadas (Regiones personalizadas y año fiscal en nuestro ejemplo).

    Captura de pantalla de la tabla año fiscal con valores.

  3. Importe o ingrese las asignaciones de factores con Sustainability Manager o el portal. Power Apps

    Captura de pantalla de la asignación de factores personalizados.

  4. Importe o ingrese los datos de la actividad con Sustainability Manager.

La siguiente imagen muestra un ejemplo de un biblioteca de factores llamado Biblioteca de factores extendidos que contiene asignaciones que utilizan datos de referencia personalizados (Regiones personalizadas y año fiscal).

Captura de pantalla de la biblioteca de factores extendidos.

Utilice factores extendidos en modelos de cálculo

En el portal de Power Apps, diseñe el modelo de cálculo y utilícelo en el perfil de cálculo.

Captura de pantalla del diseño de un modelo de cálculo.

Nota

Puede utilizar el filtrado en el perfil de cálculo para asegurarse de que la búsqueda tenga un valor.

Puede utilizar atributos extendidos en el perfil de cálculo según sea necesario.

Captura del uso de atributos extendidos.

Preguntas frecuentes

Cuando creo un nuevo factor asignación manualmente, no veo mi tabla personalizada como una opción para los datos de referencia

  1. Asegúrese de que el usuario tenga los privilegios adecuados para la tabla personalizada.

  2. Asegúrese de que la tabla personalizada tenga al menos un registro.

  3. Asegúrese de haber agregado el nombre del esquema (distingue entre mayúsculas y minúsculas) de su tabla personalizada en msdyn_referencedata.

  4. Asegúrese de que la tabla personalizada se agregue al objeto de aplicación Sustainability Manager como se describió anteriormente en este artículo.

  5. Actualice la página desde su navegador.

Cuando importo asignaciones de factores, no veo mi tabla de datos de referencia personalizada como una opción en el campo asignación experiencia

  1. Asegúrese de que el usuario tenga los privilegios adecuados para la tabla personalizada.

  2. Asegúrese de haber agregado el nombre del esquema (distingue entre mayúsculas y minúsculas) de su tabla personalizada en msdyn_referencedata.

  3. Asegúrese de que la tabla personalizada se agregue al objeto de aplicación Sustainability Manager como se describió anteriormente en este artículo.

  4. Actualice la página desde su navegador.

¿Los registros de tablas personalizadas se consideran "aprobados" o "pendientes" a efectos de aprobación de datos?

Todos los registros de tablas personalizadas se consideran "aprobados" a efectos de aprobación de datos en el contexto de asignaciones de factores para cálculos.

Mi importación de asignaciones de factores falló debido a la falta de un privilegio prvAppendTo_[su tabla personalizada] para un usuario

Al usuario de la aplicación Sustainability Manager o al usuario actual no se le otorgó el privilegio Anexar a para la tabla personalizada. Asegúrese de que tanto Sustainability Manager como el usuario tengan los privilegios adecuados y luego intente importar nuevamente.

En el modelo de cálculo, no veo mi tabla personalizada como una opción en la sección Asignaciones de factores del menú desplegable Factor de emisión del nodo Informe o Factor de estimación del nodo Factor de estimación

Asegúrese de haber agregado el registro msdyn_referencedata para su tabla personalizada.

Verifique que el valor de Nombre de entidad en el registro msdyn_referencedata de su tabla personalizada tenga el nombre lógico de su tabla (distingue entre mayúsculas y minúsculas), no el nombre del esquema. Vaya a Tabla > Propiedades, expanda Opciones avanzadas y vea el nombre lógico.

Asegúrese de que los datos de actividad para la fuente de su cálculo tengan un campo de búsqueda que apunte a su tabla personalizada. Por ejemplo, si personalizó Combustión estacionaria para buscar Región personalizada, pero no Combustión móvil, los cálculos para Combustión móvil no pueden usar asignaciones de factores basadas en la región de Contoso.

Personalizar varios entornos

Es posible que deba realizar estas personalizaciones en un entorno y luego aplicarlas en otro. Por ejemplo, puede realizar todas las personalizaciones en un entorno de desarrollo y luego necesitar importarlas a su entorno de producción. En este caso, puede seguir estos pasos para minimizar la duplicación de trabajo.

  1. Para cualquier solución que haya utilizado para exportar cambios de un entorno a otro, debe incluir estas personalizaciones en esa solución:

    • Las adiciones de sus tablas personalizadas a Sustainability Manager.

    • Las adiciones de más Relaciones a las búsquedas polimórficas de asignaciones de factores.

    Luego podrá importar la solución para la gestión del ciclo de vida de las aplicaciones (ALM).

  2. Por entorno, realice las siguientes acciones:

    • Agregue los registros msdyn_referencedata.

    • Personalice el rol de seguridad de la aplicación Sustainability Manager.