Image

Fonction La commande Image vous permet d’afficher des fichiers images dans les écrans R/3. Quel est l’intérêt d’avoir des images et des graphiques dans les écrans R/3? Il y a quatre raisons principales qui viennent à l’esprit: créer un contexte facilement reconnaissable, faciliter l’orientation dans l’écran, donner aux écrans une touche personnelle et agréable à utiliser et finalement parce que les images expriment une quantité d’informations, en particulier si le choix d’images se fait en fonction de certaines données.
Exemple Image (10,40) “C:\Images\logo.jpg”  

Le fichier image C:\Images\logo.jpg est affiché à la position (10,40), c.-à.-d. que le coin haut gauche de l’image est à la ligne 10, colonne 40.

Formats standards d’images supportés Les formats standards d’images suivants sont supportés: 
  • bmp
  • gif
  • jpg

On peut utiliser la règle suivante: utilisez le format bmp pour des petites images (par ex. icônes) et gif ou jpg pour des images plus grandes. 

Format
  • Image (ligne,colonne) “Nom du fichier image” 

Les coordonnées (ligne,colonne) sont celles du coin haut gauche de l’image. Elles peuvent être exprimées par des nombres décimaux pour positionner plus exactement l’image. L’image est affichée dans sa taille d’origine. Le fichier image est cherché dans le répertoire du scripte, à moins que la position exacte ne soit spécifiée, par ex.: “E:\pictures\logo1.bmp”. Les fichiers images sont stockées dans un buffer interne.

  • Image (ligne1,colonne1) (ligne2,colonne2) “Nom du fichier image” 

(ligne1,colonne1) désigne le coin haut gauche et (ligne2,colonne2) le coin bas droit de l’image. L’image va être étirée pour rentrer dans le rectangle défini, sans conserver ses proportions d’origine (voir option -NoStretch). 

Options supplémentaires
-NoStretch Conserve le rapport hauteur/largeur de l’image d’origine. 
-Plain Il n’y a pas de carde 3D affiché autour de l’image.
-NoBuffer L’image est rechargée à chaque affichage. Sans cette option, GuiXT mémorise les images dans la mémoire centrale et le système ne relit pas les fichiers à chaque fois.

Cette option est utile, lorsque les images sont actualisées et mises à disposition au fur et à mesure par des programmes externes (par exemple par le R/3 ou par périodes de temps régulières) et qu’elles doivent être affichées dans leur état actuel.

-Transparent Applicable pour des images .gif et .bmp 8-bit. L’image est affichée de manière transparente. Techniquement, la couleur du coin haut gauche de l’image est remplacée par la couleur de fond de l’écran R/3.
Images multiples Il est également possible d’afficher des images multiples avec la commande Image
. De cette manière, l’utilisateur peut faire défiler plusieurs images différentes en cliquant dessus avec la souris. 

Pour obtenir cet effet, il faut numéroter les images de façon séquentielle, par ex.: “img01.gif”, “img02.gif”, “img03.gif”. Vous pouvez ensuite utiliser la combinaison de caractères &# (ou &##, &###) dans le fichier image: 

Image (10,40) (16,65) “Image&##.gif” 

Le système substitue 1, 2, 3… (ou 01, 02, 03… ou 001, 002, 003…) à la place de &# (&##, &###), en incrémentant la valeur à chaque fois que l’utilisateur clique sur l’image avec la touche gauche de la souris ou en décrémentant la valeur à chaque fois que la touche droite de la souris est cliquée. 
Le curseur de la souris indique le numéro de l’image affichée.

Veuillez également vous reporter au Tutorial 6 de GuiXT Ajouter des images.

Images dépendantes de données Le fichier image peut contenir des variables qui seront remplacées par des valeurs avant l’affichage de l’image. Par ex.: 

Image (4,80) “C:\articles\img&F[article].jpg” 

Si l’utilisateur saisit un le numéro d’un article 00500187, le fichier image C:\articles\img00500187.jpg va être affiché. 

Veuillez également vous reporter au Tutorial 6 de GuiXT Ajouter des images.

Construction d’images dynamiques Quelques fois il n’est pas possible ou il n’est pas conseillé de stocker toutes les images dans le système local de fichiers. Dans ce cas, vous pouvez spécifier un fichier exe ou bat dans la commande Image qui va copier les fichiers images dans le répertoire local à partir d’une autre source: 

