Obtenir le complément Business Central pour Excel

Business Central comprend un complément pour Excel qui permet aux utilisateurs de sélectionner l'action Modifier dans Excel sur certaines pages pour ouvrir les données dans une feuille de calcul Excel. Cette action est différente de l'action Ouvrir dans Excel action, car elle permet aux utilisateurs d'apporter des modifications dans Excel, puis de publier ces modifications dans Business Central

Vue d'ensemble

À propos du complément

Le complément s'appelle Microsoft Dynamics Office Add-in et il est disponible à l'installation depuis le Office Store (AppSource). Une fois le complément installé, l'action Modifier dans Excel action est disponible sur la plupart des pages de liste et de partie de liste depuis le Partager icône . Pour en savoir plus sur l'utilisation du complément, consultez Afficher et modifier dans Excel depuis Business Central.

Remarque

Remarque:
Le complément fonctionne uniquement sous Windows.

À propos du déploiement en tant qu'administrateur

Avec Business Central en ligne, il existe quelques options de déploiement pour fournir le complément aux utilisateurs. L'une d'elles est l' acquisition individuelle, où les utilisateurs installent eux-mêmes le complément. Avec cette option, les utilisateurs doivent avoir accès au téléchargement de fichiers depuis Office Store. Une autre option consiste à configurer le Déploiement centralisé dans le centre d'administration Microsoft 365 pour déployer automatiquement le complément dans toute votre organisation, dans des groupes ou pour des utilisateurs spécifiques. Le déploiement centralisé permet de fournir le complément aux utilisateurs si votre organisation ne leur accorde pas l'accès à Office Store.

Pour l'utilisateur, l'expérience d'installation diffère selon les deux scénarios de déploiement :

• Avec l'acquisition individuelle, la première fois que les utilisateurs choisissent l'action Modifier dans Excel action, le volet Nouveau complément Office volet s'ouvre dans Excel. Pour installer le complément, l'utilisateur choisit Faire confiance à ce complément, ce qui installe directement le complément depuis Office Store. Les utilisateurs se connectent ensuite à Business Central à l'aide de leur nom d'utilisateur et de leur mot de passe.

• Avec le déploiement centralisé, la première fois que les utilisateurs choisissent l'action Modifier dans Excel action, le complément est automatiquement installé dans Excel depuis le déploiement centralisé, et non depuis Office Store. Les utilisateurs n'ont qu'à se connecter à Business Central.

Avec ces deux options de déploiement, le complément est automatiquement configuré pour se connecter à Business Central. Une troisième option de déploiement est l'installation manuelle du complément directement depuis Excel. Avec cette option, les utilisateurs doivent configurer le complément pour se connecter à Business Central.

Passage de l'acquisition individuelle au déploiement centralisé, ou vice versa

Lorsque vous passez de l'acquisition individuelle du complément au déploiement centralisé, ou vice versa, cela a une incidence sur les fichiers Excel que les utilisateurs ont créés avant la transition. Après la transition, les utilisateurs peuvent toujours ouvrir les feuilles de calcul Excel créées précédemment à l'aide de l'action Modifier dans Excel action ou créées manuellement en configurant le complément Excel. Cependant, ils ne peuvent pas mettre à jour les données du fichier depuis Business Central ni publier les mises à jour vers Business Central.

Cette situation se produit parce que chaque fichier Excel reçoit un identifiant « complément ». Lors de la transition vers ou depuis le déploiement centralisé, un identifiant différent est attribué, de sorte que l'identifiant antérieur est bloqué.

Préparation (en local uniquement)

Business Central en local nécessite que votre environnement soit configuré pour le complément. Si ce n'est pas le cas, l'action Modifier dans Excel action n'est pas disponible pour les utilisateurs. Pour en savoir plus, consultez Configuration du complément Business Central pour Excel dans Business Central en local dans l'aide pour développeurs et professionnels de l'informatique.

Déployer le complément à l'aide du déploiement centralisé

