Ottenere il componente aggiuntivo Business Central per Excel

Business Central include un add-in per Excel che permette agli utenti di selezionare un'azione Modifica in Excel su certe pagine per aprire i dati in un foglio di lavoro Excel. Questa azione è diversa dall'azione Apri in Excel perché consente agli utenti di apportare modifiche in Excel, quindi di ripubblicare le modifiche in Business Central

Sintesi

Informazioni sull'add-in

L'add-in si chiama Add-in Microsoft Dynamics per Office ed è disponibile per l'installazione su Office Store (AppSource). Con l'add-in installato, l'azione Modifica in Excel è disponibile nella maggior parte delle pagine dell'elenco e delle parti dell'elenco dall'icona Condividi . Per ulteriori informazioni sull'uso dell'add-in, vedi Visualizzazione e modifica in Excel da Business Central.

Riguardo all'impiego come amministratore

Con Business Central Online, ci sono alcune opzioni di distribuzione per portare l'add-in agli utenti. Un'opzione è l' acquisizione individuale, dove si lascia che gli utenti installino il componente aggiuntivo da soli. Con questa opzione, gli utenti devono avere accesso al download di file da Office Store. Un'altra opzione è quella di impostare la distribuzione centralizzata nell'interfaccia di amministrazione di Microsoft 365 per distribuire automaticamente l'add-in all'intera organizzazione, a gruppi o a utenti specifici. La distribuzione centralizzata fornisce un modo per ottenere l'add-in agli utenti se la tua organizzazione non dà agli utenti l'accesso a Office Store.

Per l'utente finale, l'esperienza di installazione è diversa per i due scenari di distribuzione:

• Con l'acquisizione individuale, la prima volta che gli utenti scelgono l'azione Modifica in Excel, il riquadro Nuovo add-in per Office si apre in Excel. Per installare l'add-in, l'utente sceglie Considera questo add-in affidabile, che a sua volta installa l'add-in direttamente da Office Store. Gli utenti accedono poi a Business Central usando il loro nome utente e la loro password.

• Con la distribuzione centralizzata, la prima volta che gli utenti scelgono l'azione Modifica in Excel, il componente aggiuntivo viene automaticamente installato in Excel dalla distribuzione centralizzata; non da Office Store. L'unica cosa che gli utenti devono fare è accedere a Business Central

Con entrambe queste opzioni di distribuzione, il componente aggiuntivo viene configurato automaticamente per la connessione a Business Central. Una terza opzione di distribuzione è l'installazione manuale del componente aggiuntivo direttamente da Excel. Con questa opzione, gli utenti devono configurare il componente aggiuntivo a cui connettersi Business Central

Passare dall'acquisizione individuale alla distribuzione centralizzata o viceversa

Quando si passa dall'acquisizione individuale del componente aggiuntivo alla distribuzione centralizzata, o viceversa, i file Excel che gli utenti hanno creato prima della transizione sono interessati. Dopo la transizione, gli utenti possono ancora aprire qualsiasi foglio di lavoro Excel precedentemente creato utilizzando l'azione Modifica in Excel o creato manualmente configurando l'add-in Excel. Ma non possono aggiornare i dati nel file da Business Central o spingere gli aggiornamenti a Business Central

Questa condizione è causata dal fatto che ad ogni file Excel viene assegnato un identificatore "add-in". Nella transizione da o verso la distribuzione centralizzata, viene assegnato un ID diverso, quindi l'ID precedente diventa bloccato.

Preparazione (solo in sede)

Business Central on-premises richiede che il tuo ambiente sia configurato per l'add-in. In caso contrario, l'azione Modifica in Excel non è disponibile per gli utenti. Per maggiori informazioni, vedi Impostazione dell'add-in di Excel per la modifica dei dati di Business Central nella guida di Developer e IT Pro.

Distribuire il componente aggiuntivo utilizzando la distribuzione centralizzata

La distribuzione centralizzata è una funzione nell'interfaccia di amministrazione di Microsoft 365 che si usa per installare automaticamente i componenti aggiuntivi nelle applicazioni Office degli utenti, come Excel. Per aiutarvi con la distribuzione centralizzata, Business Central include la configurazione assistita di Distribuzione centralizzata Add-in Excel.

Prima di iniziare

