Obtention du complément Business Central pour Excel
Business Central inclut un complément pour Excel qui permet aux utilisateurs de sélectionner une 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 car elle permet aux utilisateurs d’apporter des modifications dans Excel, puis de publier les modifications dans Business Central
Aperçu
À propos du complément
Le complément s’appelle Microsoft Dynamics Office Add-in et il est disponible pour l’installation à partir de l’Office Store (AppSource). Une fois le complément installé, l’action Modifier dans Excel est disponible sur la plupart des pages de liste et de liste partielle à l’aide de l’icône Partager 
. Pour plus d’informations sur l’utilisation du complément, voir Affichage et édition dans Excel depuis Business Central.
Remarque
Le complément fonctionne uniquement sur Windows.
À propos du déploiement en tant qu’administrateur
Business Central Online comprend quelques options de déploiement pour fournir le complément aux utilisateurs. Une option est l’acquisition individuelle, où les utilisateurs installer eux-mêmes le complément. Avec cette option, les utilisateurs doivent avoir accès au téléchargement de fichiers depuis l’Office Store. Une autre option consiste à configurer le Déploiement centralisé dans le centre d’administration de Microsoft 365 pour déployer automatiquement le complément sur l’ensemble de votre organisation, ou pour des groupes ou des utilisateurs spécifiques. Le déploiement centralisé fournit un moyen de mettre le complément à disposition des utilisateurs si votre organisation ne leur donne pas accès à l’Office Store.
Pour l’utilisateur, l’expérience d’installation est différente dans les deux scénarios de déploiement :
Avec l’acquisition individuelle, la première fois que l’utilisateur choisit l’action Modifier dans Excel, le volet Nouveau complément Office s’ouvre dans Excel. Pour installer le complément, l’utilisateur choisit Faire confiance à ce complément, ce qui a pour effet d’installer le complément directement depuis l’Office Store. L’utilisateur se connecte ensuite à Business Central à l’aide de son nom d’utilisateur et de son mot de passe.
Avec le déploiement centralisé, la première fois que l’utilisateur choisit l’action Modifier dans Excel, le complément est automatiquement installé dans Excel à partir du déploiement centralisé, pas de l’Office Store. La seule chose que les utilisateurs doivent faire est de 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 une installation manuelle du complément directement à partir d’Excel. Avec cette option, l’utilisateur doit configurer le complément pour se connecter à Business Central.
Passage de l’acquisition individuelle au déploiement Centralisé, ou inversement
Lorsque vous passez de l’acquisition individuelle du complément au déploiement centralisé, ou vice versa, il affecte les fichiers Excel créés par les utilisateurs avant la transition. Après la transition, les utilisateurs peuvent toujours ouvrir toutes les feuilles de calcul Excel précédemment créées à l’aide de l’action Modifier dans Excel ou créés manuellement en configurant le complément Excel. Mais ils ne peuvent pas mettre à jour les données du fichier provenant de Business Central ni de transmettre les mises à jour à Business Central.
Cette situation est causée par le fait que chaque fichier Excel se voit attribuer un identifiant de « complément ». Lors de la transition vers ou depuis le déploiement centralisé, un ID différent est attribué, de sorte que l’ID précédent est bloqué.
Préparation (sur site uniquement)
Business Central local nécessite que votre environnement soit configuré pour le complément. Si ce n’est pas le cas, l’action Modifier dans Excel n’est pas disponible pour les utilisateurs. Pour en savoir plus, consultez Configuration du complément Business Central pour Excel dans Business Central local dans l’aide pour les développeurs et les 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 de Microsoft 365 que vous utilisez pour installer automatiquement des compléments dans les applications Office des utilisateurs, comme Excel. Pour vous aider dans le déploiement centralisé, Business Central comprend la configuration assistée Déploiement centralisé du complément Excel.
Avant de commencer
- Pour savoir comment empêcher les utilisateurs de réaliser des téléchargements à partir de l’Office Store, voir 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.
- En savoir plus sur l’acquisition individuelle à une autre méthode, consultez Passer de l’acquisition individuelle au déploiement centralisé.
Remarque
L’activation du déploiement centralisé affecte les fonctionnalités qui utilisent le complément Excel, telles que l’action Modifier dans Excel. Cela n’a aucun effet sur les autres fonctionnalités et/ou autorisations liées à Excel et attribuées aux utilisateurs dans Business Central.
Configurer le déploiement centralisé du complément
Dans cette tâche, vous travaillez à la fois dans Business Central et dans le centre d’administration de Microsoft 365.
Dans Business Central, choisissez l’icône
, entrez Déploiement centralisé du complément Excel, puis choisissez le lien associé.Lisez les informations de la page Configuration du complément Business Central pour Excel et sélectionnez Suivant.
Connectez-vous au Centre d’administration Microsoft 365 et accédez à Applications intégrées.
Effectuez les étapes suivantes pour configurer le complément à déployer à partir de l’Office Store :
Sélectionnez Obtenir des applications pour ouvrir l’Office Store (AppSource).
Recherchez le Complément Office Microsoft Dynamics, puis sélectionnez Obtenir maintenant.
Sur la page Ajouter des utilisateurs, spécifiez les utilisateurs pour lesquels vous souhaitez déployer le complément, puis sélectionnez Suivant.
Examinez Accepter les demandes d’autorisation, puis sélectionnez Suivant>Terminer le déploiement.
Attendez que la coche verte à côté de Déployé apparaisse pour le complément, puis sélectionnez Terminé.
Le complément apparaît sur la page Compléments. Pour plus d’informations sur le déploiement de compléments dans le centre d’administration Microsoft 365, voir Déployer des compléments dans le centre d’administration.
Revenez à la configuration assistée du Déploiement centralisé du complément Excel dans Business Central et choisissez Suivant.
Activez Utiliser le déploiement centralisé, et choisissez Terminer.
Si vous n’activez pas ce bouton à bascule, Business Central obtient le complément directement depuis l’Office Store.
Une fois terminé, vous pouvez toujours modifier le déploiement dans le centre d’administration Microsoft 365, par exemple en affectant plus d’utilisateurs. Pour plus d’informations sur le déploiement de compléments dans le centre d’administration, consultez Déployer des compléments dans le centre d’administration.
Important
Si vous avez plusieurs environnements, vous devez exécuter la configuration assistée du Déploiement centralisé du complément Excel sur chaque environnement pour lequel vous souhaitez utiliser le déploiement centralisé. Cependant, vous n’avez pas besoin de configurer à nouveau le déploiement centralisé dans Microsoft 365. La seule chose que vous avez à faire est d’activer le bouton à bascule Utiliser le déploiement centralisé dans la configuration assistée.
Remarque
Il peut s’écouler jusqu’à 24 heures avant que le complément ne se déploie automatiquement dans l’instance Excel des utilisateurs.
Acquisition individuelle : installer le complément manuellement pour votre propre usage
Dans la plupart des cas, lorsque vous ouvrez Excel à partir de Business Central, le complément est soit installé automatiquement pour vous, soit vous êtes invité à l’installer. Cependant, il peut arriver que vous deviez installer manuellement le complément.
- Ouvrez Excel, puis ouvrez n’importe quel classeur Excel.
- Sur le Accueil onglet, sélectionnez Compléments>Plus de compléments.
- Accédez à Géré par l’administrateur et cherchez Complément Office Microsoft Dynamics. Si vous l’y voyez, sélectionnez-le, puis choisissez Ajouter. Si vous ne le voyez pas, allez au Store, puis recherchez Microsoft Dynamics Office Add-in et suivez les instructions pour l’ajouter.
Lorsque le complément est installé, il apparaît sous forme de volet dans Excel. À présent, configurez la connexion.
Configurer la connexion Business Central
Si un utilisateur ne parvient pas à se connecter automatiquement, vous pouvez le débloquer en lui demandant de suivre ces étapes :
- Dans le volet de complément Microsoft Dynamics dans Excel, choisissez Ajouter des informations sur le serveur. Si vous ne la voyez pas, choisissez l’icône
en haut pour ouvrir la boîte de dialogue Options. - Pour Business Central Online, définissez URL du serveur sur
https://exceladdinprovider.smb.dynamics.com. Pour Business Central local, définissez-lui l’URL du client Web, par exemplehttps://myBCserver/240. - Sélectionnez OK, puis vérifiez que l’application se recharge.
- À l’invite, connectez-vous à Business Central avec votre nom d’utilisateur et votre mot de passe.
- En option, choisissez l’environnement et la société 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 proxys ou les pare-feu doivent autoriser le routage entre tous les appareils clients sur lesquels le complément est installé et de nombreux points de terminaison de service. Pour obtenir la liste des points de terminaison, consultez Préparation de votre réseau pour le complément Excel.
Résolution des problèmes
Parfois, les utilisateurs rencontrent des problèmes avec le complément Excel. Cette section donne des conseils sur la façon de débloquer des utilisateurs dans certaines circonstances.
| Problème | Solution ou 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 essaie d’utiliser le complément. Ce problème particulier peut se produire si le déploiement centralisé est correctement configuré, mais que l’accès n’a pas été attribué à l’utilisateur. |
Vérifiez si le complément est déployé de manière centralisée. Sinon, vérifiez si l’utilisateur n’est pas autorisé à l’installer localement. | L’administrateur peut configurer Office de sorte que les utilisateurs ne puissent pas acquérir de compléments. Dans ces cas, l’administrateur doit déployer le complément de manière centralisée. Pour plus d’informations, 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 à partir de Business Central. Sinon, ouvrez le classeur dans Excel dans un navigateur. | Si l’utilisateur a spécifié un nom de société contenant des caractères spéciaux, le complément ne peut pas se connecter. |
| Les données ne peuvent publier vers 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 fausses. | Excel peut afficher les heures et les dates dans un format différent de celui de Business Central. Cette situation ne les rend pas erronées, et les données contenues dans Business Central ne sont pas compromises. | |
| Pour certaines pages de liste, la modification de plusieurs lignes dans Excel provoque systématiquement des erreurs. Cette situation peut se produire si des appels OData incluent des FlowFields et des champs hors de contrôle du répéteur. | Sur la page Services web, cochez les cases Exclure les FlowFields non modifiables et Exclure les champs hors de contrôle du répéteur pour la page publiée. La sélection de ces cases à cocher exclut les FlowFields et les champs non modifiables du calcul de l’eTag. | Ces cases à cocher sont masquées par défaut. Pour les afficher sur la page Services web, utilisez la personnalisation. |
| Les utilisateurs ne peuvent plus se connecter au complément. Lorsqu’ils essaient de se connecter, le processus s’arrête sans s’achever. | Ce problème peut être causé par une mise à jour que nous avons apportée au complément, en juillet 2022. Pour obtenir plus d’informations et un correctif, voir Modifier la configuration du complément Excel pour prendre en charge la mise à jour de juillet 2022. | S’applique à Business Central local uniquement. |
| Le complément communique à l’aide de l’API v2.0 pour Dynamics 365 Business Central, et toutes les limitations de cette API sont automatiquement héritées. Un exemple de limitation est si vous essayez de modifier une liste et que la carte 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 que l’utilisateur doit confirmer explicitement le changement. Si la confirmation est négligeable lors de l’utilisation de Modifier dans Excel, vous pouvez alors envelopper 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 d’ODataV4, par exemple, if SESSION.CurrentClientType() <> ClientType::ODataV4 then. |
Il se peut que vous souhaitiez supprimer la boîte de dialogue de confirmation d’autres clients, tels que OData et SOAP. |
Limitations connues dans la logique métier
| Page | Limitation | Commentaires |
|---|---|---|
| Commandes vente | Message d’erreur : « Les services de données Microsoft Dynamics 365 Business Central ont tenté d’émettre un rappel client pour exécuter la page 301 Liste d’adresses de livraison comme modale. » Les rappels client ne sont pas pris en charge dans les services de données Microsoft Dynamics 365 Business Central. | Le Code destinataire sur la page Commande vente est modifiable uniquement avec des options de livraison spécifiques. Lorsque vous définissez Autre adresse d’expédition sur Destinataire, cela ouvre la boîte de dialogue modale Liste adresses destinataire, qui n’est pas compatible avec Modifier dans Excel. |
| Feuille projet | La mise à jour du champ Prix unitaire ne déclenche pas une mise à jour du Montant ligne. À la place, Remise ligne est mis à jour. | En utilisant le client web, vous pouvez mettre à jour les champs dans n’importe quelle commande : prix, montant, remise ligne. Les autres champs sont mis à jour automatiquement. Pour éviter les mises à jour en cascade, les champs ont une logique avancée qui se base 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
Lorsque vous utilisez Modifier dans Excel dans Business Central, soit en sélectionnant l’action Modifier dans Excel sur une page ou 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 elles sont introuvables.
Cette erreur se produit lorsque la page que vous essayez de modifier devient trop complexe pour que Modifier dans Excel la traite efficacement. La cause principale est l’installation de plusieurs extensions qui ajoutent des champs avec des noms de champs identiques à la même page parente, ce qui entraîne des conflits. Il est également possible qu’une seule extension bloque la génération de métadonnées.
Extension unique bloquant la création de métadonnées
Considérez le scénario suivant impliquant une extension A, qui inclut l’extension de page CustomerCardExtA et la page WebViewerA où PageType = CardPart.
Lorsque des métadonnées sont générées pour la page Fiche client, l’algorithme évalue chaque champ individuel, y compris les champs ajoutés par des extensions. Cependant, si l’extension A est installée, ce processus échoue car 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é ClientSourceTable à la page WebViewerA. Un exemple de cette modification peut être observé dans les extraits de code contenant CustomerCardExtB et WebViewerB.
Dans certains cas, vous devrez peut-être incorporer CardPart sur plusieurs pages sans référencer une table source spécifique. Pour ces scénarios, nous recommandons de créer un CardPart distinct pour chaque page où vous devez également générer des métadonnées et de refactoriser la logique partagée en 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
}
}
}
}
Extensions multiples provoquant des collisions
Pour résoudre ce problème, il existe deux solutions potentielles :
Désactiver les extensions : pour identifier quelle extension est à l’origine du conflit, vous pouvez désactiver les extensions qui affectent la page, une à la fois. Cependant, cette approche peut ne pas être idéale si les extensions en question sont nécessaires à vos processus métier.
Modifier le code d’extension : cette solution implique d’analyser la cause principale du problème et de la résoudre en modifiant le code des extensions en conflit.
Pour mieux comprendre ce problème, prenez l’exemple suivant impliquant la page Fiche client (ID 21). Lorsque vous êtes sur la page Liste des clients (ID 22) et que vous 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. Ce service web inclut tous les champs de page définis sur la page Fiche client, 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 et étend la page Fiche client, les champs ajoutés par l’extension sont également exposés dans le service web. Bien que les extensions ne puissent pas créer de champs de page avec les mêmes noms que les champs déjà existants sur la page Fiche client, des conflits peuvent toujours survenir lorsque plusieurs extensions ajoutent des champs avec des noms identiques.
Par exemple, supposons que l’extension suivante, appelée 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, considérons qu’une autre extension, appelée 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 deux extensions A et B ajoutent un champ de page nommé ShoeSize à la page Fiche client. Cette condition génère un conflit, qui entraîne un échec de la génération de métadonnées pour la page Fiche client.
Pour résoudre ce problème, vous devez accéder au code d’au moins une des extensions, puis modifier les noms de champ de page en conflit pour éviter les collisions.
Voir aussi
Analyse des états financiers dans Microsoft Excel
Utiliser Business Central
Améliorations de l’intégration d’Excel dans la 2e vague de lancement 2019
Trouvez des modules d’apprentissage en ligne gratuits pour Business Central ici