par Services Integration Framework (SIF) est utilisé pour intégrer Informatica GMD avec applications personnalisées. Cette intégration nécessite une connaissance pratique préalable de MDM Hub et une familiarité avec Java et les API. Cet article explique comment effectuer l’intégration d’applications avec Informatica MDM à l’aide de leurs API données.
Qu’est-ce que le cadre d’intégration des services (SIF) ?
Vous pouvez utiliser Services Integration Framework (SIF) pour appeler les opérations MDM Hub à partir d’applications externes en temps réel. Il utilise architecture orientée services qui offre des fonctionnalités d’intégration d’applications sous la forme de services à d’autres applications.
Vous pouvez également configurer le SIF pour que MDM Hub interagisse avec le logiciel client. SIF fonctionne comme intermédiaire, ou niveau intermédiaire, dans le modèle client-serveur. Vous pouvez utiliser les protocoles d’accès SIF pour implémenter les interactions de demande et de réponse.
Remarque : Les ressources privées ne sont accessibles qu’aux utilisateurs administrateurs via des requêtes SIF.
Cadre d’intégration des services (SIF) des offres le services et événements suivants :
Les services de processus sont des processus d’intégration et des processus de personne à système. Par exemple, dans un domaine client, les services de processus incluent des activités telles que la vérification des clients et l’approbation des clients.
Les événements métier sont des événements et des actions régis par des règles et basés sur la logique métier. Par exemple, vous pouvez évaluer l’impact d’une nouvelle relation.
Dans le modèle de données, les services aux entreprises fonctionnent sur des objets de base. Par exemple, vous pouvez récupérer un objet de base client ou en créer un dans un domaine client.
Les services de données agissent sur les enregistrements des tables. Vous pouvez récupérer un enregistrement, insérer un enregistrement ou mettre à jour un enregistrement.
Les événements de données sont des événements qui affectent les données de base ou les données source. Par exemple, le nom de famille d’un client change dans un enregistrement source ou une adresse change dans un enregistrement maître.
Les requêtes SIF peuvent communiquer directement entre elles. Les services de données peuvent interagir avec les événements de données, traiter les services avec les services de données, les services de données avec les services métier et les événements de données avec les services de processus.
Mise en œuvre du cadre d’intégration des services (SIF) :
SDK SIF :
Vous pouvez utiliser le SDK SIF pour développer des applications Java et des services Web qui communiquent avec le hub MDM. Le SDK SIF offre les outils nécessaires à la création et au déploiement de l’intégration d’applications SIF. De plus, il comprend également des exemples de codes pour développer des services Web et une série de classes Java pour créer des services.
De même, de nombreux développeurs utilisent le SDK SIF pour créer des services client, des objets de données, des contrôles d’interface graphique et des services métier pour le développement et la livraison d’applications Web et client riche.
Le programme d’installation du kit de ressources MDM Hub est fourni avec le SDK SIF. Vous pouvez facilement trouver les structures de répertoires, les bibliothèques, la documentation en ligne pour SIF et les fichiers de construction dans le répertoire suivant :
Toute machine cliente sur laquelle vous avez l’intention de créer et d’exécuter des programmes pour communiquer avec le Hub MDM doit être copiée avec le SDK SIF. Vous pouvez utiliser les classes Java fournies avec le SDK SIF si vous pouvez exécuter une machine virtuelle Java (JVM) sur le système client.
Protocoles d’accès
Vous pouvez utiliser les protocoles d’accès suivants pour les interactions de demande et de réponse SIF :
- Appels de procédure à distance Java étroitement couplés basés sur Enterprise JavaBeans (EJB) dans un environnement de développement Java.
- Services Web faiblement couplés qui utilisent le protocole SOAP. Utilisez le langage de description des services Web (WSDL) pour définir la demande et la réponse XML. L’environnement de développement peut être Microsoft Visual Studio, Eclipse ou d’autres outils client de service Web.
- Le protocole XML sur HTTP, qui est assez similaire aux services Web mais sans l’enveloppe SOAP.
- Messages asynchrones basés sur JMS qui utilisent le protocole XML sur HTTP.
Le protocole d’accès s’exécute au-dessus du protocole natif MDM Hub, qui accepte les requêtes au format XML ou EJB et renvoie les réponses dans le même format.
Vous pouvez également utiliser le proxy SiperianClient dans un Développement Java environnement pour gérer le protocole de communication pour les requêtes SIF.
Voici une image qui montre comment SIF traite les communications de requête et de réponse :
Configuration du SDK SIF
Le SDK SIF est fourni avec le programme d’installation du kit de ressources MDM Hub. Vous pouvez utiliser le programme d’installation du kit de ressources MDM Hub pour installer la documentation de référence SIF SDK et SIF API. Une fois que vous avez installé le kit de ressources, vous pouvez trouver les bibliothèques, les structures de répertoires, les fichiers de construction et la documentation de référence de l’API SIF dans le répertoire suivant :
Configuration d’un exemple de client Eclipse
Utiliser l’échantillon.projetfichier qui fait partie du SDK SIF pour créer un exemple de client Eclipse.
1. Dans l’IDE Eclipse, importez l’exemple.projetfichier situé dans le
répertoire dans votre espace de travail Eclipse.
2. Identifiez les fichiers JAR de bibliothèque manquants qui sont spécifiques au serveur d’intégration d’applications et ajoutez-les au chemin d’accès aux classes de génération. L’échantillon.projetnécessite les fichiers JAR de la bibliothèque pour configurer le chemin de génération Java approprié.
3. Vous devez personnaliser les fichiers suivants en fonction de votre environnement :
\hub\resourcekit\sdk\sifsdk\build.xml \hub\resourcekit\sdk\sifsdk\my.properties \hub\resourcekit\sdk\sifsdk\source\properties\log4j.xml \hub\resourcekit\sdk\sifsdk\source\properties\siperian-client.properties
Exemple de code pour récupérer des enregistrements
Après avoir configuré un client Eclipse, le code doit maintenant être développé pour interagir avec le hub MDM. Par exemple, créez une classe et ajoutez l’exemple de code suivant qui utilise le RechercheRequêteRequête
etSearchQueryResponse classes pour récupérer des enregistrements :
importer java.io.File ;
importer java.util.ArrayList ;
importer java.util.List ;
import com.siberian.sif.client.SiberianClient ;
importer com.siperian.sif.client.SoapSiperianClient ;
import com.siperian.sif.message.Parameter ;
importer com.siperian.sif.message.Record ;
importer com.siperian.sif.message.mrm.SearchQueryRequest ;
importer com.siperian.sif.message.mrm.SearchQueryResponse ;
classe publique SearchQuery {
public static void main(String[] arguments) {
Fichier file = new File(“E:\\siperian-client.properties”);
System.out.println(“Reading File:” + file.getAbsolutePath());
si (!fichier.existe()) {
System.out.println (” *** ERREUR -> Le fichier de propriétés n’existe pas à l’emplacement – “);
retour;
}
SoapSiperianClient sipClient = (SoapSiperianClient) SiperianClient.newSiperianClient(fichier);
Demande SearchQueryRequest = new SearchQueryRequest();
request.setRecordsToReturn(5);
request.setSiperianObjectUid(“BASE_OBJECT.C_PARTY”);
request.setFilterCriteria(“C_PARTY.FIRST_NAME =?”);
Paramètres ArrayList = new ArrayList(2);
params.add(nouveau Paramètre(“3333”));
request.setFilterParameters(params);
Réponse SearchQueryResponse = (SearchQueryResponse) sipClient.process(demande);
Lister les enregistrements
for (Record record : records) {
System.out.println(“Date de début de la période : ” + record.getField(“PERIOD_START_DATE”).getDateValue().toString());
System.out.println(“Date de fin de période : ” + record.getField(“PERIOD_END_DATE”).getDateValue().toString());
}
}
}
Exécution de l’exemple de code pour récupérer des enregistrements
Exécutez l’exemple de classe en tant qu’application Java une fois que vous avez créé une classe.
Pour exécuter l’exemple de classe en tant qu’application Java, dans l’IDE Eclipse, cliquez avec le bouton droit sur l’exemple de classe et sélectionnezExécuter en tant que -> Application Java. La vue de la console affiche la sortie.
Objets de requête et de réponse
Un ensemble d’objets de demande et de réponse est nécessaire pour chaque opération effectuée à l’aide de SIF. R Les méthodes d’un objet de requête spécifient l’action que vous souhaitez effectuer sur MDM Hub, et les méthodes d’un objet de réponse renvoient le résultat de cette action.
Une classe SIF peut représenter un objet de réponse ou un objet de requête. Une classe SIF qui représente un objet de demande a un suffixe de ‘Request’, et une classe SIF qui représente un objet de réponse a un suffixe de ‘Response.’ Par exemple, lePutRequestla classe représente un objet de requête, et la
PutResponseclasse représente la réponse à laPutRequestobjet.
Demander des objets
Un objet de requête inclut des méthodes qui indiquent l’action qui doit être effectuée sur MDM Hub. Une classe SIF qui représente un objet de requête est une sous-classe deSiperianRequest
classe et étend laSiperianRequest classe.
Par exemple, l’exemple suivant utilise leRechercheRequêteRequête objet:
Demande SearchQueryRequest = new SearchQueryRequest();
request.setRecordsToReturn(5); //Requis
request.setSiperianObjectUID(“PACKAGE.PARTY_ADDRESS_READ_PKG”);//Obligatoire
request.setFilterCriteria(“PARTY_FULL_NAME COMME ?”);
La requête exécute lePARTY_ADDRESS_READ_PKG paquet, utilise lePARTY_FULL_NAME J’AIME
critères de filtre et ne renvoie pas plus de cinq enregistrements.
Objets de réponse
Un objet de réponse représente la réponse à l’objet de requête correspondant et inclut des méthodes qui renvoient le résultat de l’action que vous effectuez sur MDM Hub. Une classe SIF qui représente un objet de réponse est une sous-classe duSibérienRéponseclasse et étend la
SibérienRéponseclassedans ça.
Par exemple, l’exemple suivant utilise le GetOrsMetadataResponseGetOrsMetadataResponseobjet:
GetOrsMetadataResponse getOrsMetadataResponse = (GetOrsMetadataResponse)
sifClient.process(getOrsMetadataRequest );
System.out.println(“ORS Metadata (première ligne uniquement):” +
getOrsMetadataResponse.getRepositoryXml().substring(0, 80));;
Conclusion
Nous espérons que cet article vous aidera à comprendre le Cadre d’intégration des services API (SIF) que vous pouvez utiliser pour intégrer une application à Informatica MDM.
Si vous avez besoin d’aide supplémentaire, contactez-nous au [email protected].
