Centre de Services

d’Amiens

Formation
IDOC
27 août 2024
 Objectifs de la présentation

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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Sommaire

 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Présentation Générale(1/4)

 IDOC = Intermediate DOCument

 Ensemble d’enregistrements comprenant

 Des données applicatives (Ex données clients)
 Des données de gestion (Données nécessaires au traitement de l’Idoc)

 Forme électronique d’un processus transactionnel

(Ex : une commande d’achat)

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Présentation Générale(2/4)

 Deux formats d’échange

 EDI : Electronic Data Interchange
Format d’échange identique pour tous les systèmes
 ALE : Application Link Enabling

 Type d’échanges
 Intra-société : échange de données entre différentes application SAP ou
non SAP dans une même société
Ex : envoi des données commande entre un système de prise de
commande et SAP

 Inter-société : échange de données entre différentes sociétés

Ex : envoi des commandes d’achat d’un client à un fournisseur

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Présentation Générale(3/4)

 ALE : Application Link Enabling

 EDI : Electronic Data Interchange

Document

ALE
Système SAP R/3 R/2 Système SAP R/3 R/2
Idoc
Idoc sortant Idoc entrant

Sous système EDI

EDI Sous système EDI
Message
www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Présentation Générale(4/4)

 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(1/9)

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…)

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(2/9)

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

Enregistrement de contrôle
Enregistrements de données

Enregistrements de statuts

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(3/9)

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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(4/9)

Les enregistrements de données

 Il contient :

Enregistrement de donnée
En tête Données applicatives

Zone 1 Zone 2

 L ’entête contient le nom du segment.

 Le segment est une structure du DDIC

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(5/9)

Les enregistrements de statut

 Il contient :

ID de l ’Idoc + information sur le statut

 Au cours du traitement, les informations de statut

évoluent et servent de base pour la gestion des exceptions

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(6/9)

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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(7/9)

Extension d’Idoc

 Il s’agit d’un type d’Idoc permettant de créer de nouveaux

segments dans un type d’ Idoc standard

 Les segment de l’Extension se remplissent par User-Exit

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(8/9)

Quelques transactions:

 WEDI
 Segments WE30
 Type d’IDOC/Extensions WE31

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Définition des IDOCs(9/9)

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.

 On peut créer des extensions d’Idoc pour rajouter des

segments à des types d’Idoc standard.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Les définitions des communications
en entrées et sorties (1/2)

SOMMAIRE

Port / type de port

 Fichier
 RFC
 Internet
 CPI-C
 PI

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Les définitions des communications
en entrées et sorties (2/2)

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 ?

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Types de port (1/6)

 Cinq techniques de communication différentes :

Interface Idoc

Fichier tRFC Internet CPI-C PI

/RFC

Système externe R/2 Autre...

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Types de port (2/6)

Types de port fichier :

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).

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Types de port (3/6)

Interface Idoc
4 3
1 2
Startrfc
Fichier Rfcexec Fichier Idoc in.script
Idoc out.script Conf. statut statut.script

1 2
3 4
Système externe

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Types de port (4/6)

Types de port tRFC

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

Interface Idoc
Interface RFC

TCP/IP

Interface RFC
Système externe

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Types de port (5/6)

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.

Interface Idoc R/3

TCP/IP

CPI-C

LI 6.2

Interface Idoc R/2

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Types de port (6/6)

Types de port Internet

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

Interface Idoc R/3

SAP office / SAP connect

E-mail MIME

Système externe
www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Systèmes logiques
Identification du système émetteur(1/2)

 Création d ’un système logique

 IMG > Composantes inter-applications > Répartition (ALE) > Options de
base > Installer système logique > Gérer systèmes logiques
 En SAP 4.7 , IMG>SAP Web Application Server>Application Link Enabling
(ALE)>Préparer systèmes émetteur et récepteur>Configurer systèmes
logiques>Nommer le système logique

 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Systèmes logiques
Identification du système émetteur(2/2)

 Affectation du système logique au système physique

 IMG > Composantes inter-applications > Répartition (ALE) > Options de
base > Installer système logique > Affecter système logique au mandant
 En SAP 4.7 , IMG>SAP Web Application Server>Application Link Enabling
(ALE)>Préparer systèmes émetteur et récepteur>Configurer systèmes
logiques>Affecter système logique au mandant

 Le système logique est lié à un mandant d’une instance SAP.

Caractéristiques :
 Table inter mandant
 Valable pour l ’ALE et l ’EDI.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Systèmes logiques
Répartition ALE (1/2)

 Gestion de l ’ALE :
 IMG > Composantes inter-applications > Répartition (ALE) > Gérer modèle
de répartition >

 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Systèmes logiques
Répartition ALE (2/2)

Exemple sur le système UC4 (4.0B)

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange (1/9)

SOMMAIRE

 Le paramétrage des accords d ’interchange

Exemples :
 Configuration des partenaires EDI (fournisseur)
 Configuration des partenaires ALE

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange (2/9)

 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange (3/9)
Les quatre vues

 Quatre vues :
Partenaire Message + Comprenez :
Partie à aviser Partenaire
Général Port Message =
Type de port document SAP
Sortant
Type d ’Idoc
Application
Partie à aviser Partenaire
Code opération
Message +
Partenaire Message logique
Entrant Code opération Paramètre MC
Partie à aviser
www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange entrant (4/9)

 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange entrant (5/9)
