SAP - Overview du formulaire Adobe

Sharifah SYED YASINLe 8 Septembre 2011

1. Introduction2. Les pré-requis3. L’architecture d’un

formulaire4. Formulaire Adobe

Interface Contexte Mise-en-Forme Exemple du programme de

lancement

5. Web dynpro Le Web Dynpro Intégration avec le

formulaire Web Dynpro Code Wizard Les actions

6. Les points importants 7. Questions

2

Une solution de type « PDF » directement intégrée dans le système SAP

Deux types de PDF :

3

PDF de visualisation ( ou « print ») PDF interactif

Transaction utilisée pour créer un formulaire : « SFP »

• Les composants d’Adobe–Adobe Livecycle Designer – outil graphique pour la mise en page–Adobe Document Services (ADS) – un ensemble des services additionnels dans le système SAP• Exemple de services fournis par ADS:

– Générer des formulaires– Extraire des données à partir du formulaire– Gérer des droits des users

Les deux composants sont téléchargeables sur le site SAP Support Portals (Lien : https://websmp209.sap-ag.de/support)

–Adobe Reader – affichage et manipulation des formulairesLien : http://get.adobe.com/fr/reader/

4

Un formulaire est composé de deux parties : Interface et Formulaire La partie Formulaire est divisée en deux sous-parties : Contexte et

Mise-en-Forme

5

Partie Elément Fonctionnalité

Interface- Définir les données à inclure dans le formulaire- Initialiser les données

Formulaire

Contexte

- Spécifier les donnés qui seront utilisées dans la Mise-en-Forme- Fixer les conditions sur les données

Mise-en-Forme

- Définir la conception graphique du formulaire

• Elle est créée avec la transaction « SFP »• Sa création est obligatoire avant la création d’un formulaire • Il existe trois types d’interface :

– Basée sur ABAP (recommandée pour les formulaires de type « print »)

– Basée sur XML (recommandée pour les formulaires interactifs)– Basée sur SmartForm

6

Une interface peut être utilisée par plusieurs formulaires

ImportDéfinir les données récupérées à partir des tables du système SAP dans le formulaire à créer (par el biais de l’interface)

ExportDéfinir les données envoyées au système SAP depuis les champs saisies dans un formulaire interactif

ExceptionsDéfinir les exceptions en cas d’erreur, en retour sur le programme appelant. Elles viennent par défaut

7

Global Data

Déclaration des données globales (variantes, constantes, structures…) du formulaire, mais pas les tables

Possibilité de reprendre les structures de la partie « Types » pour créer une table interne

TypesDéfinir de nouvelles structures non existantes dans le système

Field Symbols Déclarer les pointeurs8

Code Initialization

Déterminer les paramètres d’entrée et paramètres de sortie (champs déclarés dans « Import » et « Export »

Initialiser les données (Comme « Initialization » dans un programme SAP)

Form RoutinesInsérer les fonctions que nous pouvons appeler depuis « Code Initialization »

9

Currency/Quantity Devise

Associer un montant à une devise.

Associer une quantité à une unité.

10

La partie « Formulaire » est composée de deux parties : Contexte et Mise-en-Forme

Elle est également créée avec la transaction « SFP » Un formulaire doit être basé sur une interface

11

Les éléments du contexte sont ceux qui seront utilisés pour la mise en forme

Par défaut aucun élément n’est dans le contexte, ils sont a ajouter depuis la partie interface (drag and drop)

12

Liste des données

récupérée depuis l’interface

Liste des éléments du contexte

Propriété des éléments dans l’interface

Propriété de l’élément choisi dans la liste

13

Ajout de conditions permet de vérifier les données avant qu’ils soient traitées et affichées

Les éléments graphiques sont ajoutés depuis la bibliothèque d’objet (drag and drop)

14

Editeur de script

Liste des éléments dans le formulaire

La bibliothèque d’objet (boutons, textes…)

La propriété d’un objet

Le lien entre un élément graphique et une donnée de contexte (un « binding ») permet de recevoir les informations depuis les tables SAP

15

Pour établir le lien, deux méthodes possibles :• Le définir dans l’onglet Liaison dans la palette « Objet »• Faire un glisser-déposer à partir de la palette « Vue des données » de la liste des données du formulaire

Il existe différents notations qui servent comme référence d’un élément ($record, # , ! , *….). En fonction de sa position dans le « Data View », la référence peut être +/- complexe

Les scripts permettent d’ajouter des traitements dynamiques tels que le calcul et la vérification des erreurs

16

Chaque script est associé à un objet et correspond à un événement spécifique (un click, enregistrement du formulaire…)

Deux langages de scripting utilisés dans Adobe LC:• FormCalc : langage propriétaire d’Adobe • Javascript : plus complexe mais plus complète

Pour afficher un formulaire, il faut lui créer un module fonction de lancement (Transaction SE38), dans notre exemple le formulaire sera de type « print »:

Récupération des données (Recherche des données dans SAP en fonction des paramètres du MF)

Recherche du module fonction associé au formulaire

Ouverture d’un spool Exécution du traitement du formulaire Fermeture du spool

17

1. Sélectionner les données à partir de table SAP et les enregistrer dans une table interne

2. Récupérer le nom du module de fonction à exécuter à partir du nom de formulaire (Ce module fonction est généré lors de la création d’un formulaire (SPF))

18

Nom du formulaire

Nom du MF récupéré

3. Définir les paramètres d’impression et ouvrir la tâche spool

4. Exécuter le module de fonction du formulaire

19

Paramètres du formulaire (import de l’interface)

5. Fermer la tâche de spool

20

Web Dynpro est la technologie propriétaire de SAP pour le développement des applications web

Elle existe en Java ou en ABAP

21

Un web dynpro est crée dans la transaction « SE80 »

Intégration d’un formulaire Adobe dans un web dynpro permet de l’ouvrir à partir d’un navigateur web

Il peut être : Un formulaire statique Un formulaire interactive

Les formulaires sont intégrés dans la vue de web dynpro

22

Un formulaire interactif fait partie des éléments graphiques proposés par le WDP

23

Aperçu d’une vue de web dynpro avec un élément graphique « formulaire interactif » intégré :

L’élément graphique Les propriétés de l’élément

La liste des éléments graphiques dans la vue

Les propriétés importants à renseigner pour un élément de type « Interactive Form » :

Nom Valeur à enseigner

templateSource Le nom du formulaire

dataSource Les données choisies à partir

du contexte (faire le « binding »)

enabledSi coché, le formulaire sera interactif, sinon formulaire

statique

pdfSourceUn attribut de type

« xstring » dans le contexte

Width/Height Largeur et hauteur

24

Deux façons de procéder :

Utiliser un formulaire existant Créer un nouveau formulaire à partir de web

dynpro

Si on crée un nouveau formulaire, on peut utiliser le contexte du web dynpro pour le formulaire

25

Aller chercher le contexte du WDP qui sera adapté au formulaire

26

L’éditeur du formulaire peut s’ouvrir également dans le Workbench (SE80)

C’est l’outil pour l’aide à l’insertion des codes

« Onglet Context»: les codes générés utilisent les données du

contexte

27

1) Choisir l’attribut de contexte

qui correspond

2) Choisir l’opération (lire ou définir la valeur)

Exemple du code généré

Onglet « General » : génère les codes pour fonctionnalités diverses

Exemple : Les codes générés pour naviguer entre deux vues

28

Les actions sont les événements déclenchés suite à des activités externes tels qu’un click, appui sur une touche de clavier et autres

Elles sont ajoutées pour améliorer l’utilisation du formulaire Exemple des actions :

Récupération et envoi des données Navigation entre les différents formulaires

Le comportement de l’action est défini dans sa méthode de « event handler »

L’ajout des codes dans les méthodes « event handler » est simplifié par le Code Wizard

29

Exemple des étapes du programme pour récupération de données :

30

Récupérer le numéro de cas litige souhaité à

partir de l’URL

Appeler le BAPI avec comme paramètre

d’entrée le numéro de cas litige

Remplir le contexte avec les données

récupérées grâce au BAPI

Afficher les données dans les champs du

formulaire

Formulaire Adobe SAP

Chaque application web dynpro est désignée par une URL

L’URL est générique et contient que le nom du web dynpro

31

Il est possible de rajouter les paramètres supplémentaires dans l’URL

URL générique

1. Ajouter les paramètres supplémentaires dans l’onglet « Parameters »

2. Définir les valeurs qui sont acceptées par ces paramètres dans la méthode « handledefault » de la fenêtre

32

Adobe Reader permet seulement l’affichage des formulaires L’ajout des autorisations spéciales Adobe

ReaderRights est nécessaire pour utiliser les fonctionnalités avancées tels que les formulaires interactifs et la signature électronique

Utilisation de l’ABAP objet et Javascript Web Dynpro utilise ABAP et ABAP objet dans le développement des

méthodes Les traitements dynamiques dans les formulaires sont inclus avec

Javascript

Utilisation de BAPI pour la manipulation d’un Business Object (ex: Cas Litige)

33

Liens : SAP Library

Interactive Forms by Adobe Web Dynpro ABAP

Documentation en ligne de LC Tutoriels : SAPTechnical.com