Manuel d'intégration des applications > CallAPI > CallAPI et programme dédié > C, C++

 C, C++

CallAPI vous offre la possibilité d'exécuter des Scripts dans le système AE à partir de vos propres programmes C et C++.

Pour ce faire, associez les fichiers uccall3.h et ucxbwi3c.lib. Attention : votre programme doit pouvoir accéder à la bibliothèque ucxbwi3c.dll.

 Les fichiers fournis contiennent également des exemples de programmes qui vous montrent comment une activation de Script peut être mise en œuvre.

 Le fichier uccall3.h fournit des renseignements précis sur la structure et les fonctions.

Généralités

Le processus d'activation de Script se déroule toujours dans l'ordre suivant :

  1. Connexion au système AE
  2. Transmission du Script au système AE
  3. Déconnexion du système AE

 Vous pouvez bien sûr vous connecter simultanément à plusieurs systèmes AE et exécuter plusieurs Scripts. Une licence de dialogue est utilisée pour chaque connexion.

Fonctions

Vous pouvez utiliser les fonctions suivantes dans votre programme. Les fonctions indiquent le code retour 0 lorsque l'action a réussi ou un numéro de message en cas d'erreur.

Description

Type de données du code retour

Fonction

Connexion au système AE

long

UCCALL3_Logon (structure, données de connexion, lien)

Type de données de la structure : UCCALL_PARAMS*
Type des données de connexion : char*
Type de données de la connexion : char*

Format des données de connexion :    
Client, Utilisateur, [département, [mot de passe]]

Format des données de connexion pour le processus de communication :
nom DNS:numéro de port
ou
adresse TCP/IP:numéro de port

Activation d'un Script

long

UCCALL3_ActivateScript (structure, Script)

Type de données de la structure : UCCALL_PARAMS*
Type des données du Script : char*

Déconnexion du système AE

long

UCCALL3_Logoff (structure)

Type de données de la structure : UCCALL_PARAMS*

Fonction universelle

long

UCCALL3 (structures)

Vous pouvez également exécuter UCCALL3 à la place des fonctions citées précédemment. Toutefois, il est ensuite nécessaire d'indiquer l'Opcode dans la structure pour exécuter l'opération souhaitée.

Type de données de la structure : UCCALL_PARAMS*

Variables

Certaines informations, comme le nom du système ou le RunID renvoyé du Script, s'affichent dans une structure intitulée UCCALL_PARAMS. Elle contient les Variables suivantes :

Type de données

Variable

Description

char [4]

cOpCode

Code d'opération

Cette Variable doit être définie lorsque la fonction universelle est utilisée.

Valeurs autorisées :
"OPC_LOGON" - Connexion au système AE
"OPC_LOGOFF " - Déconnexion du système AE
"OPC_ACTIVATE_SCRIPT" - Activation d'un Script

char

cErrorCode

Le code d'erreur dans cErrorCode est défini automatiquement et peut contenir l'une des valeurs suivantes :

" " - Aucune erreur ne s'est produite
"P" - Paramètre(s) non valide(s)
"O" - Opcode non valide
"Q" - Echec de la connexion
"R" - Echec de la mémoire
"L" - Echec de la libération d'espace mémoire
"S" - Erreur du connecteur
"T" - Délai dépassé
"U" - Message d'erreur du système AE

char [3]

cInterface

Le numéro d'interface doit toujours contenir la valeur 3.

char [8]

cSystemName

Nom du système AE auquel la connexion doit être établie

unsigned short

sTimeout

Durée, en secondes, pendant laquelle CallAPI attend une confirmation du système AE

char

cLanguage

Langue utilisée dans les messages

unsigned char

cFlag1

Selon la valeur définie, cet indicateur agit sur l'une des options de traitement suivantes :

"CALL_FLAG1_INI_SERVER" - La connexion au processus de communication est déterminée à partir du fichier INI.
"CALL_FLAG1_INI_LOGIN" - Les données de connexion sont déterminées à partir du fichier INI.
"CALL_FLAG1_INI_USEMSL" - Convertit les Variables du message en texte.
"CALL_FLAG1_INI_USEALL" - Les réglages de la section [GLOBAL] du fichier INI sont utilisés.
"CALL_FLAG1_TRC_HANDLE" - uniquement pour le traitement CallAPI en interne
"CALL_FLAG1_LOG_HANDLE" - uniquement pour le traitement CallAPI en interne
"CALL_FLAG1_INI_FILE" - Nom du fichier INI
"CALL_FLAG1_TRC_OUTPUT" - uniquement pour le traitement CallAPI en interne

unsigned long [4]

lUnused1

non utilisé

unsigned long

Output

non utilisé

unsigned long [4]

lUnsued2

non utilisé

unsigned long

lScriptRunNr

RunID du Script

unsigned long

lRetCode

Code retour de l'exécution du Script

char [256]

cRetText

Partie Variable du message qui explique l'arrière-plan du code retour

char*

pIniFile

Chemin et nom du fichier INI

unsigned long

hZuLog

uniquement pour le traitement interne de CallAPI

unsigned long

hZuTrc

uniquement pour le traitement interne de CallAPI

unsigned long

hZuHlp

uniquement pour le traitement interne de CallAPI

unsigned long [11]

lUnused3

non utilisé

void*

pOwnPointer

uniquement pour le traitement interne de CallAPI

 

Rubriques connexes : 

Généralités sur CallAPI