Créer et exécuter un job SAP ABAP depuis Automation Engine

Un utilisateurDans Automation Engine, un utilisateur se réfère à une instance d'un objet utilisateur, mais c'est en général une personne qui travaille avec les produits Automic. Chaque utilisateur a son identifiant et un ensemble de droits d'accès aux différentes parties du système Automation Engine et à la suite de produits. Ces droits d'accès se présentent sous la forme d'autorisations et de privilèges dans Automation Engine, de rôles utilisateurs dans Decision, de droits EventBase et de droits des objets pour l'application Web ARA. Vous pouvez les gérer en central avec les fonctions de gestion des utilisateurs d'AWI. Reportez-vous aussi à la gestion des droits des utilisateurs. Automic Workload Automation veut créer un job SAP (JOBS) pour exécuter un programme ABAP par lots à partir de Automation EngineCe composant commande un système Automation Engine. Il se compose de plusieurs processus serveur., sans avoir à changer pour le clientEnvironnement indépendant pour la création et l'exécution d'objets dans un système AE. Le nom d'un client est un nombre de quatre chiffres à saisir lors de la connexion d'un utilisateur au système AE. Les utilisateurs et leurs droits y sont aussi définis.Egalement un type d'objet distinct dans l'Automation Engine. SAP.

Que traite ce cas d'application ?

Ce cas d'applicationUne application est un logiciel qui aide l'utilisateur à réaliser des tâches spécifiques. Dans un environnement ARA, voir aussi : Entité d'application. décrit les objets, les paramètres d'objets et les étapes à effectuer pour pouvoir créer un job SAP, l'exécuter sur le client SAP et accéder aux détails de son exécutionDurée d'exécution d'une Tâche. C'est la période entre le début et la fin de la Tâche. La période d'activation n'en fait pas partie (voir aussi Activation et Démarrage). sans quitter Automation Engine.

Conditions préalables

Exécuter des jobs SAP avec succès

Ce cas d'application explique en détails comment procéder, ainsi que les paramètres nécessaires.

Pourquoi un objet Login est-il nécessaire ?

Lors de l'exécution d'un job SAP dans Automation Engine, un job est créé à distance dans le système SAP cible. La connexion entre les deux systèmes est établie grâce aux informations d'identification saisies dans l'objet connexion (voir description détaillée ci-après) affecté à l'agent.

Le job du système SAP a deux utilisateurs :

Le job SAP (JOBS) de Automation Engine, d'un autre côté, contient les informations d'identification définies dans l'objet Login lui ayant été affecté. L'option permettant de remplacer les informations de login de l'agent par celles du job que vous pouvez sélectionner lorsque vous définissez les attributs de jobs, remplace les informations d'identification de la connexion par celles spécifiées dans l'objet Login. Cela simplifie l'identification et le suivi des processus, les procédures de dépannage, etc.

Le graphique ci-dessous illustre ceci :

 

Cas d'application Acteurs

Vue d'ensemble

La liste ci-après vous donne un aperçu des étapes à suivre :

  1. Installer les fichiers binaires de l'agent et configurer le fichier INI.
  2. Créer l'agent SAP.
  3. Accorder à l'agent SAP les droits nécessaires.
  4. Créer un objet connexion.
  5. Affecter l'objet connexion à l'agent SAP.
  6. Créer l'objet Login permettant au job d'accéder au client SAP.
  7. Créer le job SAP.
  8. Exécuter le job.
  9. Vérifier les résultats.

