I-DOC

1
I-DOC

• Intermediate DOCument

2
A qui s adresse ce cours ?Quels objectifs ?

• Participants
• Ingénieurs
• Consultants techniques (la première journée)
• Objectifs du cours
• A la fin du cours, vous serez en mesure de
• configurer l interface Idoc
• suivre le traitement des Idocs dans le système
• créer et modifier un Idoc spécifique

3
Sommaire 1

• Chapitre 1 présentation générale des Idocs
• Chapitre 2 les définitions des IDOC
• Chapitre 3 les processus d envoie / réception
• Chapitre 4 l environnement de développement
• Chapitre 5 le Workflow et la configuration
  minimale pour la gestion des erreurs
• Chapitre 6 les tests des traitements
• Chapitre 7 l administration

4
Sommaire 2

• Feuille Word dans directory

5
Présentation générale des Idocs

• Qu est qu un Idoc ?
• Intermediate DOCument
• un ensemble d enregistrements dans la base de
  données qui comprennent les données applicatives
  d un document de gestion (ex. facture) ainsi que
  des données de gestion (ex. un statut évoluant
  lors de son traitement)
• L IDOC est utilisé pour mettre un processus
  transactionnel (tel quune commande) dans une
  forme électronique.

6
Présentation générale des Idocs

• Les utilisations des Idoc sont cross-
  applications
• Workflow
• Système R/3 ou R/2
• ALE
• EDI
• Système R/2
• Internet/ Intranet
• ...

7
Présentation générale des Idocs

• Quand les utiliser ?
• EDI échange de données informatisé entre
  différentes sociétés
• ex. entre un client et un fournisseur
• ALE échange de données informatisé entre
  différentes applications réparties sur plusieurs
  systèmes au sein d une même société.
• ex. entre deux systèmes R/3 ou R/2, entre R/3 et
  un système de traçabilité, entre R/3 et un
  système d acquisition
• Les données sont des données de base telles que
  fiches articles, comptes généraux, .ou des
  documents applicatifs tels que documents
  comptables, contrats cadres...

8
Présentation générale des Idocs

• ALE Application Link Enabling
• EDI Electronic Data Interchange

9
Quelques caractéristiques de l interface Idoc

• Interface standard
• Structure des messages standards / Montée de
  version
• Gestion des erreurs
• Avertissement des utilisateurs responsables
• Consultation du message d erreur et de l IDOC
• Recyclage de l IDOC (manuel ou automatique)
• Monitorage des IDOCs
• suivi des IDOCs, liste des erreurs, statistiques,
  audit ....
• Utilisable pour une interface périodique ou
  permanente entre applications.

10
L architecture EDI et ALE

• SOMMAIRE
• EDI Sous système EDI, module SAP
• ALE système de gestion externe
• Les composantes impactées dans SAP

11
EDI sous système, module SAP
12
ALE Idocs de communication
13
Les composantes impactées dans SAP
14
Les définitions des IDOC

• SOMMAIRE
• Type d enregistrements contrôle, données et
  statut
• les trois types d enregistrements d un IDOC
• l enregistrement de contrôle
• les enregistrements de données
• les enregistrements de statuts
• Type d IDOC
• définition du contenant (structure du message)
• Type de message
• définition du contenu (commande, facture,
  article)

15
Les définitions des IDOC

• A la fin de ce chapitre vous devez pouvoir
  répondre aux questions
• Qu est ce qu un type d Idoc par rapport à un
  Idoc ?
• Comment est structuré un Idoc ?

16
Types d enregistrement Idoc

• Chaque Idoc de la base de données R/3 est
  composée de

17
L enregistrement de contrôle

• Il contient les données générales de
  communication
• l ID de l Idoc
• trois données  partenaire 
• le type d Idoc et le message logique
• la structure externe (nom du sous système EDI par
  exemple)
• le  port d entrée ou de sortie  de SAP
• Son rôle est de permettre la communication
  entre systèmes et en accord avec le paramétrage
  des systèmes.

18
Les enregistrements de donnée

• Il contient
• L entête contient le nom du segment.
• Le segment est une structure du DDIC

