Formulaires SAP

Les objets jobs SAP vous permettent d'exécuter un certain nombre de fonctions SAP directement à partir de Automation Engine. Les formulaires sont des jeux de commandes prédéfinis qui répliquent ces fonctions. Grâce à l'interface utilisateur, vous pouvez créer des scripts pour des jobs SAP, sans avoir à vous inquiéter de leur format exact.

Cette rubrique contient les sujets suivants :

Conseil : Pour toute information sur la syntaxe de chaque élément de script SAP (commandes), voir Généralités sur le JCL SAP.

Présentation

Grâce à l'intégration dans les systèmes SAP, vous pouvez exécuter des jobs dans SAP, directement à partir de Automation Engine.

Votre système Automation Engine est connecté à SAP via l'agent SAP qui interprète et transforme les commandes envoyées par le client pour que SAP les comprenne. Cela signifie que les seuls prérequis pour que votre système puisse créer des jobs via Interface Web Automic et les exécuter dans le client SAP sont :

Une fois ces prérequis respectés, il vous suffit de créer les scripts à exécuter. Cela se fait dans la page Traitement de la définition d'objet du job SAP.

Compte tenu de la complexité des fonctions SAP, cela peut être fastidieux. C'est là que les formulaires SAP fournis par Automation Engine entrent en jeu. Ils constituent une façon supplémentaire et intuitive de créer des scripts pour les jobs SAP, via l'interface graphique qui fournit des commandes prêtes à l'emploi.

Autorisations requises

