Integrazione con Setup assistito in un'estensione

  • 8 minuti

A partire dal ciclo di rilascio 1 di Dynamics 365 Business Central 2021 i record in Setup manuale e Setup assistito sono passati in una nuova tabella, Elemento esperienza guidata. In questa tabella è presente un campoTipo che determina il tipo di ogni record:

Setup assistito: qui risiedono ora tutte le procedure guidate di setup assistito.

Setup manuale: qui risiedono ora tutti i record di setup manuale.

Learn: i record di tipo Learn rimandano a un URL esterno.

Presentazione: i record di tipo Presentazione rimandano a una presentazione di Gestione ruolo utente. Attualmente, solo Microsoft può aggiungere le presentazioni nella piattaforma Business Central. Stiamo valutando la possibilità di consentire in futuro agli sviluppatori AL di aggiungere e controllare queste presentazioni.

Tour di contenuti in evidenza: i record di tipo Tour di contenuti in evidenza puntano a un tipo di presentazione speciale in cui Business Central apre una pagina in una modalità speciale che elimina le altre presentazioni e punta i riflettori sulle funzionalità principali, come Apri in Excel o Condividi su Teams. Usare i tour di contenuti in evidenza negli scenari di vendita e valutazione per mostrare le funzionalità chiave del prodotto di maggiore interesse per i clienti. Considerare in che modo usare i tour di contenuti in evidenza per dare maggiore rilievo a funzionalità specifiche. L'illustrazione seguente mostra un tour di contenuti in evidenza che richiama l'integrazione di Teams ed Excel in una pagina.

Screenshot di Tour di contenuti in evidenza per richiamare le funzionalità di integrazione di Teams ed Excel.

Il tour di contenuti in evidenza elimina i suggerimenti didattici nella pagina e richiama immediatamente le funzionalità di integrazione di Teams ed Excel, come mostrato nell'illustrazione seguente.

Screenshot del tour di contenuti in evidenza che elimina i suggerimenti didattici nella pagina e richiama le funzionalità di integrazione di Teams ed Excel.

Video: i record di tipo Video consentono agli utenti di guardare un video fornito da un URL personalizzato. Il video viene riprodotto in una finestra all'interno di Business Central. Considerare come usare i video per illustrare una caratteristica o una funzionalità. Il video viene normalmente usato in uno scenario di vendita/valutazione, ma potrebbe essere utilizzato anche per scopi di formazione in un caso di onboarding. L'illustrazione seguente mostra un lettore video avviato dall'elenco di controllo.

Screenshot di un lettore video all'interno di Business Central, avviato dall'elenco di controllo.

Funzionalità dell'applicazione: i record di tipo Funzionalità dell'applicazione consentono a un'attività dell'elenco di controllo di aprire qualsiasi pagina in Business Central. In modo simile aSetup manualeviene aperta una pagina e viene visualizzata una presentazione della pagina stessa, se definita.

Gli elementi dell'elenco di controllo possono essere basati su record nella tabella Elemento esperienza guidata, il che significa che prima di poter visualizzare un'attività nell'elenco di controllo occorre aggiungerla a Elemento esperienza guidata.

Per inserire un record nella tabella Elemento esperienza guidata usare le funzioni di facciata nella codeunit Esperienza guidata:

  • InsertManualSetup

  • InsertAssistedSetup

  • InsertLearnLink

  • InsertTour

  • InsertSpotlightTour

  • InsertVideo

  • InsertApplicationFeature

Ad esempio, si supponga di disporre della pagina Setup soluzione ISV personale in cui l'utente può configurare l'app. Si desidera invitare il manager aziendale ad accedere a questa pagina dall'elenco di controllo. In questo esempio, è necessario inserire un nuovo record nella tabella Elemento esperienza guidata con il tipo Setup manuale e fornire i metadati come dati (titolo, descrizioni e così via) come descritto di seguito.

Dopo aver creato questo record, è possibile farvi riferimento e inserirlo in un elenco di controllo.

Accesso agevole a pagine di configurazione per nuove app

È possibile aggiungere un'opzione per eseguire una pagina di configurazione direttamente dalla pagina Gestione estensioni se l'app ha specificato una pagina di configurazione. Lo sviluppatore dell'app deve fornire un riferimento alla pagina di configurazione nel manifesto dell'app, di modo che Business Central esegua la pagina corretta per l'app specifica.

In praticano, esistono due funzionalità:

  • La possibilità di ottenere una panoramica delle pagine di configurazione fornite da un'app, se l'app le registra nella tabella Elemento esperienza guidata.

  • Una nuova azione nella pagina Gestione estensioni che esegue la pagina specificata dallo sviluppatore.

Screenshot che mostra l'opzione Imposta questa app.

Aggiunta alla pagina Setup assistito

La pagina 1901 Setup assistito dell'app di base offre agli utenti un accesso rapido a tutte le guide di Setup assistito. Questa sezione spiega come aggiungere la guida al setup assistito alla pagina.

L'app di base include svariati oggetti che controllano quali elementi vengono visualizzati nella pagina Setup assistito. Ad esempio, la tabella 1990 Elemento esperienza guidata è una tabella interna che costituisce l'origine per la pagina Setup assistito. La codeunit 1990 Esperienza guidata permette di registrare la guida al setup assistito nella tabella Elemento esperienza guidata ed eseguirla dalla pagina Setup assistito. La codeunit Esperienza guidata pubblica l'evento OnRegisterAssistedSetup che comunica alla pagina Setup assistito di aggiungere nuovi elementi.

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

Per aggiungere una guida al setup assistito alla pagina Setup assistito aggiungere una codeunit che esegua la sottoscrizione all'evento OnRegisterAssistedSetup. Il codice seguente mostra come aggiungere la guida al setup assistito ToDoAssistedSetup. L'esempio crea inoltre una nuova categoria denominata Tasks nella pagina Setup assistito in cui è presente un collegamento 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)
    {
    }
}