Obtener el complemento Business Central para Excel
Business Central incluye un complemento para Excel que permite a los usuarios seleccionar una acción Editar en Excel en determinadas páginas para abrir los datos en una hoja de cálculo de Excel. Esta acción es diferente a la acción Abrir en Excel porque permite a los usuarios realizar cambios en Excel y luego publicar los cambios en Business Central
Información general
Acerca del complemento
El complemento se llama Complemento de Office de Microsoft Dynamics y está disponible para su instalación desde la Tienda Office (AppSource). Con el complemento instalado, la acción Editar en Excel está disponible en la mayoría de las páginas de listas y de partes de listas desde el icono Compartir Para obtener más información sobre el uso del complemento, consulte Ver y editar en Excel desde Business Central.
Nota
El complemento solo funciona en Windows; no en macOS.
Acerca de la implementación como administrador
Con Business Central Online, existen algunas opciones de implementación para proporcionar el complemento a los usuarios. Una opción es adquisición individual, que permite que los usuarios instalen el complemento ellos mismos. Con esta opción, los usuarios deben tener acceso a la descarga de archivos desde Office Store. Otra opción es configurar Despliegue centralizado en el Centro de administración de Microsoft 365 para implementar automáticamente el complemento en toda la organización, grupos o usuarios específicos. La implementación centralizada proporciona una forma de hacer llegar el complemento a los usuarios si su organización no les da acceso a la tienda Office.
Para el usuario final, la experiencia de instalación es diferente para los dos escenarios de implementación:
Con la adquisición individual, los nuevos usuarios eligen la acción Editar en Excel, el panel Nuevo complemento de Office se abre en Excel. Para instalar el complemento, el usuario elige Confía en este complemento, que a su vez instala el complemento directamente desde la Tienda Office. Luego, los usuarios inician sesión en Business Central utilizando su nombre de usuario y contraseña.
Con Implementación centralizada, los nuevos usuarios eligen la acción Editar en Excel, el complemento se instala automáticamente en Excel desde Implementación centralizada; no la Tienda Office. Lo único que los usuarios tienen que hacer es iniciar sesión en Business Central
Con ambas opciones de implementación, el complemento se configura automáticamente para conectarse a Business Central. Una tercera opción de implementación es la instalación manual del complemento directamente desde Excel. Con esta opción, los usuarios deben configurar el complemento para conectarse a Business Central
Cambiar de adquisición individual a Implementación centralizada o a la inversa
Cuando cambia de adquisición individual del complemento a Implementación centralizada, o viceversa, los archivos de Excel que los usuarios crearon antes de la transición se ven afectados. Después de la transición, los usuarios pueden seguir abriendo cualquier hoja de cálculo de Excel creada previamente usando la acción Editar en Excel o creada manualmente mediante la configuración del complemento de Excel. Pero no pueden actualizar los datos en el archivo desde Business Central o insertar actualizaciones a Business Central
Esta condición se debe al hecho de que a cada archivo de Excel se le asigna un identificador de "complemento". En la transición hacia o desde Implementación centralizada, se asigna un identificador diferente, por lo que el identificador anterior se bloquea.
Preparación (solo local)
Business Central local requiere que su entorno esté configurado para el complemento. Si no, la acción Editar en Excel no está disponible para los usuarios. Puede obtener más información en Configuración del complemento de Excel para editar datos de Business Central en la ayuda para desarrolladores y profesionales de TI.
Implementar el complemento mediante Implementación centralizada
Implementación centralizada es una característica del Centro de administración de Microsoft 365 que se usa para instalar complementos automáticamente en las aplicaciones de Office de los usuarios, como Excel. Para ayudarlo con Implementación centralizada, Business Central incluye la configuración asistida Implementación centralizada complementos Excel.
Antes de empezar
- Obtenga más información sobre cómo evitar que los usuarios descarguen desde la Tienda Office en Administrar complementos en el centro de administración.
- Verifique que Implementación centralizada funcione para su organización. Obtenga más información en Determinar si Implementación centralizada de complementos funciona para su organización.
- Si está realizando la transición desde adquisición individual, obtenga más información en Cambio de adquisición individual a Implementación centralizada.
Nota
La habilitación de Implementación centralizada afecta a las funciones que utilizan el complemento de Excel, como la acción Editar en Excel. No tiene ningún efecto sobre otras funciones o permisos relacionados con Excel asignados a los usuarios en Business Central
Configurar Implementación centralizada del complemento
En esta tarea, trabajará en Business Central y el Centro de administración de Microsoft 365.
En Business Central, elija el icono , introduzca Implementación centralizada complementos Excel y luego elija el vínculo relacionado.
Lea la información en la página Configuración de complementos de Excel de Business Central y elija Siguiente.
Inicie sesión en Centro de administración de Microsoft 365, y luego vaya a Aplicaciones integradas.
Complete los siguientes pasos para configurar el complemento para implementar desde la Tienda Office:
Elija Obtener aplicaciones para abrir Office Store (AppSource).
Busque Complemento de Office de Microsoft Dynamics, luego seleccione Obtener ahora.
En la página Agregar usuarios, especifique los usuarios para los que desea implementar el complemento, luego elija Siguiente.
Revise Aceptar solicitudes de permisos, luego elija Siguiente>Finalizar implementación.
Espere a que aparezca la marca de verificación verde junto a Implementado para el complemento, luego elija Hecho.
El complemento aparece en la página Complementos. Para obtener más información sobre la implementación de complementos en el Centro de administración de Microsoft 365, consulte Implementar complementos en el centro de administración.
Vuelva a la configuración asistida de Implementación centralizada de complementos de Excel en Business Central y elija Siguiente.
Active Utilizar Implementación centralizada y elija Terminar.
Si no activa este conmutador, Business Central obtiene el complemento directamente de Tienda Office.
Cuando termine, siempre puede cambiar la implementación en el Centro de administración de Microsoft 365, como asignar más usuarios. Para obtener más información sobre la implementación de complementos en el Centro de administración, consulte Implementar complementos en el centro de administración.
Importante
Si tiene más de un entorno, debe ejecutar la configuración asistida de Implementación centralizada de complementos de Excel en cada entorno en el que desee utilizar Implementación centralizada. Sin embargo, no es necesario que vuelva a configurar Implementación centralizada en Microsoft 365. Lo único que tiene que hacer es activar el conmutador Utilizar Implementación centralizada en la configuración asistida.
Nota
Pueden pasar hasta 24 horas antes de que el complemento se implemente automáticamente en Excel de los usuarios.
Adquisición individual: instale el complemento manualmente para su propio uso
En la mayoría de los casos, cuando abre Excel desde Business Central, el complemento se instalará automáticamente o se le pedirá que lo instale. Sin embargo, puede haber casos en los que tenga que instalar manualmente el complemento.
- Abra Excel, luego abra cualquier libro de Excel.
- En la pestaña Inicio, seleccione Complementos>Más complementos.
- Vaya a Administrado por el administrador y busque Complemento de Office de Microsoft Dynamics. Si lo ve, selecciónelo, luego elija Agregar. Si no lo ve, vaya a Tienda, luego busque Complemento de Office de Microsoft Dynamics y siga las instrucciones en pantalla para agregarlo.
Cuando se instala el complemento, aparece como un panel en Excel. A continuación, configure la conexión.
Configurar la conexión de Business Central
Si un usuario no puede conectarse automáticamente, puede desbloquearlo pidiéndole que siga estos pasos:
- En el panel de complementos de Microsoft Dynamics en Excel, elija Agregar información del servidor. Si no lo ves, elige el icono en la parte superior para abrir el cuadro de diálogo de opciones.
- Para Business Central online, configure URL del servidor como
https://exceladdinprovider.smb.dynamics.com
. Para Business Central local, configúrelo como el URL del cliente web, comohttps://myBCserver/240
. - Elija Aceptar y luego confirme que la aplicación se vuelva a cargar.
- Cuando se le pida, inicie sesión con su nombre de usuario y contraseña de Business Central.
- Opcionalmente, elija el entorno y la empresa a los que desea conectarse.
El complemento ahora está conectado a Business Central y puede editar datos y publicar los cambios en Business Central.
Prepare los dispositivos y la red para el complemento de Excel
Los servicios de red, como los servidores proxy o los firewalls, deben permitir el enrutamiento entre cada dispositivo cliente en el que está instalado el complemento y muchos puntos finales de servicio. Para obtener una lista de puntos finales, consulte Preparar la red para el complemento de Excel.
Solución de problemas
A veces, los usuarios tienen problemas con el complemento de Excel. Esta sección ofrece algunos consejos para desbloquear usuarios en determinadas circunstancias.
Problema | Solución o solución alternativa | Comentarios |
---|---|---|
El complemento no se inicia Por ejemplo, el usuario recibe el mensaje "Advertencia de complemento: este complemento ya no está disponible" al intentar usar el complemento. Este problema en particular puede ocurrir si la implementación centralizada está configurada correctamente, pero no se asignó acceso al usuario. |
Compruebe si el complemento se implementa de forma centralizada. O verifique si el usuario no puede instalarlo localmente. | El administrador puede configurar Office para que los usuarios no puedan adquirir complementos. En esos casos, el administrador debe implementar el complemento de forma centralizada. Para más información, vea Implementar complementos en el centro de administración. |
Los datos no se cargan en Excel | Pruebe la conexión abriendo otra lista en Excel desde Business Central. O abra el libro en Excel en un navegador. | Si el usuario ha especificado un nombre de empresa que contiene caracteres especiales, el complemento no se puede conectar. |
Los datos no se pueden volver a publicar en Business Central. | Pruebe la conexión abriendo el libro en Excel en un navegador. | A veces, una extensión puede bloquear el trabajo de publicación. Si la página está extendida o personalizada, elimine las extensiones y vuelva a intentarlo. |
Las fechas están mal | Excel puede mostrar fechas y horas en un formato diferente que Business Central. Esta situación no significa que sean incorrectos y los datos de Business Central no se desorganizarán. | |
Para algunas páginas de lista, la edición de varias líneas en Excel provoca errores de forma constante. Esta condición puede ocurrir si las llamadas de OData incluyen FlowFields y campos fuera del control del repetidor. | En la página Servicios web, seleccione las casillas Excluir FlowFields no editables y Excluir campos fuera del repetidor para la página publicada. Al seleccionar estas casillas se excluyen los FlowFields y campos no editables del cálculo de eTag. | Estas casillas están ocultas de forma predeterminada. Para mostrarlas en la página Servicios web, use personalización. |
Los usuarios ya no pueden iniciar sesión en el complemento. Cuando intentan iniciar sesión, el proceso se detiene sin completarse. | Este problema puede deberse a una actualización que realizamos en el complemento, en algún momento de julio de 2022. Para obtener más información y una solución, consulte Modificar la configuración del complemento de Excel para admitir la actualización de julio de 2022. | Se aplica a Business Central local solo. |
El complemento se comunica mediante la API v2.0 para Dynamics 365 Business Central y cualquier limitación de esta API se hereda automáticamente. Una limitación de ejemplo es si intenta editar una lista y la tarjeta subyacente utiliza un cuadro de diálogo de confirmación en su lógica AL, por ejemplo, como lógica de validación. | A veces no hay nada que hacer porque es una elección de diseño que el usuario debe confirmar explícitamente el cambio. Si la confirmación es insignificante al usar Editar en Excel, entonces puede envolver la llamada del diálogo de confirmación en una declaración condicional if que verifique si el tipo de cliente es diferente de ODataV4. por ejemplo, if SESSION.CurrentClientType() <> ClientType::ODataV4 then . |
Es posible que haya otros clientes de los que desee eliminar el cuadro de diálogo de confirmación, como OData y SOAP. |
Limitaciones conocidas en la lógica empresarial
Página | Limitación | Comentarios |
---|---|---|
Pedidos de venta | Mensaje de error: Los servicios de datos de 'Microsoft Dynamics 365 Business Central intentaron emitir una devolución de llamada del cliente para ejecutar la página 301 'Lista de direcciones de envío' como 'modal'. Las devoluciones de llamadas de cliente no son compatibles con los servicios de datos de Microsoft Dynamics 365 Business Central. | El Código de envío en la página Pedido de venta solo se puede editar con opciones de Envío específicas. Al establecer Dirección de envío alternativa en Enviar a, se abre el cuadro de diálogo modal Lista de direcciones de envío, que no es compatible con Editar en Excel. |
Diario del proyecto | La actualización del campo Precio unitario no implica una actualización del Importe de línea. En su lugar, actualiza el Descuento de línea. | Utilizando el cliente web, puede actualizar los campos de cualquier pedido: precio, importe y descuento de línea. Los otros campos se actualizan automáticamente. Para evitar actualizaciones en cascada, los campos tienen una lógica avanzada que se basa en xRec, que se comporta de manera diferente cuando se llama a través de API. |
Limitaciones conocidas en la generación de metadatos
Al usar la acción Editar en Excel en Business Central, ya sea seleccionando la acción Editar en Excel en una página o cuando el complemento de Excel se carga después de abrir un libro de Excel, es posible que aparezca el siguiente error: No se pudieron recuperar los metadatos para la entidad <nombre de entidad> ya que no se encontraron.
Este error ocurre cuando la página que está intentando modificar se vuelve demasiado compleja para que Editar en Excel la procese de manera efectiva. La causa principal es la instalación de múltiples extensiones que agregan campos con nombres de campo idénticos a la misma página elemento primario, lo que genera conflictos. También es posible que una sola extensión bloquee la generación de metadatos.
Extensión única que bloquea la creación de metadatos
Considere el siguiente escenario que involucra la extensión A, que incluye la extensión de página CustomerCardExtA y la página WebViewerA donde PageType = CardPart.
Cuando se generan metadatos para la página Ficha cliente, el algoritmo evalúa cada campo individual, incluidos aquellos campos agregados por extensiones. Sin embargo, si está instalada la extensión A , este proceso falla porque WebViewerA no comparte la misma tabla de origen que la página Ficha cliente.
Para resolver este problema, debe agregar una propiedad ClienteSourceTable
a la página WebViewerA. Un ejemplo de esta modificación se puede observar en los fragmentos de código que contienen CustomerCardExtB y WebViewerB.
En algunos casos, es posible que necesite incrustar CardPart
en varias páginas sin hacer referencia a una tabla de origen específica. Para tales escenarios, recomendamos crear una CardPart
separada para cada página, donde también deberá generar metadatos y refactorizar la lógica compartida en una codeunit.
pageextension 50120 CustomerCardExtA extends "Customer Card"
{
layout
{
addlast(content)
{
part("Bing WebViewer"; "WebViewer")
{
ApplicationArea = All;
}
}
}
}
page 50120 "WebViewerA"
{
ApplicationArea = All;
Caption = 'WebViewer', Locked = true;
PageType = CardPart;
layout
{
area(Content)
{
usercontrol(WebViewer; WebPageViewer)
{
#region ControlAddInReady
trigger ControlAddInReady(callbackUrl: Text)
begin
CurrPage.WebViewer.Navigate('https://www.bing.com')
end;
#endregion ControlAddInReady
}
}
}
}
pageextension 50120 CustomerCardExtB extends "Customer Card"
{
layout
{
addlast(content)
{
part("Bing WebViewer"; "WebViewer")
{
ApplicationArea = All;
}
}
}
}
page 50120 "WebViewerB"
{
ApplicationArea = All;
Caption = 'WebViewer', Locked = true;
PageType = CardPart;
SourceTable = Customer;
layout
{
area(Content)
{
usercontrol(WebViewer; WebPageViewer)
{
#region ControlAddInReady
trigger ControlAddInReady(callbackUrl: Text)
begin
CurrPage.WebViewer.Navigate('https://www.bing.com')
end;
#endregion ControlAddInReady
}
}
}
}
Múltiples extensiones que provocan colisiones
Para resolver este problema, hay dos posibles soluciones:
Deshabilitar extensiones: para identificar qué extensión está causando el conflicto, puede deshabilitar las extensiones que afectan la página de una en una. Sin embargo, este enfoque podría no ser ideal si las extensiones en cuestión son necesarias para sus procesos de negocio.
Modificar el código de extensión: esta solución implica analizar la causa raíz del problema y abordarlo modificando el código de las extensiones en conflicto.
Para comprender mejor este problema, considere el siguiente ejemplo que involucra la página Ficha cliente (ID 21). Cuando está en la página Lista de clientes (ID 22) y selecciona Editar en Excel, se genera un servicio web en segundo plano que expone los campos de la página Ficha cliente. Este servicio web incluye todos los campos de página definidos en la página Ficha cliente, mientras que los campos de tabla solo se exponen si corresponden a un campo de página o son parte de la clave principal.
Cuando se instala una extensión que extiende la página Ficha cliente, los campos agregados por la extensión también se exponen en el servicio web. Si bien las extensiones no pueden crear campos de página con los mismos nombres que los campos que ya existen en la página Ficha cliente, aún pueden surgir conflictos cuando varias extensiones agregan campos con nombres idénticos.
Por ejemplo, supongamos que está instalada la siguiente extensión, denominada A:
using Microsoft.Sales.Customer;
// Extension A
pageextension 50101 CustomerCardExtA extends "Customer Card"
{
layout
{
addLast(General)
{
field("ShoeSize"; Rec.ShoeSize)
{
ApplicationArea = ALL;
Caption = 'ShoeSize';
}
}
}
}
tableextension 50101 CustomerTableExtension extends Customer
{
fields
{
field(50100; ShoeSize; Integer) { }
}
}
Ahora, considere que se instala otra extensión, denominada B, que también modifica la página Ficha cliente:
using Microsoft.Sales.Customer;
// Extension B
pageextension 50102 CustomerCardExtB extends "Customer Card"
{
layout
{
addLast(General)
{
field("ShoeSize"; Rec.ShoeSizeField)
{
ApplicationArea = ALL;
Caption = 'ShoeSize';
}
}
}
}
tableextension 50102 CustomerTableExtension extends Customer
{
fields
{
field(50105; ShoeSizeField; Integer) { }
}
}
En este escenario, ambas extensiones A y B agregan un campo de página llamado ShoeSize
a la página Ficha cliente. Esta condición genera un conflicto que conduce a una falla en la generación de metadatos para la página Ficha cliente.
Para resolver este problema, necesita tener acceso al código de al menos una de las extensiones y luego modificar los nombres de los campos de página en conflicto para evitar colisiones.
Consulte también
Análisis de estados financieros en Microsoft Excel
Trabajar con Business Central
Mejoras en la integración de Excel en el segundo lanzamiento de versiones 2 de 2019
Encuentre módulos de aprendizaje en línea gratuitos de Business Central aquí