Académique Documents
Professionnel Documents
Culture Documents
Version 7
© 2013 Sage
Composition du progiciel
Votre progiciel est composé d'un boîtier de rangement comprenant :
• le dvd sur lequel est enregistré le programme,
• la documentation électronique, présente sur le dvd.
Evolution
La documentation correspond à la version référencée. Entre deux versions, des
mises à jour du logiciel peuvent être opérées sans modification de la documenta-
tion. Toutefois, un additif peut être joint à la documentation existante pour présen-
ter les modifications et améliorations apportées à ces mises à jour.
SAGE SAS - Société par Actions Simplifiée au capital social de 500.000 euros
Siège social : le Colisée II, 10 rue Fructidor 75834 Paris Cedex 17
R.C.S. Paris 313 966 129 - Code APE 5829C.
La société Sage est locataire gérante des sociétés Sage FDC, Euratec, Ciel,
Adonix et XRT.
© 2013 Sage
Sommaire
Sommaire
Sommaire ________________________________________________ 1
Pré-requis ________________________________________________ 2
Définitions ________________________________________________ 3
© 2013 Sage 1
Pré-requis
Pré-requis
Le Complément Sage FRP pour Excel est validé avec Excel 2007, 2010 et 2013 en version 32
bits et Excel 2010 et 2013 en version 64 bits. Il ne fonctionne pas avec les versions
précédentes.
Il est disponible uniquement en Français.
Lors de l’installation du Complément Excel, un contrôle des éléments nécessaires à son
fonctionnement est effectué et les éléments manquants sont proposés à l’installation.
Office2007 PIA
.NET framework redistributable.
VSTO Runtime
© 2013 Sage 2
Définitions
Définitions
Il s’agit d’une instance du programme « Serveur1000 » qui permet de travailler (en liaison
avec un serveur Web) en client léger.
Lors de son paramétrage, on renseigne une application Sage FRP (trésorerie,
comptabilité…).
Service métier
Il s’agit d’un service exposé par un service Sage FRP, dans le cadre d’une application Sage
FRP, sous forme de Web service.
Ce service peut être basé sur une requête ou bien sur une classe de service local (DSM).
Complément Excel
Le Complément Excel est un programme qui ne peut pas être lancé directement.
Il se greffe sur Excel et interagit avec lui.
© 2013 Sage 3
Le Complément Excel
Le Complément Excel
Le Complément Sage FRP pour Excel 2007 et 2010 permet de manipuler dans Excel des
opérations de services métiers.
Les fonctions Excel créées peuvent être regroupées en catégories.
© 2013 Sage 4
Installation du complément Excel
© 2013 Sage 5
Installation du complément Excel
Si vous avez déjà installé une version du Complément Sage FRP pour Excel 2007 / 2010,
avant de procéder à l’installation, vous devez :
© 2013 Sage 6
Installation du complément Excel
© 2013 Sage 7
Installation du complément Excel
© 2013 Sage 8
Réaliser des requêtes à utiliser avec Excel
Sur la requête que vous désirez publier, cochez l’attribut « Publier comme Web service »
(pour visualiser cette option, la fonction d’affichage « Avancé » doit être sélectionnée).
La requête est immédiatement disponible comme service métier et peut être récupérée
dans Excel par la fonction de référencement d’un service métier.
© 2013 Sage 9
Référencer un service métier
La fenêtre affiche les services Sage FRP existants, choisissez le service qui propose les
services désirés.
Une fois que le service Sage FRP est sélectionné, la liste des services métiers disponibles
apparaît.
L’exploration des services utilise une mécanique de diffusion générale. Il est possible que la
configuration de votre réseau interdise cette pratique. Il faut alors paramétrer les éléments
manuellement dans l’onglet « Avancé ».
© 2013 Sage 10
Référencer un service métier
Catégorie
Chaîne libre permettant un regroupement des fonctions qui permettra de les trouver plus
facilement dans la liste des fonctions disponibles.
Si vous avez plusieurs sociétés et un service est créé par société, pour utiliser plusieurs fois
le même service métier, il faut préfixer les fonctions afin de les rendre uniques.
Il est conseillé de placer tous les dossiers dans le service Sage FRP.
© 2013 Sage 11
Référencer un service métier
© 2013 Sage 12
Voir les services métiers référencés
Vous pouvez visualiser les services disponibles par la fonction « Voir les services métier
référencés ».
Désactiver
Le service devient inactif, les fonctions qui lui sont liées ne sont plus disponibles. Il est
possible de le réactiver par la suite.
Supprimer
Le service est supprimé physiquement du référencement d’Excel, les fonctions qui lui sont
liées ne sont plus disponibles.
© 2013 Sage 13
Voir les services métiers référencés
Des exemples de feuilles Excel, qui utilisent les services métiers, sont proposés.
Pour en savoir plus, reportez-vous au chapitre sur les exemples de feuilles Excel fournis.
Les classeurs sont liés à un groupe de classeurs Excel créé dans la Console d’administration
(\Objets\Groupes de classeurs Excel).
© 2013 Sage 14
Paramétrer les sessions
L’authentification
Lors d’un appel à un service réclamant une authentification, la fenêtre suivante apparaît :
Les informations saisies sont enregistrées dans la feuille Excel. Ainsi, si la session sur le
serveur expire, seul le mot de passe est demandé.
L’adresse IP de l’ordinateur est identifiée pour n’utiliser qu’une connexion par poste, même si
plusieurs services sont ouverts.
© 2013 Sage 15
Paramétrer les sessions
Paramétrage
L’authentification permet d’obtenir un contexte de session.
Ce contexte peut être propre à :
une session par classeur : le classeur peut référencer une session valable
pour tous les onglets qu’il contient.
une session par onglet : chaque onglet peut avoir sa propre session et
permettre de travailler avec une société par onglet.
© 2013 Sage 16
Paramétrer les sessions
Contexte de partage
Cette option n’apparaît que dans le cadre du mono-base multi-sociétés. Elle liste les
sociétés restituées. L’authentification permet de définir le contexte de partage.
Déconnecter
Supprime le contexte de session, entraine une nouvelle authentification.
© 2013 Sage 17
Création automatique des services métiers
Lors de l’ouverture d’une feuille qui utilise des services métiers, le Complément Excel
vérifie que ces services métiers sont présents sur le poste.
Si ce n’est pas le cas, il propose de les créer automatiquement.
Si, lors de la création du service, l’hôte n’est pas trouvé (cas des feuilles livrées), il est
nécessaire de le renseigner.
© 2013 Sage 18
Voir les classeurs disponibles
Classeurs disponibles
Référencer un nouveau classeur
Session de référencement
Classeurs disponibles
© 2013 Sage 19
Voir les classeurs disponibles
Les classeurs sont liés à un groupe de classeurs Excel créé dans la Console d’administration
(\Objets\Groupes de classeurs Excel).
Vous avez également la possibilité de partager vos classeurs Excel avec les utilisateurs.
Cet onglet vous permet de rattacher le classeur concerné et de l’affecter à un groupe de
classeurs.
Session de référencement
© 2013 Sage 20
Voir les classeurs disponibles
Fonction « AdresseEcran »
La fonction « AdresseEcran », fournie avec le Complément Excel, permet l’ouverture
d’écrans de l’application Sage.
Par exemple, dans le document « Bilan – Actif », cette fonction est posée sur les codes des
rubriques.
Bouton « Détail »
© 2013 Sage 21
Recalculer tout
Recalculer tout
Le bouton « Recalculer tout » lance le calcul des requêtes et actualise les tableaux croisés
dynamiques.
© 2013 Sage 22
Recalculer tout
Vous trouverez des feuilles Excel qui utilisent des services métiers tel que pour la Gestion
Comptable et Financière :
le Bilan (Actif, Passif),
le Compte de résultat.
Les soldes intermédiaires de gestion
En multi-sociétés mono-base, pour obtenir un résultat cohérent sur ces feuilles, il faut
que les sociétés agrégées aient le même exercice social avec les mêmes périodes.
Certains exemples s’appuient sur des requêtes et d’autres sur des Web services.
Ces exemples vous permettront de vous familiariser avec cette fonctionnalité.
Pour les tableaux croisés dynamiques, pensez à effectuer l’actualisation après la mise à
jour de vos données (Voir le Bouton « Recalculer tout »).
© 2013 Sage 23
Recalculer tout
depuis Excel, par l’onglet Compléments \ bouton Voir les classeurs disponibles
\ onglet Classeurs disponibles. même si Sage Gestion Comptable et Financière n’a
pas été installé sur le poste.
© 2013 Sage 24
Les classeurs Excel
Les classeurs sont disponibles dans le Complément Excel, par les boutons Voir les services
métier référencés et dans Voir les classeurs disponibles.
© 2013 Sage 25
Les classeurs Excel
Les classeurs Excel supportent ainsi des droits d’accès définis par groupe d’utilisateurs.
© 2013 Sage 26
Les classeurs Excel
Les propriétés du menu contextuel d’un classeur permettent d’en connaître son Auteur et
sa date de création.
© 2013 Sage 27
Les classeurs Excel
© 2013 Sage 28
Solutions aux problèmes connus
Problème
Le service métier est créé mais certaines fonctions n’apparaissent pas.
Raison
La somme de la longueur des paramètres de la fonction ne doit pas excéder 255
caractères.
Solution
Modifier le service métier afin de respecter cette règle.
Problème
Un message « Echec d’ouverture » apparaît lors de l’appel de certaines fonctions.
Raison
L’exécution de la requête a échoué, probablement en raison des paramètres passés.
Solution
Modifier les paramètres passés à la fonction.
Problème
Un message d’erreur indique que le message passé au serveur n’est pas conforme.
Raison
Un service métier est une image d’un contrat à l’instant où on le crée. Si la requête sur
laquelle il est basé est modifiée, le contrat est rompu et les messages passés ne sont
plus conformes.
Solution
Supprimer puis re-référencer le service métier dans Excel.
© 2013 Sage 29
Conseils de réalisation de requêtes/services
Nous vous conseillons de ne pas utiliser les fonctions avec une mise en forme tableau car,
selon le paramétrage d’Excel, la fonction est répliquée dans chaque cellule et le temps
d’exécution peut être très important.
Référencement du même service avec plusieurs hôtes (vous avez plusieurs sociétés et
vous avez créé un service par société)
© 2013 Sage 30
Paramétrage de la fonction « AdresseEcran »
AdresseEcran : cette fonction permet d’ouvrir un écran dans une application Sage.
© 2013 Sage 31
Paramétrage de la fonction « AdresseEcran »
Exemple :
Ouvrir l’écran de l’application « Ecompta_ConsultationRubriqueCompte.dfm »
avec informations sur chacun des arguments qui le compose.
© 2013 Sage 32
Paramétrage de la fonction « AdresseEcran »
Dans notre exemple, pour ouvrir l’écran sur l’onglet « Résultat » avec les informations
actualisées sur la devise de reporting et le choix de l’établissement « PRS »,
les arguments de l’écran à exploiter sont :
◊ Arg_TypeDevise
◊ Arg_OidEtablissement
◊ Arg_AutoRefresh
◊ Arg_Onglet
1 pour reporting
2 pour transaction
Si aucune valeur n’est renseignée, par défaut, l’écran s’ouvre sur la devise de tenue de
compte « TC » correspondant à la valeur « 0 ».
Pour Arg_OidEtablissement,
il faut envoyer l’Oid de l’établissement.
Pour l’établissement « PRS », il faut saisir « 2D01D50CF5BF00300019000000020005 ».
© 2013 Sage 33
Paramétrage de la fonction « AdresseEcran »
Dans l’exemple, nous indiquons « TRUE » pour lancer, à l’ouverture de l’écran, une
actualisation des données renseignées.
◊ « SELECTION »
◊ « RESULTAT »
Si aucune valeur n’est renseignée, par défaut, l’écran s’ouvre sur l’onglet
« Sélection ».
© 2013 Sage 34
Paramétrage de la fonction « AdresseEcran »
Avec cette formule et le programme Complément Excel pour Sage installé, l’utilisateur
verra « AB » dans la cellule et pourra ouvrir l’écran correspondant avec le bouton Détail de
l’onglet Complément de Microsoft Excel.
© 2013 Sage 35
Configuration de IIS pour les Web Services (server)
L’erreur doit donc être détaillée : si elle est personnalisée, IIS rajoute du code html et le
client SOAP ne comprend plus la réponse, il affiche alors le message :
© 2013 Sage 36