• Per sapere come impedire agli utenti di scaricare dal negozio di Office, vedi Gestire i componenti aggiuntivi nel centro amministrativo.
• Verifica che la distribuzione centralizzata funzioni per la tua organizzazione. Per ulteriori informazioni, vedi Determinare se la distribuzione centralizzata degli add-in funziona per la propria organizzazione.
• Se stai passando dall'acquisizione individuale, vedi Passaggio dall'acquisizione individuale alla distribuzione centralizzata.

Impostare la distribuzione centralizzata dell'add-in

In questa attività, lavorerai sia in Business Central che nell'interfaccia di amministrazione di Microsoft 365.

1. In Business Central, scegli l'icona , immetti Distribuzione centralizzata Add-in Excel, quindi scegli il collegamento correlato.

2. Leggi le informazioni sulla pagina d'impostazione dell'add-in di Business Central Excel e scegli Avanti.

3. Accedi all'interfaccia di amministrazione di Microsoft 365, quindi vai ad App integrate.

   Completa i seguenti passi per configurare il componente aggiuntivo da distribuire da Office Store:

   1. Scegliere Scarica app per aprire Office Store (AppSource).

   2. Cerca Add-in di Microsoft Dynamics per Office, poi seleziona Scaricalo ora.

   3. Nella pagina Aggiungi utenti, specifica gli utenti per i quali vuoi distribuire l'add-in, quindi scegli Avanti.

   4. Esaminare le richieste di autorizzazioni accettate, quindi scegliere Avanti>Termina distribuzione.

   5. Attendere che il segno di spunta verde accanto a Distribuito appaia per l'add-in, quindi scegliere Fatto.

      L'add-in appare nella pagina Add-in . Per ulteriori informazioni sulla distribuzione dei componenti aggiuntivi nell'interfaccia di amministrazione di Microsoft 365, vedi Distribuire i componenti aggiuntivi nell'interfaccia di amministrazione.

4. Torna al setup assistito Distribuzione centralizzata di componenti aggiuntivi per Excel in Business Central, e scegli Avanti.

5. Attivare Usa distribuzione centralizzata e scegliere Fine.

   Se non si attiva questo interruttore, Business Central ottiene il componente aggiuntivo direttamente da Office Store.

Quando hai finito, puoi sempre cambiare la distribuzione nell'interfaccia di amministrazione di Microsoft 365, come assegnare più utenti. Per ulteriori informazioni sulla distribuzione dei componenti aggiuntivi nel centro amministrativo, vedi Distribuzione di componenti aggiuntivi nel centro amministrativo.

Acquisizione individuale: Installare manualmente l'add-in per uso personale

Nella maggior parte dei casi, quando aprirai Excel da Business Central, l'add-in verrà installato automaticamente per te o ti verrà richiesto di installarlo. Ci potrebbero essere casi, tuttavia, in cui è necessario installare manualmente l'add-in.

1. Aprire Excel, poi aprire una qualsiasi cartella di lavoro Excel.
2. Nella scheda Home, seleziona Componenti aggiuntivi>Altri componenti aggiuntivi.
3. Vai su Gestito da amministratore e cerca Add-in di Microsoft Dynamics per Office. Se lo vedi, selezionalo e poi scegli Aggiungi. Se non lo vedi, vai su Store, poi cerca Add-in di Microsoft Dynamics per Office e segui le istruzioni sullo schermo per aggiungerlo.

Quando l'add-in è installato, si presenta come un pannello in Excel. Successivamente, configurate la connessione.

Configurare la connessione a Business Central

Se un utente non può connettersi automaticamente, puoi sbloccarlo chiedendogli di seguire questi passi:

1. Nel Microsoft Dynamics pannello add-in in Excel, scegli Aggiungi informazioni server. Se non lo vedi, scegli l'icona in alto per aprire la finestra di dialogo delle opzioni.
2. Per Business Central Online, impostare l'URL del server su https://exceladdinprovider.smb.dynamics.com. Per Business Central in locale, impostare l'URL del client Web, come https://myBCserver/240.
3. scegli OK, e poi confermate che l'app si ricarica.
4. Quando ti viene richiesto, accedi con il tuo nome utente e la password di Business Central.
5. Opzionalmente, scegli l'ambiente e l'azienda a cui volete connettervi.

Il componente aggiuntivo è ora connesso a Business Central, e puoi modificare i dati e pubblicare le modifiche su Business Central.

Preparare i dispositivi e la rete per l'Add-In di Excel

I servizi di rete come i proxy o i firewall devono permettere il routing tra ogni dispositivo client su cui è installato il componente aggiuntivo e molti endpoint di servizio. Per un elenco di endpoint, vedi Preparare la tua rete per l'Add-In Excel.