Définir un job SAP devant exécuter un programme ABAP par lots et l'exécuter

  1. S'assurer que les fichiers binaires de l'agent sont installés et que le fichier INI est configuré pour la connexion à Automation Engine.

    Votre administrateur système a probablement déjà pris soin d'installer correctement l'agent et de le configurer. Par souci d'exhaustivité, vous trouverez ici un récapitulatif de tout ce qui doit être installé et configuré pour établir la connexion entre Automation Engine et le système SAP :

    1. Installer les fichiers binaires de l'agent dans la structure de dossiers recommandée.

    2. Adapter le fichier de configurationUn ensemble de composants qui constituent un système. Ceci comprend des informations relatives à la manière dont les composants sont connectés, ainsi que les paramètres appliqués. pour que l'agent puisse se connecter à Automation Engine.
    3. Télécharger le JCO (Java Connector) SAP version 3 à partir des pages de téléchargement SAP et l'installer dans le même répertoire que celui des fichiers binaires de l'agent.
    4. Installer le Service Manager ou étendre sa définition pour permettre le démarrage / l'arrêt de l'agent à distance.
  2. Créer ou mettre à jour un agent SAP.

    Une fois les fichiers binaires de l'agent installés, Automation Engine crée l'objet agent automatiquement si ce n'est pas déjà fait. Il est bien sûr également possible de créer d'abord l'objet agent, puis d'installer les fichiers binaires.

    L'agent SAP interprète et transforme les commandes envoyées par le client Automation Engine pour que SAP les comprenne.

    1. Connectez-vous au client 0 dans votre système Automation Engine. Les agents ne peuvent être créés que dans le client 0.
    2. Accédez à la perspectiveVolet fonctionnel propre de l'interface Web Automic (AWI). Conception des processus et sélectionnez le bouton Ajouter objet de la barre d'outils ou faites un clic droit à n'importe quel endroit de la liste pour sélectionner Ajouter objet.

    3. La boîte de dialogue Ajouter objet s'affiche.

      Automic fournit des modèlesWorflows (flux de travaux) prédéfinis pour des composants / tâches spécifiques (ex. : Tomcat, SubVersion). pour créer l'agent pour tous les systèmes cibles auxquels Automation Engine peut se connecter. Pour sélectionner le modèle SAP, procédez selon l'une des méthodes suivantes :

      • Développez la liste déroulante Agent (AGENT) et faites-la défiler pour sélectionner Agent R3.
      • Saisissez R3 dans le champ Rechercher (en haut de la boîte de dialogue), puis sélectionnez Agent R3 dans la liste de résultats du bas.

      Par exemple :

    4. Cliquez sur le bouton Ajouter objet.

      Le nouvel objet est immédiatement créé dans la base de donnéesUne base de données est un ensemble organisé de données qui comprend plusieurs structures de données pertinentes.. Automation Engine lui attribue un nom unique composé d'un préfixe indiquant le type d'objetA chaque activité correspond un objet: Agent, Notification, Utilisateur, Groupe Utilisateur, Cockpit, Table de Codes, Documentation, Evènement, Transfert de Fichier, Groupe, Include, Job, Workflow, Calendrier, Login, Client, RemoteTaskManager, Schedule, Script, Serveur, Sync, Variable et Fuseau horaire., suivi de NEW et d'un nombre.

    5. La boîte de dialogue Renommer l'objet s'ouvre en affichant le nom proposé. Vous pouvez le conserver ou le modifier en fonction des conventions de nommage de votre société. Après cela, cliquez sur le bouton Renommer.

    6. Les pages de définition de l'agent s'affichent.

      Certaines de ces pages sont communes, autrement dit, toujours accessibles, quel que soit le type d'objet créé. Pour notre cas d'application, il n'est pas nécessaire de saisir des données dans ces pages, mais vous pouvez lire les informations les concernant ici : Page Général, Page Autorisations et Page Documentation.

  3. Accordez à l'agent que vous venez de créer les droits nécessaires dans le client qui va exécuter le job.

    Après avoir renommé l'objet, il s'ouvre en se focalisant sur la page de définition principale qui, dans le cas présent est Agent.

    La moitié supérieure de la page affiche la liste des clients disponibles dans votre système. Vous pouvez accorder ici au nouvel agent les droits que vous estimez appropriés pour le client sur lequel il exécutera les jobs.

    Dans le cas d'application présent, nous utiliserons le client 100.

    1. Cochez les cases Lire, Écrire et Exécuter :

      Cliquez pour développer

    2. Enregistrez vos modifications.

    L'agent est désormais actif. Accédez à la perspective Administration vous permettant de le vérifier et de l'éditer :

    Cliquez pour développer

  4. Créer un objet connexion (CONN)

    Il faut le créer dans le client 0.

    Cet objet fournit les données de connexion au serveur de l'application SAP , ainsi que les paramètres de login SAP (client, utilisateur et mot de passeProduit(s) : AE, SNSC. Une combinaison secrète de caractères pour un utilisateur Automation Engine. SAP). Cela permet à l'agent de se connecter dans le système SAP au démarrage.

    Puisque nous configurons tout ce dont nous avons besoin pour travailler avec des jobs SAP ABAP, le type de connexion dont nous avons besoin est R3/Remote Function Call :

    1. Accédez à la perspective Conception des processus et ajoutez un objet connexion de type R3.
    2. La définition de Connexion R3 comprend diverses pages.

      Dans notre exemple, il n'est pas nécessaire de saisir des données dans les pages communes, mais vous pouvez lire les informations les concernant ici : Page Général, Page Autorisations, Page Gestion des versions et Page Documentation.

    3. Dans la page Connexion R3, saisissez les donnez de connexion au serveur d'application SAP dans la section Paramètre de connexion.
    4. Saisissez les données de login (client, utilisateur et mot de passe SAP) dans la section Paramètre d'identification.
    5. Enregistrez vos modifications.

    C'est tout ce dont vous besoin pour établir la connexion : tous les autres champs sont optionnels.

    Cliquez pour développer

  5. Affecter l'objet connexion à l'agent SAP.

    Maintenant que la connexion et l'agent sont définis, vous pouvez les connecter.

    Accédez à la perspective Administration et ouvrez l'agent que vous venez de définir. Dans la moitié inférieure de la page, affectez-lui l'objet connexion que vous venez de créer :

    Cliquez pour développer

    Enregistrez vos modifications.

    L'agent est désormais connecté à votre client SAP.

  6. Créer l'objet Login

    L'objet que vous créez dans Automation Engine et que vous souhaitez exécuter dans le client SAP aura besoin d'un objet Login contenant les informations d'identification de l'utilisateur SAP sous lequel il sera exécuté dans le système SAP.

    Vous devez créer l'objet Login contenant ces données dans le même client que celui où vous créez le job. Dans ce cas, il s'agit du client 100 ; c'est celui auquel vous avez accordé les droits nécessaires à l'exécution des jobs.

    Pensez-y ! Plus tard, lorsque vous définirez le job SAP, vous pourrez activer l'option Remplacer les informations de login de l'agent par celles du job pour utiliser les informations d'identification définies ici pour vous connecter au système SAP, à la place du login de l'agent.

    1. Accédez à la perspective Conception des processus et ajoutez un objet Login. La page de définition principale du Login se présente ainsi :

      Cliquez pour développer

    2. Cliquez sur Ajouter une nouvelle ligne dans la barre d'outils pour ajouter une nouvelle ligne.
    3. Dans la cellule Agent / Nom, saisissez le nom de l'agent pour lequel les informations de login s'appliqueront. Procédez selon l'une des méthodes suivantes :

      • Sélectionnez un agent existant dans la liste déroulante.

        La cellule Type adjacente affiche automatiquement la plateforme de l'agent.

      • Saisissez le nom de l'agent (ou une partie de ce dernier).

        S'il existe déjà, la fonction de recherche dynamique affiche les résultats immédiatement.

      • Saisissez "*" pour appliquer ce login à tous les agents du même type.

    4. Dans la liste déroulante Type, sélectionnez la plateforme de l'agent, qui est R3 dans le cas présent.
    5. Dans les champs Nom d'utilisateur / ID et Mot de passe, saisissez les informations d'identification définies dans le système SAP avec lequel le job sera exécuté.
    6. Enregistrez vos modifications.
  7. Créer un job SAP ABAP

    Créez le job. Nous allons maintenant nous focaliser sur les détails concernant les divers paramètres que vous pouvez définir pour un objet jobs SAP; pour notre exemple, nous nous concentrerons sur les paramètres de base de données nécessaires à son traitement dans votre système SAP, depuis Automation Engine.

    1. Dans la perspective Conception des processus, cliquez sur Ajouter objet. Dans la boîte de dialogue, descendez pour développer la liste JobTraitement sur un système cible. Egalement un type d'objet distinct dans l'Automation Engine. (JOBS) et sélectionnez le modèle SAP_ABAP Job.
    2. Saisissez un nom et cliquez sur Ajouter objet.
    3. Les pages de définition Job SAP s'ouvrent en affichant celle de SAP. Vous devez décider si vous souhaitez utiliser les informations d'identification de Login pour que l'agent puisse se connecter au système SAP et exécuter le job.

    4. Accédez à la page Traitement et saisissez-y votre scriptEgalement un type d'objet distinct dans l'Automation Engine.. Vous pouvez soit utiliser l'éditeur de script, soit la vue Formulaire. Par exemple :

      Cliquez pour développer

    5. Accédez à la page Attributs.
    6. Spécifiez les paramètres d'exécution. C'est là que vous définissez la relation entre le job, l'agent qui se connectera au client SAP concerné et l'objet Login contenant les informations d'identification :

      Cliquez pour développer

      Vous pouvez facilement vérifier les paramètres de votre job avant de l'exécuter :

      1. Ouvrez la liste Explorateur dans la perspective (Undefined variable: Products.Process Assembly).
      2. Sélectionnez le job et cliquez sur le bouton Détails de la barre d'outils.
      3. Les principales données concernant le job s'affichent.

    Vous êtes alors prêt à exécuter le job !

  8. Enregistrez vos modifications et accédez à la liste Explorateur de la perspective (Undefined variable: Products.Process Assembly).
  9. Sélectionnez le job que vous venez de créer, puis cliquez soit dessus avec le bouton droit de la souris pour ouvrir le menu contextuel et sélectionner Exécuter, soit sur le bouton Exécuter de la barre d'outils.

    Cliquez pour développer

    Un message contextuel en haut de votre écran indique le succès ou l'échec de l'exécution du job. Dans le premier cas, vous aurez un lien vers le rapport du job.

    Bien que contenant les informations dont êtes susceptible d'avoir besoin, Interface WebDeprecated Term. Automic propose de nombreuses autres façons d'accéder aux données relatives aux objets exécutés.

  10. Cliquez sur Ouvrir rapport. À partir de la fenêtre Rapports, vous pouvez accéder à tous les rapports créés pour le job. Le rapport du job (REP) s'affiche par défaut. Par exemple :

    Cliquez pour développer

    Vous disposez, bien sûr, de rapports supplémentaires. Dans le cas présent, le log de l'agent (PLOG) est important car il fournit les détails relatifs à l'exécution :

    Cliquez pour développer

  11. De plus, Interface Web Automic offre les possibilités suivantes de vérifier les détails relatifs au job exécuté :

Liens utiles

Ce cas d'application inclut des références vers un certain nombre de fonctions que vous souhaiterez peut-être connaître un peu mieux.