Code 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange sortants (6/9)
« 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é

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange sortants (7/9)
« 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange sortant (8/9)
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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Accords d ’interchange sortant (9/9)
avec le type de port fichier

 Dans ce cas, quatre options sont possibles : (à mettre à jour)

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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Configuration des partenaires EDI
Exemple pour un client livré

Création de la vue générale (à mettre à jour)

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Configuration des partenaires EDI
Exemple pour un client livré

Vue sortante

Vue entrante
www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Configuration des partenaires EDI
Exemple pour un client livré

Vue MC

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Configuration des partenaires ALE

un système logique = un mandant = un accord d ’interchange

Mandant 001 Mandant 021

UC4_001 UC4_021

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Quelques codes transactions

 WEDI
 Accords d ’interchange WE20
 port WE21
 Outil de test WE19
 documentation WE60
 BD87 Traitement des IDOC reçus
 BD88 Traitement des IDOC émis
 SPRO Customizing (Répartition ALE) ou SALE

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Les processus d ’envoi et réception de données

Système
externe
Facture
Idoc maître
Interface Idoc
Idoc(s) de
/ Service ALE communication

Facture
Idoc maître

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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 ».

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Envoi des données et ALE

 Déclenchement de l’envoi 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.
 L’application envoie un IDOC vers toutes les applications
réparties intéressées par le document créé ou modifié.
 Envoi direct ou différé.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Envoi des données et EDI

 Déclenchement de l’envoi par : correspondance ou

lancement massif.
 Envoi individuel ou par lot, avec ou sans lancement du sous
système.

 Envoi direct ou différé.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Traitement des documents sortants
Gestion 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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 d’enregistrements 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Le Workflow : la configuration minimale
pour la gestion des erreurs

SOMMAIRE
 le traitement des erreurs

 le paramétrage dans SAP

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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 d’interchange

 ( Le paramétrage dans SAP est décrit en annexe.)

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Traitement des documents entrants
sans 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 L ’environnement de développement

SOMMAIRE
 Création d’un segment,
 Création d’un type d’Idoc,
 Création d’un message logique associé au type d’Idoc,
 Création d’un module fonction pour le traitement de l’Idoc ,
 Définition des attributs ALE du module fonction pour le traitement de l’IDOC avec les
services ALE,
 Association entre le type d’Idoc, le module fonction, le message logique et un objet
d’application,
 Définition/utilisation d’un code opération pour l’envoi d’un message Workflow
déclenché par des événements (IDOC erroné,…)
 Définition/utilisation d’une tâche Workflow et définition des partenaires pour la réception
des tâches Workflow dans leur corbeille d’arrivée

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 1- Création d ’un segment

WEDI > Développement > Segments Idoc (transaction WE31)

 Utiliser des zones de structure du DDIC

 Pour activer la définition d’un segment, faire “ Traiter\Apposer

témoin ‘’libération’’

 Pour modifier la définition d’un segment, ‘’Annuler la libération’’

 Le segment est créé dans le DDIC (CF. SE12)

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 2- Création d ’un type d ’Idoc

WEDI > Développement > Types d ’Idoc (transaction WE30)

Type d ’IDOC
Segment

Penser à activer la définition du type d ’Idoc

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 3 - Création du message logique
et association au type d ’Idoc

 Création d’un type de message spécifique Z…

WEDI > Développement > Types de message

 Lien type d ’Idoc

WEDI > Développement >
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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 4- Création du module fonction

 Copie d ’un module fonction standard

 Les paramètres d’entrée et de sortie du module doivent respecter les

paramètres requis pour la gestion d’un 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_<nom du message>
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 5-2 Définition des propriétés
du module fonction

Accès : transaction BALD puis IDOC\Réception\Attributs du module fonction

 Le type de saisie indique la manière de traiter les paquets d’IDOC.
« 1 » n’autorise que la réception individuelle.
 La case ‘Dialogue possible’ autorise un traitement de transaction à
l’écran lorsqu’elle est cochée.

 Notez bien : la vue V_TBD51 contenant ces propriétés est inter-mandant.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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 d’opération - Type du traitement

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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
d’opération –
Traitement erreurs
(BD67)
www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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 d’objet 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 5-4 Définition du code opération
Traitement des erreurs (lié avec le Workflow)

Accès : Outil ->

Business Workflow ->
Développement -
>Outils de définition -
>Tâche (PFTC)

Faire « Données
supplémentaires ->
Affect. De
responsables »
Il s ’agit de
l ’utilisateur
responsable du
traitement des erreurs.
www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 5-4 Définition du code opération
Traitement des erreurs (lié avec le Workflow)

Accès : transaction WEDI puis Gestion\Administration 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 ...

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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 d’erreur
 Création des événements
 Création des liens avec les objets concernés

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Attention !

 Attention aux reprises de données (volumétrie)

 Convergence de paramétrage entre les systèmes
 Nécessité d’avoir une Stratégie d’archivage IDOC
 Volumétrie/Périodicité
 Gestion des workflows
 Archivage/Suppression
 Réorganisation des pointeurs de modification
 Purge des pointeurs traités

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Les transactions ALE

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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 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

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Pause

10 minutes de pause.

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Exercices

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC
 Conclusion

Tour de table

Quels sont les points que vous avez retenus de ce MSU?

www.unilog.logicacmg.com
www.unilog.logicacmg.com
www.unilog.com 27 août 2024 Formation IDOC