Troubleshooting

A volte, gli utenti incontrano problemi con l'add-in di Excel. Questa sezione fornisce alcuni suggerimenti su come sbloccare gli utenti in determinate circostanze.

Limitazioni note nella logica aziendale

Limitazioni note nella generazione di metadati

Quando si utilizza l'azione Modifica in Excel in Business Central, selezionando l'azione Modifica in Excel in una pagina o quando il componente aggiuntivo di Excel viene caricato dopo l'apertura di una cartella di lavoro di Excel, potrebbe verificarsi il seguente errore: Impossibile recuperare i metadati per l'entità <nome entità> perché non sono stati trovati.

Questo errore si verifica quando la pagina che si sta tentando di modificare diventa troppo complessa per essere elaborata in modo efficace da Modifica in Excel. La causa principale è l'installazione di più estensioni che aggiungono campi con nomi di campo identici alla stessa pagina padre, causando conflitti. È anche possibile che una singola estensione blocchi la generazione di metadati.

Estensione singola che blocca la creazione di metadati

Si consideri il seguente scenario che coinvolge l'estensione A, che include l'estensione di pagina CustomerCardExtA e la pagina WebViewerA dove PageType = CardPart.

Quando vengono generati metadati per la pagina Scheda cliente, l'algoritmo valuta ogni singolo campo, compresi quelli aggiunti dalle estensioni. Tuttavia, se è installata l'estensione A, questo processo non riesce perché WebViewerA non condivide la stessa tabella di origine della pagina Scheda cliente.

Per risolvere questo problema, è consigliabile aggiungere una proprietà ClienteSourceTable alla pagina WebViewerA. Un esempio di questa modifica può essere osservato nei frammenti di codice contenenti CustomerCardExtB e WebViewerB.

In alcuni casi, potrebbe essere necessario incorporare CardPart in più pagine senza fare riferimento a una tabella di origine specifica. Per tali scenari, è consigliabile creare un CardPart separato per ogni pagina in cui è anche necessario generare metadati e riorganizzare la logica condivisa in 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
            }
        }
    }
}

Estensioni multiple che causano collisioni

Per risolvere questo problema, ci sono due possibili soluzioni:

1. Disattivare le estensioni: per identificare quale estensione sta causando il conflitto, puoi disattivare una alla volta le estensioni che interessano la pagina. Tuttavia, questo approccio potrebbe non essere la soluzione ideale se le estensioni in questione sono necessarie per i processi aziendali.

2. Modificare il codice dell'estensione: questa soluzione prevede l'analisi della causa radice del problema e la sua risoluzione modificando il codice delle estensioni in conflitto.

Per comprendere meglio questo problema, si consideri il seguente esempio che coinvolge la pagina Scheda cliente (ID 21). Quando sei nella pagina Elenco clienti (ID 22) e selezioni Modifica in Excel, viene generato in background un servizio Web che espone i campi dalla pagina Scheda cliente. Questo servizio Web include tutti i campi di pagina definiti nella pagina Scheda cliente, mentre i campi della tabella vengono esposti solo se corrispondono a un campo di pagina o fanno parte della chiave primaria.

Quando viene installata un'estensione che estende la pagina Scheda cliente, i campi aggiunti dall'estensione vengono esposti anche nel servizio Web. Sebbene le estensioni non possano creare campi di pagina con gli stessi nomi dei campi già esistenti nella pagina Scheda cliente, possono comunque verificarsi conflitti quando più estensioni aggiungono campi con nomi identici.

Ad esempio, supponiamo che sia installata la seguente estensione, denominata 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) { }
    }
}

Ora, considera che è installata un'altra estensione, denominata B, che modifica anche la pagina Scheda 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) { }
    }
}

In questo scenario, entrambe le estensioni A e B aggiungono un campo di pagina denominato ShoeSize alla pagina Scheda cliente. Questa condizione genera un conflitto, che determina un errore nella generazione dei metadati per la pagina Scheda cliente.

Per risolvere questo problema, è necessario accedere al codice di almeno una delle estensioni e quindi modificare i nomi dei campi della pagina in conflitto per evitare collisioni.

Vedi anche

Analisi dei rendiconti finanziari in Microsoft Excel
Utilizzare Business Central
Miglioramenti all'integrazione di Excel nella seconda ondata di rilascio del 2019

I moduli di e-learning gratuiti per Business Central sono disponibili qui