19
Les enregistrements de statut

• Il contient
• Au cours du traitement, les informations de
  statut évoluent et servent de base pour la
  gestion des exceptions

20
Types d Idoc

• C est un ensemble de segments (le contenant),
  ordonnés et hiérarchisés.
• Un type d Idoc est très lié à une application ou
  à un processus de gestion (ex. une commande).
• Lorsqu ils contiennent des données applicatives,
  les segments constituent un Idoc.
• L Idoc est une instance du type d Idoc.

21
Résumé

• Dans SAP, un Idoc est constitué d un
  enregistrement de contrôle, d enregistrements de
  données et d enregistrements de statuts
• Ces derniers ne sont pas transmis au système
  externe.
• C est le type d Idoc qui spécifie les
  différents segments et leurs hiérarchies.

22
Les définitions des communications en entrées et
sorties

• SOMMAIRE
• Port / type de port
• Fichier
• RFC
• Internet
• CPI-C
• PI

23
Les définitions des communications en entrées et
sorties

• A la fin de ce chapitre vous devez pouvoir
  répondre aux questions
• Qu est ce qu un port, un accord d interchange
  ?
• Comment sont utilisées ces définitions ?

24
Types de port définition

• Cinq techniques de communication différentes

25
Types de port fichier

• Définition

• La définition d un port fichier comprend
• le nom du fichier de sortie,
• le nom et le répertoire du fichier de commande
  devant être appelé par le programme rfcexec et
  qui lance le système externe,
• une destination RFC celle-ci doit être définie
  dans la transaction SM59 (connexion TCP/IP).

26
Types de port fichier
27
Types de port tRFC

• Le port de type tRFC est relié à une destination
  RFC du serveur d application pour le système
  externe.

28
Types de port CPI-C

• Le port de type CPI-C est relié à une
  destination RFC du serveur d application pour le
  système externe.

29
Types de port Internet

• l Idoc est envoyé avec une adresse Internet au
  format MIME.

30
Types de port PI

• Programming interface

31
Communication avec versions antérieures

• Les structures sont modifiées selon les
  versions.
• Noms plus longs
• zones supplémentaires
• Pour la communication avec une version inférieure
  (scénario ALE), il faut spécifier la version dans
  la définition du port.

32
Paramétrages de base des systèmes

• SOMMAIRE
• le paramétrage de base
• Création d un système logique
• Affectation d un système logique au système
  physique
• Cas particulier de l ALE

33
Systèmes logiquesIdentification du système
émetteur

• 1- Création d un système logique
• IMG gt Composantes inter-applications gt
  Répartition (ALE) gt Options de base gt Installer
  système logique gt Gérer systèmes logiques
• Un nom de système logique doit être créé par
  émetteur de messages SAP. Ce nom ne doit pas être
  spécifique au nom du système physique mais à sa
  fonction.
• Caractéristiques
• Table inter mandant
• Valable pour l ALE et l EDI.

34
Systèmes logiquesIdentification du système
émetteur

• 2- Affectation du système logique au système
  physique
• IMG gt Composantes inter-applications gt
  Répartition (ALE) gt Options de base gt Installer
  système logique gt Affecter système logique au
  mandant
• Le système logique est lié à un mandant dune
  instance SAP.
• Caractéristiques
• Table inter mandant
• Valable pour l ALE et l EDI.

35
Systèmes logiquesRépartition ALE

• 3- Gestion de l ALE
• IMG gt Composantes inter-applications gt
  Répartition (ALE) gt Gérer modèle de répartition gt
  
• Un modèle de répartition doit être défini afin de
  faire le lien entre les systèmes logiques et le
  message à transmettre.
• N.B le message est lié à un document SAP (ex.
  commande, centre de coût).
• Caractéristiques
• Modèle avec répartition sur les différents
  mandants
• Valable pour l ALE seulement

36
Systèmes logiquesRépartition ALE

• Exemple sur le système UC4 (4.0B)

37
Résumé

• Les Idocs sont échangés par l intermédiaire du
  port.
• Le port définit le système cible et les
  paramètres de communication techniques.