Le déploiement centralisé est une fonctionnalité du centre d'administration Microsoft 365 que vous utilisez pour installer automatiquement des compléments dans les applications Office des utilisateurs, comme Excel. Pour vous aider avec le déploiement centralisé, Business Central comprend la configuration assistée Déploiement centralisé du complément Excel configuration assistée.

Avant de commencer

• Pour en savoir plus sur la façon d'empêcher les utilisateurs de télécharger depuis Office Store, consultez Gérer les compléments dans le centre d'administration.
• Vérifiez que le déploiement centralisé fonctionne pour votre organisation. Pour en savoir plus, consultez Déterminer si le déploiement centralisé des compléments fonctionne pour votre organisation.
• Pour en savoir plus sur la transition depuis l'acquisition individuelle, consultez Passage de l'acquisition individuelle au déploiement centralisé.

Remarque

Remarque:
L'activation du déploiement centralisé a une incidence sur les fonctionnalités qui utilisent le complément Excel, telles que l'action Modifier dans Excel action. Elle n'a aucun effet sur les autres fonctionnalités liées à Excel ni sur les autorisations attribuées aux utilisateurs dans Business Central.

Configurer le déploiement centralisé du complément

Dans cette tâche, vous travaillez dans Business Central et dans le centre d'administration Microsoft 365.

1. Dans Business Central, sélectionnez Rechercher (Alt+Q) dans le coin supérieur droit, saisissez Déploiement centralisé du complément Excel, puis choisissez le lien associé.

2. Lisez les informations sur la page Configuration du complément Excel Business Central page et choisissez SUIVANT.

3. Connectez-vous au Centre d'administration Microsoft 365 et accédez à Applications intégrées.

   Effectuez les étapes suivantes pour configurer le déploiement du complément depuis Office Store :

   1. Choisissez Obtenir des applications pour ouvrir Office Store (AppSource).

   2. Rechercher Microsoft Dynamics Office Add-in, puis sélectionnez Obtenir maintenant.

   3. Sur l' Ajouter des utilisateurs page, précisez les utilisateurs pour lesquels vous souhaitez déployer le complément, puis choisissez SUIVANT.

   4. Passez en revue la page Accepter les demandes d'autorisation, puis choisissez SUIVANT > Terminer le déploiement.

   5. Attendez la coche verte à côté de Déployé s'affiche pour le complément, puis choisissez Terminé.

      Le complément apparaît sur la page Compléments page. Pour en savoir plus sur le déploiement des compléments dans le centre d'administration Microsoft 365, consultez Déployer des compléments dans le centre d'administration.

4. Revenez à la Déploiement centralisé du complément Excel configuration assistée dans Business Central et choisissez SUIVANT.

5. Activez Utiliser le déploiement centralisé, et choisissez Terminer.

   Si vous n'activez pas ce commutateur, Business Central obtient le complément directement depuis Office Store.

Une fois terminé, vous pouvez toujours modifier le déploiement dans le centre d'administration Microsoft 365, par exemple en attribuant davantage d'utilisateurs. Pour en savoir plus sur le déploiement des compléments dans le centre d'administration, consultez Déployer des compléments dans le centre d'administration.

Important

Important:
Si vous disposez de plusieurs environnements, vous devez exécuter la configuration assistée Déploiement centralisé du complément Excel configuration assistée dans chaque environnement pour lequel vous souhaitez utiliser le déploiement centralisé. Cependant, vous n'avez pas à reconfigurer le déploiement centralisé dans Microsoft 365. La seule chose à faire est d'activer le commutateur Utiliser le déploiement centralisé commutateur dans la configuration assistée.

Remarque

Remarque:
Le déploiement automatique du complément dans Excel pour les utilisateurs peut prendre jusqu'à 24 heures.

Acquisition individuelle : installer manuellement le complément pour votre propre usage

Dans la plupart des cas, lorsque vous ouvrez Excel depuis Business Central, le complément s'installe automatiquement pour vous ou vous êtes invité à l'installer. Il peut toutefois arriver que vous deviez installer le complément manuellement.

