Integrar con Configuración asistida en su extensión

  • 8 minutos

Desde el primer lanzamiento de versiones de Dynamics 365 Business Central 2021, los registros en Configuración manual y Configuración asistida se migran a una nueva tabla, Artículo de experiencia guiada. Esta tabla tiene un campo, Tipo, que determina el tipo de cada registro:

Configuración asistida: aquí residen ahora todos los asistentes de configuración asistida.

Configuración manual: aquí residen ahora todos los registros de configuración manual.

Aprendizaje: los registros de tipo Aprendizaje dirigen a una URL externa.

Recorrido: los registros de tipo Recorrido dirigen a un recorrido por el área de trabajo. Actualmente, solo Microsoft los puede agregar en la plataforma Business Central. Estamos estudiando la posibilidad de permitir que los desarrolladores de AL agreguen y controlen estos recorridos con el tiempo.

Recorrido de lo más destacado: los registros de tipo Recorrido de lo más destacado dirigen a un tipo especial de recorrido donde Business Central abre una página en un modo especial que suprime otros recorridos y destaca las capacidades principales, como Abrir en Excel o Compartir con Teams. Use el recorrido de lo más destacado en escenarios de ventas y evaluación para mostrar capacidades clave que harán que los clientes se entusiasmen con el producto. Considere cómo puede usar estos destacados para sus propias características o para otras. En la siguiente ilustración se muestra un recorrido destacado que llama a la integración de Teams y Excel en una página.

Captura de pantalla de Recorrido de lo más destacado para llamar a características de integración de Teams y Excel

El recorrido de lo más destacado suprime los consejos didácticos en la página y llama de inmediato a las características de integración de Teams y Excel como se muestra en la siguiente ilustración.

Captura de pantalla de Recorrido de lo más destacado que suprime los consejos didácticos en la página y llama a las características de integración de Teams y Excel

Vídeo: los registros de tipo Vídeo permiten al usuario ver un vídeo proporcionado por una URL personalizada. El vídeo se reproducirá en una ventana dentro de Business Central. Considere cómo puede usar el vídeo para explicar una característica o capacidad. El vídeo se usa normalmente en un escenario de ventas/evaluación, pero también podría usarse con fines de formación en un caso de incorporación. En la siguiente ilustración se muestra un reproductor de vídeo que se inicia desde la lista de comprobación.

Captura de pantalla de un reproductor de vídeo dentro de Business Central, iniciado desde la lista de comprobación

Característica de la aplicación: los registros de tipo Característica de la aplicación habilitan una tarea de la lista de comprobación para abrir cualquier página dentro de Business Central. De forma similar a Configuración manual, esto abre una página y muestra un recorrido por la página, si hay alguno definido.

Los elementos de la lista de comprobación se pueden basar en registros de la tabla Artículo de experiencia guiada, lo que significa que antes de mostrar una tarea en la lista de comprobación, primero debe agregarla al Artículo de experiencia guiada.

Para insertar un registro en la tabla Artículo de experiencia guiada, use las funciones de fachada en la codeunit Experiencia guiada:

  • InsertManualSetup

  • InsertAssistedSetup

  • InsertLearnLink

  • InsertTour

  • InsertSpotlightTour

  • InsertVideo

  • InsertApplicationFeature

Por ejemplo, supongamos que tiene la página Configuración de mi solución ISV donde el usuario puede configurar su aplicación. Desea invitar al administrador de negocio para que acceda a esta página desde la lista de comprobación. En este ejemplo, debe insertar un nuevo registro en la tabla Artículo de experiencia guiada con el tipo Configuración manual y proporcionar los metadatos en forma de datos (título, descripciones, etc.) como se describe a continuación.

Una vez que haya creado este registro, podrá hacerle referencia e insertarlo en una lista de comprobación.

Acceda fácilmente a las páginas de configuración de nuevas aplicaciones

Puede agregar una opción para ejecutar una página de configuración directamente desde la página de administración de extensiones si la aplicación ha especificado una página de configuración. El desarrollador de la aplicación debe proporcionar una referencia a la página de configuración en el manifiesto de la aplicación, de modo que Business Central sepa qué página ejecutar para la aplicación específica.

En términos prácticos, hay dos nuevas características:

  • Capacidad para obtener información general de las páginas de configuración presentadas por una aplicación si la aplicación las registra en la tabla de elementos de experiencia guiada.

  • Una nueva acción en la página de administración de extensiones que ejecuta la página que ha especificado el desarrollador.

Captura de pantalla con la opción Configurar esta aplicación

Agregar en la página Configuración asistida

La página 1901 Configuración asistida de la aplicación base les da a los usuarios acceso rápido a todas las guías de configuración asistida. Esta sección explica cómo puede agregar la guía de configuración asistida en la página.

La aplicación base incluye varios objetos que controlan qué elementos aparecen en la página Configuración asistida. Por ejemplo, la tabla 1990 Artículo de experiencia guiada es una tabla interna que constituye el origen de la página Configuración asistida. El codeunit 1990 Experiencia guiada se utiliza para registrar su guía de configuración asistida en la tabla Artículo de experiencia guiada y ejecutarla desde la página Configuración asistida. El codeunit Experiencia guiada publica el evento OnRegisterAssistedSetup que notifica la página Configuración asistida a fin de agregar nuevos artículos.

[IntegrationEvent(false, false)]
internal procedure OnRegisterAssistedSetup()
begin
end;

Para agregar una guía de configuración asistida en la página Configuración asistida, agregue un codeunit que se suscriba al evento OnRegisterAssistedSetup. El siguiente código ilustra cómo puede agregar la guía de configuración asistida ToDoAssistedSetup. El ejemplo también crea una nueva categoría llamada Tareas en la página Configuración asistida; se incluye un vínculo a ToDoAssistedSetup:

codeunit 50100 "AddToDoAssistedSetup"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"Guided Experience", 'OnRegisterAssistedSetup', '', true, true)]
    local procedure OnRegisterAssistedSetup()
    var
        AssistedSetup: Codeunit "Guided Experience";
        GuidedExperienceType: Enum "Guided Experience Type";
        AssistedSetupGroup: Enum "Assisted Setup Group";
        VideoCategory: Enum "Video Category";
    begin
        if not AssistedSetup.Exists(GuidedExperienceType::"Assisted Setup",
            ObjectType::Page,
            Page::"ToDoAssistedSetup") then
        AssistedSetup.InsertAssistedSetup(
        // Link text for the assisted setup guide
        'Add a to-do',
        // Short description, not shown on page
        'Create a task for your team',
        // Text that shows in Description column
       'Register a task for your team and assign people',
       1,
       ObjectType::Page,
       Page::ToDoAssistedSetup,
       // Assign guide to Task category
       AssistedSetupGroup::Tasks,
       //Video URL not required
       '',
       VideoCategory::Uncategorized,
       //Help URL not required
       '');
    end;
}

enumextension 50100 MyEnumExtension extends "Assisted Setup Group"
{
    value(100; Tasks)
    {
    }
}