• En émission, le port comprend les paramètres
  techniques de sortie (lien avec le système
  externe)
• En réception,il s agit d une porte d entrée
  dans SAP.
• Un paramétrage technique est nécessaire en amont
• N.B. L échange de donnée est également lié au
  paramétrage SAP Office et SAPConnect pour
  Internet.

38
Les accords d interchange

• SOMMAIRE
• Le paramétrage des accords d interchange
• Exemples
• Configuration des partenaires EDI (fournisseur)
• Configuration des partenaires ALE

39
Accords d interchange

• Ils permettent de faire le lien entre le
  document SAP et l Idoc.
• Exemple pour l envoi des données
• au départ, un document SAP est enregistré (une
  commande)
• à l enregistrement, un Idoc est généré.
• A partir du n de fournisseur, les accords
  d interchange sont lus pour trouver le type
  d Idoc, le port à utiliser.

40
Accords d interchangeLes quatre vues

• Quatre vues

Comprenez Message document SAP
41
Accords d interchange entrant

• Dans l enregistrement de contrôle de tous les
  Idoc, on trouve les données partenaire et le type
  de message.
• Le témoin de test fait également partie de
  l enregistrement de contrôle.
• À partir de ces zones, une vue  Accord
  d interchange entrant  est définie de manière
  unique.

42
Accords d interchange entrantCode opération

• Parmi les données de l accord d interchange
  entrant figure le  code opération .
• Il identifie le type de traitement des données
  et est lié à un module fonction.
• Le module fonction lit les données depuis
  l Idoc entrant et poursuit le traitement des
  données.

43
Accords d interchange sortant les clés 

• partenaire
• numéro numéro SAP
• type B (banque), KU (client), LI (fournisseur),
  LS (système logique)
• Fonction est un client livré, un donneur
  d ordre ?
• message type, code et fonction
• type lié au document SAP (ex. centre de coût,
  commande)
• variante (fac.) pour créer un type dérivé.
• fonction (fac.) la fonction du message pour
  créer un sous type dérivé

44
Accords d interchange sortants les données 

• témoin de test lors des phases de tests
• type de port le port de sortie
• type d Idoc
• il est lié à une application (une version
  spécifique du système cible) ou à un processus de
  gestion (un type de document à traiter ex.
  appels fermes ou appels prévisionnels d une
  commande )
• Ex. pour le type de message ORDERS (commande), on
  trouve le type d IDOC ORDERS01, ORDERS02,
• destinataire des notifications

45
Accords d interchange sortant gestion des
messages

• Les zones propres à la gestion des messages sont
  
• l application (par exemple EF pour Achat),
• la case à cocher  modification de message  (par
  opposition à  création )
• le partenaire
• Ces trois zones définissent un type de message
  et un code opération de manière unique.
• À partir de l enregistrement MC, une vue
   Accord d interchange sortant  est définie de
  manière unique.

46
Accords d interchange sortant avec le type de
port fichier

• Dans ce cas, quatre options sont possibles

Transfert un seul Idoc et lance le système externe
Transfert un seul Idoc et ne lance pas le système
externe
Transfert par lot d Idoc et lance le système
externe
Transfert par lot d Idoc et ne lance pas le
système externe
47
Configuration des partenaires EDI Exemple pour
un client livré

• Création de la vue générale

48
Configuration des partenaires EDI Exemple pour
un client livré
Vue sortante
Vue entrante
49
Configuration des partenaires EDI Exemple pour
un client livré
Vue MC
50
Configuration des partenaires ALE

• un système logique un mandant un accord
  d interchange

51
Accords d interchange résumé

• Les partenaires sont saisis dans les accords
  d interchange afin que les Idocs puissent être
  transmis avec succès.
• Les accords d interchange précisent la méthode
  d envoi des Idocs, le traitement à effectuer
  ainsi que le mode de traitement.
• Le port doit être précisé pour la vue
   Sortante  des accords d interchange.

52
Quelques codes transactions