1. Ouvrez Excel, puis ouvrez n'importe quel classeur Excel.
2. Sur l' Accueil onglet, sélectionnez Compléments, puis Autres compléments.
3. Aller à Géré par l'administrateur et recherchez Microsoft Dynamics Office Add-In. Si l'option est disponible, sélectionnez-la, puis choisissez Ajouter. Si l'option n'est pas disponible, accédez à Store, puis recherchez Microsoft Dynamics Office add-In et suivez les instructions pour l'ajouter.

Une fois le complément installé, il apparaît sous forme de volet dans Excel. Configurez ensuite la connexion.

Configurer la connexion à Business Central

Si un utilisateur ne peut pas se connecter automatiquement, vous pouvez le débloquer en lui demandant de suivre ces étapes :

1. Dans la Microsoft Dynamics volet du complément dans Excel, choisissez Ajouter les informations du serveur. Si l'option n'est pas disponible, choisissez l'icône icône en haut pour ouvrir la boîte de dialogue des options.
2. Pour Business Central en ligne, définissez l' URL du serveur à https://exceladdinprovider.smb.dynamics.com. Pour Business Central en local, définissez-la sur l'URL du client Web, par exemple https://myBCserver/240.
3. Choisissez OK, puis confirmez que l'application se recharge.
4. Lorsque vous y êtes invité, connectez-vous avec votre nom d'utilisateur et votre mot de passe Business Central.
5. Vous pouvez également choisir l'environnement et la compagnie auxquels vous souhaitez vous connecter.

Le complément est maintenant connecté à Business Central, et vous pouvez modifier les données et publier les modifications dans Business Central.

Préparer les appareils et le réseau pour le complément Excel

Les services réseau tels que les serveurs mandataires (proxies) ou les pare-feu doivent autoriser le routage entre chaque appareil client sur lequel le complément est installé et de nombreux points de terminaison de service. Pour obtenir la liste des points de terminaison, consultez Préparer votre réseau pour le complément Excel.

Dépannage

Les utilisateurs rencontrent parfois des problèmes avec le complément Excel. Cette section fournit des conseils pour débloquer les utilisateurs dans certaines situations.