Image (ligne,colonne) “Nom du fichier image” exe=“nom du programme” 

Si le système ne trouve pas le fichier image, il va exécuter le programme bat ou exe avec pour premier paramètre le nom du fichier image. Après l’exécution du programme l’image va être affichée. Exemple d’une commande Image: 

Image (10,40) (18,74) “C:\tempimg\chart&F[compte]\&F[Date].gif” exe=“C:\prog\getchart.exe”

Interactions du R/3 basées sur des images En cliquant sur l’image, vous pouvez appeler des valeurs optionnelles de saisie dépendantes de l’utilisateur, elles seront simulées par le système R/3. Ceci est obtenu en ajoutant le paramètre supplémentaire Input=“string”: 

Image (ligne,colonne) “Nom du fichier image” Input=“string” 

  • Vous pouvez fixer des valeurs pour les champs de saisie R/3
  • Vous pouvez appeler des fonctions de menu

Les notations sont les suivantes: 

“Input=champ1:valeur1;champ2:valeur2;champ3:valeur3;OK:fcode“ 

La fonction code fcode peut, soit être un code interne obtenu par le menu d’écran, par ex.: SCMP, soit un code de transaction, par ex.: /NFB01 ou /OMM02. 

Vous trouvez les codes internes de menu de la façon suivante: choisissez la fonction désirée dans le menu de transaction et appuyez sur la touche F1 tout en pointant le curseur de la souris sur la fonction. Le code de fonction interne est alors affiché par le système R/3 dans une fenêtre (pop-up). 

La touche de confirmation (touche retour), sans aucun code spécial de fonction, peut être activée avec l’option OK à la fin de l’URL SAP: 

Input=“champ1:valeur1;champ2:valeur2;champ3:valeur3;OK“

Si vous utilisez GuiXT pour travailler avec un écran tactile, les fonctions spéciales suivantes seront utiles pour une navigation facile dans des contrôles SAP, par exemple un grid control. Vous pouvez représenter les touches flèches de votre clavier (avancer, reculer d’une ligne ou d’une page, début ou fin de liste) avec vos propres images et exécuter la fonction en utilisant l’option “Input=…”. Exemple:

Image (0,1) (3,8) “nextline.gif” Input=“X[Grid1]:<DOWN>” 

Les fonctions suivantes sont possibles:

  • <DOWN>  Curseur vers le bas
  • <UP> Curseur vers le haut
  • <LEFT>  Curseur vers la gauche
  • <RIGHT> Curseur vers la droite
  • <NEXT> Page vers le bas
  • <PRIOR> Page vers le haut
  • <END>  Fin
  • <HOME> Home
  • <BOTTOM>  Ctrl+End
  • <TOP>  Ctrl+Home
Lancer un InputScript En combinaison avec l’InputAssistant vous pouvez également lancer l’exécution d’un InputScript. Pour cela, il vous suffit d’ajouter la commande process= à l’argument OK:fcode.

Exemple:

Input=“champ1:valeur1;champ2:valeur2;champ3:valeur3;OK:fcode,process=affichermaterial.txt”

Les paramètres de “Using” peuvent être transmis à l’InputScript en utilisant la notation U[nom]:valeur. Vous pouvez également utiliser une variable interne de GuiXT en utilisant  V[nom]:valeur et utiliser cette valeur dans votre InputScript ou dans un scripte GuiXT.

Exemple 1 Input=“OK:PR03″ 

Cliquer sur l’image appellera la fonction PR03 du R/3.

Exemple 2 Input=“Article:00012345;Usine:0021;OK“ 

Cliquer sur l’image remplira les champs de saisie "Article" et "Usine" avec les valeurs. La touche de confirmation (touche retour) sera activée automatiquement.

Exécuter des applications de l’ordinateur personnel à partir d’images Vous pouvez exécuter des applications de votre ordinateur personnel en cliquant sur une image. Pour cela vous pouvez vous servir de l’option Start=“string”: 

Image (ligne,colonne) “fichier image” Start=“string” 

Avec cette option, vous pouvez

  • afficher des documents de différents types. Le type de document concerné doit être associé à une application dans Windows
  • exécuter des fichiers .exe ou .bat avec éventuellement l’indication de paramètres
Exemple 1 Start=“\\P00800\Doc12\me21.html” 