• WEDI
• Accords d interchange WE20
• port WE21
• Outil de test WE19
• documentation WE60
• VOED Configuration EDI
• BALD Configuration, développement ALE
• BALM Administration ALE et répartition
• BD87 Traitement des IDOC reçus
• BD88 Traitement des IDOC émis
• SPRO Customizing (Répartition ALE) ou SALE

53
Les processus d envoi et réception de données

• SOMMAIRE
• Le processus d envoi des données
• Transcription de données R/3 au format IDOC
• Envoi de données et ALE
• Envoi de données et EDI
• Le processus de réception des données
• Transcription de formats IDOC en données R/3
• Service ALE rôle

54
Les processus d envoi et réception de données
55
Envoi des données

• Le traitement des documents sortants comprend
• la création du document applicatif (ex. une
  facture)
• la génération de l Idoc sortant correspondant
• la recherche du partenaire et du port
• l envoi de l Idoc vers le système externe via
  le port
• La recherche du partenaire s effectue selon les
   accords d interchange .

56
Envoi des données et ALE

• Déclenchement de lenvoi par Pointeur de
  modification, correspondance ou lancement massif.
• Pointeurs de modification Toute donnée de base
  modifiée est transmise vers le système intéressé
  par cette modification.
• Lapplication envoie un IDOC vers toutes les
  applications réparties intéressées par le
  document créé ou modifié.
• Envoi direct ou différé.

57
Envoi des données et EDI

• Déclenchement de lenvoi par correspondance ou
  lancement massif.
• Envoi individuel ou par lot, avec ou sans
  lancement du sous système.
• Envoi direct ou différé.

58
Réception des données

• Le traitement des documents entrants comprend
• la réception des données Idoc depuis un système
  externe via un port entrant
• la création d un Idoc entrant
• la recherche du type de traitement correct via
  les accords d interchange
• la création d un document applicatif
• Le port comprend aussi les paramètres techniques
  d entrée (paramètre du système SAP)
• Les accords d interchange déterminent le
  traitement

59
Service ALE de l interface Idoc

• L interface Idoc comprend les services ALE.
• Les services ALE comprennent
• le filtrage d Idoc,
• la conversion d un Idoc,
• la modification de version,
• la détermination du partenaire destinataire ,
• la duplication de l Idoc.
• N.B. différent de l ALE compris habituellement

60
Traitement des documents entrants à l aide du
workflow

• Un Idoc est reçu par SAP et issu du système
  externe.
• L interface Idoc réceptionne l Idoc sur un
  port. Les coordonnées du système externe sont
  vérifiées.
• Le contenu de l Idoc est également vérifié ex.
  le partenaire existe t il dans SAP ?
• Ensuite, c est le Business Workflow qui pilote
  la création du document applicatif.

61
Traitement des documents sortantsGestion des
messages

• Repose sur la technique de conditions
• La création et l envoi d un Idoc sont liés à
  une séquence d opérations définie dans le
  customizing.
• L Idoc est envoyé à l interface Idoc qui se
  charge d effectuer les dernières
  transcodifications (services ALE).
• L Idoc est enfin envoyé à un port, techniquement
  lié au système externe.

62
Résumé

• Idoc est une norme SAP pour le transfert de
  données entre des systèmes
• L ALE et l EDI mettent en œuvre les Idocs
• Un Idoc est un ensemble denregistrements de
  données applicatives et de gestion
• Les accords d interchange et les ports
  permettent de gérer l émission et la réception
  d Idoc de SAP

63
Le Workflow la configuration minimale pour la
gestion des erreurs

• SOMMAIRE
• le traitement des erreurs
• le paramétrage dans SAP

64
Gestion des erreurs

• La gestion des erreurs se fait par le workflow
• Le paramétrage minimal pour les IDOCs est
  automatisé.
• Avertissement en cas de problèmes fonctionnels /
  techniques
• Retraitement des messages en erreur
• Notion de personne / Structure organisationnelle
  (regroupement)
• Déclaration des personnes ou services
  responsables
• pour les problèmes techniques Administrateur
  des IDOCs
• pour les problèmes fonctionnels dans les accords
  dinterchange
• Le paramétrage dans SAP est décrit en annexe.

65
Traitement des documents entrantssans workflow