Problème	Solution ou solution de contournement	Commentaires
Le complément ne démarre pas. Par exemple, l'utilisateur reçoit le message « Avertissement de complément : ce complément n'est plus disponible » lorsqu'il tente de l'utiliser. Ce problème peut se produire si le déploiement centralisé est correctement configuré, mais que l'utilisateur n'a pas été autorisé à y accéder.	Vérifiez si le complément est déployé de manière centralisée. Ou vérifiez si l'utilisateur est bloqué pour l'installation locale.	L'administrateur peut configurer Office de façon à ce que les utilisateurs ne puissent pas acquérir de compléments. Dans ce cas, l'administrateur doit déployer le complément de manière centralisée. Pour en savoir plus, consultez Déployer des compléments dans le centre d'administration.
Les données ne se chargent pas dans Excel.	Testez la connexion en ouvrant une autre liste dans Excel depuis Business Central. Ou ouvrez le classeur dans Excel dans un navigateur.	Si l'utilisateur a spécifié un nom de compagnie contenant des caractères spéciaux, le complément ne peut pas se connecter.
Les données ne peuvent pas être publiées dans Business Central.	Testez la connexion en ouvrant le classeur dans Excel dans un navigateur.	Parfois, une extension peut bloquer le travail de publication. Si la page est étendue ou personnalisée, supprimez les extensions, puis réessayez.
Les dates sont incorrectes.	Excel peut afficher les heures et les dates dans un format différent de celui de Business Central. Cette situation ne les rend pas incorrectes, et les données dans Business Central ne sont pas affectées.
Pour certaines pages de liste, la modification de plusieurs lignes dans Excel génère régulièrement des erreurs. Cette situation peut se produire si les appels OData incluent des FlowFields et des champs en dehors du contrôle de répéteur.	Sur l' Services web page, sélectionnez les Exclure les FlowFields non modifiables et Exclure les champs en dehors du répéteur cases à cocher pour la page publiée. La sélection de ces cases à cocher exclut les FlowFields non modifiables et les champs du calcul eTag.	Ces cases à cocher sont masquées par défaut. Pour les afficher sur la page Services web page, utilisez la personnalisation.
Les utilisateurs ne peuvent plus se connecter au complément. Lorsqu'ils tentent de se connecter, le processus s'arrête sans se terminer.	Ce problème peut survenir en raison d'une mise à jour que nous avons apportée au complément. Pour en savoir plus, consultez Modifier la configuration du complément Excel pour prendre en charge la mise à jour de juillet 2022.	S'applique uniquement à Business Central en local.
Le complément communique à l'aide de l'API v2.0 pour Dynamics 365 Business Central, et toute limitation de cette API est automatiquement héritée. Un exemple de limitation est si vous tentez de modifier une liste et que la fiche sous-jacente utilise une boîte de dialogue de confirmation dans sa logique AL, par exemple, comme logique de validation.	Parfois, il n'y a rien à faire car c'est un choix de conception exigeant que l'utilisateur confirme explicitement la modification. Si la confirmation est négligeable lors de l'utilisation de Modifier dans Excel, vous pouvez encapsuler l'appel de la boîte de dialogue de confirmation dans une instruction if conditionnelle qui vérifie si le type de client est différent de ODataV4, par exemple, if SESSION.CurrentClientType() <> ClientType::ODataV4 then.	Il peut y avoir d'autres clients pour lesquels vous souhaitez supprimer la boîte de dialogue de confirmation, tels que OData et SOAP.
Lorsque vous choisissez Modifier dans Excel, le message suivant s'affiche : « Certains filtres appliqués sur la page ne sont pas disponibles dans Office, ce qui entraîne l'affichage d'un plus grand nombre de lignes par rapport à Business Central. Filtres supprimés : ... ».	Si le filtre supprimé s'applique à un champ que vous avez ajouté via une extension AL, assurez-vous que le nom du champ de page et le nom du champ de table sous-jacent sont identiques. Par exemple, pour le champ de page field("Customer Name"; Rec."Customer Name"), le nom du champ de table « Customer Name » doit être field(1; "Customer Name"; Text). Si le filtre supprimé concerne un champ appartenant à Microsoft ou à un fournisseur tiers, même si le filtre est supprimé dans Business Central, il peut toujours être disponible dans l'onglet de filtre du complément Office. L'inconvénient est qu'il devrait être appliqué manuellement à chaque fois. Pour corriger définitivement les champs sur lesquels vous n'avez pas de contrôle, contactez le propriétaire de l'extension.

Limitations connues dans la logique métier

Page	Limitation	Commentaires
Bons de commande vente	Message d'erreur : « Microsoft Dynamics 365 Business Central Data Services a tenté d'émettre un rappel client pour exécuter la page 301 Ship-to Address List en mode modal. » Les rappels clients ne sont pas pris en charge dans Microsoft Dynamics 365 Business Central Data Services.	La Code d'expédition sur la Commande vente page est modifiable uniquement avec certaines options d'adresse de livraison. Le paramètre Autre adresse de livraison à Expédier à ouvre la Liste des adresses de livraison boîte de dialogue modale, qui n'est pas compatible avec Modifier dans Excel.
Journal de projet	La mise à jour du champ Prix unitaire champ ne déclenche pas la mise à jour du champ Montant de la ligne. À la place, il met à jour Escompte de ligne.	À l'aide du client Web, vous pouvez mettre à jour les champs dans n'importe quel ordre : prix, montant, remise de ligne. Les autres champs sont mis à jour automatiquement. Pour éviter les mises à jour en cascade, les champs ont une logique avancée qui repose sur xRec, qui se comporte différemment lorsqu'il est appelé via des API.

Limitations connues dans la génération de métadonnées

