Assistant writeback
Dans Nectari, les données sont récupérées depuis l'ERP et affichées dans le classeur. Toute modification apportée dans la feuille reste locale par défaut et rien n'est renvoyé à l'ERP. La formule NECWRITEBACK est ce qui envoie les changements du classeur vers l'ERP. Un classeur peut contenir plusieurs formules, chacune ciblant des champs ou entités différents.
L'association des cellules du classeur aux champs ERP doit être fait prudemment : chaque champ doit pointer vers le bon enregistrement et la bonne valeur. Le Writeback Wizard aide à génèrer la formule plutôt que d'avoir à la saisir manuellement. Des classeurs de writeback prédéfinis sont également disponibles pour Acumatica, couvrant la création de documents ainsi que la gestion des budgets et prévisions.
Il faut les autorisations requises pour créer un assistant et envoyer les modifications vers l'ERP directement depuis Nectari.
L'assistant est actuellement disponible uniquement avec Acumatica.
Quand renvoyer des données vers l'ERP
- Créer un document comme une écriture de journal, une facture fournisseur, une facture client ou une facture pro forma.
- Réapprovisionner les stocks et générer des bons de commande directement depuis le classeur.
- Gérer les budgets et prévisions, notamment les budgets annuels, les révisions prévisionnelles et les prévisions de coûts de projet.
- Mettre à jour des enregistrements existants quand des valeurs doivent être corrigées ou révisées à la source.
Configurer l'assistant
- Dans l'onglet Analyse, cliquez sur Assistant Writeback.
- Sélectionnez l'environnement et la source de données.
- Choisissez l'entité dans la liste déroulante.
- Dans l'onglet Sélection, développez chaque table pour voir les champs disponibles, puis cochez ceux à inclure.
- Cliquez sur Suivant.
- Dans l'onglet Mappage, associez chaque champ sélectionné à une cellule ou une table du classeur.
- Sous Options, développez Bouton Writeback et activez Afficher le bouton.
- Configurez la cellule cible, le libellé et la couleur du bouton.
- (Facultatif) Activez Résultats pour afficher le résultat du writeback dans une cellule de la feuille.
- Cliquez sur Enregistrer.
Propriété de l'assistant
| Champ | Ce qu'il faut configurer |
|---|---|
| Environnement | Environnement Nectari contenant la source de données à utiliser pour le writeback. |
| Source de données | Source de données utilisées pour l'assistant. S'assurer que le Nom du point de terminaison et la Version du point de terminaison sont bien configurés. Disponible uniquement avec Acumatica pour le moment. |
| Entité | Entité cible. Une seule entité par assistant peut être sélectionnée. |
| Tables | Le panneau Tables affiche la hiérarchie complète de l'entité sélectionnée. La table d'en-tête représente l'entité principale. Les tables de détail (Attributs, Détails, etc.) apparaissent en dessous et correspondent à des sous-tables contenant plusieurs enregistrements liés. Des champs peuvent être sélectionnés dans la table d'en-tête, dans une ou plusieurs tables de détail, ou dans les deux. Les champs marqués d'une icône de clé dorée sont des champs clés qui identifient les enregistrements dans l'ERP. Ces champs sont requis pour cibler le bon enregistrement, sauf lors de la création de nouveaux enregistrements. |
Associer les champs de la table
Dans l'onglet Mappage, tous les champs sélectionnés s'affichent regroupés par table. L'association varie selon le type de table.
- Les champs de la table d'en-tête sont associés à une cellule unique dans la feuille.
- Les champs des tables de détail comportent plusieurs enregistrements et sont associés à une table plutôt qu'à des cellules individuelles.
Pour chaque table de détail, choisissez le mode d'association via les onglets Table existante, Nouvelle table ou Cellule.
Table existante
Sélectionnez la table dans la liste déroulante, puis utilisez les listes Colonne de table pour associer chaque champ à la colonne correspondante. Cliquez sur Enregistrer en bas de l'assistant pour appliquer.
Nouvelle table
Si la table n'existe pas encore dans le classeur, saisissez la référence de cellule où elle sera créée. Chaque champ affiche un Nom de libellé qui deviendra l'en-tête de colonne. Mettez à jour les libellés si nécessaire, puis cliquez sur Enregistrer pour créer la table et appliquer le mappage.
Cellule
Lorsqu'un champ de table de détail correspond à une valeur unique plutôt qu'à un tableau complet, saisissez la référence de cellule directement. Cette option s'utilise quand une formule NECWRITEBACK doit être placée par cellule, par ligne ou par feuille.
Exemple de mappage
Personnaliser les boutons
Sous Options, à droite de l'onglet Mappage, le bouton Writeback peut être ajouté à la feuille. Pour les boutons spécifiques à Nectari et Acumatica, utiliser l'Assistant de bouton d'action dans l'onglet Analyse. Activez les boutons voulus via le bouton bascule correspondant. Le bouton Writeback est le seul requis pour envoyer les modifications vers l'ERP.
- Bouton Writeback
- Bouton Initialiser
- Bouton Réinitialiser
- Boutons Acumatica
Bouton Writeback
Ce bouton déclenche l'envoi des modifications vers l'ERP. En cliquant dessus, toutes les formules NECWRITEBACK liées à ce bouton sont exécutées et leurs valeurs mappées sont transmises aux enregistrements correspondants dans l'ERP. Plusieurs formules peuvent être liées au même bouton, mais une formule ne peut être liée qu'à un seul bouton Writeback.
Le libellé et la couleur sont entièrement personnalisables. Quelques exemples :
- Développez Bouton Writeback.
- Activez Afficher le bouton.
- Saisissez ou sélectionnez la cellule où le bouton apparaîtra dans la feuille.
- (Facultatif) Modifiez le libellé par défaut.
- Choisissez une couleur via le sélecteur ou saisissez un code HEX directement.
- Vérifiez l'Aperçu pour confirmer l'apparence du bouton.
- Cliquez sur Enregistrer.
Lorsqu'un classeur contient plusieurs formules NECWRITEBACK, toutes peuvent être liées au même bouton. Configurez la première formule et placez le bouton dans une cellule, par exemple C34. Pour chaque formule supplémentaire, définissez la même cellule cible. Un seul clic exécute alors toutes les formules liées simultanément. C'est particulièrement utile pour les classeurs budgétaires où plusieurs champs doivent être envoyés ensemble.
Bouton Initialiser
Ce bouton crée une copie figée du classeur dans laquelle toutes les données extraites sont enregistrées comme valeurs fixes. L'assistant d'extraction est retiré de la copie : les données ne s'actualisent plus et les valeurs saisies manuellement sont préservées.
Le libellé et la couleur sont entièrement personnalisables. Quelques exemples :
Ce bouton se configure depuis l'Assistant de bouton d'action dans l'onglet Analyse.
Bouton Réinitialiser
Ce bouton restaure le classeur à son état d'ouverture et annule toutes les modifications effectuées depuis son chargement.
Le libellé et la couleur sont entièrement personnalisables. Quelques exemples :
Ce bouton se configure depuis l'Assistant de bouton d'action dans l'onglet Analyse.
Boutons Acumatica
Les boutons d'action Acumatica déclenchent des opérations spécifiques à Acumatica directement depuis le classeur, comme la création ou la validation d'entrées. Ils sont disponibles uniquement avec une source de données Acumatica.
Le libellé et la couleur sont entièrement personnalisables. Quelques exemples :
Ces boutons se configurent depuis l'Assistant de bouton d'action dans l'onglet Analyse.
Envoyer les modifications vers l'ERP
Une fois l'assistant configuré, cliquez sur le bouton Writeback dans le classeur pour envoyer toutes les valeurs mappées vers l'ERP. Un message de confirmation s'affiche à la fin de l'opération. La mise à jour peut aussi être confirmée en se connectant directement à l'ERP.
Lorsque l'option Résultats est activée, l'ERP renvoie une valeur dans la cellule configurée après l'opération. Par exemple, la création d'une écriture de journal renvoie le numéro de lot attribué par Acumatica.
Chaque formule NECWRITEBACK possède un état qui reflète sa situation dans la feuille.
| État | Signification |
|---|---|
| En attente | Formule créée, ou une cellule référencée a été modifiée. Revient à l'état En attente à chaque modification d'une cellule référencée, même si la formule était précédemment à l'état Écrit ou Erreur. |
| En cours | Exécution en cours. |
| Écrit | Opération terminée avec succès. |
| #Erreur : [ message ] | Échec de l'opération. Le message d'erreur indique la cause. |
Si le message Writeback completed with errors s'affiche, les valeurs des cellules mappées ne correspondent pas à ce qu'attend l'ERP. Vérifiez le mappage des champs et assurez-vous que le point de terminaison configuré dans la source de données correspond à celui de l'environnement ERP.