• Les mêmes contrôles que pour le workflow sont
  exécutés.
• L Idoc est transmis directement au module de
  l application.
• C est au niveau des accords d interchange
  qu est géré l option Workflow ou non.

66
L environnement de développement

• SOMMAIRE
• Création dun segment,
• Création dun type dIdoc,
• Création dun message logique associé au type
  dIdoc,
• Création dun module fonction pour le traitement
  de lIdoc ,
• Définition des attributs ALE du module fonction
  pour le traitement de lIDOC avec les services
  ALE,
• Association entre le type dIdoc, le module
  fonction, le message logique et un objet
  dapplication,
• Définition/utilisation dun code opération pour
  lenvoi dun message Workflow déclenché par des
  événements (IDOC erroné,)
• Définition/utilisation dune tâche Workflow et
  définition des partenaires pour la réception des
  tâches Workflow dans leur corbeille darrivée

67
1- Création d un segment

• WEDI gt Développement gt Segments Idoc
  (transaction WE31)
• Utiliser des zones de structure du DDIC
• Pour activer la définition dun segment, faire
   Traiter\Apposer témoin libération
• Pour modifier la définition dun segment,
  Annuler la libération
• Le segment est créé dans le DDIC (CF. SE12)

68
2- Création d un type d Idoc

• WEDI gt Développement gt Types d Idoc
  (transaction WE30)
• Penser à activer la définition du type d Idoc

69
3 - Création du message logique et association au
type d Idoc

• Création dun type de message spécifique Z
• WEDI gt Développement gt Types de message
• Lien type d Idoc
• WEDI gt Développement gt
• Types d Idoc/Message
• Notez bien La vue VEDI_EDMSG contenant les
  types de messages logiques est inter-mandant. La
  table EDIMSG contenant le lien type IDOC/message
  logique est inter-mandant.

70
4- Création du module fonction

• Copie d un module fonction standard (conseillé)
• Les paramètres dentrée et de sortie du module
  doivent respecter les paramètres requis pour la
  gestion dun IDOC.
• Le code du module fonction utilise un formatage
  particulier (ex. gestion des messages
  d exception ou statut)
• Nom en général Z_IDOC_INPUT_ltnom du messagegt
• Exemple de structure de programme
• contrôle du type d Idoc et des accords
  d interchange
• contrôle du nom de chaque segment, de la séquence
  des enregistrements par rapport au type d Idoc
  défini dans SAP
• Traitement
• Mise à jour du statut de l Idoc

71
4- Création du module fonction

• ltFEUILLE cf. Plan_Idoc.doc ! gt

72
5- Paramétrage de la réception de l Idoc

• 5-1 Définition lien module fonction/type
  IDOC/message logique/sens du transfert
• 5-2 Définition des propriétés du module fonction
• 5-3 Définition du code opération
• 5-4 Définition du code opération - traitement des
  erreurs

73
5-1 Définition lien module fonction/type
IDOC/message logique

• Accès  transaction WEDI 
• puis Développement\
• Message/objet appl.
• Ou transaction BALD
•  puis IDOC\Réception\
• Module fonction/
• Message/Objet appl.
• Notez bien la vue VEDIEDIFCT contenant les
  types de messages logiques est inter-mandant.

74
5-2 Définition des propriétés du module fonction

• Accès  transaction BALD puis IDOC\Réception\Attri
  buts du module fonction
• Le type de saisie indique la manière de traiter
  les paquets dIDOC.  1  nautorise que la
  réception individuelle.
• La case Dialogue possible autorise un
  traitement de transaction à lécran lorsquelle
  est cochée.
• Notez bien la vue V_TBD51 contenant ces
  propriétés est inter-mandant.

75
5-3 Définition du code opération

• Accès  transaction WEDI puis Gestion\Code
  opér.(réception) OU  transaction BALD puis
  IDOC\Réception\Code dopération - Type du
  traitement

76
5-4 Définition du code opération Traitement des
erreurs (lié avec le Workflow)

• Déclenchement le module fonction renvoie le
  paramètre WORKFLOW_RESULT. Si celui-ci est
  différent de 0 (valeur 99999), il déclenche
  lévénement de création de tâche Workflow.