En cliquant sur l’image le fichier .html \\P00800\Doc12\me21.html sera affiché.

Exemple 2 Start=“C:\Program Fi
les\graph12.exe &F[Article]“

En cliquant sur l’image le programme C:\Program Files\graph12.exe sera exécuté avec pour paramètre le numéro de l'article.

Telefonie Vous pouvez passer un numéro de téléphone à la composante TAPI (“Telephony Application Programming Interface”, appels sortant), en utilisant le paramètre  dial=. 
Exemple

Image (10,24) “téléphone.gif” dial=“&F[numéro_de_tél.]“ 

Si TAPI est installé et configuré sur le poste, cliquer sur l’image initiera l’appel du numéro spécifié.

Afficher un fichier d’aide sous format html La composante “Viewer” est nécessaire pour cette option

En cliquant sur l’image, le fichier html indiqué par l’option ViewHelp=est affiché sur le côté droit de l’écran R/3. Ce fichier peut contenir des interactions avec le R/3, veuillez-vous reporter à la documentation de la commande View (Interactions avec le R/3). 

L’affichage de l’aide disparaît automatiquement lorsque l’utilisateur clique sur un champ de l’écran R/3.

Image (ligne,colonne) “Nom du fichier image” ViewHelp=“nomdefichier.html” 

Exemple Image (toolbar) “Aide.gif” ViewHelp=“doc_ordreint.htm“ 
Options pour ViewHelp 
ViewHelpWidth= Largeur de la fenêtre d’affichage de l’aide (en pixel). Si vous ne spécifiez pas de largeur, 40% de la largeur totale de la fenêtre est utilisée.
ViewHelpHeight= Hauteur de la fenêtre d’affichage de l’aide (en pixel). Si vous ne spécifiez pas de hauteur, 40% de la hauteur totale de la fenêtre est utilisée.
ViewHelpPosition= Position (coin en haut à gauche) de l’affichage de l’aide. Le format est de la forme (ligne, colonne), par ex.: ViewHelpPosition=(10,50), ou alors relative à des éléments d’écran, par ex.: ViewHelpPosition=”[Article]+(1,30)”.
Lorsque vous spécifiez une position mais pas de hauteur ou largeur, l’affichage se fait sur toute la fenêtre à partir de la position (vers le bas et à droite).
Exemple Image (toolbar) “Aide.gif” ViewHelp=“doc_ordreint.htm“  ViewHelpWidth=“200″
Dynamic text output 
Textstring= Un texte spécifié est affiché sur l’image.
Vous pouvez spécifier un changement de ligne en utilisant ”\n“. Exemple:
Textstring=“Première ligne\ndeuxième ligne\ntroisième ligne”
Options pour Textstring 
Textfont= Sélection du type de caractère. La valeur par défaut est “Arial” ou respectivement “Arial Unicode MS” dans un système unicode.
Textcolor= Sélection de la couleur du texte. La valeur par défaut est black (noir). Valeurs possibles: “red” (rouge), “blue” (bleu), “green” (vert), “white” (blanc), “black” (noir), “yellow” (jaune), ou “RGB(x,y,z)” où x,y,z représentent les valeurs RGB de la couleur.
Textheight= Sélection de la taille des caractères en pixel. La valeur par défaut est 10.
Textweight= Sélection de l’épaisseur des caractères entre 1 (fin) et 9 (épais). La valeur par défaut est 5. Gras est approximativement 7.
Textarea= Zone de l’image dans laquelle est dessiné le texte. Format: (x1,y1) or (x1,y1,x2,y2), en coordonnées pixel. Valeur par défaut: toute l’image. Lorsque vous spécifiez des nombres négatifs, le coin en bas à droite est pris comme référence. Exemples:
 … Textarea=(10,20)          // Offset (10,20) du coin en haut à gauche
 … Textarea=(-50,-50)        // un carré au coin en bas à droite, taille 50×50 pixels
 … Textarea=(30,50,-30,-50)  // zone au milieu de l’image
-textcenter Le texte est centré au milieu de la zone d’image spécifiée. Si le texte contient des indicateurs de retours de ligne “\n”, le texte est centré uniquement en horizontale.  
Exemple Image (1.1,0.5)  (10,20) “logon.gif” textstring=“&V[_database]“  textheight=“24″ textweight=“8″  textcolor=“”yellow”

Image