Pour établir la connexion au système SAP, l'agent SAP utilise les informations d'identification SAP (nom d'utilisateur, mot de passe et client) de l'objet connexion pour ABAP Basis. Pour pouvoir utiliser des formulaires SAP, il vous faut les autorisations suivantes :

Vues synchronisées - Éditeur de scripts / formulaire

La page Traitement des jobs SAP propose deux vues que vous pouvez activer / désactiver via les boutons se trouvant en haut de la page :

Les deux vues sont synchronisées. L'ajout d'une commande SAP via la vue Formulaire signifie que la ligne de code correspondante est simultanément écrite dans l'éditeur de script ; si vous renseignez ensuite les champs de ce formulaire, ces valeurs seront également écrites dans l'éditeur de script.

De même, la saisie ou l'édition d'éléments de script dans l'éditeur de script entraîne les modifications correspondantes dans le formulaire SAP.

Au lieu de saisir les valeurs dans les champs des formulaires SAP, vous pouvez utiliser des variables de scripts. Cela s'applique bien sûr également à la vue Éditeur de scripts.

Important !

Exemple

Vous voulez créer un script qui copie une variante de rapport. Grâce à la vue Formulaire SAP, il vous suffit d'ajouter la commande Copier une variante existante dans l'éditeur de script et de saisir les valeurs dans les champs de commande :

Écran de la Page Traitement d'un job SAP affichant la vue Formulaire.

Si vous passez à la vue Éditeur de scripts, l'instruction de script se présente ainsi :

Écran de la Page Traitement d'un job SAP affichant la vue Editeur de script avec les mêmes commandes que la vue Formulaire.

Bien sûr, la saisie ou l'édition d'éléments de script dans l'éditeur de script entraîne également les modifications correspondantes dans le formulaire SAP.

Paramètres par défaut n'apparaissant pas dans l'éditeur de scripts

De nombreux paramètres de commande ont une valeur par défaut. Si vous conservez cette valeur par défaut lors de la création de vos scripts, l'éditeur de scripts n'affiche pas ces paramètres.

Par exemple, dans le cas de la commande Copier une variante existante (R3_COPY_VARIANT), telle que celle utilisée dans l'exemple précédent, la valeur par défaut pour Protéger la variante est Non. Cela signifie que cette case n'est, par défaut, pas cochée. L'éditeur de script n'affiche pas ce paramètre.

Cependant, si vous le sélectionnez, autrement dit, si vous définissez une valeur différente de celle par défaut, l'éditeur de script l'inclura. Dans ce cas particulier, PROTECTED="YES" sera ajouté au script.

Combiner des commandes SAP avec des commande non-SAP

Lorsque vous créez des scripts pour des jobs SAP, vous souhaitez peut-être utiliser non seulement des commandes spécifiques à SAP, mais également Langage de script Automation Engine, par exemple. Vous pouvez saisir ces instructions dans l'éditeur de script.

Si vous le faites, puis que vous accédez à la vue Formulaire, les commandes non SAP sont grisées, afin de vous permettre de les reconnaître facilement.

Extraire des valeurs du système SAP cible

Avec une connexion active à un système SAP, il est possible d'extraire les valeurs permettant de renseigner les champs de saisie, listes déroulantes, etc. Cliquez sur le bouton de navigation lorsqu'il est disponible.

Cela ouvre une boîte de dialogue vous permettant de rechercher et d'extraire les données du client SAP pour les insérer dans vos scripts. Le contenu et l'apparence de cette boîte de dialogue dépendent de la nature des données dont vous avez besoin :

Dans les deux cas, les informations relatives à la connexion au système SAP s'affichent en bas de la boîte de dialogue.

Travailler avec le Gestionnaire de critères pour les Jobs R3 et ABAP

Avec le Gestionnaire de critères SAP, vous définissez les conditions et les critères pour les événements et les combinez avec les dépendances qui déterminent quels événements doivent être enregistrés. Pour construire ces conditions, reliez des options standards ABAP avec les opérateurs logiques ET et OU :

Graphique illustrant les dépendances ADD et OR dans le Gestionnaire de critères.

La combinaison de critères et de conditions est stockée dans le profil du critère.

Si vous avez reçu le droit Gestionnaire de critères SAP dans votre définition d'utilisateur et si la connexion au système SAP est active, la vue Formulaire des jobs R3 et ABAP contient un bouton supplémentaire Gestionnaire de critères dans la barre d'outils. Ce bouton fournit un accès direct au Gestionnaire de critères dans votre système SAP et vous permet de faire les choses suivantes directement depuis l'Automation Engine :

Important ! Les versions d'interface inférieures à XBP3.0 ne sont pas supportées.

Travailler avec le dialogue de profils des critères

Ce graphique fournit une courte description du dialogue des profils des critères.

Écran de la boîte de dialogue du Gestionnaire de critères avec brève description de ses éléments.

Filtrer les profils affichés dans la liste

  1. Cliquez le bouton Filtrer de la barre d'outils dans le dialogue Profils des critères pour ouvrir un panneau sur le côté droit affichant toutes les possibilités de critères.
  2. Vous pouvez restreindre les profils à un Type particulier.
  3. Vous pouvez saisir une Description ou une partie d'une description. Le champ utilise des caractères génériques au début et à la fin de la chaîne de caractères que vous saisissez. Par exemple, saisir DB_BACKUP déclenche en réalité le filtre pour *DB_BACKUP*.

  4. Par défaut, le filtre Fenêtre horaire est défini à Pas de fenêtre horaire. Si vous souhaitez restreindre les profils affichés à ceux modifiés en dernier dans une période de temps spécifique, ouvrez la liste déroulante et sélectionnez Fenêtre horaire.

    Procédez selon l'une des méthodes suivantes

    • Activez De/À et sélectionnez la fenêtre horaire :

      1. Saisissez la date et l'heure ou cliquez sur l'icône pour ouvrir la vue de calendrier.
      2. Utilisez les flèches situées en haut de la vue de calendrier pour sélectionner le mois.
      3. Cliquez sur la date.
      4. Utilisez les boutons se trouvant en bas de la vue du calendrier pour spécifier une heure.
      5. Procédez de la même manière pour définir la fin de la période.
    • Activez Dernier et spécifiez le début de la période. L'heure de fin est toujours l'heure actuelle.
  5. Cliquez sur le bouton Filtre pour l'appliquer.

Une fois que vous avez filtré le contenu de la liste vous pouvez désactiver le Filtre et laisser plus de place pour les panneaux restants.

Ajouter, supprimer ou dupliquer des profils

Activer/désactiver des profils

Sélectionnez un profil dans la liste et cliquez Activer/Désactiver dans la barre d'outils. Les profils activés affichent une case cochée dans la colonne Statut. Il ne peut y avoir qu'un seul profil actif par type.

Ajouter, supprimer ou renommer des noeuds/critères pour un profil

Définir les champs et les valeurs pour le critère

Le Gestionnaire de critères et le Script CA Automic

Langage de script Automation Engine fournit des éléments associés au Gestionnaire de critères SAP. Consultez Généralités sur le JCL SAP pour une vue d'ensemble ainsi que les sujets suivants pour des descriptions détaillées des commandes disponibles :

Voir aussi Jobs interceptés.

Travailler avec la vue Formulaire SAP

Ajouter des commandes au script

  1. Ouvrez la page Traitement de l'objet job SAP.

  2. Cliquez sur le bouton Formulaire pour activer la vue Formulaire.

    Le volet Commandes apparaît à droite. C'est là que vous créez le script SAP en utilisant les commandes prédéfinies.

  3. Cliquez sur Ajouter commande pour ouvrir une boîte de dialogue affichant toutes les commandes disponibles, organisées par groupes.

  4. Sélectionnez celle qu'il vous faut. Vous avez deux options :

    • Faire dérouler la liste et développer le groupe de commandes où se trouve celle qui vous intéresse.

    • Dans le champ Recherche en haut de la boîte de dialogue, commencez à écrire n'importe quel mot contenu dans le nom de la commande qui vous intéresse. La liste en dessous affiche les commandes dont le nom contient la chaîne de caractères saisie.

  5. Cliquez sur le bouton Ajouter commande en bas de la boîte de dialogue.

    La commande est insérée dans le volet et les champs de sélection et de saisie correspondants s'affichent sur la page principale.

  6. Renseignez les champs selon vos besoins.

    Avec une connexion active, vous pouvez extraire les valeurs du système SAP. Pour cela, cliquez sur le navigateur lorsqu'il est disponible.

  7. Continuez à ajouter des commandes et à saisir des valeurs, jusqu'à ce que vous ayez terminé le script.
  8. Enregistrez vos modifications.

Accédez à la vue Éditeur de script ; les commandes et valeurs que vous avez spécifiées y sont également insérées.

Dupliquer des commandes

  1. Dans le volet Commandes, faites un clic droit sur la commande que vous souhaitez dupliquer.
  2. Un menu contextuel apparaît. Sélectionnez Dupliquer.
  3. La nouvelle commande dupliquée est immédiatement insérée sous l'originale. Tous les paramètres et sélections de la commande d'origine sont également disponibles dans la nouvelle.
  4. Enregistrez vos modifications.

Supprimer des commandes

Dans le volet Commandes, procédez selon l'une des méthodes suivantes :

Modifier l'ordre des éléments de scripts / commandes dans le script

La vue Formulaire permet de réorganiser l'ordre des commandes, qu'elles soient ou non spécifiques à SAP, et de les déplacer. Les commandes de l'éditeur de script sont réorganisées en conséquence.

  1. Dans le volet Commandes, cliquez sur une commande ou une instruction non SAP pour la sélectionner.
  2. Maintenez le bouton de la souris et faites la glisser vers la position souhaitée.
  3. Enregistrez vos modifications.

Importer les jobs /steps de job existants depuis SAP dans le script actuel

Lorsque vous construisez un script, vous pouvez importer le code qui est déjà disponible dans les jobs dans le système SAP.

  1. Sélectionnez la commande après laquelle vous souhaitez insérer les steps de job que vous souhaitez importer.
  2. Dans le panneau Commandes, cliquez le bouton Importer job.
  3. Le dialogue Sélectionner nom du job est affiché, où vous pouvez rechercher le job souhaité.
  4. Cliquez sur OK.
  5. Les commandes nécessaires sont insérées immédiatement après la commande sélectionnée. Le panneau de Recherche sur la droite vous permet de filtrer et restreindre le nombre de jobs qui sont affichées dans la liste.
  6. Sélectionnez le job approprié et cliquez Choisir pour fermer le dialogue.

Les lignes de code importées sont insérées tout de suite après la commande que vous avez sélectionnée, à la fois dans le script et dans la vue Formulaires.

AE JCL pour SAP

Voir aussi :