Accès  transaction BALD puis IDOC\Réception\Code
dopération Traitement erreurs (BD67)
77
5-4 Définition du code opération Traitement des
erreurs (lié avec le Workflow)
Accès  transaction BALD puis IDOC\Réception\Lien
avec événement (SWE2)
Le type dobjet IDOCAPPL et les événements vus
précédemment sont ici liés à un type de
récepteur. Remarque La tâche standard TS
20000051 (CF. transaction PFTC) définit le
traitement des erreurs lors de la réception de
BAPI-IDOC. Le type de récepteur WORKITEM permet
la mise à niveau de la tâche (suppression,)
après traitement des erreurs.
78
5-4 Définition du code opération Traitement des
erreurs (lié avec le Workflow)
Accès  Outil -gt Business Workflow -gt
Développement -gtOutils de définition -gtTâche
(PFTC) Faire  Données supplémentaires -gt
Affect. De responsables  Il s agit de
l utilisateur responsable du traitement des
erreurs.
79
5-4 Définition du code opération Traitement des
erreurs (lié avec le Workflow)
Accès  transaction BALD puis
IDOC\Réception\Contrôle de cohérence Effectuer un
contrôle de cohérence sur tout ce qui a été
défini auparavant pour le code opération.
Corriger les erreurs.
80
5-4 Définition du code opération Traitement des
erreurs (lié avec le Workflow)
Accès  transaction WEDI puis Gestion\Administrati
on IDOC Il s agit de définir les valeurs par
défaut pour le développement d Idoc. En
particulier, notez le lien avec le Workflow. Les
étapes suivantes sont la création des accords
d interchange et les tests ...
81
Développement ALE

• Extension
• Ajout de données dans un message
• Modification des programmes de traitement
  (sortant et/ou entrant)
• Création
• Création du message
• Création des codes de traitement
• Création du traitement (sortant et/ou entrant)
• Création de la tâche standard derreur
• Création des événements
• Création des liens avec les objets concernés

82
Attention !

• Attention aux reprises de données (volumétrie)
• Convergence de paramétrage entre les systèmes
• Nécessité davoir une Stratégie darchivage IDOC
• Volumétrie/Périodicité
• Gestion des workflows
• Archivage/Suppression
• Réorganisation des pointeurs de modification
• Purge des pointeurs traités

83
Les transactions ALE

• Paramétrage ALE
• Transaction SALE
• Administration/suivi des IDOCs
• Transaction BALE
• Transaction WEDI
• Envoi des données de base
• Transaction BALM

84
Synthèse codes transactions

• WEDI
• Accords d interchange WE20
• port WE21
• Outil de test WE19
• documentation WE60
• VOED Configuration EDI
• BALD Configuration, développement ALE
• BALM Administration ALE et répartition
• BD87 Traitement des IDOC reçus
• BD88 Traitement des IDOC émis
• SPRO Customizing (Répartition ALE) ou SALE

85
Tests de traitement

• WE19 (outil de test) avec les fonctions de debug
  disponibles
• en partant d un Idoc existant
• s il s agit d un Idoc entrant, simulant une
  sortie (au niveau applicatif) puis une entrée en
  modifiant l enregistrement de contrôle
• Exemple de l exercice commande d  achat puis
  commande client
• S il s agit de spécifique, tester les
  messages de succès, cas d erreurs, retraitement
  des anomalies.

86
Tests de traitement

• WE12 tests des fichiers sortants. Modifie les
  enregistrements de contrôle pour créer un Idoc
  entrant à partir d un Idoc sortant.
• Échange de données avec le système de fichiers
  WE14 (sortant), WE16 (entrant), WE17
  (confirmation de statut, entrant)
• Traitement de l enregistrement MC WE15
• Transfert de données depuis l interface Idoc
  vers un traitement des documents entrants
  supplémentaire WE19
• Transfert de données vers n importe quel port
  WE14

87
ANNEXE

• User-exit
• Mise en œuvre Gestion des erreurs - Workflow
• Glossaire
• Exemple de scripts Unix