Lors de l'utilisation de Modifier dans Excel dans Business Central, soit en sélectionnant l'action Modifier dans Excel action sur une page, soit lorsque le complément Excel se charge après l'ouverture d'un classeur Excel, vous pouvez rencontrer l'erreur suivante : Les métadonnées n'ont pas pu être récupérées pour l'entité <nom de l'entité> car elle est introuvable.

Cette erreur se produit lorsque la page que vous tentez de modifier devient trop complexe pour être traitée efficacement par Modifier dans Excel pour être traitée efficacement. La cause principale est l'installation de plusieurs extensions qui ajoutent des champs portant des noms identiques à la même page parente, entraînant des conflits. Il est également possible qu'une seule extension bloque la génération des métadonnées.

Extension unique bloquant la création de métadonnées

Imaginez le scénario suivant impliquant l'extension A, qui comprend l'extension de page CustomerCardExtA et la page WebViewerA où PageType = CardPart.

Lors de la génération des métadonnées pour la page Fiche client page, l'algorithme évalue chaque champ individuel, y compris ceux ajoutés par les extensions. Cependant, si l'extension A est installée, ce processus échoue parce que WebViewerA ne partage pas la même table source que la page Fiche client .

Pour résoudre ce problème, vous devez ajouter une propriété Client SourceTable propriété à la page WebViewerA page. Un exemple de cette modification peut être observé dans les extraits de code contenant CustomerCardExtB et WebViewerB.

Dans certains cas, vous pourriez avoir besoin d'intégrer le CardPart sur plusieurs pages sans référencer une table source spécifique. Pour de tels scénarios, nous recommandons de créer un CardPart séparé pour chaque page où vous devez également générer des métadonnées et de refactoriser la logique partagée dans une 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
            }
        }
    }
}

Plusieurs extensions causant des collisions

Pour résoudre ce problème, il existe deux solutions possibles :

1. Désactiver les extensions: Pour identifier quelle extension cause le conflit, vous pouvez désactiver les extensions qui affectent la page une par une. Cependant, cette approche peut ne pas être idéale si les extensions en question sont nécessaires pour vos processus métier.

2. Modifier le code de l'extension: Cette solution consiste à analyser la cause profonde du problème et à y remédier en modifiant le code des extensions conflictuelles.

Pour mieux comprendre ce problème, examinez l'exemple suivant impliquant la page Fiche client page (ID 21). Lorsque vous êtes sur la page Liste des clients page (ID 22) et sélectionnez Modifier dans Excel, un service Web est généré en arrière-plan qui expose les champs de la page Fiche client page. Ce service Web comprend tous les champs de page définis sur la page Fiche client page, tandis que les champs de table ne sont exposés que s'ils correspondent à un champ de page ou font partie de la clé primaire.

Lorsqu'une extension est installée qui étend la page Fiche client page, les champs ajoutés par l'extension sont également exposés dans le service Web. Bien que les extensions ne puissent pas créer des champs de page portant les mêmes noms que ceux déjà présents sur la page Fiche client page, des conflits peuvent tout de même survenir lorsque plusieurs extensions ajoutent des champs portant des noms identiques.

Par exemple, supposons que l'extension suivante, désignée sous le nom de A, soit installée :

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

Maintenant, supposons qu'une autre extension, désignée sous le nom de B, soit installée, qui modifie également la page Fiche client :

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

Dans ce scénario, les extensions A et B ajoutent toutes deux un champ de page nommé ShoeSize vers Fiche client page. Cette situation crée un conflit, ce qui entraîne un échec de génération des métadonnées pour la page Fiche client .

Pour résoudre ce problème, vous devez avoir accès au code d'au moins une des extensions, puis modifier les noms des champs de page conflictuels pour éviter les collisions.

Informations connexes

Analyser les états financiers dans Microsoft Excel
Utiliser Business Central
Améliorations de l'intégration Excel dans la 2e vague de lancement 2019

Trouvez des modules d'apprentissage en ligne gratuits pour Business Central ici