1. No category

Automation Engine 10
ONE Automation Platform
Automation Engine et SAP
Version: 10.0.4
Date de Publication: 2015-01
Automic Software GmbH
ii Copyright
Copyright
Les logos Automic ® et Automic ® sont des marques déposées appartenant à Automic Software
GmbH (Automic). L'utilisation de toutes les marques déposées nécessite une autorisation explicite
écrite et est soumise aux conditions de la licence. Les logiciels et/ou le programme sont la propriété
protégée d'Automic Software. L'accès et l'utilisation de ces derniers sont soumis à des conditions
de licence devant être approuvées par écrit.
Les logiciels et/ou le programme sont également protégés par des droits de reproduction par des
contrats internationaux ainsi que par les lois nationales et internationales. Un accès et/ou une
utilisation non autorisés peuvent entraîner des poursuites civiles et pénales. La copie non autorisée
et d'autres formes de reproduction partielle ou totale, la décompilation, la reproduction, la
modification, ou le développement de produits dérivés du logiciel sont strictement interdits. Le nonrespect de ces conditions peut entraîner des poursuites pénales.
Sous réserve de modifications. Aucune responsabilité ne sera acceptée pour toute modification,
omission, erreur d'impression ou de production. Toute reproduction, totale ou partielle, est
strictement interdite.
© Copyright Automic Software GmbH. Tous droits réservés.
Automation Engine
iii
Contents
1 Solutions SAP et Job Scheduling avec l'Automation Engine
1
2 SAP NetWeaver
2
2.1 Automation Engine et SAP NetWeaver
2
2.2 Intégration à People
4
2.2.1 Intégration dans SAP Enterprise Portal (iViews)
4
Introduction
4
Démarrage de Tâches
5
Surveillance des activités
6
2.3 Intégration d’informations
7
2.3.1 Planification des processus de chargement des données
7
2.3.2 Planification des chaînes de processus
7
2.3.3 Planification de requêtes dans le batch
9
2.4 Intégration des processus
2.4.1 Surveillance des canaux de communication SAP XI
2.5 Plate-forme d'application
2.5.1 ABAP
Gestion des variantes
JCL pour SAP
Gestion de BDC
JCL pour SAP
Gestion de Spool
10
10
11
11
11
12
12
12
13
JCL pour SAP
13
Gestion d'Evènements
14
Evènement SAP
14
Prise en charge par l'Automation Engine
15
JCL pour SAP
15
Gestionnaire de critères
15
JCL pour SAP
16
Reprise de Jobs SAP
16
Reprise des définitions de calendrier SAP
18
2.5.2 Gestion des Jobs
Exécution de Jobs dans la pile ABAP (CCMS)
20
20
iv
Contents
JCL pour SAP
Processus fils
JCL pour SAP
Jobs interceptés
JCL pour SAP
Analyse du code retour d'application des steps SAP
21
22
23
23
24
24
Avec un élément de script
24
Avec le rapport de Liste de steps
24
Avec le rapport de Job
25
2.5.3 JAVA
26
Agent Java EE/JMX pour SAP NetWeaver
26
JMX dans SAP NetWeaver
26
Surveillance du moteur J2EE
26
Démarrage et arrêt d'un service
27
Exécution de Jobs dans la pile Java (JXBP)
30
Rapport pour les statistiques du Job Java
30
Installation
30
Cas exceptionnels
31
Codes retour
31
2.6 Gestion du cycle de vie
2.6.1 Surveillance de SAP NetWeaver
Surveillance des moniteurs
JCL pour SAP
Surveillance des Evènements SAP
31
31
31
32
32
Déroulement
33
Conseils
33
2.6.2 Intégration de l'Automation Engine à SAP Solution Manager
34
2.6.3 Inscription dans le système Landscape Directory
37
2.6.4 Analyse du log système et du log application
38
2.6.5 Commutation des modes de fonctionnement
38
3 SAP Banking
3.1 Gestion de processus pour SAP for Banking
4 SAP Financial Closing Cockpit
4.1 Intégration de l'Automation Engine dans SAP Closing Cockpit
40
40
43
43
Automation Engine
4.2 Activation d'objets avec SAP Closing Cockpit
5 SAP Solution Manager
5.1 Intégration de SAP Solution Manager
Configuration et test
v
47
51
51
51
5.2 SAP Solution Manager - Cas d'application
54
5.3 Configurer une connexion avec l'Interface Utilisateur
59
6 Solutions personnalisées
61
6.1 Archivage des données dans SAP
61
6.2 Traitements en masse
64
6.3 Copie de Client dans SAP R/3
65
6.4 Dialogue SAP pour l'Automation Engine
66
6.5 Automated SystemCopy for SAP
67
7 Liaison technique
68
7.1 Automation Engine et SAP
68
7.2 Plusieurs systèmes SAP
68
7.3 Objets SAP Security
69
7.4 Prise en compte d'attributs de Job
74
7.5 Interfaces
75
7.5.1 Interfaces
75
7.5.2 Différences au niveau des fonctions
75
7.5.3 Transport de l'interface
78
Nom du fichier
78
Importation des modules fonctionnels dans SAP
79
Requis :
79
Déroulement:
79
7.5.4 Test de l'interface avec ABAP Workbench
81
7.6 Agent pour SAP BW
85
7.7 Paramètres d'archivage avec R3_ACTIVATE_REPORT
86
7.8 ERROR/ERRORLEVEL dans R3_ACTIVATE_SESSIONS
87
7.9 Résolution de problèmes
89
7.9.1 Conseils sur la recherche d'erreurs
89
Rapport de Job
89
Attributs de l'objet activé
89
Utilisateur CPIC
89
vi
Contents
Transactions utiles
89
Fichiers log
89
Le log système SAP
89
Traces
90
90
7.9.2 Problèmes lors de l'importation des modules fonctionnels
90
7.9.3 Jobs SAP se terminant par ARCHIVE_INFO_NOT_FOUND
91
7.9.4 Problème de stabilité avec des instances SAP chez de nombreux Agents SAP
(connexion RFC) sur un serveur :
92
7.9.5 Problème de transmission de mot de passe à SAP
92
8 Certification
95
8.1 Résumé
95
Glossaire
96
.1 A
96
.2 B
96
.3 C
97
.4 D
98
.5 E
98
.6 F
99
.7 G
99
.8 H
99
.9 I
99
.10 J
100
.11 L
100
.12 M
100
.13 O
101
.14 P
101
.15 Q
102
.16 R
102
.17 S
102
.18 T
103
.19 U
104
.20 V
105
.21 W
106
Automation Engine
1 Solutions SAP et Job Scheduling
avec l'Automation Engine
Lorsque vous utilisez des solutions SAP et qu'il vous faut un Job Scheduling efficace, Automation
Engine est une solution idéale. Elle permet une intégration rapide et transparente de toutes les
applications SAP dans le contrôle de processus d'entreprise. Automation Engine prend en charge
toutes les applications SAP, y compris SAP R/3, mySAP Business Suite et SAP NetWeaver ainsi
que les solutions sectorielles, se basant sur ces applications, pour les télécommunications,
l'approvisionnement, la banque, etc. Résultat : les processus informatiques dans diverses
applications SAP sont gérés et surveillés centralement et sont en phase avec le reste de votre
exploitation informatique mondiale.
Développé comme un planificateur d'entreprise, l'Automation Engine ne nécessite aucun
composant intergiciel, tel qu'un serveur d'applications JAVA, et il permet une fonctionnalité de
planification très poussée sur l'ensemble de l'infrastructure informatique. Le système est
directement lié à SAP NetWeaver et accélère ainsi la création et la maintenance de Jobs pour les
applications SAP. Les rapports, variantes et tous les autres paramètres nécessaires sont
disponibles au travers de l'interface graphique intuitive et conviviale de Automation Engine. Les
problèmes relatifs aux accès manuels, aux erreurs de saisie ou aux listes de paramètres obsolètes
sont éliminés de manière efficace. Il est facile de créer les Jobs avec la fonctionnalité de glisserdéposer, de plus, ceux-ci sont affichés graphiquement à l'écran. Cela assure une excellente
visibilité et simplifie la gestion et le contrôle.
Grâce à une automatisation complète de tous les processus informatiques, Automation Engine
augmente la productivité au niveau de l'utilisation des solutions d'entreprise de SAP. Les Jobs
d'arrière-plan et les processus des applications SAP sont surveillés centralement et automatisés.
Automation Engine assure une meilleure performance grâce à un traitement d'arrière-plan optimisé
et à un nombre réduit d'interruptions et d'erreurs du système.
Rubriques connexes :
Automation Engine et SAP NetWeaver
1
2
Chapter 2 SAP NetWeaver
2 SAP NetWeaver
2.1 Automation Engine et SAP NetWeaver
Cette documentation suit l'architecture SAP NetWeaver et explique les fonctions AE en fonction
de cette dernière. De plus, y sont expliquées les fonctions pour les solutions sectorielles ainsi
que les solutions personnalisées.
Intégration à People
Ce domaine de SAP NetWeaver sert à l'intégration d'Utilisateurs finaux. L'Automation Engine crée
des interfaces spécifiques aux rôles et rend ainsi le département concerné responsable du
démarrage des processus avec les paramètres qui conviennent. Cela permet de désactiver les
sources d'erreur potentielles et l'Automation Engine exécute les processus prédéfinis en Tâche
d'arrière-plan, sans souci d'erreur.
Fonctionnalités de l'Automation Engine
Intégration dans SAP Enterprise Portal (iViews)
Business Intelligence
Le point central de cette couche est la gestion de l'entreposage. Les processus de chargement des
données et les chaînes de processus sont contrôlés par l'Automation Engine et, avec des
processus supérieurs, ils sont également intégrés à d'autres plateformes. L'analyse et la
représentation automatiques des processus individuels d'une chaîne, jusqu'au niveau le plus bas,
vont ainsi de soi.
Fonctionnalités de l'Automation Engine
Automation Engine
3
Planification des processus de chargement des données
Planification des chaînes de processus
Planification de requêtes dans le batch
Intégration des processus
Cette partie traite l'intégration des processus métier à SAP Exchange Infrastructure (SAP XI). En
tant qu'Integration Broker, les messages peuvent être validés directement dans l'Automation
Engine via les processus à adaptateur standard SAP XI et inversement.
Fonctionnalités de l'Automation Engine
Surveillance des canaux de communication SAP XI
Plateforme d'application
La plateforme d'application forme la base de toutes les applications SAP. L'Automation Engine
utilise l'ABAP ainsi que le domaine Java pour mettre à votre disposition des fonctionnalités utiles.
Fonctionnalités de l'Automation Engine
ABAP :
Exécution de Jobs dans la pile ABAP (CCMS)
Processus enfants
Jobs interceptés
Analyse du code retour d'application des steps SAP
Gestion des variantes
Gestion de BDC
Gestion de Spool
Gestion d'Evènements
Reprise de Jobs SAP
Reprise des définitions de calendrier SAP
JAVA :
Agent Java EE/JMX pour SAP NetWeaver
JMX dans SAP NetWeaver
Exécution de Jobs dans la pile Java (JXBP)
Gestion du cycle de vie
Cette partie comprend le contrôle et la surveillance de toutes les solutions utilisées sur la base de la
technologie SAP NetWeaver. L'Automation Engine a accès à toutes les données de surveillance
d'un côté et, d'un autre côté, y fournit ses propres données.
4
Chapter 2 SAP NetWeaver
Fonctionnalités de l'Automation Engine
Surveillance des moniteurs
Surveillance des Evènements SAP
Intégration de l'Automation Engine à SAP Solution Manager
Inscription dans le système Landscape Directory
Analyse du log système et du log application
Commutation des modes de fonctionnement
Développement d'applications
L'Automation Engine vous soutient pour le développement d'applications avec une kyrielle de
possibilités.
Fonctionnalités de l'Automation Engine
ABAB :
CallAPI pour SAP
JAVA :
Interface d'application
2.2 Intégration à People
2.2.1 Intégration dans SAP Enterprise Portal (iViews)
Introduction
Les iViews pour Job Scheduling apportent des informations actuelles sur le fonctionnement de
Job Scheduling dans les composants SAP Enterprise Portal de SAP NetWeaver et permettent
aux utilisateurs finaux de démarrer des processus commerciaux critiques.
Les Tâches peuvent être démarrées et surveillées directement à partir de SAP Enterprise Portal.
L'utilisateur final peut démarrer des processus importants, même sans connaissance de Job
Scheduling. Lorsque cela est nécessaire, les paramètres correspondants peuvent être définis.
Chaque utilisateur peut surveiller le statut actuel du traitement en arrière-plan via SAP Enterprise
Portal. Les processus démarrés à cet emplacement sont contrôlés et surveillés par Automation
Engine. L'état actuel est mis à disposition de l'Utilisateur via la technologie iView.
Rubriques connexes :
Démarrage de Tâches
Surveillance des activités
Automation Engine
5
Démarrage de Tâches
L'"ActivateObject" de iView permet aux utilisateurs de démarrer les objets activables dans
l'Automation Engine. Pour cela, enregistrez le nom de l'objet et une description explicative dans
les propriétés de personnalisation. Il est important de définir l'alias du système. Il doit
correspondre à la désignation que l'administrateur a définie dans les paramètres système.
Vous pouvez avec les alias de système accéder à différents systèmes AE.
Le bouton "Start" permet désormais d'activer l'objet. iView affiche le numéro courant (RunID) de
l'exécution actuelle ou de la dernière. D'autres informations sont à votre disposition en utilisant le
lien "Détail" qui ouvre la fenêtre de détails. De même que dans l'Interface Utilisateur, vous y
trouverez des renseignements sur l'heure de début ou le code retour.
Si l'exécution de l'objet requiert une saisie utilisateur car l'instruction de Script :READ a été utilisée,
un masque de saisie correspondant est créé dans iView. Les astérisques "*" rouges symbolisent
les champs obligatoires.
Rubriques connexes : Surveillance des activités
6
Chapter 2 SAP NetWeaver
Surveillance des activités
Les "Activities" de iView affiche les activités du système AE qui ont été démarrées sous
l'Utilisateur. De même que dans l'Interface Utilisateur, vous y trouverez des renseignements sur
la priorité, l'heure de début ou le statut des Tâches, par exemple.
Les informations sur les activités peuvent uniquement être consultées. iView ne permet pas
d'effectuer des modifications du type interruption ou traitement de la Tâche.
Il est possible de fusionner certaines colonnes et ainsi d'adapter l'affichage à vos besoins. Utilisez
pour cela la configuration personnalisée. Il est important de définir l'alias du système. Il doit
correspondre à la désignation que l'administrateur a définie dans les paramètres système.
Rubriques connexes : Automation Engine
Démarrage de Tâches
2.3 Intégration d’informations
2.3.1 Planification des processus de chargement des
données
Un info package est un objet qui décrit dans BW les conditions de sélection pour la demande de
données d'un système source. Cet objet peut être planifié et contrôle ainsi un processus de
chargement des données à partir d'un système source. Un info package peut être contrôlé de
l'extérieur à partir d'une interface standard. Cette interface est utilisée en conséquence par
l'Automation Engine.
JCL pour SAP
Eléments de script
Description
BW_ACTIVATE_
INFOPACKAGE
Planifie un ou plusieurs Info Packages pour un démarrage immédiat.
BW_GET_
INFOPACKAGES
Lit des Info Packages à partir du système BW. Les Info Packages
disponibles sont enregistrés dans le rapport d'activation ou dans un
fichier.
BW_SET_
INFOPACKAGE_
SELECTION
Définit les paramètres de sélection utilisés pour la lecture des Info
Packages à partir du système BW.
2.3.2 Planification des chaînes de processus
Dans votre système BW, vous pouvez représenter des déroulements par des chaînes de
processus. Une telle chaîne se compose d'un processus de démarrage, de processus
d'application individuels et de processus collectifs. Il est également possible d'associer des info
packages.
Avec l'Automation Engine, il vous est possible de démarrer et de surveiller des chaînes de
processus. Vous pouvez voir chacun des processus dans la Fenêtre d'Activités de l'Interface
Utilisateur. Les protocoles des processus sont, en outre, enregistrés dans l'Automation Engine
dans le rapport de l'objet Job.
7
8
Chapter 2 SAP NetWeaver
JCL pour SAP
Eléments
de script
Description
BW_
Démarre une chaîne de processus, surveille l'exécution et enregistre ses
ACTIVATE_ protocoles dans le rapport d'activation.
CHAIN
BW_GET_
CHAINS
Lit les chaînes de processus à partir du système BW. Les chaînes de processus
disponibles sont enregistrées dans le rapport d'activation ou dans un fichier.
BW_
RESTART_
CHAIN
Continue une chaîne de processus interrompue.
Automation Engine
9
2.3.3 Planification de requêtes dans le batch
A l'aide de la transaction RSCRM_BAPI, vous pouvez créer des interrogations dans votre
système BW avec de soi-disant requêtes. Le résultat est soit stocké dans une table, soit dans un
fichier. Utilisez l'Automation Engine pour exécuter les requêtes à intervalles réguliers ou selon les
besoins.
Identifiez-vous, tout d'abord, dans le système BW et exécutez la transaction RSCRM_BAPI.
Planifiez la requête que vous voulez automatiser avec l'Automation Engine. Chaque requête
possède son propre ID batch. Ouvrez le moniteur de batch et copiez ce numéro.
Créez maintenant un Job SAP dans le système AE. Utilisez l'onglet Forme ou écrivez directement
dans l'onglet Script la fonction suivante :
R3_ACTIVATE_REPORT REP='RSCRMREPORT_BAPI'
Passez ensuite à l'onglet "SAP" et entrez l'ID batch copié précédemment dans le champ
"Jobname".
10
Chapter 2 SAP NetWeaver
Il est possible d'intégrer l'objet Job dans votre traitement, par exemple dans un objet Schedule, et il
exécute la requête aux moments définis par vos soins.
En raison du comportement de SAP, vous ne voyez pas toutes les exécutions dans le moniteur
de batch, mais uniquement la dernière.
2.4 Intégration des processus
2.4.1 Surveillance des canaux de communication SAP
XI
Les adaptateurs SAP XI servent à échanger des données avec SAP Exchange Infrastructure. Ils
transforment les messages de manière à ce qu'ils puissent être transmis via les canaux de
communication.
L'Agent SAP met à votre disposition des fonctions vous permettant de contrôler des canaux de
communication :
l
l
l
démarrage des canaux de communication
arrêt des canaux de communication
demande d'informations concernant les canaux de communication
Automation Engine
Utilisez dans le Job SAP les fonctions XI_GET_CHANNEL et XI_SET_CHANNEL. Les
informations sur les canaux de communication sont enregistrées sous forme de document XML
dans le rapport de Job. Les éléments de script pour XML préparent les données.
De plus, vous pouvez surveiller les canaux de communication à l'aide des objets Evènements de
type "Console". A chaque changement de statut, un Evènement est déclenché.
Activez l'interface XI du fichier INI de l'Agent SAP avec les paramètres de la section [SAP_XI].
Pour l'accès au système XI, un objet Login avec des données d'identification valides est
nécessaire. L'Utilisateur XI doit disposer des autorisations pour contrôler les canaux de
communication XI. Utilisez différents objets Login pour les systèmes SAP et XI lorsque les deux
sont installés sur le même hôte. Sinon le Login n'est pas sans ambiguïté.
AE JCL pour XI
Elément de script
Description
XI_GET_CHANNEL
Enumère les canaux de communication.
XI_SET_CHANNEL
Démarre et arrête les canaux de communication.
2.5 Plate-forme d'application
2.5.1 ABAP
Gestion des variantes
Les variantes facilitent le traitement dans SAP, étant donné que les Jobs à entrées prédéfinies
peuvent être exécutés. L'Automation Engine prend bien entendu en charge l'utilisation des
variantes et offre de nombreuses fonctions à cette fin. Celles-ci permettent par exemple la
lecture, la copie ou la modification des variantes. Il est également possible de supprimer et
d'énumérer.
La vérification et la définition de variantes immédiatement avant l'exécution d'un programme
ABAP est d'une très grande importance, étant donné que cela permet d'éliminer des sources
d'erreur.
11
12
Chapter 2 SAP NetWeaver
JCL pour SAP
Eléments de script
Description
R3_ACTIVATE_REPORT
Peut exécuter un rapport après spécification d'une variante.
R3_COPY_VARIANT
Copie la variante d'un rapport.
R3_CREATE_VARIANT
Crée une nouvelle variante.
R3_DELETE_VARIANT
Supprime la variante d'un rapport.
R3_GET_VARIANT_
CONTENTS
Affiche le contenu d'une variante.
R3_GET_VARIANTS
Affiche toutes les variantes disponibles dans le protocole
d'activation.
R3_MODIFY_VARIANT
Modifie une entrée dans une variante.
Gestion de BDC
Batch input est une technique classique de reprise en masse des données à partir de systèmes
externes vers le système SAP.
Les dossiers batch input utilisés à cet effet contiennent une ou plusieurs exécutions de transaction,
y compris des données de transaction. L'Automation Engine peut lire les dossiers, mais aussi les
exécuter et les surveiller jusqu'à leur fin. Outre l'exécution de dossiers, l'Automation Engine permet
également l'exécution directe de transactions dont les données sont définies dans le Job (Call
Transaction).
JCL pour SAP
Eléments de script Description
R3_ACTIVATE_
SESSIONS
Exécution des sessions batch input.
R3_CALL_
TRANSACTION
Exécute une transaction SAP.
R3_GET_
SESSIONS
Sélectionne des dossiers batch input et affiche le résultat dans le rapport
d'activation ou dans un fichier.
Automation Engine
R3_SET_
BDCDATA
13
Définit les données BDC.
Gestion de Spool
Dans l'Automation Engine, le traitement des Tâches peut être contrôlé par des Jobs. Les
paramètres de l'objet Job et divers scripts vous aident à y parvenir.
Vous pouvez entrer des destinataires de la liste spool dans l'onglet SAP des Jobs SAP. Toutes les
requêtes spool que le Job crée sont envoyées aux destinataires entrés ici.
JCL pour SAP
De nombreux scripts possèdent des paramètres à l'aide desquels il est possible d'influencer la
sortie du Job. En outre, les fonctions suivantes, qui traitent précisément les requêtes spool, sont à
votre disposition.
Elément de script
Description
R3_CREATE_OUTPUT_
REQUEST
Crée un nouvel ordre d'édition pour une requête spool
existante.
R3_GET_JOB_SPOOL
Lit la liste spool d'un step de type "programme ABAP".
Vous pouvez spécifier des paramètres de filtrage.
R3_GET_SPOOL_REQUESTS
Sélectionne des requêtes spool avec des Filtres prédéfinis.
R3_SEND_SPOOL_REQUEST
Envoie une requête spool existante.
14
Chapter 2 SAP NetWeaver
Gestion d'Evènements
La gestion de processus doit être exécutée à partir d'Evènements pour des applications
modernes. Un contrôle purement chronologique des déroulements ne suffit pas pour prendre en
compte la complexité des environnements d'applications et de systèmes, avec leurs processus
imbriqués et leurs dépendances.
Avec Event, l'Automation Engine met à votre disposition une solution complète pour une gestion de
processus orientée Evènements. Le traitement peut se faire en fonction d'un grand nombre de
statuts et d'Evènements du système. Event met à disposition cette fonctionnalité pour un grand
nombre de plateformes de système d'exploitation et d'application. La définition et le traitement
d'Evènements se font de manière centrale et pour l'Utilisateur, quelle que soit la plateforme.
Le traitement d'arrière-plan SAP possède également un contrôle d'Evènements. Les Evènements
permettent de déclencher des processus d'arrière-plan SAP. En ce qui concerne la flexibilité et
l'étendue des fonctions, les Evènements SAP sont loin des possibilités d'une mise en œuvre de
l'Automation Engine. Dans certains cas, il est cependant nécessaire de prendre en compte les
Evènements SAP dans l'Automation Engine. L'Automation Engine étend ainsi sa fonctionnalité à la
prise en charge des Evènements SAP.
Evènement SAP
Un Evènement SAP est un indicateur qui est défini à l'aide de la transaction SM62. Un Evènement
défini peut être déclenché (manuellement, à partir d'un Job du système d'exploitation ou d'un
programme ABAP) et l'exécution d'un processus d'arrière-plan peut démarrer.
Il existe deux types d'Evènements SAP :
l
l
Evènements système
Ils sont définis par SAP et sont déclenchés automatiquement lorsque des Evènements
système se produisent, comme l'activation d'un nouveau mode d'exploitation. Les
Evènements système ne peuvent être modifiés.
Evènements utilisateur
Ils sont définis par l'Utilisateur. Ces Evènements doivent être déclenchés par un ABAP ou
un programme externe. Par exemple, un programme externe peut signaler au traitement
d'arrière-plan SAP que des données externes sont prêtes à l'importation dans le système
SAP.
Automation Engine
15
Prise en charge par l'Automation Engine
L'Automation Engine prend en charge les Evènements SAP et les intègre dans sa gestion de
processus centrale. Cette fonctionnalité peut être nécessaire lorsque le contrôle d'arrière-plan de
SAP travaille déjà avec un grand nombre d'Evènements définis et qu'un changement à une mise en
œuvre de l'Automation Engine avec des Workflows et Event paraît trop compliqué.
Dans la plupart des cas d'application, il est cependant utile de remplacer les Evènements SAP
par les mises en œuvre de l'Automation Engine correspondantes.
L'Automation Engine peut utiliser les Evènements SAP pour sa gestion de processus. L'exécution
des objets peut être soumise à la réalisation d'un Evènement SAP. Certains traitements peuvent
ainsi par exemple dépendre de la fin d'une importation.
Les Evènements définis dans SAP peuvent être déclenchés par l'Automation Engine. L'ensemble
des fonctions variées de l'Automation Engine est à votre disposition pour définir la condition et le
moment de déclenchement d'un Evènement SAP. Des processus du système SAP sont démarrés
sur la base d'un tel Evènement.
Pour la surveillance des Evènements SAP, un objet Evènement de type "Console" peut également
être utilisé. L'Agent surveille les Evènements SAP déclenchés et transmet les informations aux
Evènements de consoles. En utilisant des Filtres, vous pouvez sélectionner les Evènements SAP
dont le moment de déclenchement marque le coup d'envoi d'un traitement séquentiel ou d'une
Alerte.
JCL pour SAP
Elément de script
Description
R3_GET_EVENT
Attend un Evènement déclenché dans SAP.
R3_RAISE_EVENT
Déclenche un Evènement défini dans SAP.
Rubriques connexes :
Surveillance des Evènements SAP
Gestionnaire de critères
Le gestionnaire de critères SAP permet de définir les conditions de l'historique des Evènements,
de la réorganisation de l'historique des Evènements et de l'interception de Job dans les profils.
Vous pouvez accéder directement au gestionnaire de critères dans le Job SAP.
Fonctionnalités :
l
l
l
Création et suppression de profils
Activation et désactivation de profils
Ajout, modification et suppression de conditions
Dans l'onglet Forme, cliquez sur le bouton
pour ouvrir le gestionnaire de critères.
Vous devez obligatoirement utiliser XBP 3.0 pour accéder au gestionnaire de critères SAP.
16
Chapter 2 SAP NetWeaver
JCL pour SAP
Elément de script
Description
R3_ACTIVATE_CM_
PROFILE
Active un profil dans le Gestionnaire de critères SAP.
R3_DEACTIVATE_
CM_PROFILE
Désactive un profil dans le Gestionnaire de critères SAP.
Reprise de Jobs SAP
Avec l'objet Job de l'Automation Engine, il est non seulement possible de définir de nouveaux
Jobs SAP, mais il est également possible de reprendre dans l'Automation Engine des Jobs
existants. Cela présente l'avantage de ne pas devoir créer une deuxième fois les Jobs.
Pour la reprise de Jobs, l'Interface Utilisateur doit être connectée au système SAP.
Ouvrez un objet Job et passez à l'onglet "Forme". Dans coin supérieur gauche se trouvent de
nombreux boutons. Cliquez sur le symbole . Une fenêtre s'ouvre dans laquelle vous pouvez saisir
des Filtres pour les Jobs SAP, comme le nom ou le numéro de Job.
Automation Engine
17
Cliquez ensuite sur "Chercher". Tous les Jobs SAP correspondant au Filtre que vous avez saisi
s'affichent. Sélectionnez le Job que vous souhaitez reprendre dans l'Automation Engine, puis
cliquez sur OK.
L'objet Job reprend les instructions que contient ce Job. Des paramètres, comme la variante ou le
périphérique de sortie, sont renseignés automatiquement comme vous pouvez le voir dans
l'illustration suivante.
18
Chapter 2 SAP NetWeaver
La reprise ne veut pas dire que le Job est supprimé du système SAP. Seuls les paramètres du
Job sont lus et copiés dans l'objet Job.
Cette méthode de reprise de Job est très pratique pour de petites quantités de Jobs. Pour un grand
nombre de Jobs, nous recommandons d'utiliser ApplicationInterface.
Attention : une reprise de Jobs en masse doit être bien réfléchie et planifiée ! Essayez tout
d'abord d'avoir une vue d'ensemble. Dans la plupart des cas, les Jobs qui se sont développés au fil
du temps peuvent être retravaillés et donc simplifiés. Il se peut même que vous souhaitiez adapter
certaines parties du traitement ou les remplacer par d'autres.
Rubriques connexes : Reprise des définitions de calendrier SAP
Reprise des définitions de calendrier SAP
SAP offre la possibilité de définir le calendrier d'entreprise à l'aide de la transaction SCAL.
L'interface contient un programme ABAP avec lequel vous pouvez exporter ces Groupes
Calendriers sous forme de fichier XML, puis les transférer dans votre système AE. Les règles
particulières du Groupe Calendrier sont également prises en compte.
Une fois l'interface importée (voir instructions d'installation pour l'Agent SAP), le programme ABAP
"/SBB/UC4_CALE_CREATE" peut être exécuté. Outre l'ID de calendrier d'entreprise, entrez
également les informations de votre système AE, comme le montre l'illustration suivante.
Les deux cases à cocher situées en fin de formulaire vous permettent de déterminer si la définition
de calendrier doit être créée sous forme de liste spool et/ou sous forme de fichier XML. Dans le
Automation Engine
19
dernier cas, un dialogue s'ouvre dans lequel vous pouvez sélectionner le dossier où enregistrer le
fichier.
Importez ensuite le fichier XML dans votre système AE. Le calendrier d'entreprise est désormais
disponible comme objet Groupe Calendrier.
Le processus de reprise du Calendrier peut bien entendu être automatisé à l'aide d'un élément de
script.
Rubriques connexes : Groupe Calendrier
Importation et Exportation d'objets
Reprise de Jobs SAP
20
Chapter 2 SAP NetWeaver
2.5.2 Gestion des Jobs
Exécution de Jobs dans la pile ABAP (CCMS)
L'Automation Engine vous offre, avec ses fonctionnalités, de nombreuses possibilités pour
l'exécution de votre traitement dans SAP. A la base se trouve l'objet Job à l'aide duquel vous
définissez les instructions devant être exécutées dans le système SAP.
L'onglet Forme représente une interface graphique qui entretient une liaison au système SAP. La
définition des instructions de traitement est ainsi simple et rapide, car vous pouvez sélectionner
directement des données comme les variantes.
L'Automation Engine permet l'exécution de :
l
l
l
l
l
l
Jobs,
rapports ,
commandes externes ;
programmes externes,
Jobs interceptés,
et bien d'autres.
Dans la Fenêtre d'Activités de l'Interface Utilisateur, vous voyez le statut de la Tâche et vous
pouvez la redémarrer ou l'interrompre selon vos besoins. Les processus enfants sont également
représentés. Une fois la Tâche terminée dans l'Automation Engine, vous pouvez afficher le rapport
qui contient également les messages du système SAP.
Mais l'objet Job n'est pas le seul à pouvoir exécuter des traitements dans le système SAP. Le type
d'objet "RemoteTaskManager" possède la fonctionnalité permettant de surveiller des Jobs dans
SAP, mais aussi de les démarrer. Vous pouvez l'utiliser pour des Jobs ou en particulier pour des
Jobs interceptés.
Automation Engine
JCL pour SAP
Elément de script
Description
R3_ACTIVATE_EXT_
COMMAND
Exécute une commande externe.
R3_ACTIVATE_EXT_
PROGRAM
Exécute un programme externe.
R3_ACTIVATE_
INTERCEPTED_JOBS
Exécute des Jobs interceptés sous le contrôle de l'Automation
Engine.
R3_ACTIVATE_JOBS
Exécute des Jobs déjà planifiés dans SAP sous le contrôle de
l'Automation Engine.
R3_ACTIVATE_REPORT
Exécute le rapport indiqué.
R3_GET_JOBS
Sélectionne des Jobs SAP et affiche le résultat dans le rapport
d'activation ou dans un fichier.
R3_MODIFY_JOB
Modifie un step ABAP.
R3_SCHEDULE_JOB_
CANCEL
Réattribue le statut "Planifié" à un Job SAP déjà lancé.
Rubriques connexes :
Processus enfant
Jobs interceptés
RemoteTaskManager
21
22
Chapter 2 SAP NetWeaver
Processus fils
Les Jobs SAP peuvent être composés d'un seul ou de plusieurs sous-Jobs (par ex. : pour les
chaînes de processus). L'Automation Engine peut représenter ce qu'on appelle les processus
fils. Ils sont affichés dans la Fenêtre d'Activités et possèdent des enregistrements statistiques
propres ainsi que des rapports.
Activez la fonctionnalité Parent-enfant dans la transaction SE38 au moyen du programme
INITXBP2.
Le type d'objet des processus fils s'appelle JOBD.
Pour qu'une réplication des processus fils puisse avoir lieu dans le système AE, il faut définir le
paramètre REPLICATE=YES pour le Script approprié.
Attention : les processus fils peuvent, à leur tour, posséder des processus fils. Ces cas-là sont
reconnaissables à la colonne "Parent" de la Fenêtre d'Activités et dans les statistiques.
L'illustration suivante montre l'exécution d'une chaîne de processus dans laquelle c'est le cas :
Dans la fenêtre de détails, le point "Texte du Statut" contient le numéro d'instance du système
SAP.
La désactivation des processus fils est contrôlée à partir du processus parent.
Les Jobs SAP possèdent un onglet spécial nommé "Post-Traitement Lié". L'exécution a lieu dès
qu'un processus fils individuel se termine. Une analyse du résultat peut alors être effectuée
immédiatement après la fin d'un processus fils.
Pour chaque processus fils, un enregistrement statistique et un rapport sont créés. Affichez-les
tous deux à partir des statistiques du processus parent.
Automation Engine
23
Le rapport est structuré comme celui du processus parent le plus élevé ; il ne contient cependant
que les contenus de l'étape du processus en question.
Les paramètres du rapport de Job sont également repris par le processus parent (base de données,
fichier, uniquement en cas d'erreur). En outre, vous pouvez déterminer la taille du rapport avec les
paramètres JOBLOG=, PROCESSLOG= et LONGTEXT= dans les éléments de script BW_
ACTIVATE_CHAIN et BW_RESTART_CHAIN.
JCL pour SAP
Elément de script
Description
BW_ACTIVATE_CHAIN
Démarre une chaîne de processus.
BW_RESTART_CHAIN
Continue une chaîne de processus interrompue.
R3_ACTIVATE_
INTERCEPTED_JOBS
Exécute des Jobs interceptés sous le contrôle de l'Automation
Engine.
R3_ACTIVATE_JOBS
Exécute des Jobs déjà planifiés dans SAP sous le contrôle de
l'Automation Engine.
R3_ACTIVATE_REPORT
Exécute le rapport indiqué.
Rubriques connexes : Onglet Post-Traitement Lié
Jobs interceptés
Dans SAP, il est possible de définir dans la table TBCICPT1 des critères de filtrage pour les
Jobs. En font partie les indications d'un Client, d'un nom de Job et de l'Utilisateur. Si un
Utilisateur entré ici démarre un Job correspondant aux critères de filtrage, alors celui-ci est mis en
statut "Planifié" quelles que soient les conditions de démarrage (par exemple "Immédiatement").
Activez la fonctionnalité Interception dans la transaction SE38 au moyen du programme
INITXBP2.
24
Chapter 2 SAP NetWeaver
Dans l'onglet Forme des Jobs SAP, vous pouvez accéder à la table via l'icône
entrées (XBP 2.0) ou utiliser le gestionnaire de critères (XBP 3.0).
et gérer ses
Il est possible de modifier dynamiquement les entrées de la table avec le script R3_MODIFY_
INTERCEPTION.
Il existe plusieurs méthodes pour exécuter les Jobs interceptés :
1. Le Gestionnaire de File d'Attente permet de contrôler et de surveiller les Jobs interceptés.
2. Utilisez R3_ACTIVATE_INTERCEPTED_JOBS.
3. Utilisez R3_GET_INTERCEPTION pour lire la table. Le résultat est enregistré dans un
fichier auquel vous pouvez accéder à l'aide de PREP_PROCESS_FILE.
Si vous démarrez les Jobs interceptés individuellement, et si vous les entrez comme type de
démarrage d'un Groupe, vous pouvez définir le nombre de Jobs s'exécutant en parallèle.
JCL pour SAP
Elément de script
Description
R3_ACTIVATE_
INTERCEPTED_JOBS
Exécute des Jobs interceptés sous le contrôle de l'Automation
Engine.
R3_GET_
INTERCEPTION
Lit la table de filtre pour les Jobs interceptés et enregistre dans le
protocole d'activation ou un fichier.
R3_MODIFY_
INTERCEPTION
Modifie la table de filtre pour les Jobs interceptés.
Rubriques connexes :
Onglet Forme
Analyse du code retour d'application des steps SAP
Un step SAP peut également contenir un code retour d'application.
Vous pouvez y accéder des façons suivantes :
Avec un élément de script
R3_GET_APPLICATION_RC peut vérifier le code retour d'application d'un ou plusieurs steps de
Job et, le cas échéant, interrompre le Job.
Avec le rapport de Liste de steps
Ce type de rapport spécifique contient des informations sur les steps et également le code retour
d'application. Lisez la valeur à l'aide d'un élément de script XML.
Exemple :
:SET &xmlreport# = XML_OPEN(REPORT,,SSTP)
! Lire le premier élément
:SET &job# = XML_GET_FIRST_CHILD(&rapport xml#)
:SET &nom# = XML_GET_NODE_NAME(&job#)
Automation Engine
25
:PRINT "Premier élément : &nom#"
! Lire le deuxième élément
:SET &enfant# = XML_GET_FIRST_CHILD(&step#)
! Lire les processus enfant du step
:WHILE &enfant# <> ""
:SET &nom# = XML_GET_NODE_NAME(&enfant#)
! Lire le code retour d'application
:IF &nom# = "RC"
: SET &applrc# = XML_GET_NODE_TEXT(&enfant#)
: PRINT "Code retour d'application : &applrc#"
:ENDIF
:SET &enfant# = XML_GET_NEXTSIBLING(&child#)
:ENDWHILE
:XML_CLOSE
Avec le rapport de Job
Les informations sur les steps de Job SAP sont journalisées dans le rapport de Job. Le code retour
d'application est également spécifié dans le rapport de Job, si vous utilisez l'interface.
Si un step ne possède pas de code retour d'application, "Appl-RC n/a" est spécifié dans le
rapport de Job.
La fonction de script PREP_PROCESS_REPORT vous permet de lire les codes retour
d'application et de les traiter.
Dans l'exemple suivant, un ABAP nommé ZZ_TEST_APPL_RC est exécuté une fois dans le Job.
Son code retour d'application doit être lu.
! Sélectionner la ligne contenant l'ABAP et le code retour
d'application
:SET &HND# = PREP_PROCESS_REPORT(,,REP,"*ZZ_TEST_APPL_RC*Appl-RC*")
:PROCESS &HND#
:
SET &LIGNE# = GET_PROCESS_LINE(&HND#)
! Trouver l'emplacement dans la ligne où commence "Appl-RC"
:
SET &POS_STR# = STR_FIND(&LIGNE#,"Appl-RC")
! Le code retour d'application se trouve 8 caractères après
:
SET &POS_ARC# = ADD(&POS_STR#,8)
! Lire le code retour d'application
:
SET &ARC# = STR_CUT(&LIGNE#,&POS_ARC#)
! Vérifier si le step fournit vraiment un code retour d'application
:
IF &ARC# <> "n/a"
! Comme la valeur lue est une séquence de caractères, elle doit être
convertie en un nombre
:
SET &ARC#= CINT(&ARC#)
! A partir d'ici se trouvent des instructions de script quelconques
qui traitent le code retour d'application
:
PRINT &ARC#
:
ENDIF
:ENDPROCESS
Attention : le code retour d'application n'est pas disponible dans l'interface XBP.
26
Chapter 2 SAP NetWeaver
2.5.3 JAVA
Agent Java EE/JMX pour SAP NetWeaver
Java Management Extensions (JMS) est une technologie qui configure des instruments pour
contrôler et surveiller des applications, appareils et réseaux.
Automation Engine offre la possibilité d'intégrer des applications Java dans des processus métiers
à l'aide d'un Agent pour JMX. La connexion est établie via un Serveur MBean grâce auquel vous
pouvez accéder aux MBeans à l'aide de fonctions.
SAP NetWeaver comprend, par exemple, plus de 1600 MBeans dans sa version standard. Ceux-ci
peuvent être contrôlés directement. Du côté JAVA, il n'est pas nécessaire de procéder à une
prédéfinition de Jobs exclusifs. Un planificateur n'est pas non plus nécessaire au sein de JAVA,
étant donné que cela est pris en charge par l'Automation Engine. En raison du standard, cette
fonctionnalité peut s'exécuter sur des sources Java d'autres éditeurs. Les serveurs d'applications
qui sont pris en charge sont énumérés dans la check-list des prérequis.
Des éléments de script sont disponibles dans l'Automation Engine pour, par exemple, enregistrer,
énumérer et supprimer les MBeans. Il est également possible d'exécuter des MBeans ainsi que de
lire et définir des attributs et des informations.
L'onglet Forme de l'objet Job offre une interface graphique dans laquelle il est aisé de
sélectionner ces fonctionnalités.
Rubriques connexes :
Onglet Forme (JMX)
Généralités sur JMX-JCL
JMX dans SAP NetWeaver
L'utilisation de MBeans dans SAP NetWeaver est possible via l'Agent JMX AE.
Surveillance du moteur J2EE
A l'aide de JMX, il est possible de consulter le statut du moteur J2EE. Ces informations sont
également affichées dans le Visual Administrator, sous Server -> Services -> Monitoring.
Automation Engine
27
Toutes les fonctions du Visual Administrator sont à votre disposition dans MBeans et peuvent donc
également être utilisées par l'Automation Engine.
Il existe cependant une restriction : L'Automation Engine ne peut utiliser aucune opération ou
attribut JMX qui utilise des classes spécifiques à SAP (par exemple
com.sapmarkets.bam.application.User) ou des structures de données complexes (listes, cartes,
séries, etc.).
Le navigateur MBean de l'Automation Engine dans le Job JMX affiche 300 entrées MBean au
maximum. Le filtre de recherche (clic droit sur l'arborescence -> Appliquer le filtre ...) permet de
rechercher précisément certains MBeans.
Exemple : vous voulez consulter le nombre de tentatives de connexion échouées. Dans la première
illustration, cette valeur se trouve sous le nœud Security -> Aggregated Data. Il est ainsi possible
de filtrer sur "*Security/Aggregated Data/UnsuccessfulLogonAttemptsCount*" dans le navigateur
MBean. Dans notre environnement, cela renvoie exactement un MBean comme résultat.
Ici, vous pouvez sélectionner un des attributs "Value", "MaxValue" ou "MinValue". Il est possible de
planifier, dans un Job, une consultation périodique du nombre d'identifications échouées.
Démarrage et arrêt d'un service
Le Visual Administrator configure également les services, les démarre et les arrête. Etant donné
que des MBeans JMX sont également utilisés ici, cette fonctionnalité peut être exécutée à l'aide de
l'Agent.
Ces services sont énumérés dans le Visual Administrator, sous Server -> Services :
28
Chapter 2 SAP NetWeaver
Exemple : le service Telnet doit être démarré ou arrêté.
Pour afficher tous les services dans le navigateur MBean, il est possible de filtrer en fonction de
"*SAP_J2EEServicePerNode*". Les MBeans renvoyés correspondent aux services.
Tous les services ont une méthode "start" et "stop". Sélectionnez l'entrée "telnet" dans
l'arborescence. Dans le détail, il est possible de sélectionner ensuite la méthode "stop". Après avoir
cliqué sur OK, un Job qui arrête le service Telnet est créé :
Automation Engine
La modification est immédiatement visible dans le Visual Administrator :
29
30
Chapter 2 SAP NetWeaver
Exécution de Jobs dans la pile Java (JXBP)
L'Automation Engine vous offre les possibilités suivantes pour gérer des Jobs dans le
planificateur Java de SAP :
l
l
l
l
Démarrer les Jobs avec les paramètres
Interrompre les Jobs
Reprendre le protocole dans le rapport de Job.
Surveiller les Jobs par filtre à l'aide du RemoteTaskManager
La définition du Job Java doit d'abord être déployée dans le planificateur Java. Elle est ainsi visible
par l'Agent SAP. Ce n'est qu'après que vous pouvez créer une instance à partir d'une définition de
Job existante à l'aide d'un objet Job.
Un objet Job SAP appartient toujours à une seule définition de Job Java.
Créez un objet Job SAP pour les Jobs du planificateur Java et sélectionnez l'Agent SAP ainsi qu'un
objet Login. Vous pouvez sélectionner dans l'onglet Forme la définition de Job qui doit être
exécutée. La partie inférieure de l'onglet affiche automatiquement les paramètres correspondants.
L'onglet "Protocole du Job" contient les options suivantes :
l
l
l
Supprimer après x jours - Le protocole du Job est supprimé après x jours dans le planificateur
Java.
Ne pas supprimer - Le protocole du Job n'est pas supprimé dans le planificateur Java.
Utiliser les paramètres par défaut - Le paramètre de la définition du Job permet de définir le
délai de suppression du protocole du Job dans le planificateur Java.
Le protocole du Job est toujours supprimé avec l'instance du Job.
Rapport pour les statistiques du Job Java
Un objet Job SAP exécuté peut, entre autre, comporter un rapport (SJJI) contenant des
informations relatives au Job Java. Dans l'objet Job, dans l'onglet SAP, cochez la case
correspondante dans la zone "Rapports optionnels".
Installation
Création du planificateur externe dans SAP :
1.
2.
3.
4.
Connectez-vous à l'administrateur SAP Netweaver par le biais de l'interface web.
Sélectionnez l'onglet "Job".
Cliquez sur le lien "Planificateur Java" -> "Planificateur externe".
Ajoutez une nouvelle entrée dans la liste du planificateur Java externe enregistré à l'aide du
bouton "Ajouter".
5. Renseignez les champs. Indiquez un nom et la description "Operations Manager".
6. Cliquez ensuite sur "Ajouter".
Création d'un objet Connexion dans l'Automation Engine :
1. Connectez-vous au Client système 0000.
2. Créez un nouvel objet Connexion pour SAP.
3. Ouvrez l'objet Connexion et sélectionnez le type de connexion "Internet" dans l'onglet
Attributs.
Automation Engine
31
4. Allez dans l'onglet Internet et indiquez les données de connexion au planificateur Java SAP.
Indiquez quel Utilisateur vous avez également utilisé lorsque vous avez ajouté l'Automation
Engine comme planificateur externe.
5. Enregistrez l'objet Connexion et fermez-le.
6. Allez dans le dossier "HOST" et ouvrez l'objet de l'Agent SAP.
7. Sélectionnez l'objet Connexion dans l'onglet Agent dans le champ "Java Basis".
8. Sauvegardez l'objet Agent et fermez-le.
9. Si l'Agent SAP est en cours d'exécution, vous devez le redémarrer.
Cas exceptionnels
Dans un environnement comportant plusieurs nœuds, les Jobs du planificateur Java sont exécutés
sur le nœud sur lequel le service de planification est actif. Lorsqu'un nœud est désactivé ou
défaillant, le traitement du Job se poursuit sur un autre nœud.
Si l'Agent perd la connexion au planificateur Java pendant l'exécution du Job, il tente
périodiquement de restaurer la connexion. Le Job reste actif dans le système AE et a le statut
"Attente d'un Système distant".
Si l'appel du planificateur Java génère une erreur, le Job est alors interrompu. Dans ce cas, il
n'existe pas de rapport sur les statistiques du Job Java. L'erreur est journalisée dans le rapport "Log
d'Agent" de l'objet Log et dans le fichier log de l'Agent SAP. Le Job est interrompu avec le code
retour 403.
Une reprise est impossible. Dans la mesure où il n'y a aucun JCL AE, le Job complet est toujours
relancé dans le planificateur Java.
Codes retour
Statut SAP
Code retour du Job dans l'Automation Engine
COMPLETED
HOLD
RUNNING
SCHEDULED
STARTING
UNKNOWN
0
ERROR
501
CANCELLED
502
2.6 Gestion du cycle de vie
2.6.1 Surveillance de SAP NetWeaver
Surveillance des moniteurs
SAP offre une série de moniteurs avec lesquels vous pouvez surveiller l'environnement SAP
ainsi que les composants qui en font partie. La fonction R3_GET_MONITOR lit ses informations
et les prépare en vue du traitement.
32
Chapter 2 SAP NetWeaver
Dans l'exemple suivant, le moniteur "All Monitoring Contexts" est lu et enregistré dans un fichier
texte :
R3_GET_MONITOR MONITOR_SET="SAP CCMS Technical Expert Monitors",
MONITOR="All Monitoring Contexts", FILE="C:\AE_und_
SAP\AllMonitoringContexts.txt"
La fonction script PREP_PROCESS est très utile si vous ne souhaitez filtrer que certaines parties
des informations du moniteur. Elle fournit, sur la base d'un Filtre, une séquence de données qui peut
ensuite être traitée. L'Agent SAP prépare les informations du moniteur sous forme de colonnes.
Dans l'exemple suivant, les lignes contenant "Enqueue" sont filtrées et quatre colonnes passent
dans le traitement ultérieur :
:SET &HND# = PREP_PROCESS("SAP01","R3MONITOR","*Enqueue*","MONSET=SAP
CCMS Technical Expert Monitors","MONNAM=All Monitoring
Contexts","COL=FILE","UC_LOGIN=LOGIN.SAP")
:PROCESS &HND#
:
SET &Contexte# = GET_PROCESS_LINE(&HND#, CONTEXT)
:
SET &Nom# = GET_PROCESS_LINE(&HND#, NAME)
:
SET &Valeur# = GET_PROCESS_LINE(&HND#, VALUE)
:
SET &Statut# = GET_PROCESS_LINE(&HND#, STATUS)
:
PRINT "&Contexte# --- &Nom"
:
PRINT "Valeur : &Valeur#"
:
PRINT "Status: &Statut#"
:
PRINT ""
:ENDPROCESS
En arrière-plan, l'exemple exécute également la fonction R3_GET_MONITOR. Vous trouverez des
informations plus précises dans la description de la fonction script PREP_PROCESS.
L'objet RemoteTaskManager autorise également une surveillance dans le système SAP. Il
affiche, à partir des critères de filtrage définis, les Jobs ayant été déclenchés par SAP.
JCL pour SAP
Elément de script
Description
R3_GET_MONITOR
Lit des données d'un moniteur SAP.
Surveillance des Evènements SAP
Les Evènements ont une très grande importance dans le traitement en arrière-plan dans SAP.
L'objet Evènement du type "console" peut être utilisé pour surveiller les Evènements SAP.
L'Agent interroge périodiquement le système SAP au sujet des Evènements SAP survenus et
les signale aux Evènements de console actifs. L'administrateur peut régler l'intervalle dans la
Variable UC_HOSTCHAR_DEFAULT avec la clé JOB_CHECKINTERVAL.
Un Filtre vous permet de définir les Evènements SAP que vous souhaitez suivre. Si l'Agent
annonce un Evènement SAP, les instructions de l'onglet "!Script" sont exécutées. Vous pouvez
ainsi introduire d'autres étapes dans le traitement.
Dans !Script, utilisez la fonction GET_EVENT_INFO. Elle vous fournit des détails sur
l'Evènement SAP qui s'est produit.
Automation Engine
33
Dans la table figurant dans la partie inférieure de l'onglet, il est possible d'entrer plusieurs lignes de
filtrage. Si l'Agent annonce un Evènement SAP correspondant à au moins une ligne de filtre, le
!Script est exécuté. S'il correspond à plusieurs filtres, le !Script n'en est pas pour autant traité
plusieurs fois.
Des filtres se recoupant peuvent également se produire si vous utilisez plusieurs Evènements de
console. En l'occurrence, l'Agent annonce l'Evènement SAP à tous les Evènements de console.
Outre l'Evènement de console, l'Automation Engine met également à votre disposition des
fonctions avec lesquelles vous pouvez traiter des Evènements SAP à partir des objets Job. R3_
GET_EVENT attend qu'un Evènement se déclenche dans SAP et avec R3_RAISE_EVENT, vous
déclenchez vous-même un Evènement défini dans SAP.
Déroulement
1. Créez un objet Evènement du type "console".
2. Ouvrez-le et passez à l'onglet "Console". Il est possible d'y spécifier l'Agent qui est lié au
système SAP et les critères de filtre pour les Evènements SAP.
3. Dans l'onglet "!Script", vous entrez les instructions de Script devant être exécutées dès
qu'un Evènement SAP correspondant aux critères de filtre est annoncé. La fonction script
GET_EVENT_INFO peut vous fournir des détails sur l'Evènement SAP.
4. Renseignez selon les besoins les autres onglets de l'Evènement de console et enregistrez
l'objet.
5. L'Evènement de console peut désormais être activé pour relier les Evènements SAP dans
votre traitement.
Conseils
La condition requise pour la surveillance d'Evènements SAP par le type d'Evènement "Console"
est XBP 3.0. L'utilisation de l'interface XBP 3.0 doit être définie par l'administrateur dans le fichier
34
Chapter 2 SAP NetWeaver
INI de l'Agent SAP.
Si l'Agent perd la connexion au système SAP, un certain nombre d'Evènements SAP s'accumulent
et l'Agent n'est pas capable de les transmettre aux Evènements de console. Une fois la connexion
rétablie, il vérifie cette situation et annonce également ces Evènements SAP aux Evènements de
console concernés.
En raison de l'éventuelle grande quantité de données, il ne lit pas tous les Evènements SAP en
une seule fois. L'administrateur peut configurer en conséquence le comportement à l'aide du
paramètre maxEventTimeSpan= du fichier INI de l'Agent.
Si l'Agent est terminé, il ne peut surveiller aucun Evènement SAP pendant l'arrêt. Après
redémarrage, l'Agent détermine le moment auquel il a surveillé pour la dernière fois les Evènements
SAP et annonce également les Evènements SAP qui se sont produits durant l'arrêt.
Tous les Agents reliés au système SAP demandent les Evènements SAP. Autrement dit,
chaque Agent annonce tous les Evènements SAP survenus à tous les Evènements de console.
Si l'heure du système SAP retarde par rapport à l'heure du système AE, les premiers
Evènements SAP ne peuvent pas être recueillis, s'ils tombent dans l'intervalle de temps situé entre
les différences d'heure.
Rubriques connexes : Gestion d'Evènements
Exemple - Réaction à des Evènements externes
2.6.2 Intégration de l'Automation Engine à SAP Solution
Manager
SAP Solution Manager est fourni avec tous les systèmes SAP à partir de Web Application Server
(WAS) 6.10. Il doit devenir le logiciel central de surveillance pour les systèmes SAP, mais aussi
pour les applications externes. Cela conduit à une centralisation de tous les services dans le
cadre d'un environnement SAP.
L'Agent SAP permet à l'Automation Engine d'intégrer l'ensemble des processus de gestion de
l'entreprise dans SAP Solution Manager.
Surveillance
La surveillance centrale est un des éléments essentiels de SAP Solution Manager. La partie de
surveillance se décompose, à son tour, en deux domaines essentiels :
l
l
exploitation
surveillance des processus métier
Alors que pour le premier domaine, il s'agit principalement de déroulements et d'états techniques, le
domaine de la surveillance des processus métier représente les processus métier logiques des
systèmes SAP ainsi que leur surveillance.
Automation Engine
35
Surveillance de l'exploitation
Dans le domaine Surveillance de l'exploitation, Solution Manager collabore avec l'infrastructure de
surveillance existante dans CCMS (Computing Center Management Systems). Les statuts des
systèmes et des processus sont représentés dans une arborescence.
Jusqu'à présent, ces moniteurs se limitaient aux systèmes SAP. Désormais, SAP met à
disposition des interfaces pour applications externes, pour annoncer leurs propres données de
statut à Solution Manager et pour les afficher dans l'arborescence de surveillance.
L'Agent SAP utilise une telle interface pour accéder à la structure du moniteur dans CCMS. Il utilise
pour cela un objet Connexion pour ABAP Basis. A l'aide de scripts, vous pouvez créer et modifier
des attributs et supprimer des nœuds :
Elément de script
Description
R3_DELETE_NODE
Suppression d'un nœud.
R3_SET_LOG_ATTR
Définition d'un attribut log.
R3_SET_PERF_
ATTR
Définition d'un attribut de performance.
R3_SET_STATUS_
ATTR
Définition d'un attribut de statut.
R3_SET_TEXT_
ATTR
Définition d'un attribut de texte.
L'onglet Forme des Jobs SAP vous permet d'examiner les nœuds. Un navigateur séparé affiche le
moniteur "All Monitoring Contexts" de l'ensemble de moniteurs "SAP CCMS Technical Expert
Monitors". Les couleurs des nœuds correspondent au statut d'alerte actuel.
36
Chapter 2 SAP NetWeaver
Surveillance des processus métier
Chacun des processus et systèmes informatiques forment la base des processus métier. Avec
SAP Solution Manager, ces contextes peuvent être définis et affichés. Toutes les données
disponibles dans la surveillance de l'exploitation sont à disposition pour modéliser les processus
métier.
L'Automation Engine contrôle les processus centraux de tous les systèmes et applications de
l'entreprise. Grâce à l'intégration de l'Automation Engine à SAP Solution Manager, il est possible de
représenter dans le système SAP les processus métier de l'entreprise et de les surveiller.
Automation Engine
37
Si une erreur se produit dans un processus métier, son origine peut être constatée immédiatement.
Le temps nécessaire à la correction de l'erreur est ainsi réduit et le processus métier redémarre le
plus vite possible.
Contrôle des processus
Solution Manager contient également la fonctionnalité pour le contrôle des processus d'arrière-plan.
A l'heure actuelle, cette fonctionnalité est accessible via les transactions SM36 et SM37.
Ces fonctions sont entièrement prises en charge par l'Automation Engine. L'ensemble du traitement
d'arrière-plan SAP peut être contrôlé et surveillé de manière centralisée avec l'Automation Engine.
En outre, l'Automation Engine associe ces processus SAP aux processus de tous les autres
systèmes et applications de l'entreprise.
Rubriques connexes :
Monitor SAP NetWeaver
2.6.3 Inscription dans le système Landscape Directory
Le système Landscape Directory (SLD) de SAP donne un aperçu des composants logiciels
installés. Vous pouvez configurer l'Agent SAP de sorte qu'il s'inscrive dans le SLD au
démarrage.
Les étapes suivantes sont nécessaires :
38
Chapter 2 SAP NetWeaver
1. Connectez-vous au Client système 0000.
2. Créez un nouvel objet Connexion pour SAP.
3. Ouvrez l'objet Connexion et sélectionnez le type de connexion "Internet" dans l'onglet
Attributs.
4. Allez dans l'onglet Internet et indiquez les données de connexion au SLD.
5. Enregistrez l'objet Connexion et fermez-le.
6. Allez dans le dossier "HOST" et ouvrez l'objet de l'Agent SAP.
7. Sélectionnez l'objet Connexion dans le champ "Moniteur" de l'onglet Agent.
8. Sauvegardez l'objet Agent et fermez-le.
L'Agent SAP essaie désormais de se connecter au SLD à chaque démarrage. Même si l'inscription
échoue, par exemple à cause d'une erreur dans les paramètres de connexion, l'Agent SAP
n'interrompt pas le démarrage.
Le fichier log de l'Agent SAP contient un message indiquant si l'inscription à SLD a réussi.
2.6.4 Analyse du log système et du log application
L'Automation Engine permet la lecture de logs SAP. En font partie les logs application mais aussi
le log système.
Les deux types de log fournissent des informations pour le traitement et les éventuelles situations
d'erreur. Avec les fonctions mises à disposition par l'Automation Engine, vous pouvez lire les
entrées en utilisant des Filtres et les enregistrer dans le rapport ou dans les fichiers. Il est ensuite
possible d'analyser le résultat avec PREP_PROCESS et PREP_PROCESS_FILE.
Pour le log système, il existe une autre particularité. Les Jobs interrompus peuvent enregistrer les
dernières lignes du log système dans un rapport spécial nommé SLOG. Cela vous facilite l'analyse
des erreurs. L'objet Connexion de l'Agent SAP permet de définir entre autres paramètres le nombre
de lignes du log système prises en compte.
JCL pour SAP
Eléments de script
Description
R3_GET_
APPLICATIONLOG
Cherche les messages du log application et les génère dans le
rapport ou le fichier.
R3_GET_SYSTEMLOG
Lit les informations d'une période donnée d'un logging système SAP.
2.6.5 Commutation des modes de fonctionnement
Avec les modes de fonctionnement de SAP, les ressources système disponibles sont utilisées
de manière optimale. Il est possible de définir, en fonction de l'heure du jour, divers paramètres
pour le traitement d'arrière-plan ou par dialogue. Ce type d'attribution des ressources ne
nécessite aucun redémarrage du système R/3.
Automation Engine
39
L'Automation Engine prend, bien entendu, en charge cette fonctionnalité SAP. L'élément de script
R3_SWITCH_OPMODE est à votre disposition pour commuter les modes de fonctionnement pour
tous les serveurs d'applications SAP ou seulement pour certains.
JCL pour SAP
Eléments de script
Description
R3_SWITCH_OPMODE
Change le mode de fonctionnement dans SAP.
40
Chapter 3 SAP Banking
3 SAP Banking
3.1 Gestion de processus pour SAP for
Banking
SAP développe, en collaboration avec d'importantes banques européennes, une solution dédiée
à la gestion des comptes dans SAP for Banking. Les développeurs de l'Automation Engine ont
travaillé à l'intégration de cette nouvelle solution SAP dans la gestion de processus éprouvée de
l'Automation Engine.
Il en résulte la création d'Agent for SAP AM/BCA offrant des capacités complètes de gestion de
processus pour les transactions bancaires. L'Automation Engine intègre cette nouvelle solution
SAP dans sa gestion de processus centrale et assure les processus métier pour toute l'entreprise et
sur toutes les plateformes.
Déroulements dans SAP Banking
Une des particularités de SAP Transaction Banking est que des déroulements entiers peuvent être
enregistrés dans la personnalisation. La définition du déroulement correspond à un type de
Workflow (sous forme tabulaire). Les déroulements sont en fait de soi-disant traitements de fin de
journée (TEV).
Le contrôle de ces déroulements doit prendre en compte les facteurs suivants :
Réseau de processus
Le réseau de processus est créé et surveillé à l'aide d'une fonction de menu d'une définition de
déroulement dans la personnalisation. Il possède un ID unique devant être attribué pour chaque
cycle. Le réseau de processus se compose d'une série de processus. Un processus est une
fonction d'application qui est toujours traitée, d'un point de vue technique, en deux étapes :
1. La fonction d'application même
2. La partie de surveillance de cette fonction d'application. La partie de surveillance n'est
cependant exécutée que si le processus a été initié via un réseau de processus.
Il est désormais possible de traiter de façon synchrone et asynchrone l'ensemble de la fonction
d'application, y compris la partie de surveillance.
Traitement synchrone
La fonction d'application, y compris la surveillance, est traitée de façon synchrone à partir d'un
composant de fonction, c'est-à-dire que le composant de fonction se termine de façon synchrone
avec la fonction d'application.
Traitement asynchrone
La fonction d'application ainsi que la surveillance sont démarrées en tant que Jobs d'arrière-plan,
sachant que le Job de surveillance suit toujours le Job d'application.
Processus avec parallélisation
Pour certains processus (avec données de masse), une parallélisation du traitement (similaire à ISU/IS-T) est prévue. Il n'existe, hélas, aucune fonctionnalité de base pour ce type d'exigence.
Automation Engine
41
Un processus avec parallélisation crée des Jobs d'arrière-plan parallèles, c'est-à-dire un Job
d'arrière-plan parallèle ainsi qu'un Job de surveillance le suivant. Si le processus est démarré de
façon asynchrone, un "Job père" est créé et il est suivi d'un Job de surveillance qui reste actif pour
l'ensemble de la durée du processus.
Les processus ont un code de retour d'application
Les processus comportent un code retour d'application. Le statut technique normal (par ex. Job
terminé) ne suffit pas à garantir un traitement réussi. En outre, un log d'application est généré par
rapport à chacun des composants d'un processus (composant de fonction, ABAP, ABAP de
surveillance, etc.).
Démarrage de réseaux de processus et de processus
Les réseaux de processus sont liés à des fonctions de dialogue et sont initiés par celles-ci. Selon le
cas applicatif, les processus sont alors démarrés de façon synchrone ou asynchrone. (les grands
cycles de façon asynchrone, bien entendu).
Exigences sur l'Automation Engine
Un Workflow AE correspond à une définition du déroulement de la personnalisation. Les Tâches du
Workflow représentent alors les processus.
Le contrôle de Job de la base SAP n'offre pas des moyens appropriés pour le contrôle de processus
dans AM/BCA. Pour le contrôle des processus individuels, il n'est pas possible de créer des Jobs
d'arrière-plan standard, étant donné que la partie de surveillance de la fonction d'application n'a pas
été démarrée et qu'ainsi aucun code retour d'application n'a pu être généré.
Cela n'aurait pas été judicieux de modifier toutes les applications de façon à ce que cette fonction
de surveillance se déroule de façon implicite. Cela aurait créé un trop grand nombre de programmes
; de plus, le code retour d'application aurait dû être communiqué via le log de Job.
C'est pourquoi il est resté l'alternative de créer pour chaque Tâche à partir du Workflow AE un
réseau de processus à ID distinct dans le système SAP. Ce réseau de processus ne contient
jamais qu'un seul processus. Si le processus est démarré à l'aide du réseau de processus, cela
conduit en fin de compte toujours à la création de deux Jobs batch asynchrones dans le système
SAP, la fonction d'application et la fonction de surveillance.
Pour l'Automation Engine, des éléments de script contrôlant les processus ont été définis (BCA_
ACTIVATE_PROCESS).
Pour permettre la surveillance (vérification de statut) par l'Automation Engine, SAP a étendu
l'interface avec une fonction correspondante.
Description de fonction AE
Démarrage et surveillance de processus
Cette fonction encapsule un seul processus dans un réseau de processus, démarre le processus et
le surveille. Avec la fin du processus, le réseau de processus est également terminé parce qu'il ne
contient que ce processus.
Exploitation des codes retour d'application
Les processus individuels renvoient des codes retour d'application. Ceux-ci peuvent être analysés
dans l'Automation Engine. (par exemple dans Postscript).
Exploitation des logs d'application
42
Chapter 3 SAP Banking
Les processus d'un réseau de processus génèrent des logs d'application. Il n'existe cependant pas
un rapport de 1:1 entre les processus ou les réseaux de processus et les logs d'application. C'est
pourquoi l'exploitation des logs d'application est une procédure distincte dans l'Automation Engine.
Cette fonction met à une disposition une possibilité de sélectionner les logs d'application en
fonction de certains critères (des numéros de log sont le résultat). Les messages et textes du log
d'application correspondants peuvent ensuite être lus en fonction des numéros de log. Les textes
sont générés dans un fichier texte ou dans un rapport.
Intégration dans les réseaux de Job
Les processus contrôlés par l'Automation Engine dans SAP AM/BCA peuvent être intégrés aux
Workflows d'entreprise. Les dépendances pour les traitements peuvent être mises en œuvre et
surveillées facilement dans d'autres systèmes SAP, mais aussi dans d'autres systèmes.
Statistiques complètes
Pour tous les processus contrôlés avec l'Automation Engine, des statistiques complètes sont à
disposition pour des analyses et planifications ultérieures. Il en va bien entendu de même pour les
processus de SAP for Banking.
JCL pour SAP
Elément de script
Description
BCA_ACTIVATE_
PROCESS
Démarre et surveille un processus qui se déroule dans un réseau de
processus distinct.
Automation Engine
43
4 SAP Financial Closing Cockpit
4.1 Intégration de l'Automation Engine dans
SAP Closing Cockpit
SAP Financial Closing Cockpit permet de planifier différentes Tâches qui doivent être réalisées
dans un ordre déterminé et à moment précis. Grâce à l'intégration de l'Automation Engine dans
cette fonctionnalité, il est possible d'activer des objets dans un système AE via des Tâches
Closing Cockpit.
Conditions
Service Web Internal
L'utilisation du service Web Internal est possible pour les serveurs d'application suivants :
l
l
l
l
Sun Glassfish
JBoss
IBM WAS CE
SAP Netweaver CE
Pour l'installation, suivez la description de l'installation pour le serveur d'application souhaité.
Veillez à utiliser la version actuelle du service Web Internal.
Version SAP
Pour SAP Basis, il convient d'utiliser une version de Support Package spécifique ou supérieure.
Elle dépend de la version de SAP Release utilisée.
Release
Package Name
700
SABKB70017
701
SABKB70101
710
SABKB71007
Une condition supplémentaire est l'utilisation de SAP ERP version 6.00.
Fichiers fournis
Les fichiers cryptés sont fournis dans le fichier SAP_CloCo.zip.ucc du répertoire
IMAGE:FRAMEWORK\SAPCLOSINGCOCKPIT.
Installation
1.
l
Décryptage du fichier fourni
Pour le décryptage du fichier SAP_CloCo.zip.ucc, utilisez le programme UCYBCRYP.EXE
qui se trouve sur le CD Automation Engine, dans le dossier IMAGE:\TOOLS\ENCRYPT.
Exécutez maintenant le programme via la ligne de commande avec les paramètres
suivants :
UCYBCRYP.EXE -d -f SAP_CloCo.zip.ucc -lFichier de licence
44
Chapter 4 SAP Financial Closing Cockpit
l
l
Le fichier de licence vous est fourni par le Support (Numéro de Client.TXT).
Vous obtenez le fichier compressé nommé SAP_CloCo.ZIP
Décompressez le fichier SAP_CloCo.ZIP
2.
Chargement des transports SAP
Pour l'intégration, des programmes ABAP spécifiques qui doivent être chargés au moyen de
l'importation dans le système SAP sont nécessaires. Vous trouverez pour cela 2 fichiers dans
l'archive SAP_CloCo.ZIP
l
l
KNNNNNN.SID - Fichier d'information
RNNNNNN.SID - Fichier de données
Copiez ces fichiers dans le répertoire de transport de SAO (par exemple, /usr/sap/trans/). Le fichier
R doit être enregistré dans le sous-dossier "data" et le fichier K dans "cofiles".
Connectez-vous au système SAP et importez l'ordre correspondant avec la transaction STMS. A la
fin de l'importation, ouvrez et vérifiez le protocole de transport de l'ordre : toutes les étapes doivent
posséder le code retour 0 (terminé avec succès) ou 4 (terminé avec avertissement).
3.
Etablissement de la connexion RFC HTTP
Exécutez la transaction SM59 et choisissez le point "Connexion HTTP au serveur externe".
Etablissez ensuite une nouvelle connexion.
Attribuez un nom à la destination RFC (par exemple, UC4_WEBSERVICE) avec une description.
Onglet : Configurations techniques :
Dans le champ "Machine cible", il faut entrer le nom d'hôte du serveur d'application sur lequel
s'exécute le service Web Internal. Définissez le numéro de port avec le champ "N° de service".
Onglet : Connexion et sécurité :
Sélection de l'option "Authentification par défaut". Il faut désormais indiquer les données pour
l'accès au système AE : Pour cela, entrez dans le champ "Utilisateur" le client AE, le nom
d'utilisateur et le service, séparés par une barre oblique. Une fois le mot de passe saisi, enregistrez
la connexion RFC.
Automation Engine
4.
Définition du port logique
Démarrage de la transaction Ipconfig
Remplissez les champs comme suit :
Classe de proxy : /UC4/CO_UC4PORT_TYPE
Port logique : UC4
Définissez l'option "Port par défaut".
Le bouton "Nouveau" permet de créer le port logique.
Ensuite, d'autres paramètres s'affichent. Ils doivent être définis comme suit :
Configurations générales :
Onglet Exécution : Web Service Infrastructure
Onglet "Paramètre d'appel" : HTTP Destination
Nom de la destination RFC établie (voir "Etablissement de la connexion RFC HTTP")
Suffixe du chemin : /uc4ws/uc4ws
45
46
Chapter 4 SAP Financial Closing Cockpit
Configurations propres à l'application :
Désactivez toutes les options dans l'onglet "Configurations globales".
Enregistrez puis activez le port logique.
5.
Enregistrement du rapport ABAP pour Closing Cockpit
Exécutez la transaction SM30 et ouvrez le tableau SCMAPROGRAMS pour effectuer des
modifications (bouton "Modifier"). Il faut ensuite ajouter une entrée avec les valeurs suivantes :
Colonne
Valeur
Programme
/UC4/CC_
REPORT
Application
CUSTOMER
Enregistrez la nouvelle entrée.
6.
Test de la connexion
Automation Engine
47
Pour tester la connexion d'ABAP au système AE, le programme AE/CC_REPORT doit être
démarré au moyen de la transaction SE38.
Rubriques connexes :
Services Web AE Internal
4.2 Activation d'objets avec SAP Closing
Cockpit
L'intégration permet d'activer des objets exécutables via des Tâches dans SAP Financial Closing
Cockpit. Vous trouverez l'installation à ce sujet au chapitre Installation de l'intégration de SAP
Financial Closing Cockpit. Ce document explique plus précisément le fonctionnement et
l'utilisation.
Une fois le service Web Internal et l'intégration de Closing Cockpit installés, des objets exécutables
peuvent être attribués aux modèles dans Closing Cockpit. Vous trouverez dans la description cidessous les étapes nécessaires et le comportement à adopter lors de l'exécution.
Configuration
Identifiez-vous dans le système SAP et exécutez la transaction CLOCOC. Ouvrez un modèle
(Modifier) et sélectionnez ensuite à l'emplacement de votre choix de la structure organisationnelle la
commande "Ajouter Tâche" via le menu contextuel. Définissez toutes les valeurs nécessaires dans
le dialogue qui s'affiche. Pour l'option "Type de Tâche", sélectionnez "Programme" et entrez dans le
champ associé /UC4/CC_REPORT. Il faut ensuite sélectionner ou recréer une variante associée.
La variante enregistre le nom de l'objet à exécuter. Les champs restants sont facultatifs et sont
transférés à l'objet activé en tant que valeurs supplémentaires via le tampon de lecture.
48
Chapter 4 SAP Financial Closing Cockpit
Si l'assistant de saisie (F4) est appelé pour le champ "Nom d'un objet", tous les objets exécutables
du Client qui a été indiqué dans Connexion RFC s'affichent. Le nom, le type, le titre et le chemin
des objets s'affichent.
Automation Engine
49
Les champs supplémentaires dans le dialogue Variante servent à transférer les valeurs
supplémentaires à l'objet activé. Vous trouverez dans la liste suivante les noms des Variables de
Script qui sont mises à la disposition de l'objet dans le cache :
Paramètre / champ
Nom de la Variable de Script AE
Périmètre de résultat
KOKRS
Période
PERIO
Année fiscale
AFISCALE
Les "Paramètres supplémentaires" permettent d'inscrire des valeurs autodéfinies dans le tampon
de lecture. La colonne "Variable" permet de déterminer le nom de la Variable de tampon de lecture.
Les valeurs de ces Variables de Script peuvent être lues dans le Script à l'aide de l'élément de script
:READ.
Exemple :
:READ &KOKRS#,,'KOKRS',
Enregistrez ensuite la variante et la Tâche. Créez un plan de Tâches à partir du modèle.
50
Chapter 4 SAP Financial Closing Cockpit
Exécution
La transaction CLOCO permet d'exécuter des plans de Tâches de Closing Cockpit. Ouvrez un plan
de Tâches contenant des Tâches qui activent des objets. Planifiez ces Tâches et contrôlez leur
statut.
Si la Tâche a été exécutée et que le statut dans SAP affiche "Terminé", la Tâche s'est terminée
dans le système AE avec le statut ENDED_OK. Tout autre statut entraîne l'affichage du message
"Erreur" dans Closing Cockpit.
Pour afficher le rapport du Job, ouvrez le Spool de la Tâche dans Closing Cockpit. Le Spool contient
tous les types de rapport AE (ACT, REP, LOG,...) ainsi que les RunID de la Tâche exécutée.
Dans la configuration de Closing Cockpit (CLOCOC), des dépendances peuvent aussi être définies
pour les Tâches qui démarrent des programmes ou des transactions. Pour cela, il faut ouvrir un
modèle ou un plan de Tâches et appeler la vue "Dépendances". Les Tâches peuvent être ajoutées
dans la zone de dépendances par glisser-déposer. Cette fonction est aussi prise en charge pour les
Tâches qui exécutent des objets. Les dépendances permettent de déterminer qu'une Tâche ne doit
démarrer qu'après la fin d'une Tâche spécifique.
Rubriques connexes : Intégration de l'Automation Engine dans SAP Closing Cockpit
Automation Engine
51
5 SAP Solution Manager
5.1 Intégration de SAP Solution Manager
L'Agent SAP permet d'accéder à un système AE grâce au SAP Solution Manager, d'y lire
diverses informations et d'y gérer des processus. La configuration et les utilisations précises de
cette connexion sont décrites ci-dessous.
Certaines fonctionnalités ne peuvent être exécutées directement dans Solution Manager. Mais
la configuration d'une liaison spéciale permet cependant d'ouvrir directement le Solution Manager
via l'Interface Utilisateur et d'accéder rapidement à ces fonctions. Les fonctionnalités concrètes et
la configuration de cette connexion sont disponibles dans la description.
Configuration et test
Pour utiliser le SAP Solution Manager pour l'Automation Engine, les paramètres de l'interface
SMSE (Solution Manager Scheduling Enabler) doivent être configurés dans l'objet Connexion de
l'Agent. L'Agent SAP concerné doit ensuite être redémarré.
Un Agent SAP propre est nécessaire pour l'intégration de SAP Solution Manager.
Dans l'objet Connexion de l'Agent SAP devant être utilisé pour l'intégration, configurez tout d'abord
la connexion au système SAP (objet CONN : Généralités -> Paramètres de connexion). Ensuite,
tous les champs de l'objet CONN dans la zone Interfaces -> SMSE doivent être renseignés :
l
Cliquez sur Activer pour modifier les champs.
Sous Utilisateur AE, vous devez saisir le Client, le nom, le département et le mot de passe
d'un objet Utilisateur AE existant.
l
Le Client AE peut également être indiqué dans le SAP Solution Manager. Dans ce cas,
l'utilisateur indiqué dans l'objet Connexion doit aussi exister dans le Client.
Sous Serveur RFC, vous devez définir la passerelle SAP et la connexion RFC. La
destination RFC est créée automatiquement au démarrage de l'Agent SAP. L'ID du
programme et le nom de la connexion RFC peuvent ainsi être choisis librement.
l
52
Chapter 5 SAP Solution Manager
Redémarrez l'Agent et exécutez ensuite la transaction EXTSDL dans le système SAP. La
connexion RFC qui a été définie dans l'objet Connexion devrait y être listée et définie comme valeur
par défaut. Le bouton "Connection Test" vous permet alors de vérifier si la connexion à l'Automation
Engine a été établie avec succès.
Fonctionnalité
Après la configuration réussie, les fonctionnalités suivantes peuvent être exécutées via le SAP
Solution Manager :
Fonctionnalité
Description
Lire des Clients
Liste de tous les Clients du système AE et descriptions.
Interrompre des tâches
Commandes possibles : Interrompre, Stop, Stop
(récursif), Go, Go (récursif).
Définir le statut des tâches
Demander le statut d'une certaine activité.
Déterminer le dossier
Une liste est fournie avec l'ID, le nom de dossier, le titre
de dossier et le nom du dossier subordonné.
Les noms des dossiers et des dossiers parents sont
tronqués à partir de 80 caractères. La longueur maximale
du titre est de 255 caractères. Les dossiers spéciaux
comme la corbeille, le conteneur Transport, <Aucun
dossier>, etc. ne sont pas affichés dans la liste.
Etablir la liste du système SAP
Nom et description de l'Agent SAP de chaque Client. La
description supplémentaire contient la version SAP de
base et la version Automation Engine de l'Agent.
Demander la liste de la Queue
Nom de l'objet, titre et slots max. des Queues.
Déterminer les types d'objets
exécutables
Liste avec le type et la description des objets exécutables
(par ex. : notification CALL, etc.)
Automation Engine
Déterminer les objets exécutables
53
Liste avec le nom et le type d'objet des objets
exécutables.
Il est possible de mentionner ici un certain dossier dont
les objets doivent être listés. Il est également possible le
nom ou le type d'objet comme filtre de recherche.
Déterminer le filtre de statut
Liste des groupements de statuts utilisés pour le filtrage
d'activités (par ex. :ANY_OK, ANY_ABEND, etc.)
Demander la liste des activités
Contenu de la Fenêtre d'activités de chaque Client.
Il est possible d'indiquer un filtre de statut et un ordre de
tri (croissant / décroissant) afin de limiter les résultats.
Les champs heure/date (par ex. heure de début) sont
convertis et affichés dans UTC. On considère ici que le
Fuseau horaire en vigueur dans l'Automation Engine
correspond au fuseau horaire local.
Liste des rapports d'une tâche
Liste de tous les rapports / sorties d'une tâche.
Cette liste contient le type de rapport (par ex. REP ou
ACT) et le type de sortie ("L" = Joblog, "S" = Spool-Liste,
"A" = ApplicationLog, "O" = Other).
Lire le contenu d'un rapport
Déterminer le contenu d'un rapport d'une tâche.
Déterminer l'utilisateur d'une tâche
Déterminer le nom et le département de l'utilisateur qui a
démarré la tâche.
Lus à partir du détail des statistiques. Si le nom dépasse
40 caractères, il est alors tronqué.
Lire les paramètres Prompts d'une
définition d'objet
Les paramètres suivants peuvent alors être lus :
Lire les paramètres d'une tâche
Lire le nom et la valeur des variables Objet et PromptSet
d'une activité (Détail - Variables d'objet)
Créer / supprimer des évènements
BAE dans l'Automation Engine
Créer / supprimer des évènements BAE en tant qu'objet
Sync
-) Nom de l'objet PromptSet
-) Variable de référence
-) Type d'élément PromptSet ("N" = Nombre, "D"
= Marque horaire, "S" = Tous les autres types)
-) Valeur de l'élément PromptSet
-) Propriété "Valeur nécessaire" ("X" = Option activée, " "
= Option non activée ou inconnue)
-) Assistant de saisie disponible ("X" = Oui, " " = Non ou
inconnu)
Les objets Sync représentant des évènements BAE ont
défini la valeur "SMSE" comme index d'archivage 1. Il est
donc possible de rechercher / filtrer ces objets spéciaux.
En outre, les objets Sync disposent seulement de deux
statuts CLEARED (état initial) et RAISED.
54
Chapter 5 SAP Solution Manager
Lire des évènements BAE à partir de
l'Automation Engine
Déterminer les objets Sync qui représentent les
évènements BAE (type d'objet = SYNC, Index
d'archivage 1 = SMSE)
Il est alors possible de réaliser un filtrage sur le nom de
l'objet.
Déterminer le statut des évènements
BAE à partir de l'Automation Engine
Statut actuel d'un objet Sync représentant un évènement
BAE. Le Moniteur Sync est alors lu. De plus, le titre de
l'objet est fourni comme description.
Valeurs possibles: R (RAISED) ou C (CLEARED)
Interroger les instances d'un
évènement BAE
Liste des tâches en attente d'un objet Sync représentant
un évènement BAE. Est également lue à partir du
Moniteur Sync.
Lire des messages
Lire le Moniteur d'objets Message actifs ou achevés
Sont fournis :
-) Objet
-) Possibilités de réponse
-) Texte du message
-) Activateur (RunID)
-) Heure de début
-) Statut (en fonction du type de message. Alarme /
Requête : "Q" = actif, "R" = achevé. Message : "N"
= actif, "R" = achevé)
-) Type de l'objet Déclencheur
Lire le texte de messages
Déterminer le texte d'un message actif
Paramètre de saisie : RunID du message
Confirmer un message
Accepter ou refuser un message actif
Paramètre de saisie : RunID du message
Planifier, modifier et démarrer des
tâches
Les actions suivantes sont possibles :
-) Activer une tâche une fois ou périodiquement
-) Reprise d'une tâche
-) Reprise d'une tâche à partir du dernier point de reprise
-) Modification de la planification. Lorsque l'activation est
par exemple basculée de périodique à unique, la tâche est
à nouveau planifiée (nouveau RunID).
Ces fonctionnalités (hormis "Lire des Clients") se rapportent au Client AE mentionné dans l'objet
Connexion pour l'interface SMSE.
5.2 SAP Solution Manager - Cas d'application
Le document suivant décrit les cas d'application typiques de la SAP Solution Manager Integration.
L'intégration avec SAP Solution Manager permet l'accès aux fonctionnalités. De plus, la
planification des tâches est possible à partir du Job Scheduling Workcenter dans SAP Solution
Manager.
Automation Engine
55
La planification peut s'effectuer soit directement, soit à partir de la documentation de Job SAP.
L'Automation Engine peut ainsi être intégré dans SAP Change Management ou le Service Desk.
Vous trouverez les informations sur la configuration et le test de l'intégration au chapitre SAP
Solution Manager Integration.
Pour les cas d'application suivants, le Job Scheduling Workcenter (Transaction : SOLMAN_
WORKCENTER) du SAP Solution Manager doit être démarré.
Cas d'application 1: rechercher le Job via le Solution Manager
1. Dans le SAP Solution Manager Workcenter, à la rubrique Job Monitoring, sélectionnez
l'élément "External Job Scheduler".
2. Il est ensuite possible de définir des critères de filtrage pour rechercher les jobs. Le Groupe
Isolation correspond alors au client AE.
3. Un clic sur "Apply" vous permet d'afficher les Jobs trouvés dans la table.
Cas d'application 2 : planification des tâches à partir d'une
documentation de Job
Pour planifier des objets dans l'Automation Engine à partir de la documentation de Job SAP,
veuillez procéder de la manière suivante :
1. Ouvrez une documentation de Job SAP et sélectionnez un système dans l'onglet
"Systèmes".
2. Le bouton "Scheduling" vous permet d'accéder à l'interface de planification des tâches.
3. Définissez les paramètres requis tels que le client AE (champ : Separation Group), la
connexion RFC, l'objet Queue, la priorité et le nom de l'objet à démarrer (champ : définition
du Job).
56
Chapter 5 SAP Solution Manager
Un Assistant de saisie est mis à disposition pour la sélection de l'objet à démarrer (définition
du Job). Dans l'Assistant de saisie, tous les objets exécutables du client AE précédemment
indiqué sont listés. La liste peut être filtrée selon le dossier (ID of an application), le type
d'objet (Definition Type) ou le nom de l'objet (Job Definition).
Automation Engine
57
4. Le bouton "Schedule/Change Externally" vous permet de planifier ensuite la tâche dans
l'Automation Engine. Le RunID de la tâche activée s'affiche ensuite comme message de
retour dans la zone supérieure.
5. Le bouton "External Notes" vous permet d'ajouter des commentaires concernant une
exécution.
6. "External Logs" affiche les rapports AE de la tâche. Toutefois, les rapports externes ne sont
pas disponibles !
Cas d'application 3 : planification directe des tâches
Après l'ouverture du Job Scheduling Workcenter, l'élément de menu "Schedule Jobs" permet de
planifier directement des objets dans l'Automation Engine.
1. Lors de la sélection du planificateur, l'élément "SMSE" doit être sélectionné pour
l'Automation Engine.
2. Sélectionnez ensuite la connexion RFC avec le client AE correspondant. Veuillez noter que
le client AE s'affiche en tant que Groupe de séparation. Dans l'Automation Engine, le Groupe
de séparation doit donc toujours afficher un chiffre (p. ex. : 1010). L'élément RFC avec
Separation Group GLOBAL peut être ignoré.
58
Chapter 5 SAP Solution Manager
3. Redéfinissez les paramètres requis pour l'objet à démarrer (connexion RFC, Separation
Group, queue, priorité et nom de l'objet). Le nom de l'objet à démarrer doit être indiqué dans le
champ "Job Definition" ; un Assistant de saisie est alors mis à disposition.
De même que pour le cas d'application 2, la tâche est planifiée dans l'Automation Engine via
le bouton "Schedule/Change Externally".
Des objets Calendrier temporaires sont générés dans l'Automation Engine pour les
conditions de démarrage.
Définissez l'option "Schedule Stopped", la tâche planifiée reste dans l'Automation Engine
avec le statut d'attente "Attente de libération manuelle", jusqu'à ce qu'elle soit libérée
manuellement.
Vous avez également la possibilité de modifier ultérieurement les planifications déjà
existantes. Après l'adaptation, cliquez sur le bouton "Reschedule" pour appliquer les
modifications dans l'Automation Engine.
Automation Engine
59
5.3 Configurer une connexion avec
l'Interface Utilisateur
Certaines fonctionnalités, comme par exemple l'ouverture de Jobs, ne peuvent être directement
effectuées dans SAP Solution Manager. Avec une configuration spéciale, il est cependant
possible d'ouvrir l'Interface Utilisateur via Solution Manager à l'emplacement correspondant et
d'accéder ainsi rapidement à ces fonctionnalités.
Il s'agit alors concrètement des fonctionnalités suivantes :
l
l
l
Créer et modifier des objets Job
Lister les objets Job existants
Créer et modifier des Workflows
Suivez les étapes suivantes pour configurer l'intégration de l'Interface Utilisateur. La configuration
générale de l'intégration de SAP Solution Manager est décrite dans le présent document.
Fichiers fournis
L'Interface Utilisateur est fournie sous forme d'application Web à intégrer à un serveur d'application
Tomcat. Un serveur d'application Tomcat (version 7) est donc nécessaire pour l'installation.
L'application Web est disponible dans le répertoire fourni suivant : IMAGE:\AGENTS\SAP\_
SOLMAN\
Nom du fichier
Description
UC4WEBSTART.WAR
Interface Utilisateur pour le serveur d'application
Déroulement
1.
l
l
l
l
Configuration de l'application Web UI
Hôte
Copiez le fichier UC4WEBSTART.WAR dans le dossier "webapps" situé dans le répertoire
de programme du serveur d'application Tomcat.
Procédez ensuite à un redémarrage du serveur d'application.
Le nouveau sous-dossier "UC4WEBSTART" est créé dans le répertoire "webapps".
Ne supprimez pas le fichier WAR, sinon Tomcat fera de même avec le dossier
"UC4WEBSTART".
2.
l
l
l
l
l
Adaptation du fichier de configuration
Hôte
Cette étape décrit à quel système AE l'Interface Utilisateur doit se connecter.
Veuillez noter qu'une seule connexion peut être configurée pour l'Interface Utilisateur !
Ouvrez le fichier de configuration :
<Répertoire Tomcat>/webapps/uc4webstart/WEB-INF/web.xml.
Adaptez les paramètres suivants à votre environnement système :
l
Nom du serveur : Nom ou adresse IP de l'ordinateur sur lequel est exécuté le
système AE.
60
Chapter 5 SAP Solution Manager
l
l
Nom du système : Nom du système AE
Numéro de port : Numéro de port du CP avec lequel la connexion doit être établie.
Exemple de partie pertinente et à adapter du fichier web.xml :
<init-param>
<param-name>Nom du serveur</param-name>
<param-value>SAPHOST01</param-value>
</init-param>
<init-param>
<param-name>Nom du système</param-name>
<param-value>UC4</param-value>
</init-param>
<init-param>
<param-name>Numéro de port</param-name>
<param-value>2217</param-value>
</init-param>
3.
l
l
l
l
Configuration de l'Agent
Ordinateur de l'Agent
Ouvrez le fichier INI de l'Agent SAP pour lequel l'intégration du SAP Solution Manager a été
configuré.
Saisissez l'URL de l'application Web Interface Utilisateur comme valeur du paramètre
WebStartURL= (section [SMSE]).
Enregistrez le fichier INI, puis redémarrez l'Agent.
Exemple :
[SMSE]
webStartURL=http://saphost01:8080/uc4webstart
4.
Affichage de l'Interface Utilisateur
Lorsqu'une des fonctionnalités mentionnées est affichée dans Solution Manager, l'URL indiquée
dans le fichier INI de l'Agent est ouverte.
Dans le navigateur Web, la page qui s'affiche contient le lien "Démarrer l'Interface Utilisateur".
Après avoir cliqué dessus, la boîte de dialogue de connexion à l'Interface Utilisateur apparaît. Après
la connexion réussie, la fonction sélectionnée est exécutée dans l'Interface Utilisateur.
Exemple : Lorsqu'un nouveau Job est créé via le SAP Solution Manager, l'Interface Utilisateur est
ouverte et la boîte de dialogue qui s'affiche nécessite de saisir un nom pour le nouvel objet Job.
Automation Engine
61
6 Solutions personnalisées
6.1 Archivage des données dans SAP
L'archivage des données dans le système SAP sert à supprimer de la base de données les
données de masse n'étant plus nécessaires dans le système, mais devant toutefois être
conservées pour être exploitables. Vous pouvez, bien entendu, contrôler l'archivage des données
de façon centrale avec l'Automation Engine.
Les données à archiver sont rassemblées au sein d'"objets d'archivage" (par ex. l'objet d'archivage
SD_VBAK comporte toutes les données relatives aux documents de vente). Les cycles d'archivage
sont intégrés au ADK (Archive Development Kit). L'ADK représente la base technique de la
transaction d'archivage (SARA).
Pour chaque objet d'archivage, il existe en règle générale un programme qui marque les données à
archiver sur la base de durées de résidence réglables. Dans de nombreux cas, l'utilisation des
indicateurs s'effectue en 2 étapes : un repère de suppression est défini après écoulement de la
durée de résidence 1 (par ex. 6 mois), puis remplacé par un indicateur de suppression après
écoulement de la durée de résidence 2. L'objet devient alors archivable.
Le processus d'archivage se compose en fait de quatre étapes :
1. Cycle préparatoire (indicateur de suppression) :
le cycle préparatoire marque les données à archiver. Le cycle préparatoire peut également
être exécuté indépendamment du cycle d'archivage.
2. Création de fichiers d'archive :
lors de l'archivage, les données à archiver sont tout d'abord écrites séquentiellement dans
des fichiers d'archive nouvellement créés.
3. Début du programme de suppression :
sur la base des fichiers d'archive créés, le programme de suppression supprime les données
de la base de données.
4. Stockage des fichiers d'archive :
les fichiers d'archive créés peuvent ensuite être stockés dans un système de stockage ou
alors, par exemple, être enregistrés sur bande magnétique. Le stockage dans le système de
stockage peut être enclenché automatiquement ou manuellement.
Du point de vue de la transaction SARA, l'exécution d'un cycle d'archivage peut se faire
manuellement ou semi-automatiquement (suppression et stockage). L'Automation Engine
automatise les cycles d'archivage des données en principe pour toutes les versions de SAP.
Pour une exécution de l'archivage des données hors transaction SARA, il faut toujours tenir compte
des remarques suivantes en ce qui concerne SAP :
l
l
458670 Archivage des données avec un planificateur de Job externe
133707 Archivage des données hors transaction SARA
Contrôle avec l'Automation Engine
Au niveau technique, les cycles d'archivage SAP, quel que soit l'objet d'archivage, sont toujours
organisés selon les étapes suivantes :
1. Programme d'écriture (WRI)
Le programme d'écriture comprend le cycle préparatoire et la création des fichiers d'archive.
Il s'agit d'un programme normal, pouvant s'exécuter en Tâche d'arrière-plan, paramétré à
62
Chapter 6 Solutions personnalisées
l'aide d'une seule variante.
2. Programme de suppression
Le programme d'écriture crée automatiquement pour chaque fichier d'archive un Job de
suppression (DEL), si cela a été défini ainsi dans la personnalisation de l'objet d'archivage
concerné. Le Job DEL contient le programme de suppression.
3. Stockage des fichiers d'archive (STO)
Le programme de suppression crée automatiquement un Job de stockage (STO). Le Job
STO contient le programme de stockage.
4. Post-traitement éventuel (END)
Les Jobs de post-traitement se produisent également automatiquement, mais ne sont
cependant pas disponibles pour tous les objets d'archivage.
Prérequis dans SAP
1. Programme de suppression automatique
Dans la personnalisation de chaque objet d'archivage, il faut définir que le programme de
suppression est démarré automatiquement.
2. Les Jobs DEL, STO et END ne peuvent pas être démarrés automatiquement dans SAP
Pour contrôler les Jobs DEL, STO et END à l'aide de l'Automation Engine, il faut éviter que
ces derniers ne démarrent automatiquement dans le système SAP. Pour ce faire, on utilise
la fonctionnalité "Job Interception" à partir de la version 4.6C. Il faut activer celle-ci avec le
programme ABAP INITXBP2. La table de décision pour l'interception de Job doit contenir les
noms de Job des Jobs DEL, STO et END des cycles d'archivage.
Objets
L'ensemble du déroulement est contrôlé à l'aide d'un Workflow. Le Workflow comporte 3 étapes :
1. Début et surveillance du programme d'écriture
La fonction AE "Exécuter Programme ABAP" crée le Job WRI dans SAP et le surveille
jusqu'à sa fin.
2. Début et surveillance du Job de suppression
Les Jobs DEL créés par le Job WRI sont démarrés et surveillés à l'aide de la fonction AE
"Sélectionner et démarrer les Jobs interceptés".
3. Début et surveillance des Jobs de stockage
Les Jobs de stockage créés par le Job DEL sont également démarrés et surveillés à l'aide de
la fonction AE "Sélectionner et démarrer les Jobs interceptés".
Automation Engine
63
Déroulement
1. Activation du Workflow
L'Utilisateur peut également consulter le nom de l'objet d'archivage à l'aide d'un masque
:READ.
2. Moniteur de Workflows
Après sélection ou indication de l'objet d'archivage, le Workflow est automatiquement
démarré et affiché sur le moniteur. Il ne s'arrête que lorsque toutes les étapes du traitement
se sont bien terminées.
3. Surveillance et contrôle
L'ensemble du déroulement peut être suivi au sein de l'Automation Engine, mais également
de SAP. Tous les protocoles pour l'analyse automatique sont disponibles dans l'Automation
Engine. Il est également possible de déterminer l'objet d'archivage utilisé pour le
déroulement dans la fonction de gestion à partir du côté SAP (transaction SARA).
Récapitulatif
L'archivage des données SAP est facile à réaliser avec la fonctionnalité standard de l'Automation
Engine. Avec une mise en œuvre restreinte, une telle méthode offre une série d'avantages :
l
l
l
l
l
l
Automatisation continue
Le contrôle de l'archivage de données par Automation Engine permet l'automatisation
continue de l'ensemble du système de gestion SAP. Nul besoin d'interventions manuelles.
Les dépendances mutuelles aux autres processus sont faciles à mettre en œuvre.
Economies
L'archivage régulier des données permet d'assurer des dimensions de base de données
optimales, améliore la performance tout en économisant de l'espace. Contrôlé centralement
et exécuté automatiquement, cet avantage peut être obtenu sans frais supplémentaires,
grâce à l'Automation Engine.
Exploitation optimale des ressources
En raison de contrôles centraux et automatisés, les ressources disponibles peuvent être
utilisées de manière optimale. Les conflits et les goulots d'étranglement sont ainsi évités. Un
fonctionnement sans encombre de SAP est assuré.
Haute fiabilité
L'automatisation de tous les paramètres système réduit nettement le nombre de sources
potentielles d'erreur.
Décharge du personnel
Les spécialistes SAP sont libérés des Tâches manuelles contraignantes. Ils peuvent ainsi
concentrer leurs compétences sur les domaines les plus importants : l'amélioration des
systèmes et des niveaux de service.
Contrôle et surveillance centralisés
Tous les processus du système SAP sont surveillés et contrôlés de manière centralisée.
64
Chapter 6 Solutions personnalisées
Les problèmes potentiels sont reconnus immédiatement, la durée jusqu'à la correction
d'erreurs est réduite au minimum absolu.
6.2 Traitements en masse
IS-U est la solution sectorielle de SAP pour le secteur de l'approvisionnement.
IS-U, en tant que système de facturation pour les sociétés d'approvisionnement et de prestation de
services en particulier est personnalisé par rapport aux exigences des activités
d'approvisionnement. Grâce à l'intégration d'IS-U aux composants neutres de la norme R/3 et grâce
à des interfaces vers des systèmes externes, SAP offre aux sociétés d'approvisionnement une
solution globale, intégrée et d'entreprise pour le traitement des informations commerciales.
Le volume des transactions des entreprises d'approvisionnement, avec leurs millions de Clients,
différents types d'approvisionnement et éventuellement une facturation mensuelle, est traité, pour
sa plus grande part, dans des tâches d'arrière-plan.
En voici des exemples :
l
l
l
l
l
l
Création de documents de lecture
Contraintes de remise
règlement/facturation
Cycle de relance
Cycle de paiement
etc.
Définition
L'Automation Engine est capable d'automatiser ces exigences d'arrière-plan. Pour réussir le
traitement de ces gros volumes de données avec un débit le plus optimal possible, un "traitement en
masse" spécial a été développé pour le traitement d'arrière-plan.
Les caractéristiques de ce traitement en masse sont les suivantes
l
l
un nombre dynamique de Jobs fractionnés naît d'un Job maître
Chaque cycle de traitement en masse nécessite un jeu de paramètres, identifié par la date et
l'ID de cycle
Une des exigences particulières du traitement en masse est également le respect d'un certain
ordre, par exemple "Règlement" doit se dérouler avec "Facturation", les deux étant un traitement en
masse.
Technique
Le traitement en masse comprend un répartiteur qui génère avec l'aide de la définition des
paramètres des Jobs fractionnés parallèles.
Le répartiteur est lui-même défini dans le traitement d'arrière-plan comme "Job maître" lors de
l'ordonnancement du traitement en masse. Si le Job maître est exécuté, il crée un certain nombre
dynamique de Jobs fractionnés. Le nombre de Jobs fractionnés dépend des paramètres définis.
Le contrôle se fait avec l'Automation Engine. L'ordonnancement peut également être effectué dans
l'Automation Engine ou dans SAP.
Automation Engine
65
6.3 Copie de Client dans SAP R/3
SAP R/3, tout comme Automation Engine, est une application orientée client. Chacun des
Clients est une unité entièrement indépendante. Dans plusieurs cas, un échange de données
régulier entre les Clients est nécessaire. L'Automation Engine permet d'automatiser ces
processus.
Le "Client" est le terme de classement le plus élevé pour les applications R/3. Les définitions au
niveau des Clients sont valides dans toutes les structures de l'organisation de l'entreprise sous R/3.
Le Client est une unité indépendante au niveau de la gestion des données, au niveau de la gestion
de l'entreprise et au niveau de l'organisation.
Dans la pratique, ce concept de Client peut, par exemple, être utilisé pour l
l
héberger dans un centre de calcul de nombreux Clients sur un système R/3 configurer sur un système R/3 plusieurs Clients avec diverses Tâches, par exemple :
l
Client de livraison SAP (Client 000)
l
Client de personnalisation (001)
l
Client test l
Client d'assurance qualité l
Client de production
Dans un tel environnement, il est souvent nécessaire de fournir à un Client d'assurance qualité ou à
un Client test des données cohérentes. Vous obtiendrez au mieux ces données en copiant le Client
de production. Pour un environnement de test réaliste, des copies de Client doivent être créées
régulièrement.
Copie de Client dans SAP R/3
La copie de Clients dans SAP R/3 comporte une série de problèmes. En particulier, des copies
régulières pour fournir des données actuelles aux systèmes de test sont synonymes d'une certaine
quantité de travail.
SAP prend en charge la copie en ligne ou le transport des Clients. Etant donné qu'il s'agit ici de
transactions, ces méthodes ne sont adaptées qu'à une exécution périodique (SAP version 4.0 à
4.6D).
Le contrôle d'arrière-plan de SAP ne peut pas non plus exécuter régulièrement de telles
transactions, car des variantes dynamiques sont utilisées.
Exposé du problème
Lors de la copie d'un Client, de grandes quantités de données sont déplacées. Un Client sans
données d'application nécessite environ 500 Mo de mémoire dans la base de données. La copie
peut donc durer plusieurs heures. Pendant ce temps, un ou plusieurs processus de dialogue sont
occupés.
Aucun Utilisateur ne doit travailler dans le Client source ou cible pendant le processus de copie. Les
Utilisateurs d'autres Clients utilisent des ressources supplémentaires et rallongent le processus de
copie.
Avant la copie d'un Client, un cycle de test doit être exécuté. Cela permet de déterminer les tables
qui doivent être modifiées. En outre, le système vérifie si la base de données dispose d'un espace
mémoire suffisant.
Avant la copie d'un Client, le Client cible est souvent supprimé. Tous les Groupes Utilisateurs sont
alors également supprimés. Seul l'Utilisateur SAP* peut encore s'identifier dans le Client cible.
66
Chapter 6 Solutions personnalisées
Copie de Client dans R/3 avec l'Automation Engine
Des copies périodiques des Clients peuvent être effectuées plus facilement et de façon plus
sécuritaire avec l'Automation Engine. Les cycles de test et le processus de copie peuvent être
exécutés automatiquement. L'exécution normale est ininterrompue.
Le processus de copie est démarré en fonction des résultats du cycle de test et de la disponibilité
des ressources. Si des erreurs se déclarent au cours du traitement, l'Automation Engine informe
immédiatement le personnel de garde responsable. Pour que l'Automation Engine puisse créer des
copies de Client, il faut que les prérequis suivants soient remplis dans le système SAP :
l
l
Les Groupes Utilisateurs ne doivent pas être supprimés avant la copie.
L'Automation Engine utilise un compte utilisateur normal pour l'identification à SAP étant
donné qu'il ne peut s'identifier avec l'utilisateur SAP*. SAP offre la possibilité de ne pas
supprimer le Client cible avant la copie. Il est également possible de supprimer les grandes
tables à l'aide d'ABAP spéciaux (voir également SAP Service Marketplace, conseil numéro
365304).
Le rapport RSCLXCOP doit être modifié, afin de pouvoir traiter les variantes du
rapport.
Un Job de copie de Client obtient les informations nécessaires d'une variante. Lors de
l'exécution d'une copie de Client, celle-ci est remplacée par les données issues du Client
source, ou alors elle est supprimée. Lors d'une exportation de Client, le numéro de la copie
se trouvant dans la variante est entré pour de bon. Cela provoque des problèmes pour les
ordonnancements périodiques. C'est pourquoi des variantes identiques (du même nom)
doivent être créées dans le Client source et cible pour le rapport RSCLXCOP. La procédure
exacte est détaillée dans le conseil numéro 303007 de SAP Service Marketplace.
Une fois ces prérequis remplis, il est possible de créer dans l'Automation Engine un Job pour
l'exécution d'une copie de Client. Cela permet de représenter des dépendances au sein d'un
Workflow. Le cycle de test ainsi que le processus de copie peuvent être exécutés
automatiquement. L'Automation Engine s'assure que des ressources suffisantes soient
disponibles. Des copies régulières des Clients peuvent ainsi être effectuées bien plus facilement et
de façon bien plus sécuritaire.
6.4 Dialogue SAP pour l'Automation Engine
Dialogue SAP pour l'Automation Engine est une interface pour les Utilisateurs de SAP R/3 à
partir de laquelle vous pouvez déclencher des traitements dans le système AE. Les Tâches
définissables dans SAP sont transmises au système AE avec CallAPI pour SAP.
La transaction "/sbb/uc4dc" affiche l'interface de l'Utilisateur final qui contient la vue des Tâches.
Ainsi, seules les Tâches auxquelles il est autorisé à accéder sont proposées à l'Utilisateur. Elles
peuvent être divisées en classes et portent un nom évocateur. Pour en sélectionner une, il suffit de
cliquer dans la liste. Ensuite, en fonction de la définition, l'interrogation des Variables ou des
attributs, ou la maintenance d'une variante. Chaque activation de Tâche est enregistrée dans les
statistiques.
l
Activation avec saisie d'attributs définissables librement
Les attributs sont définissables librement et sont transmis à l'Automation Engine via :PUT_
READ_BUFFER.
l
Connexion directe à la maintenance des variantes par défaut
L'utilisation d'ABAP standard via l'Automation Engine permet d'avoir une connexion directe à
la maintenance des variantes. Seule la variante prédéfinie peut être maintenue.
Automation Engine
l
67
Création de Workflows
Il est possible de créer un Workflow à l'aide des Variables. Vous pouvez ainsi, par exemple,
sélectionner les composants devant être exécutés à partir d'un déroulement prédéfini. La
communication vers le Workflow au sein de l'Automation Engine se fait uniquement par la
définition de Variables.
l
Statistiques et suivi du statut
L'Utilisateur dispose de statistiques permettant de comprendre toutes les activations. En
outre, une Tâche peut, par exemple, être interrompue précisément ou un statut actuel peut
être synchronisé.
Le dialogue SAP pour l'Automation Engine ne remplace pas l'Interface Utilisateur à tous les
niveaux. Il aide les Utilisateurs qui utilisent uniquement l'interface utilisateur SAP et qui souhaitent
contrôler à l'aide de l'Automation Engine ses Tâches d'arrière-plan (Jobs, Workflows) à partir de
SAP.
Le dialogue SAP pour l'Automation Engine est une solution de consultant et ne fait pas partie du
produit ! Il ne bénéficie donc pas d'une maintenance !
6.5 Automated SystemCopy for SAP
Cette solution AE vous permet d'exécuter une copie du système SAP de manière entièrement
automatisée. Le procédé peut être adapté à votre convenance et vous pouvez déterminer
exactement quelles étapes doivent être réalisées.
Automated SystemCopy for SAP est une solution de consultant et ne reçoit donc aucune
maintenance ! La documentation relative à cette solution est disponible sous forme de document
externe.
68
Chapter 7 Liaison technique
7 Liaison technique
7.1 Automation Engine et SAP
La connexion entre l'Automation Engine et SAP est établie via un Agent. Dans son fichier INI se
trouve les données de connexion à un système AE déterminé. Les données de connexion à un
système SAP sont consignées dans des objets Connexion. L'Agent a besoin d'au moins un objet
Connexion dans lequel l'Utilisateur CPIC est entré avec ses données de connexion.
Un Job requiert la spécification d'un Agent et d'un objet Login. Dans les informations de connexion,
vous définissez dans quel Client SAP le Job sera exécuté.
Lors de la création d'un Job, l'onglet "Forme" est utile. Il offre une interface graphique dans laquelle
les lignes de script peuvent être créées aisément. En outre, certaines données peuvent être
fournies par le système SAP (par exemple : variantes disponibles). L'Agent SAP établit la
connexion requise au système SAP. Les nom d'utilisateur, mot de passe et Client sont repris
depuis l'objet Connexion pour "ABAP Basis"
Rubriques connexes :
Onglet Forme
7.2 Plusieurs systèmes SAP
Cette description montre de quelle façon est réalisée la configuration lors de l'utilisation de
plusieurs Agents SAP exécutés sur différents systèmes SAP.
Agents SAP supplémentaires
1.
Renseignez le fichier de définition du ServiceManager UC4.SMD.
Entrez les autres Agents dans le fichier de définition du ServiceManager en fonction de l'exemple
suivant.
La chaîne *OWN est automatiquement remplacée par le chemin dans lequel le ServiceManager se
trouve (ucybsmgr.exe).
! Les lignes de commentaires commencent par un point d'exclamation
!
! Les sous-services sont maintenant définis
!DEFINE Automation Engine;*OWN\UCServer.exe;*OWN
DEFINE UC4 C11-Agent;*OWN\C11\UCXJR3X.exe -i*OWN\UCXJC11.INI;*OWN
DEFINE UC4 XYZ-Agent;c:\uc4global\bin\XYZ\UCXJRX3.exe ic:\uc4global\bin\XYZ\UCXJXYZ.INI;*OWN\XYZ
Ces entrées peuvent également être dupliquées et adaptées avec le dialogue du ServiceManager
dans le fichier UC4.SMD.
2.
Créer les fichiers *.INI.
Automation Engine
Créez, pour chaque nouvel Agent entré, un fichier UCXJ*.INI du nom convenu dans l'Automation
Engine.SMD. Idéalement, copiez le fichier d'un Agent existant (par exemple UCXJR3X.INI vers
UCXJC11.INI).
Renseignez ou vérifiez UCXJ*.INI dans les fichiers créés.
3.
Renseigner SAPRFC.INI (uniquement lors de l'utilisation de SAPRFC.INI)
Complétez plusieurs chapitres de SAPRFC.INI (anciennement SIDEINFO) comme ils sont
indiqués dans les fichiers UCXJ*.INI, en fonction de l'exemple suivant :
DEST=UC_C11
LU=R33
TP=sapdp00
GWHOST=R33
GWSERV=sapgw00
PROTOCOL=I
DEST=UC_XYZ
LU=R33
TP=sapdp01
GWHOST=R33
GWSERV=sapgw01
PROTOCOL=I
4.
Terminer et démarrer le ServiceManager.
Terminez le ServiceManager et redémarrez-le. Ensuite, les autres Agents devraient être
disponibles. N'oubliez pas de créer l'Utilisateur pour RFCLOGIN dans le système SAP
correspondant !
7.3 Objets SAP Security
Les autorisations requises pour les Jobs AE dépendent de l'installation et des fonctions utilisées
dans l'Automation Engine. Dans le présent document sont mentionnés tous les objets
d'autorisation dont a besoin l'Utilisateur CPIC pour une utilisation complète de toutes les
fonctionnalités.
Le tableau suivant part du principe que vous connaissez bien le concept d'autorisation de SAP.
Objet
d'autorisation
S_RFC
Connexion à l'AE
Lorsque vous définissez le
paramètre de profil
auth/rfc_authority_check,
SAP vérifie si l'Utilisateur
RFC dispose de
l'autorisation d'exécuter le
groupe de fonction.
Nom du champ
ACTVT RFC_
NAME RFC_
TYPE
Valeur
*
*
*
69
70
Chapter 7 Liaison technique
S_BTCH_JOB
Traitement de batch
: Opérations sur les
Jobs de batch
AE crée des Jobs SAP
JOBACTION
dynamiquement et
JOBGROUP
nécessite donc
l'autorisation de planifier
des Jobs, de les surveiller
et de les libérer. AE crée,
en outre, des Jobs en
utilisant le programme
ABAP standard
RSBDCBTC pour exécuter
des sessions BDC.
*
*
S_BTCH_ADM
Traitement de batch
: Administrateur de
batch :
Pour que les Jobs SAP
BTCADMIN
existants puissent être
exécutés, AE doit adapter
les Jobs correspondants.
Les interfaces AE et
standard utilisent le module
fonctionnel standard BP_
JOB_MODIFY pour
exécuter les Jobs et
nécessitent donc
l'autorisation
administrateur de batch.
Cette dernière est
également nécessaire pour
afficher la liste spool d'un
Job si celui-ci n'a pas été
créé par l'Utilisateur CPIC.
Y
S_BTCH_ADM permet
des sélections
indépendantes du Client
dans les Jobs existants.
L'exécution de l'instruction
AE R3_ACTIVATE_JOBS
avec un Utilisateur CPIC
possédant cette
autorisation, peut, en
fonction des critères de
filtrage, mener au
démarrage de Jobs dans
plusieurs Clients SAP (par
exemple, le même nom de
Job existe dans deux
Clients SAP).
S_BTCH_NAM
L'Utilisateur CPIC doit
disposer de cette
autorisation pour créer et
exécuter des Jobs pour
d'autres Utilisateurs SAP.
BTCUNAME
*
Automation Engine
S_SPO_DEV
Spooler :
autorisations de
périphérique
Pour pouvoir spécifier le
SPODEVICE
paramètre d'impression
"Impression Immédiate" au
sein d'un step de Job,
l'Utilisateur CPIP
nécessite l'autorisation
pour le périphérique de
sortie en question.
*
S_TMS_ACT
Pour que la page de garde
d'une liste spool puisse
être transmise à AE, il est
utile d'afficher le paramètre
de la variante qui a été
utilisée pour l'exécution
ABAP. Cette information
fait partie de la page de
garde.
STMSACTION
STMSOBJECT
STMSOWNER
*
*
*
S_XMI_PROD
Cet objet d'autorisation est
utilisé pour l'identification à
l'interface standard. Les
applications externes
doivent tout d'abord s'y
identifier pour pouvoir faire
appel à ses fonctions.
EXTCOMPANY
EXTPRODUCT
INTERFACE
*
*
*
S_XMI_LOG
L'objet d'autorisation n'est pas requis pour
l'Automation Engine. Lors
de l'utilisation de l'interface
standard, des entrées sont
toutefois écrites dans le log
XML (Online Transaction
Code RZ15), qu'il n'est
possible d'afficher ou de
supprimer qu'avec cette
autorisation.
-
S_WFAR_OBJ
ArchiveLink :
autorisations pour
l'accès aux
documents
AE permet de spécifier des
paramètres d'archivage
(type d'objet, type de
document). Grâce à ceuxci, vous pouvez transférer
immédiatement la liste
d'impression d'un
programme ABAP à une
archive optique (si cela est
installé dans le système
SAP).
*
*
*
*
ACTVT
OAARCHIV
OADOCUMENT
OAOBJEKTE
71
72
Chapter 7 Liaison technique
S_WFAR_PRI
ArchiveLink :
autorisations pour
l'accès aux listes
d'impression
Pour que les listes
d'impression puissent être
créées dans les archives
optiques, l'Utilisateur
CPIC doit posséder cette
autorisation.
ACTVT
OAARCHIV
OADOKUMENT
OAOBJEKTE
PROGRAM
*
*
*
*
*
S_PROGRAM
ABAP : Vérifications
du déroulement du
programme
AE requiert cette
P_ACTION
autorisation pour planifier
P_GROUP
des programmes ABAP
auxquels des groupes
d'autorisation sont
attribués (champ
d'autorisation P_
ACTION=BTCSUBMIT) et
pour contrôler les variantes
(P_ACTION=VARIANT).
BTCSUBMIT,VARIANT
*
S_SPO_ACT
Spool : Actions
Le champ SPOACTION
doit autoriser les actions
BASE et DISP pour les
Utilisateurs
correspondants pour que
les listes spool qui n'ont
pas été créées par
l'Utilisateur CPIC puissent
être transmises.
SPOACTION
SPOAUTH
BASE,DISP
*
S_ADMI_FCD
Autorisations
système
Le champ S_ADMI_FCD
doit au moins autoriser
l'action SP0R pour que les
listes spool qui n'ont pas
été créées par l'Utilisateur
CPIC puissent être
transmises.
S_ADMI_FCD
SP0R
S_RS_ISOUR
Administrator
Workbench InfoSource (mise à
jour flexible)
L'autorisation est
uniquement requise si la
fonction Business
Warehouse BW_
ACTIVATE_
INFOPACKAGE est
utilisée et si la mise à jour
flexible est appliquée.
ACTVT
RSAPPLNM
RSISOURCE
RSISRCOBJ
*
*
*
*
S_RS_ISOUR
Administrator
Workbench InfoSource (mise à
jour directe)
L'autorisation est
uniquement requise si la
fonction Business
Warehouse BW_
ACTIVATE_
INFOPACKAGE est
utilisée et si la mise à jour
directe est appliquée.
ACTVT
RSAPPLNM
RSISOURCE
RSISRCOBJ
*
*
*
*
Automation Engine
S_DEVELOP ABAP L'autorisation est
Workbench
uniquement requise si la
fonction Business
Warehouse BW_
ACTIVATE_CHAIN est
utilisée.
ACTVT
DEVCLASS
OBJNAME
OBJTYPE P_
GROUP
*
*
*
*
*
S_RS_ICUBE
Administrator
Workbench InfoCube
L'autorisation est
uniquement requise si la
fonction Business
Warehouse BW_
ACTIVATE_CHAIN est
utilisée.
ACTVT
RSICUBEOBJ
RSINFOAREA
RSINFOCUBE
*
*
*
*
S_RS_ADMWB
Administrator
Workbench - Objets
L'autorisation est
uniquement requise si les
fonctions Business
Warehouse sont utilisées.
ACTVT
RSADMWBOBJ
*
*
S_RS_DS
L'autorisation est
uniquement requise si les
fonctions Business
Warehouse sont utilisées.
S_RS_DTP
L'autorisation est
uniquement requise si les
fonctions Business
Warehouse sont utilisées.
S_RS_ODSO
L'autorisation est
uniquement requise si les
fonctions Business
Warehouse sont utilisées.
S_RS_PC
L'autorisation est
uniquement requise si les
fonctions Business
Warehouse sont utilisées.
S_RZL_ADM
Lancement de Jobs
ACTVT
interceptés (Gestionnaire
de File d'Attente, R3_
activate_intercepted_Jobs)
01
S_TABU_DIS
Pour l'utilisation des
formulaires SAP
03
SPFL
-
Aucune autorisation SAP
spécifique n'est nécessaire
pour les fonctions AE
supplémentaires comme il
n'existe aucun risque de
sécurité.
ACTVT
DICBERCLS
*) Nous vous recommandons de créer des autorisations en fonction de vos conventions de noms
spécifiques.
73
74
Chapter 7 Liaison technique
Pour disposer de la fonctionnalité minimale dans l'Automation Engine, l'Utilisateur RFC doit avoir
un profil Utilisateur qui contient l'objet d'autorisation S_BTCH_JOB. Ce dernier doit contenir les
autorisations standard S_BTCH_ALL ou avoir saisi les valeurs suivantes :
Activités sur les Jobs : DELE, PLAN, PROT, RELE, SHOW
Résumé des Jobs pour un Groupe : *
7.4 Prise en compte d'attributs de Job
L'onglet spécifique à l'hôte pour les Jobs SAP contient plusieurs attributs ayant une influence sur
plusieurs scripts. Le tableau suivant les énumère. Les scripts SAP n'apparaissant pas dans cette
liste n'utilisent aucun attribut.
Elément de
script
BCA_
ACTIVATE_
PROCESS
R3_
ACTIVATE_
EXT_
COMMAND
R3_
ACTIVATE_
EXT_
PROGRAM
R3_
ACTIVATE_
INTERCEPTE
D_JOBS
R3_
ACTIVATE_
JOBS
R3_
ACTIVATE_
REPORT
R3_
ACTIVATE_
SESSIONS
R3_CALL_
TRANSACTIO
N
R3_GET_
EVENT
R3_GET_JOB_
SPOOL
Logi
n
Langu
e
No
m
de
Job
Class
e de
Job
Systèm
e cible
Mode de
démarra
ge
Supprim
er dans
CCMS
Destinatai
re de la
liste spool
Automation Engine
75
R3_MODIFY_
JOB
R3_RAISE_
EVENT
Rubriques connexes :
Onglet SAP pour les Jobs SAP
7.5 Interfaces
7.5.1 Interfaces
Les Agents communiquent avec le système SAP sur la base de RFC (Remote Function Call) de
SAP. Pour ce faire, des modules fonctionnels sont exécutés. Parallèlement aux interfaces par
défaut, l'Agent peut utiliser l'interface qui donne accès à des fonctionnalités supplémentaires.
Nous faisons généralement la distinction dans la documentation entre
l
l
L'interface
est composée de modules de fonctions développés par l'Automation Engine.
Les interfaces standard
sont composées de modules de fonctions développés par SAP. L'Automation Engine utilise
plusieurs de ces interfaces à différentes fins. Les interfaces se répartissent en
l
XMB (eXternal Monitoring Basics)
l
XAL (eXternal ALerting)
l
XBP (eXternal Batch Processing) *)
l
XMW (eXternal Monitoring Write)
l
BW-STA (Business Warehouse - data STAging)
*) Attention : l'interface XBP 2.0 doit être activée avec le programme SAP INITXBP2. Cela fait
partie de l'installation XBP 2.0. Sinon, les relations parent-enfant et la fonction de Jobs interceptés
ne peuvent pas être utilisées.
Operations Manager prend en charge les interfaces XBP 2.0 et XBP 3.0 de SAP NetWeaver.
Des modules SAP utilisant cette interface peuvent donc être utilisés. En font par exemple partie
SAP 4.7, NetWeaver Stack 2004s, ECC5, ECC6, etc.
La version de l'interface XBP est indépendante de celle du kernel. SAP assure une certaine
compatibilité. Cela signifie que lorsqu'une nouvelle version de l'interface est disponible, un certain
nombre des versions de kernel prennent en charge l'ancienne version.
L'interface requiert BABP XBP V2.0. Vérifiez la version de votre système AE et installez, le cas
échéant, le package de prise en charge actuel.
7.5.2 Différences au niveau des fonctions
Le tableau récapitulatif suivant montre quels Scripts SAP exigent l'interface (Script). Les Scripts
qui possèdent des paramètres pour lesquels l'utilisation de l'interface est requise sont également
identifiés (Paramètre).
76
Chapter 7 Liaison technique
Scripts et interfaces utilisées
Script
Description
Interface
nécessaire
Script Paramètres
R3_ACTIVATE_
CM_PROFILE
Active un profil dans le Gestionnaire de critères
SAP.
R3_ACTIVATE_
EXT_COMMAND
Exécute une commande externe.
R3_ACTIVATE_
EXT_PROGRAM
Exécute un programme externe.
R3_ACTIVATE_
INTERCEPTED_
JOBS
Exécute les Jobs interceptés.
R3_ACTIVATE_
JOBS
Exécute les Jobs déjà planifiés.
R3_ACTIVATE_
REPORT
Exécute un programme ABAP.
R3_ACTIVATE_
SESSIONS
Exécute des dossiers batch input.
R3_CALL_
TRANSACTION
Exécute une transaction SAP.
R3_COPY_
VARIANT
Copie la variante d'un rapport.
R3_CREATE_
OUTPUT_
REQUEST
Crée un nouvel ordre d'édition pour une requête
spool existante.
R3_CREATE_
VARIANT
Crée une nouvelle variante.
R3_DEACTIVATE_
CM_PROFILE
Désactive un profil dans le Gestionnaire de critères
SAP.
R3_DELETE_
NODE
Supprime un nœud de l'architecture de moniteur
SAP.
R3_DELETE_
VARIANT
Supprime la variante d'un rapport.
R3_GET_
APPLICATIONLOG
Vérifie le code retour d'application d'une ou de
plusieurs étapes de Job.
R3_GET_
APPLICATIONLOG
Cherche les messages du logging d'application et
les génère dans le rapport ou le fichier.
R3_GET_EVENT
Attend un Evènement déclenché dans SAP.
R3_GET_
INTERCEPTION
Lit la table de filtre pour les Jobs interceptés et
enregistre dans le protocole d'activation ou un
fichier.
R3_GET_JOB_
SPOOL
Lit la liste spool d'un step de type "programme
ABAP".
Automation Engine
R3_GET_JOBLOG
Cherche le logging d'un Job SAP dans SAP et
l'affiche dans un rapport.
R3_GET_JOBS
Sélectionne des Jobs SAP et affiche le résultat
dans le rapport d'activation.
R3_GET_
MONITOR
Lit des données d'un moniteur SAP.
R3_GET_
SESSIONS
Sélectionne des dossiers batch input et affiche le
résultat dans le rapport d'activation ou dans un
fichier.
R3_GET_
Sélectionne des requêtes spool avec des Filtres
SPOOLREQUESTS prédéfinis.
R3_GET_
SYSTEMLOG
Lit les informations d'une période donnée d'un
logging système SAP.
R3_GET_
VARIANTS
Lit le catalogue des variantes.
R3_GET_
VARIANT_
CONTENTS
Affiche le contenu d'une variante.
R3_MODIFY_
INTERCEPTION
Modifie la table de filtre pour les Jobs interceptés.
R3_MODIFY_JOB
Modifie un step ABAP.
R3_MODIFY_
VARIANT
Modifie une valeur dans une variante.
R3_RAISE_EVENT
Déclenche un Evènement défini dans SAP.
R3_SCHEDULE_
JOB_CANCEL
Réattribue le statut "Planifié" à un Job SAP déjà
lancé.
R3_SEND_
SPOOL_REQUEST
Envoie une requête spool existante.
R3_SET_
BDCDATA
Définit les données BDC.
R3_SET_FREE_
SELECTION
Définit une limite libre.
R3_SET_LOG_
ATTR
Ajoute un attribut de logging dans l'architecture de
moniteur SAP
R3_SET_PERF_
ATTR
Ajoute un attribut de performance dans
l'architecture de moniteur SAP
R3_SET_PRINT_
DEFAULTS
Définit des valeurs par défaut pour les paramètres
d'impression utilisés lors de l'exécution de
rapports.
R3_SET_SELECT_
OPTION
Définit un critère de sélection.
R3_SET_STATUS_
ATTR
Ajoute un attribut de statut dans l'architecture de
moniteur SAP
77
78
Chapter 7 Liaison technique
R3_SET_TEXT_
ATTR
Ajoute un attribut de texte dans l'architecture de
moniteur SAP
R3_SWITCH_
OPMODE
Change le mode de fonctionnement dans SAP.
Rubriques connexes : Généralités sur le JCL AE pour les applications
7.5.3 Transport de l'interface
Généralités
Pour utiliser les fonctionnalités de l'interface, les modules fonctionnels doivent d'abord être
transportés dans le système SAP.
Ils sont développés sous forme d'objets de développement ABAP. Ces objets sont fournis dans le
package "correction et transport" du système SAP:
l
l
l
KNNNNNN.SID Fichier d'information, par exemple K000046.T45
RNNNNNN.SID Fichier de données, par exemple R000046.T45
ENNNNNN.txt Protocole d'exportation, par exemple E000046.txt
Outre les modules fonctionnels, des espaces de noms sont également transportés dans des ordres
individuels. Vous trouverez une liste des ordres de transport en cours de validité dans le fichier
TRANSPRT.TXT. En cas de nouvelle installation, tous les ordres de transport doivent être
exécutés. En cas de mise à jour de l'installation, seuls les modules fonctionnels (interface) sont mis
à jour, car les espaces de noms ne changent pas.
Les noms des objets de développement sont décrits dans la terminologie.
Les abréviations suivantes sont utilisées dans ce document:
l
l
l
NNNNNN pour le numéro d'ordre de transport du système source et
SID pour le nom du système source.
TID est utilisé pour le nom du système cible (dans lequel les modules fonctionnels sont
importés).
Nom du fichier
Dans la mesure où le système SAP peut être installé dans différents environnements (UNIX,
Windows...), les particularités du système doivent être prises en compte dans les noms des
fichiers.
Dans ce document, nous écrivons généralement des noms de fichiers, qui concernent
l'environnement SAP, avec la syntaxe UNIX (également avec "/"). Dans l'environnement Windows,
les noms sont identiques, à la différence seulement que dans ce cas, on utilise "\".
Automation Engine
79
Importation des modules fonctionnels dans SAP
Pour utiliser les fonctionnalités de l'interface, les modules fonctionnels doivent d'abord être
transportés dans le système SAP.
Requis :
Les autres activités du système de transport doivent impérativement être exécutées avec
l'Utilisateur d'administration SAP (SIDadm).
Le système de transport doit être configuré et paramétré correctement, généralement lors de
l'installation du système SAP.
Au moins deux processus de travail de batch (BTC) doivent fonctionner dans cette instance SAP
pour l'importation
Contrôle: Outils – Administration – Moniteur – Surveillance système – Sélection de processus
(transaction SM50).
Le démon de transport du système SAP (Job d'arrière-plan "RDDIMPDP") doit être planifié et validé
dans le Client 000 pour l'importation d'objets de développement. Contrôle: Voir ci-dessous
La fonctionnalité peut être vérifiée comme suit:cd usr/sap/trans/bin........ Changement dans le répertoire de transport SAP
tp checkimpdp TID...........
Vérifier si le démon de transport RDDIMDP est actif dans SAP
tp connect TID.............. Tester la connexion au système SAP
Le système de transport est décrit dans la documentation SAP en ligne, dans le chapitre SYSTEME
DE BASE – PILOTAGE DU CONTROLE.
Veuillez noter que l'option "Ignorer les versions des composants" inadaptées doit être activée
lors de l'importation.
Déroulement:
Reprise du fichier de transport fourni dans l'environnement de transport SAP:
l
l
l
Sur l'ordinateur SAP:
Accédez au sous-répertoire adapté à la version SAP sous IMAGE:AGENTS\SAP\_TRANS.
Copie des fichiers dans les répertoires suivants:
KNNNNNN.SID par /usr/sap/trans/cofiles
RNNNNNN.SID par /usr/sap/trans/data
Lorsque SAP est installé sous UNIX, le transfert des fichiers s'effectue généralement via
FTP. Indiquez impérativement "bin" pour les transferts binaires.
l
Le fichier ENNNNNN.TXT du CD contient le protocole d'exportation complet et peut être
utilisé pour une éventuelle analyse.
Importation de la livraison dans le système SAP:
l
l
Sur l'ordinateur SAP (connexion avec l'Utilisateur d'administration SAP (SIDadm)).
Les fichiers de transport repris (RNNNNNN.SID et KNNNNNN.SID) ne doivent pas être
protégés en écriture (attention lors de la copie à partir du CD)!
80
Chapter 7 Liaison technique
l
Si besoin, il est possible de créer un répertoire des objets contenus dans l'ordre de transport:
cd usr/sap/trans/data....... Changement dans le répertoire de transport SAP
r3trans -l RNNNNNN.SID...... Crée un fichier trans.log (liste des objets
transportés)
l
Génération d'une entrée de tampon pour le système cible.
cd usr/sap/trans/bin........ Changement dans le répertoire de transport SAP
tp addtobuffer SIDkNNNNNN TID[pf=<nom profil, par défaut TPPARAM>]
l
Si besoin, il est possible de vérifier l'entrée de tampon:
tp showbuffer TID [pf=<nom profil, par défaut TPPARAM>]
l
l
Vous devez décider avant l'importation avec quels modes inconditionnels (u) l'importation
doit être exécutée:
l
4....est valable uniquement pour la version SAP 3.x: sachant que le nom du système
cible indiqué lors de l'exportation ne correspond pas au nom du système cible réel
(TID). Dans la mesure où le système cible réel n'est pas connu lors de l'exportation,
ce mode doit toujours être spécifié!
l
1....doit être indiqué lorsque l'importation doit être répétée.
Lancement de l'importation avec la commande:
tp import SIDkNNNNNN
bzw.
tp import SIDkNNNNNN
TPPARAM>]
TIDu4 [client123] [pf=<nom profil, par défaut TPPARAM>]
TID u14 [client123] [pf=<nom profil, par défaut
Les modes inconditionnels diffèrent selon la version TP. Vous pouvez consulter la
documentation SAP pour plus d'informations à ce sujet.
Respectez les points suivants lors de l'importation:
l
Au moins 2 tâches de batch doivent fonctionner dans l'instance pour les importations!
l
Bien que l'ordre de transport ne contienne aucune donnée propre au Client, il peut
arriver qu'un Client soit requis lors de l'importation. Dans ce cas, un Client valable
pour votre environnement doit être spécifié à l'aide du paramètre client=nnn
(l'export a eu lieu avec le Client 010).
l
L'importation peut prendre quelques minutes, plus particulièrement lorsque le démon
de transport RDDIMPDP n'est pas déclenché par un évènement, mais est contrôlé
par une horloge.
l
Message "no profile used ":
l
Aucun profil n'est indiqué lors de l'exécution interne du programme sur "sapevt". C'est
pourquoi ce message est généré pour chaque exécution sur sapevt. Il peut être ignoré
en temps normal!
l
D'autres messages peuvent être générés. Cependant, seul le Code retour est
important (voir ci-dessous – Contrôle).
Contrôle:
l
l
En raison de la complexité du système de transport et de l'environnement SAP, seul un
expert qui connaît l'environnement d'installation peut réaliser un diagnostic d'erreur complet
et apporter des corrections.
Un non-spécialiste peut toutefois évaluer si l'importation s'est bien passée à l'aide des
conseils suivants:
Automation Engine
l
l
l
l
l
81
Des fichiers log sont générés lors de l'importation.
Ils se trouvent dans le répertoire /usr/sap/trans/log sous le nom
SIDsNNNNNN.TID
s correspond à l'étape de transport:
G... Génération de rapports et d'écran
H... R3TRANS Dictionnaire d'importation
I... R3TRANS Importation principale
Le code exit (= Code retour) de ces trois fichiers log doit être contrôlé (il est toujours
indiqué à la fin du fichier). Il ne doit pas dépasser "4"!
Un expert peut naturellement contrôler ces fichiers log dans le système SAP.
7.5.4 Test de l'interface avec ABAP Workbench
Ce document contient des explications relatives au test de l'interface permettant la connexion au
système SAP.
1. Démarrer l'environnement de développement et ouvrir les modules
fonctionnels.
Démarrez l'environnement de développement (ABAP/4-Workbench) et ouvrez, à l'aide du
navigateur d'objets, les modules fonctionnels pour les groupes de fonction /SBB/UC4_JOB :
Outils ⇒ ABAP/4-Workbench ⇒ Résumé ⇒ Object Navigator, sélectionnez le groupe de fonctions
/SBB/UC4_JOB, ouvrez les modules fonctions, positionnez le curseur sur l'objet et sélectionnez
Tester dans le menu contextuel.
Le nom des modules fonctionnels a toujours UC4 comme préfixe.
2.
Tester le module fonctionnel UC4_JOB_OPEN.
Paramètre à indiquer :
JOBNAME - Nom quelconque, par exemple 'TEST'.
JOBCLASS - A, B ou C
Le paramètre JOBCOUNT est fourni. Cette valeur doit être notée ou le mieux est de la copier dans
le presse-papiers.
82
Chapter 7 Liaison technique
3.
Tester le module fonctionnel UC4_JOB_SUBMIT
Paramètre à indiquer :
JOBCOUNT - introduire la valeur ou l'ajouter depuis le presse-papiers,
JOBNAME - comme pour le modèle fonctionnel UC4_JOB_OPEN,
REPORT_ID - 'RSM04000' ou 'RSM04000_ALV'.
Automation Engine
83
Après l'exécution, il faut s'assurer qu'aucune exception ne s'est produite. Les paramètres sont
certes fournis ici, mais ils ne sont pas impérativement nécessaires pour le test.
4.
Tester le module fonctionnel UC4_JOB_CLOSE.
Paramètre à indiquer :
JOBCOUNT - introduire la valeur ou l'ajouter depuis le presse-papiers,
JOBNAME - comme pour le modèle fonctionnel UC4_JOB_OPEN.
Après l'exécution, il faut s'assurer qu'aucune exception ne s'est produite.
84
Chapter 7 Liaison technique
Le Job est maintenant démarré et peut être affiché à l'aide de la transaction standard SM37
(Système ⇒ Services ⇒ Jobs ⇒ Résumé de Job). Une fois le Job terminé, cela vient confirmer que
les modules fonctionnels élémentaires pour le contrôle de Job au sein du système SAP
fonctionnent.
Automation Engine
85
7.6 Agent pour SAP BW
Généralités
La Automation Engine prend en charge la composante SAP Business Information Warehouse
(SAP BW) comme s'il s'agissait d'un système d'exploitation propre. D'un point de vue technique,
cette collaboration est réalisée de sorte que des modules fonctionnels sont appelés au sein du
système SAP par le biais des RFC (Remote Function Call) de SAP. La communication vers le
système SAP est effectuée uniquement via les RFC et est ainsi indépendante de
l'environnement dans lequel SAP BW est installé.
La configuration du paramètre de connexion a lieu dans l'objet Connexion de l'Agent. De plus, cet
Agent peut être activé pour toutes les versions de SAP BW prises en charge par l'Automation
Engine.
L'Agent pour SAP BW peut également exécuter des Jobs dans le système de base SAP (Jobs en
arrière-plan standard).
Le tableau suivant indique les versions de SAP BW et de SAP Basis pour lesquelles un Agent est
disponible pour SAP BW.
Version BW
SAP Basis
Agent pour SAP BW
1,2B
4,5A
Non pris en charge.
2,0B
4.6C
Disponible à partir de la version Automation Engine 2.63C.
2.1C
4.6D
Disponible à partir de la version Automation Engine 2.63C.
3,0B
6.10
Disponible à partir de la version Automation Engine 2.63D.
>3.0B
6.x
Disponible à partir de la version Automation Engine 2.63D
Support Packages pour SAP BW
Pour utiliser l'Agent, nous vous recommandons d'installer les Support Packages de SAP BW ciaprès.
Version SAP BW
Niveau du Support Package
2,0B
32
2.1C
24
3,0B
14
3.1C
08
>3.1C
Pas de niveau de Support Package connu
Si un Support Package de niveau inférieur est installé sur l'Agent, les messages suivants peuvent
s'afficher. Vous trouverez de plus amples informations dans les notes SAP spécifiées.
Numéro de note SAP
Message
488588
short dump "DYNPRO_SEND_IN_BACKGROUND"
426047
Message E089(RSM1) "Job not (yet ?) started"
488808
BAPI_IPAK_CHANGE ignores InfoPackage Parameter
86
Chapter 7 Liaison technique
Vérification du statut
Dans la Automation Engine, le statut technique communiqué lors de l'appel de fonction pour vérifier
le statut est considéré comme un "statut final". La description de ce terme dans Interface
Repository est la suivante:
Le paramètre TECHSTATUS est le statut technique de la demande. Il dispose toujours l'une des
valeurs suivantes :
l
l
l
G – Vert (la demande est enregistrée avec succès)
Y – Jaune (la demande est en cours de traitement)
R – Rouge (la demande génère une erreur ou est interrompue)
Le statut n'est cependant visiblement pas un "statut final". Il peut passer plusieurs fois en "rouge"
pendant un court instant (erreur ou interruption) puis passer de nouveau en "jaune" ou en "vert". Le
système AE en tient compte ; il est possible d'activer un délai de vérification du statut, par exemple
lorsque le statut est "rouge", le système vérifie encore x fois si le statut reste réellement "rouge".
Les paramètres maxruntime= et repeat_check= (section [SAP_BW]) se trouvent dans le fichier INI
de l'Agent SAP à cet effet.
Une fonction est également appelée pour la vérification du statut des chaînes de processus. Les
valeurs des statuts sont les suivantes :
l
l
l
l
l
l
l
l
l
l
"R" – Interruption
"G" – Fin normale
"F" – Fin normale
"A" – Poursuivre la surveillance
"X" – Interruption
"P" – Poursuivre la surveillance
"S" – Interruption (mais uniquement après un redémarrage de la chaîne de processus)
"Q" – Poursuivre la surveillance
"Y" – Poursuivre la surveillance
" " – Poursuivre la surveillance
Ces statuts sont ensuite convertis en Codes Retour dans l'Automation Engine:
Code retour
Statut
Statut SAP
0
ENDED_OK
G ou F
4
ENDED_NOT_OK
R
8
ENDED_NOT_OK
X
12
ENDED_NOT_OK
S
7.7 Paramètres d'archivage avec R3_
ACTIVATE_REPORT
Les paramètres d'archivage qu'un utilisateur peut spécifier pour R3_ACTIVATE_REPORT
correspondent aux zones de saisie illustrées ci-dessous. La boîte de dialogue s'affiche dans le
système SAP si "Archivage" a été sélectionné comme mode dans les paramètres d'impression.
Automation Engine
Paramètres de SAP
Paramètres pour R3_ACTIVATE_REPORT
Type d'objet
ARCHIVE_SAPOBJECT
Type de Document
ARCHIVE_OBJECT
Information
ARCHIVE_INFO
Texte
ARCHIVE_TEXT
87
Rubriques connexes : R3_ACTIVATE_REPORT
7.8 ERROR/ERRORLEVEL dans R3_
ACTIVATE_SESSIONS
Lors de l'exécution de R3_ACTIVATE_SESSIONS, le système SAP cherche tout d'abord la liste
des dossiers à exécuter. Chaque dossier est exécuté par un seul Job SAP. Ce Job est appelé
replayer dans le présent document. Le replayer utilise l'ABAP "RSBDCBTC" pour l'exécution.
ERROR
Se rapporte au résultat (statut) du replayer. Le résultat peut être "A" pour interrompu, ou "F" pour
terminé avec succès.
ERROR=IGNORE
Le prochain dossier de la liste des correspondances est toujours exécuté. Le résultat du replayer
précédent est ignoré.
88
Chapter 7 Liaison technique
ERROR=ABEND
La lecture des dossiers est immédiatement arrêtée lorsqu'un replayer se termine avec le statut "A".
Le Job est interrompu.
ERRORLEVEL
Se rapporte toujours au dossier et est vérifié à la fin du replayer. Il définit le pourcentage des
transactions d'un dossier qui ne se sont pas exécutées avec succès. Si la valeur des dossiers est
dépassée, le traitement du Job est interrompu. Aucun autre dossier de la liste des correspondances
n'est démarré. Si ERRORLEVEL n'est pas indiqué, aucune vérification des transactions inscrites
avec succès n'est effectuée.
Automation Engine
89
7.9 Résolution de problèmes
7.9.1 Conseils sur la recherche d'erreurs
Vous trouverez ici une liste des sources d'informations qui permettent de reconnaître une
situation d'erreur lorsque l'Agent ne fonctionne pas correctement (ou que partiellement), ou qu'il
n'exécute pas correctement certaines Tâches.
Rapport de Job
La source la plus proche est le rapport du Job pour SAP. Y sont journalisées pour chacune des
Tâches les actions que l'Agent a exécutées par rapport au système SAP ainsi que la façon dont
elles se sont terminées.
Attributs de l'objet activé
Il est possible que l'origine de l'erreur se trouve tout simplement dans les attributs de l'objet activé
(par exemple Client ou Utilisateur erronés). Vérifiez les attributs de l'objet correspondant.
Utilisateur CPIC
Pour la connexion au système SAP, un Utilisateur SAP (Client, nom, mot de passe) doit être défini
dans un objet Login. Cet Utilisateur doit également exister avec le même mot de passe dans tous
les Clients du système SAP dans lesquels des Tâches sont exécutées. Vérifiez l'objet Login mais
aussi les Utilisateurs du système SAP.
L'Agent est représenté par l'Utilisateur CPIC au sein du système SAP. Cet Utilisateur doit, bien
entendu, disposer des droits correspondants, par exemple droit d'opérateur pour le traitement en
arrière-plan. Vérifiez les droits de l'Utilisateur CPIC dans le système SAP.
Transactions utiles
La transaction "SM37" offre également des informations sur l'exécution de Job dans le log de Job et
dans la liste de spool. Le log XMI, qui peut être exécuté avec "RX15", fournit également des
enregistrements utiles.
Fichiers log
Vous trouverez des informations détaillées sur l'heure en question dans les fichiers log de l'Agent et
du Serveur. Vous pouvez également afficher le contenu des fichiers dans la Supervision Système.
Au début, l'intégralité du fichier INI est tout d'abord journalisée. Dans cette section, vous pouvez
reconnaître les paramètres avec lesquels l'Agent ou le Serveur s'exécute. Toutes les actions
exécutées sont ensuite enregistrées chronologiquement.
Le log système SAP
Les situations d'erreur se produisant au sein du système SAP sont journalisées dans le log système
SAP. Vous pouvez afficher le log système avec la transaction SAP "SM21". Dans certains cas, par
exemple lorsque la planification d'un step de Job par un Agent échoue, le log système SAP est
automatiquement transféré dans le rapport de Job. Il peut alors être affiché dans un nouvel onglet du
rapport.
90
Chapter 7 Liaison technique
Traces
Les traces journalisent, sous forme de fichiers log, des informations encore plus détaillées sur les
processus. Elles contiennent, par exemple, les transmissions de messages entre l'Agent et le
Serveur ou entre l'Agent et le système SAP. Dans le dernier cas, on parle d'une trace RFC. Les
traces doivent être activées soit dans le fichier INI de l'Agent, soit dans la Supervision Système.
Les contenus des traces sont enregistrés dans des fichiers dans le répertoire de travail de l'Agent
ou dans le répertoire spécifié.
Les traces sont conçues pour une analyse par le support ou le développement. Envoyez toujours
ce genre de documents à votre demande de support.
Attention : lors de l'activation de la trace RFC, des fichiers sont non seulement enregistrés côté
Agent, mais également sur la machine du serveur d'application SAP ! N'activez donc la trace que
pendant quelques instants, afin d'économiser de l'espace sur le disque dur. Pour empêcher toute
création de fichiers de trace dans le système SAP, vous pouvez définir le paramètre gw/accept_
remote_trace_level sur 0.
Vous trouverez des informations complémentaires sur la trace RFG dans la note SAP 532918.
7.9.2 Problèmes lors de l'importation des modules
fonctionnels
Le programme tp ne se termine pas
Symptôme
Lors de l'importation des objets de développement, le programme tp ne se termine pas (il s'exécute
normalement pendant quelques minutes). Après interruption avec (Ctrl-C), le message suivant
figure dans le fichier SLOG.
Background Job RDDIMPDP could not be started or terminated abnormally
Origine
L'importation des objets de développement est exécutée par le Job RDDIMPDP. Cela est
normalement planifié en tant qu'Evènement et est déclenché par l'Evènement "SAP_TRIGGER_
RDDIMPDP" du programme tp. En l'occurrence, le démarrage de ce Job par l'Evènement ne
fonctionne pas, tp attend donc sans fin.
Solution
Vérifiez que l'Evènement "SAP_TRIGGER_RDDIMPDP" est défini (transaction SM64).
Contrôlez que les entrées pour le contrôle de l'Evènement ont été entrées correctement dans
TPPARAM.
Recherchez d'éventuels conseils dans le SAP Service Portal avec le mot-clé "SAP_TRIGGER_
RDDIMPDP".
Automation Engine
91
En cas d'urgence, utilisez le RDDIMPDP qui dure 5 minutes ; il peut être planifié par ABAP
RDDPUTPP avec SE38.
7.9.3 Jobs SAP se terminant par ARCHIVE_INFO_NOT_
FOUND
Symptôme
Les Jobs SAP se terminent par le message ci-dessous :
U2004001 RFC Returntext: ARCHIVE_INFO_NOT_FOUND
Origine
ARCHIVE_INFO_NOT_FOUND est une exception du module fonctionnel "GET_PRINT_
PARAMETERS". Ce module fonctionnel est un module fonctionnel standard du système SAP.
ARCHIVE_INFO_NOT_FOUND n'a pas nécessairement un rapport avec la zone d'informations
des paramètres d'archivage.
ARCHIVE_INFO_NOT_FOUND se rapporte à tous les paramètres d'archivage, à savoir :
l
l
l
l
ARCHIVE_O[BJECT]= catégorie de document
ARCHIVE_S[APOBJECT]= type d'objet
ARCHIVE_T[EXT]= texte
ARCHIVE_I[NFO]= zone d'informations
ARCHIVE_INFO_NOT_FOUND peut avoir toute une série de causes, telles que :
l
l
l
La catégorie de document ou le type d'objet indiqué n'est pas défini dans le système SAP.
La catégorie de document est affectée à une archive inexistante dans le système SAP
(Content Repository).
L'utilisateur ne possède pas les droits d'accès (voir l'objet d'autorisation S_WFAR_PRI).
Si l'Automation Engine transmet correctement les paramètres au module fonctionnel, la cause de
l'exception existe la plupart du temps dans le système SAP.
Solution
Vérifiez, à l'aide de la trace RFC, si l'Automation Engine a correctement transmis les paramètres au
module fonctionnel. Vérifiez les paramètres relatifs à "Business Documents" et "ArchiveLink" dans
le Customizing du système SAP ainsi que les autorisations de l'utilisateur CPIC.
Rubriques connexes : R3_ACTIVATE_REPORT
Paramètres d'archivage pour R3_ACTIVATE_REPORT
92
Chapter 7 Liaison technique
7.9.4 Problème de stabilité avec des instances SAP
chez de nombreux Agents SAP (connexion RFC) sur un
serveur :
Symptôme
Le Serveur RFC/CPIC externe ne peut ouvrir de nouvelle connexion
et le message d'erreur suivant s'affiche :
LOCATION CPIC (TCP/IP) on local host ERROR max no. of 100
conversations exceeded
Origine
Le nombre de connexions parallèles pouvant être maintenues dans la bibliothèque est limité à 100.
Solution
La Variable d'environnement CPIC_MAX_CONV vous permet d'augmenter cette valeur.
Windows : set CPIC_MAX_CONV=&lt;n&gt;
p. ex. set CPIC_MAX_CONV=500 (pour 500 connexions)
Unix : setenv CPIC_MAX_CONV &lt;n&gt; ( csh )
p. ex. setenv CPIC_MAX_CONV 500 (pour 500 connexions)
Unix : export CPIC_MAX_CONV=&lt;n&gt; ( ksh )
p. ex. export CPIC_MAX_CONV=500 (pour 500 connexions)
iSeries : ADDENVVAR ENVVAR(CPIC_MAX_CONV) VALUE(&lt;n&gt;)
p. ex. ADDENVVAR ENVVAR(CPIC_MAX_CONV) VALUE(500) (pour 500 connexions)
7.9.5 Problème de transmission de mot de passe à SAP
Après la mise à jour vers les versions 2004s et ultérieures de SAP
Netweaver, la connexion de l'Utilisateur CPIC ne fonctionne plus
Symptôme
Les essais de connexions basées sur mot de passe (sur les systèmes : ABAP à partir de la version
7.00 / NetWeaver 2004s / mySAP ERP 2005) échouent, même si l'Utilisateur a enregistré un mot
de passe a priori correct dans un composant frontal ou la destination d'un autre système.
Cependant, une connexion directe SAPGUI avec le même mot de passe réussit.
Automation Engine
93
Origine
Les systèmes ABAP à partir de la version 2004s (7.00) de NetWeaver prennent en charge des mots
de passe de 40 caractères maximum, et sensibles à la casse. Dans les anciennes versions, la
limite était de 8 caractères et toutes les minuscules étaient mises en majuscules.
Si un mot de passe non rétrocompatible est utilisé dans le nouveau système, et si le composant
frontal ou intermédiaire ne peut traiter correctement ces mots de passe, la connexion échoue. La
raison en est en général la conversion (invisible) minuscule/majuscule.
En effet, le mot de passe entré par l'Utilisateur n'arrive pas au Serveur sous sa forme originale, mais
sous une forme modifiée soit directement après la saisie, soit lors de la transmission (qui s'effectue
à travers de nombreux composants).
Définitions
l
Mot de passe : rétrocompatible / non rétrocompatible
Un mot de passe est rétrocompatible s'il a 8 caractères au maximum et ne contient aucune
minuscule.
Un mot de passe n'est pas rétrocompatible s'il a plus 8 caractères au maximum et/ou
contient au moins une minuscule.
Les anciennes versions des systèmes ABAP ne prennent en charge que les mots de passe
rétrocompatibles. A partir de la version 7.00, les deux sortes de mots de passe peuvent être
utilisées. Comme les minuscules ne sont plus converties en majuscules, les mots de passe
des nouvelles versions des systèmes ABAP ne sont généralement pas rétrocompatibles.
l
Méthode de hachage de mots de passe / Versions de Code
Les systèmes ABAP ne sauvegardent pas les mots de passe en clair. Ils calculent à partir
des données saisies une somme de contrôle qu'ils sauvegardent avec les méta-données
décrivant le mode de hachage ("version de code"). Ces informations sont enregistrées dans
les données de référence de l'Utilisateur et utilisées lors de la vérification du mot de passe. A
partir du mot de passe saisi, une somme de contrôle est calculée avec la version de code
enregistrée dans les données de référence de l'Utilisateur et comparée à celle de ces mêmes
données.
La quantité des méthodes de hachage dépend de la version du programme, les nouvelles
prenant toujours en charge celles des versions précédentes. De cette façon, la connexion
protégée par mot de passe est toujours possible, même après une mise à jour.
Seules les méthodes de hachage de mot de passe des versions à partir de 7.00 prennent
aussi en compte les mots de passe non rétrocompatibles. Les anciennes versions ne
prennent en charge que les mots de passe rétrocompatibles.
Ce sont donc les données enregistrées dans les données de référence de l'Utilisateur
(version de code) qui déterminent tout d'abord la prise en compte éventuelle de la connexion
effectuée avec des mots de passe non rétrocompatibles.
Solution
l
Emploi d'Utilisateurs techniques (dans des destinations RFC) :
94
Chapter 7 Liaison technique
Nous vous conseillons d'utiliser le type d'Utilisateur SYSTEM (ou SERVICE, si la fonction
SAPGUI est nécessaire) sur le Serveur, car c'est le seul type pour lequel la durée de validité
du mot de passe est illimitée. Tant que le mot de passe doit être saisi dans une destination
RFC d'une version ancienne d'un système (= Client RFC), il doit être défini de façon
rétrocompatible au niveau du Serveur Cela est toujours possible aux types SYSTEM ou
SERVICE, même si les règles de définition des mots de passe obligent l'utilisation de mots
de passe non rétrocompatibles (avec login/min_password_lng &gt; 8 ou login/min_
password_lowercase &gt; 0 par ex.).
l
Emploi d'anciens composants frontaux ou intermédiaires et connexion d'Utilisateurs
"normaux" (de type DIALOG) :
Dans ce cas, il n'est pas indiqué de modifier les mots de passe des nombreux Utilisateurs
(comme dans le cas précédent des utilisateurs techniques). Vous devrez dans ce cas
remplacer les composants frontaux / intermédiaires obsolètes. La remarque SAP 792850
énumère les versions à partir desquelles certains composants frontaux et intermédiaires
prennent en charge les mots de passe non rétrocompatibles. Il peut être de plus nécessaire
d'actualiser d'autre composants logiciels (d'autres fournisseurs par ex.) dépendant de ces
mêmes composants, dans le cas notamment où ces composants ont une fenêtre de
dialogue de saisie de mot de passe propre mais ne prennent pas en charge les mots de
passe non rétrocompatibles.
Provisoirement et à titre de test, vous pouvez définir le paramètre de profil login/password_
downwards_compatibility sur 2 ou 3. Dans ce cas, le Serveur vérifie si le Client a envoyé un
mot de passe rétrocompatible (coupé après 8 caractères et converti en majuscules) au lieu
du mot passe non rétrocompatible attendu. Cela est alors journalisé dans le système (pour
analyse des erreurs) et la connexion est considérée comme réussie (paramètre sur 3) Le
paramètre peut être modifié dynamiquement, sans redémarrage du système avec la
transaction SAP RZ 11.
Automation Engine
8 Certification
8.1 Résumé
Les fonctionnalités liées à SAP sont naturellement certifiées.
Le tableau suivant présente une liste de tous les certificats :
Solution Interface
Software
Interface SAP
Agent AE for SAP
BC-XBP 6.10 - Background Processing, Job Scheduling 6.10
(Vers. 2.0)
BC-XBP 7.0 - Background Processing, Job Scheduling 7.0 (Vers.
3.0)
JAVA-JXBP 7.1
Agent AE for SAP BW
BW-SCH 3.0 - Scheduling for SAP BW 3.0
Agent AE for J2EE/JMX
JAVA-EE-STD 7.1
Rubriques connexes :
Partenaires SAP
SAP Developer Network (SDN)
95
96
Chapter Glossaire
Glossaire
Ce glossaire contient tous les concepts spécifiques.
ABCDEFGHIJKLMNOPQRSTUVWXYZ
.1 A
l
l
l
l
l
l
l
l
l
Activation
L'activation entraîne l'attribution d'un RunID à la Tâche, l'affichage de la Tâche dans la
Fenêtre d'Activités et la préparation pour l'exécution.(voir aussi Début)
Agent
Programme permettant l'exécution de Traitements sur des systèmes cible comme un
ordinateur ou des solutions d'entreprise. Egalement un type d'objet distinct dans AE.
Agent RA
Agent, pouvant être associé à une solution RA particulière et mettant ses fonctionnalités à
disposition d'un système AE. Il sert donc d'interface entre un système, une application ou
une plate-forme externe et un système AE.
Aide HTML
Format d'aide de Microsoft pour les manuels. L'extension des fichiers d'aide est .CHM (voir
aussi WebHelp)
Alerte
Envoi de messages à un utilisateur ou un groupe utilisateur unique du système Automation
Engine (AE). Egalement un type d'objet propre à AE.
Alias
Nom pour les Tâches qui affichent le moniteur et les statistiques au lieu du nom de l'objet
réel dans la Fenêtre d'Activités. Possible pour les Tâches de Workflow et les objets qui sont
activés de manière unique, périodique ou bien pas le Script.
Attributs de l'hôte
Attributs de l'objet Job, variant en fonction de la plate-forme.
activité
voir Tâche
automatisation rapide
Technologie générique pouvant reprendre différentes solutions. Est composée d'un agent et
d'une solution RA.
.2 B
l
Base de données AE
Système de gestion de base de données relationnelles, permettant la gestion centralisée de
toutes les données de planification. Elle contient définitions d'objet, paramètres système,
données statistiques, rapports de Job, etc.
Automation Engine
97
.3 C
l
l
l
l
l
l
l
l
l
l
l
l
l
l
l
l
l
Calendrier
Partie d'un objet Groupe Calendrier dans lequel les jours sont définis.
CallAPI
Interface de programmation pouvant être exécutée en direct ou à partir d'un autre
programme, afin d'exécuter un Script dans le système AE.
CallOperator
Deprecated Term. Replaced by: Alerte
Caractères génériques
Caractères de remplacement des données de filtre (? = un caractère exactement, * = chaîne
de caractères).
Chaîne de job
Deprecated Term. Replaced by: Workflow
Chaîne de traitement
Deprecated Term. Replaced by: Workflow
Classe d'objet
Tous les objets sont répartis en 4 classes: objets activables, objets actifs, objets passifs et
objets système.
Clef
Colonne pour les objets Variable statique par laquelle il est possible d'accéder aux Valeurs
d'une ligne spécifique.
Client
Environnement indépendant pour l'exécution de Tâches dans un système AE. Egalement un
type d'objet distinct dans AE.
Client Queue
Objet Queue présent par défaut dans chaque client.
Cockpit
Visualise les valeurs et statuts dans AE ou à partir des systèmes surveillés et contrôlés.
Egalement un type d'objet distinct dans AE.
Code Retour
Valeur représentant le résultat des Tâches et des fonctions de Script.
Colonne Résultat
Première colonne d'objets Variable avec la source "SQL", "SQL interne"et "Multi". Le
contenu de cette colonne est déterminé par le Format du résultat.
Composants AE
Regroupe tous les programmes AE, notamment l'Interface Utilisateur, les Serveurs, les
Agents, les Service Manager, les utilitaires, etc.
Condition de calendrier
Critère d'exécution pour les Tâches basées sur les Calendriers.
Connexion e-mail
Fonctionnalité des Agents Windows et UNIX permettant l'envoi d'e-mails.
Conteneur de périodes
Contrôle l'exécution des Tâches périodiques.
98
Chapter Glossaire
.4 D
l
l
l
l
Date logique
Lors de l'exécution de Tâches, la date et l'heure jouent un rôle important. En temps normal,
les deux sont actuelles. Dans certaines situations, il est cependant nécessaire de spécifier
des date et heure particulières et non pas les date et heure actuelles. On parle alors d'une
date logique. Cela influence la vérification des conditions de calendrier.
DialogClient
Deprecated Term. Replaced by: Interface Utilisateur
Dépendance externe
Tâche dont le statut de fin est pris en compte dans le déroulement du Workflow, bien qu'elle
ne soit pas exécutée dans le cadre du Workflow.
date réelle
Date utilisée pour la vérification de la durée d'exécution ou des conditions horaires dans les
caractéristiques des tâches de workflow. La date réelle, correspondant au moment de
l'activation du workflow le plus haut, est transmise à toutes les tâches subordonnées.
.5 E
l
l
l
l
l
l
l
l
l
Elément PromptSet
Champs/ éléments de contrôle permettant de demander des valeurs de l'Utilisateur. Forment
le contenu d'un masque de saisie d'un PromptSet.
Enfant, enfants
Objets activés par le biais de Tâches supérieures dans l'arborescence (parent).
Enregistré en attente
Statut d'une Tâche qui est exécutée dans un Groupe et attend son démarrage.
Enterprise Control Center
Produit Automic. Application Web pour accéder facilement et clairement aux fonctions de
diverses applications ou produits Automation Engine. Disponible dans le centre de
téléchargement Automic.
Event-ID
Premier RunID des Evènements de systèmes de fichiers ou de console. Les deux types
d'Evènements impliquent une communication entre le composant Automation Engine et
l'Agent AE. Afin que l'affectation à l'Evènement reste possible en cas de changement du
fichier de logging ou de modification liée du RunID, la communication s'effectue par le biais
du premier RunID.
Evènement
Action exécutée lorsque certaines conditions sont remplies. Egalement un type d'objet
distinct dans AE
Explorer
Fenêtre de l'Interface Utilisateur dans laquelle les objets sont affichés, traités et gérés.
Exécuteur de tâches
Deprecated Term. Replaced by: Agent
Exécution
Duré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).
Automation Engine
99
.6 F
l
l
l
l
Fenêtre d'activités
Fenêtre de l'Interface Utilisateur dans laquelle s'affichent les objets activés.
Fenêtre de message
Fenêtre dans l'Interface Utilisateur qui affiche avertissements, messages d'information et
d'erreur.
Fichier XML
Format d'importation et d'exportation. Contient la structure des objets.
Fuseau Horaire
Définit l'heure locale. Egalement un type d'objet distinct dans AE.
.7 G
l
l
l
l
l
l
Gestion des Versions
Version protégée d'un objet qui peut être créée lors des modifications et restaurée
ultérieurement.
Graphical Workload Analyzer
Deprecated Term. Replaced by: UC4 ClearView
Groupe
Regroupe des Tâches pour les exécuter ensemble. Egalement un type d'objet distinct dans
AE.
Groupe Agent
Groupe Calendrier
Rassemblement de jours au sein de Calendriers. Egalement un type d'objet distinct dans
AE.
Groupe Utilisateur
Regroupement d'Utilisateurs auxquels un profil de droits commun doit être attribué.
Egalement un type d'objet distinct dans AE.
.8 H
l
Hôte
Ordinateur, système cible
.9 I
l
Include
Script utilisé souvent et dans de nombreux objets. Egalement un type d'objet distinct dans
100
Chapter Glossaire
l
l
AE.
Interface Utilisateur
Interface utilisateur graphique d'UC4.
Interface Web
Interface utilisateur d'UC4 que l'on peut ouvrir via un navigateur web.
.10 J
l
l
Job
Traitement sur un système cible. Egalement un type d'objet distinct dans AE.
Job Control Language
Acronyme de "Job Control Language". Il s'agit d'instructions qui forment les étapes de
traitement et sont exécutées sur les machines.
.11 L
l
l
l
L'Automation Engine
Ce composant commande un système AE. Il se compose de plusieurs processus serveur.
Les Transferts de Fichiers avec caractères qualifiés
Transferts de fichiers sans caractères génériques. Uniquement un fichier spécifique est
transféré.
Login
Données de connexion pour les systèmes cible. Egalement un type d'objet distinct dans AE.
.12 M
l
l
l
l
l
l
Mode batch
Traitement séquentiel de processus en arrière-plan.
Moniteur Sync
Fenêtre d'affichage de l'état d'un objet Sync et de ses tâches attribuées.
Moniteur de Workflows
Représentation graphique de l'exécution d'objets de workflow actifs. Affiche la structure du
Workflow et le statut des tâches subordonnées.
Moniteur de groupe
Fenêtre d'affichage des tâches d'un groupe.
Moniteur de schedule
Représentation graphique de l'exécution d'objets de schedule.
moniteur d'alertes
Fenêtre de l'alerte envoyée à au moins un utilisateur au moment de l'exécution.
Automation Engine
101
.13 O
l
Objet
Les activités et déroulements que contrôle Automation Engine sont représentés à l'aide
d'objets (voir aussi Tâche).
.14 P
l
l
l
l
l
l
l
l
l
l
l
l
Parent
Un objet peut être activé de différentes façons. L'initiateur de l'activation s'appelle Tâche de
niveau supérieur (parent). (voir aussi Enfant, Enfants)
Priorité AE
La priorité AE est influencée par le traitement des Tâches au sein du système AE.
Process Assembly
Perspective de l'Enterprise Control Center. Sert à créer, définir et modifier des workflows.
Process Automation
Ancien nom de la perspective Catalogue de Service.
Process Monitoring
Perspective de l'Enterprise Control Center. Liste et permet d'agir (annuler, désactiver,...) sur
les activités de tous les utilisateurs.
Processus de Travail Primaire
Le processus de travail primaire exécute des Tâches centrales des processus de travail qui
ne permettent aucune répartition (base horaire, gestion des processus, etc.)
Processus de communication
Partie du composante Automation Engine. Assure la connexion aux composants AE.
Processus de dialogue
Partie du composant Automation Engine et forme particulière de processus de travail. Ne
s'occupe que des messages provenant de l'Interface Utilisateur.
Processus de travail
Partie du composante Automation Engine. S'occupe du traitement dans un système UC4
(voir aussi le processus de travail primaire).
Processus non-stop
Partie du composante Automation Engine. Ils reprennent le traitement lorsque la machine
avec les processus serveur actifs tombe en panne.
Processus serveur
Partie du composant Automation Engine. Il existe plusieurs types de processus serveur:
processus de communication, processus de travail, processus de dialogue et processus
non-stop.
PromptSet
Masque de saisie défini par l'Utilisateur pour les objets activables. Egalement un type d'objet
distinct dans AE.
102
Chapter Glossaire
l
l
Protocole d'activation
Rapport contenant les détails d'activation de la Tâche. JCL généré, modifications de
Variables, etc.).
perspective
"Volet fonctionnel propre de l'interface Web de l'Enterprise Control Center (ECC). Les
perspectives ""Service Catalog"", ""Process Monitoring"" et ""Process Assembly"" mettent
à disposition de l'utilisateur des fonctionnalités de la plate-forme d'automatisation
Automation Engine."
.15 Q
l
l
Queue
Définit le nombre maximal de Tâches exécutées en parallèle, leur priorité et l'ordre des objets
à exécuter.Egalement un type d'objet distinct dans AE.
QueueManager
Deprecated Term. Replaced by: RemoteTaskManager
.16 R
l
l
l
l
l
Rapport
Rapport contenant les détails d'activation d'une Tâche ou d'un composant AE.
Release Manager
Deprecated Term.
RemoteTaskManager
Surveille et contrôle les Jobs externes qui n'ont pas été démarrés par l'Automation Engine
Egalement un type d'objet distinct dans l'AE.
Reprise
Répétition d'une exécution d'objet déjà créée pour laquelle plusieurs particularités
s'appliquent au redémarrage.
RunID
Abréviation du numéro d'identification unique. Il s'agit plus précisément d'un nombre qui
identifie clairement l'exécution d'une Tâche. Le RunID peut comporter entre 7 et 10
caractères . Ils sont attribués par le composant Automation Engine.
.17 S
l
Schedule
Démarre des objets activables à intervalles périodiques. Egalement un type d'objet distinct
dans AE.
Automation Engine
l
l
l
l
l
l
l
l
l
l
l
l
l
l
l
l
Script
Instructions de traitement dans le langage de script d'AE. Egalement un type d'objet distinct
dans AE.
Script AE
Langage de script utilisé par l'Automation Engine.
Serveur UC4
Anciens Terme pour le composant Automation Engine.
Service Catalog
Perspective de l'Enterprise Control Center. Permet à l'utilisateur de démarrer les objets de
son dossier Favoris et d'en surveiller en gros l'exécution.
Service Orchestrator
Produit Automic. Service Orchestrator est une perspective (plug-in) de Enterprise Control
Center (ECC). Il sert à gérer, surveiller, analyser les performances de SLA (Service Level
Agreements).
ServiceManager
Programme permettant de démarrer et d'arrêter des composants AE.
Simulation
Estimation de la durée d'une Tâche sur la base des exécutions précédentes.
Solution RA
Solution basée sur la technologie Rapid Automation permettant l'accès d'AE à un système,
une application ou une plate-forme externe. Il s'agit ici d'un fichier .jar, à charger dans la base
de données AE et à associer à un agent RA. Les objets RA spécifiques (jobs, relations et
agent) sont disponibles après chargement de la solution dans le système AE.
Sous-Workflow
Workflow faisant partie d'une autre Workflow.
Statistiques
Liste des exécutions précédentes d'une Tâche.
Statut
Statut d'une Tâche (par ex. active, bloquée, génération en cours, etc.).
Supervision système
Fenêtre de l'Interface Utilisateur contenant des informations sur le système AE.
Sync
Synchronise les objets activables en fonction de statuts et d'actions définis. Egalement un
type d'objet distinct dans AE.
Système AE
Environnement contrôlé par les composants AE.
Séquence de données
Liste interne (Exemple : Sorties de console ou lignes d'un objet Variable), dont les lignes
peuvent être accessibles grâce à une boucle PROCESS et l'élément de script GET_
PROCESS_LINE. Les Séquences de données sont créées avec les éléments de script
PREP_PROCESS*.
simulation automatique
Indique les tâches qui seront exécutées dans une période donnée et offre ainsi une
prévisualisation détaillée des activités futures.
.18 T
l
103
Table de Code
Définit un jeu de caractères complet. Egalement un type d'objet distinct dans AE.
104
Chapter Glossaire
l
l
l
l
l
l
Transfert de Fichier
Transmission de fichiers entre deux machines. Egalement un type d'objet distinct dans AE.
Type d'objet
A chaque activité correspond un objet: Agent, Alerte, Utilisateur, Groupe Utilisateur,
Cockpit, Table de Codes, Documentation, Evènement, Transfert de Fichier, Groupe,
Include, Job, Workflow, Groupe Calendrier, Login, Client, RemoteTaskManager, Schedule,
Script, Serveur, Sync, Variable et Fuseau horaire.
Tâche
Objet exécutable qui a déjà été exécuté.
Tâche de niveau supérieur
Liste des exécutions précédentes d'une Tâche.
Tâches périodiques
Sont planifiées sans objet Schedule et couvrent la plupart du temps une période inférieure à
un jour.
transferts de fichiers avec caractères génériques
Transferts de fichiers qui transfèrent plusieurs fichiers à l'aide de caractères génériques.
.19 U
l
l
l
l
l
l
l
l
l
l
l
l
UC4 Automation Engine
UC4 Automation Platform
Deprecated Term. Replaced by: UC4 Automation Engine
UC4 ClearView
Produit UC4. Outil d'analyse graphique : Regroupe, pour chaque utilisateur d'un système
UC4, les données de simulation, d'activités et de statistiques dans un diagramme à barre et
permet ainsi le calcul du chemin critique. Disponible dans le centre de téléchargement UC4.
UC4 ONE Automation 2013
UC4 Operations Manager
Deprecated Term. Replaced by: UC4 Automation Platform
UC4.DB Archive
L'utilitaire UC4.DB Archive exporte, afin de la sécuriser, la quantité sans cesse croissante
de données de la base de données UC4.
UC4.DB Change
Utilitaire de modification d'exportation de conteneurs Transport.
UC4.DB Client Copy
Utilitaire de copie et suppression de clients
UC4.DB Load
Pour réaliser différents objectifs, l'utilitaire UC4.DBLoad charge des données dans la base
de données UC4.
UC4.DB Reorg
Utilitaire de réorganisation de la base de données UC4. Les enregistrements reçoivent une
marque de suppression en raison de certains réglages.
UC4.DB Reporting Tool
L'utilitaire UC4.DB Reporting Tool vous permet de procéder à des évaluations de votre
système UC4. Le résultat est présenté sous forme de fichier de rapport.
UC4.DB Revision Report
Utilitaire de décharge des rapports de révision issus de la base de données UC4. Ces
rapports contiennent des informations détaillées sur les modifications d'objets et les accès.
Automation Engine
l
l
l
l
l
105
UC4.DB Unload
Utilitaire de déchargement de la base de données UC4
UC4.Log Mix
L'utilitaire UC4.LogMix vous aide à résoudre ce problème en créant un fichier unique à partir
de plusieurs fichiers de rapport, log ou trace.
Universal Time Coordinated
L'Automation Engine utilise UTC (Universal Time Coordinated) en interne en raison de sa
clarté universelle. Pour l'affichage de l'heure et pour son utilisation dans les Tâches et les
éléments de script, il est possible de créer des objets Fuseau horaire correspondants,
convertis dans un fuseau horaire local.
Utilisateur
Personne utilisant le système UC4. Egalement un type d'objet distinct dans UC4.
Utilitaires
Prennent en charge les Tâches d'administration d'un système UC4, telles que la
réorganisation et l'archivage de la base de données UC4.
.20 V
l
l
l
l
l
l
l
l
Variable
Enregistre ou fournit les valeurs dynamiques de l'exécution. Egalement un type d'objet
distinct dans UC4.
Variable PromptSet
Enregistre la valeur d'un élément PromptSet. Ainsi, il peut s'agir selon la situation de celle
indiquée par l'Utilisateur ou d'une valeur par défaut. Elles se comportent comme des
Variables d'objet.
Variable de Script
Caractères de remplacement d'une valeur dans un Script.
Variable dynamique
Objet Variable avec l'attribut "Source" - "SQL", "SQL interne", "Multi" ou "Liste de fichier".
Pour chaque accès, les valeurs sont récupérées directement dans la source de données et
ne sont pas enregistrées dans l'objet.
Variable prédéfinie
Variables fixes qui peuvent être utilisées dans des attributs ou dans des Scripts d'objets
activables. Les valeurs se rapportent à l'objet ou au système.
Variable statique
objet Variable avec le paramètre "Source" - "statique" : Les valeurs des Variables sont
saisies par l'Utilisateur ou par un Script et restent enregistrées dans l'objet.
Variables AE
Variables comportant les paramètres de configuration du système AE.
Variables d'objet
Caractères de remplacement des valeurs définies dans l'onglet "Variables & Prompts" d'un
objet.
106
Chapter Glossaire
.21 W
l
l
WebHelp
Format d'aide pour les manuels qui peut être ouvert via un navigateur web. (voir aussi l'aide
HTML)
Workflow
Déroulement de Traitements. Egalement un type d'objet propre à UC4.