Intégrer avec la configuration assistée dans votre extension

  • 8 minutes

Depuis la première vague de lancement 2021 de Dynamics 365 Business Central, les enregistrements dans Installation manuelle et Configuration assistée sont migrés vers une nouvelle table nommée Élément d’expérience guidée. Cette table comporte un champ Type qui détermine le type de chaque enregistrement :

Configuration assistée : emplacement où résident désormais tous les Assistants Configuration assistée.

Installation manuelle : emplacement où résident désormais tous les enregistrements d’installation manuelle.

Apprentissage : les enregistrements de type Apprentissage pointent vers une URL externe.

Visite : les enregistrements de type Visite pointent vers une visite du tableau de bord. À l’heure actuelle, seule l’équipe Microsoft peut les ajouter dans la plateforme Business Central. Nous envisageons de permettre aux développeurs AL d’ajouter et de contrôler ces visites à terme.

Visite guidée : les enregistrements de type Visite guidée pointent vers une visite spéciale où Business Central ouvre une page dans un mode spécial qui supprime les autres visites et met en lumière des fonctionnalités de base, comme Ouvrir dans Excel ou Partager sur Teams. Montrez les fonctionnalités clés qui susciteront l’enthousiasme des clients pour le produit à l’aide de la visite guidée dans les scénarios de vente et d’évaluation. Réfléchissez à la manière dont vous pouvez utiliser ces visites guidées pour vos fonctionnalités ou d’autres. L’illustration suivante présente une visite guidée qui appelle l’intégration de Teams et d’Excel sur une page :

Capture d’écran de la visite guidée permettant d’appeler les fonctionnalités d’intégration de Teams et d’Excel.

La visite guidée supprime les conseils pédagogiques sur la page et appelle immédiatement les fonctionnalités d’intégration de Teams et d’Excel, comme indiqué dans l’illustration suivante :

Capture d’écran de la visite guidée supprimant les conseils pédagogiques sur la page et appelant les fonctionnalités d’intégration de Teams et d’Excel.

Vidéo : les enregistrements de type Vidéo permettent à l’utilisateur de regarder une vidéo fournie par une URL personnalisée. La vidéo est lue dans une fenêtre au sein de Business Central. Réfléchissez à la manière dont une vidéo vous permet d’expliquer une fonctionnalité. Une vidéo est généralement utilisée dans un scénario de vente/d’évaluation, mais peut également être utilisée à des fins de formation dans un cas d’intégration. L’illustration suivante présente un lecteur vidéo démarré à partir de la liste de contrôle :

Capture d’écran d’un lecteur vidéo dans Business Central, démarré à partir de la liste de contrôle.

Fonctionnalité d’application : les enregistrements de type Fonctionnalité d’application permettent à une tâche de liste de contrôle d’ouvrir toute page dans Business Central. Semblable à Installation manuelle, cela ouvre une page et affiche une visite de page s’il y en a une définie.

Les éléments de liste de contrôle peuvent être basés sur des enregistrements de la table Élément d’expérience guidée. Autrement dit, avant d’afficher une tâche sur la liste de contrôle, vous devez d’abord l’ajouter à la table Élément d’expérience guidée.

Intégrez un enregistrement à la table Élément d’expérience guidée à l’aide des fonctions de façade dans le codeunit Expérience guidée :

  • InsertManualSetup

  • InsertAssistedSetup

  • InsertLearnLink

  • InsertTour

  • InsertSpotlightTour

  • InsertVideo

  • InsertApplicationFeature

Par exemple, disons que vous disposez de la page Installation de ma solution ISV où l’utilisateur peut configurer votre application. Vous souhaitez inviter le directeur commercial à accéder à cette page à partir de la liste de contrôle. Dans cet exemple, vous devez intégrer un nouvel enregistrement à la table Élément d’expérience guidée avec le type Installation manuelle et fournir les métadonnées sous forme de données (titre, descriptions, etc.) comme décrit ci-dessous.

Une fois cet enregistrement créé, il peut être référencé depuis une liste de contrôle et y être intégré.

Accéder facilement aux pages de configuration des nouvelles applications

Vous pouvez ajouter une option pour exécuter une page de configuration directement à partir de la page Gestion des extensions si l’application a spécifié une page de configuration. Le développeur de l’application doit fournir une référence à la page de configuration dans le manifeste de l’application pour permettre à Business Central d’identifier la page à exécuter pour l’application spécifique.

Dans la pratique, il existe deux nouvelles fonctionnalités :

  • Une possibilité d’obtenir un aperçu des pages de configuration apportées par une application, si l’application les enregistre dans la table Élément d’expérience guidée.

  • Une nouvelle action sur la page Gestion des extensions qui exécute la page spécifiée par le développeur.

Capture d’écran présentant l’option Configurer cette application.

Effectuer un ajout à la page Configuration assistée

La page 1901 Configuration assistée de l’application de base permet aux utilisateurs d’accéder rapidement à tous les guides de configuration assistée. Cette section explique comment ajouter votre guide de configuration assistée à la page.

L’application de base comprend plusieurs objets qui contrôlent les éléments qui s’affichent sur la page Configuration assistée. Par exemple, la table 1990 Élément d’expérience guidée est une table interne qui constitue la source de la page Configuration assistée. Le codeunit 1990 Expérience guidée permet d’enregistrer votre guide de configuration assistée dans la table Élément d’expérience guidée et de l’exécuter à partir de la page Configuration assistée. Le codeunit Expérience guidée publie l’événement OnRegisterAssistedSetup qui notifie la page Configuration assistée pour ajouter de nouveaux éléments.

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

Pour ajouter un guide de configuration assistée à la page Configuration assistée, ajoutez un codeunit qui s’abonne à l’événement OnRegisterAssistedSetup. Le code suivant illustre comment ajouter le guide de configuration assistée ToDoAssistedSetup. L’exemple crée également une catégorie nommée Tâches sur la page Configuration assistée avec un lien vers ToDoAssistedSetup répertorié :

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)
    {
    }
}