Procédure de soumission d'une importation de données à l'aide d'un flux de travaux de processus

Vous pouvez utiliser un flux de travaux de processus (par exemple, CA Process Automation) pour soumettre une importation de données de l'importateur de données pour le traitement au lieu d'utiliser l'interface utilisateur CA APM.
casm173
Vous pouvez utiliser un flux de travaux de processus (par exemple, CA Process Automation) pour soumettre une importation de données de l'importateur de données pour le traitement au lieu d'utiliser l'interface utilisateur CA APM.
Vous pouvez créer un flux de travaux de processus d'importation de données à l'aide de l'exemple de fichier XML fourni par la société et de l'intégration à CA Process Automation.
Pour soumettre une importation de données à l'aide d'un flux de travaux de processus, Procédez comme suit :
Exemple : importation de nouvelles unités matérielles via un flux de travaux de processus
Sam est l'administrateur système CA APM de la société Document Management Company et a défini un flux de travaux de processus business. Le flux de travaux détecte les nouvelles unités matérielles, les ajoute au référentiel de données de la société et exécute des rapports les concernant. Sam a déjà créé une importation de données dans CA APM qui ajoute les nouvelles unités matérielles au référentiel de données. Il veut exécuter cette importation de données à un moment précis de son flux de travaux global. Il souhaite intégrer l'importation de données à son flux de travaux de processus business global. Sam veut que l'importation de données s'exécute au moment spécifié dans le flux de travaux sans que l'utilisateur n'ait besoin de se connecter à l'interface utilisateur du produit. Sam met à jour son flux de travaux de processus business pour inclure les appels d'opérations de service Web CA APM pour l'importateur de données.
Vérification des prérequis
Pour assurer la correcte soumission d'une importation de données à l'aide d'un flux de travaux de processus, vérifiez que les conditions requises suivantes sont remplies :
  1. Définissez une importation de données avec tous les mappages et paramètres via l'interface utilisateur CA APM.
  2. Vérifiez que le chemin d'accès au fichier de données (si vous en spécifiez un) est accessible à partir du serveur sur lequel est exécuté le service d'importation. De plus, l'utilisateur du service réseau (identité du pool d'applications) requiert l'accès à ce chemin d'accès.
  3. Définissez un flux de travaux de processus à l'aide d'un fournisseur de flux de travaux (par exemple, CA Process Automation).
Spécification des appels de flux de travaux
Pour lancer l'importateur de données et exécuter une importation de données à partir d'un flux de travaux de processus, fournissez des appels de flux de travaux spécifiques aux opérations de service Web CA APM. Ces opérations effectuent les opérations suivantes :
  • Opération de connexion : connexion à CA APM
  • Soumission d'une importation de données à l'aide de l'une des méthodes de fourniture d'un fichier de données suivantes :
    • Opération SubmitImportwithfilepath : le fichier de données est disponible à un emplacement de fichier spécifié. Ce chemin d'accès du fichier doit être accessible à partir du serveur sur lequel est exécuté le service d'importation. L'opération de service Web télécharge le fichier.
    • Opération SubmitImport : le contenu du fichier de données a été converti au format binaire de tableau d'octets. L'opération de service Web reçoit le contenu du tableau d'octets à partir d'une application et le soumet à l'importateur de données.
      Pour utiliser cette méthode de fourniture d'un fichier de données, créez une application, si aucune n'est disponible, pour convertir le contenu du fichier de données au format de tableau d'octets. L'application envoie alors le contenu à l'opération de service Web.
Intégrez les appels à ces opérations dans votre flux de travaux de processus business.
Pour plus d'informations sur la création d'un flux de travaux de processus, consultez la documentation de votre fournisseur de flux de travaux.
Opération de connexion
Cette opération se connecte à CA APM à l'aide de l'ID d'utilisateur et du mot de passe CA APM. Le résultat de cette opération est le jeton de connexion. Le jeton de connexion est utilisé comme entrée pour d'autres opérations de flux de travaux d'importation de données.
  • Paramètres d'entrée
    ItamUserName : ID d'utilisateur CA APM
    ItamUserPassword : mot de passe de l'utilisateur CA APM
  • Paramètres de sortie
    loginToken : jeton renvoyé après la connexion à CA APM
Opération SubmitImport
Cette opération reçoit le contenu du fichier de données converti au format de tableau d'octets et le soumet lors de l'importation de données à l'importateur de données. Pour utiliser cette opération, créez une application, si aucune n'est disponible, pour convertir le contenu du fichier de données au format de tableau d'octets. L'application envoie alors le contenu à l'opération de service Web.
Cette opération renvoie un ID de job d'importation de données, utilisé pour vérifier le statut du job d'importation.
  • Paramètres d'entrée
    loginToken : jeton renvoyé après la connexion à CA APM
    ImportName : nom de l'importation de données
    DataFileName : nom du fichier de données associé à l'importation de données
    Datafilestream : contenu du fichier de données au format de tableau d'octets
    Caprovided : (facultatif) indicateur spécifiant une importation de données fournie par le produit. Définissez ce paramètre sur un (1) pour spécifier une importation fournie par le produit.
    Client hébergé (hébergement multiclient uniquement) : nom du client hébergé auquel s'applique l'importation.
  • Paramètres de sortie
    ID du job : ID renvoyé suite à une importation de données soumise correctement. L'opération GetJobStatus utilise cet ID pour vérifier le statut d'un job d'importation.
Opération SubmitImportwithfilepath
Cette opération télécharge un fichier de données à partir d'un chemin spécifique et le soumet lors de l'importation de données à l'importateur de données. Ce chemin d'accès du fichier doit être accessible à partir du serveur sur lequel est exécuté le service d'importation.
Cette opération renvoie un ID de job d'importation de données, utilisé pour vérifier le statut du job d'importation.
  • Paramètres d'entrée
    loginToken : jeton renvoyé après la connexion à CA APM
    ImportName : nom de l'importation de données
    Datafilepath : chemin d'accès et nom complets du fichier de données associé à l'importation de données. Ce chemin d'accès doit être accessible à partir du serveur sur lequel est exécuté le service d'importation. De plus, l'utilisateur du service réseau (identité du pool d'applications) requiert l'accès à ce chemin d'accès.
    Si l'emplacement du fichier de données est un chemin d'accès partagé, le serveur CA APM et l'ordinateur partagé doivent être disponibles dans le même domaine. Caprovided : (facultatif) indicateur spécifiant une importation de données fournie par le produit. Définissez ce paramètre sur un (1) pour spécifier une importation fournie par le produit.
    Client hébergé (hébergement multiclient uniquement) : nom du client hébergé auquel s'applique l'importation.
  • Paramètres de sortie
    ID du job : ID renvoyé suite à une importation de données soumise correctement. L'opération GetJobStatus utilise cet ID pour vérifier le statut d'un job d'importation.
Vérification du statut du job d'importation
L'importateur de données fournit un récapitulatif du statut de chaque job d'importation de données soumis. Votre flux de travaux de processus peut inclure un appel à l'opération de service Web CA APM, qui récupère le statut d'un job d'importation de données soumis. Intégrez l'appel à cette opération dans votre flux de travaux de processus.
Opération GetJobStatus
Cette opération utilise l'ID d'un job d'importation de données pour vérifier son statut.
  • Paramètres d'entrée
    loginToken : jeton renvoyé après la connexion à CA APM
    ID du job : ID renvoyé suite à une importation de données soumise correctement.
  • Paramètres de sortie
    Statut du job : statut du job d'importation
Réponse aux messages d'erreur
En cas d'erreurs lors du processus d'importation de données, vous pouvez recevoir des messages d'erreur. Les messages suivants doivent faire l'objet d'une explication :
  • 20002 : impossible d'accéder à l'importation de données en raison d'autorisations de l'utilisateur. Contactez votre administrateur.
    Pour soumettre une importation de données, le rôle de l'utilisateur requiert l'accès administrateur ou utilisateur à l'importateur de données.
  • 20005 : connexion au service d'importation impossible. Contactez votre administrateur.
    Vérifiez l'URL du service d'importation dans le fichier ImportProcessor.config, ou contactez l'administrateur.
  • 21002 : nom de l'importation de données non valide
    L'importation de données n'existe pas ou l'utilisateur n'y a pas accès. Si l'importation de données est fournie par le produit, spécifiez la valeur 1 pour le paramètre Caprovided.
  • 21004 : échec du chargement du fichier de données
    Ce message peut être entraîné par une erreur de configuration. Consultez les fichiers journaux du service du gestionnaire de stockage.
  • 21005 : aucun mappage n'est défini pour l'importation de données.
    Définissez des mappages et soumettez à nouveau l'importation de données.
  • 22001 : ID du job d'importation données non valide. Vérifiez l'ID du job et essayez de réexécuter l'importation.
    Pour vérifier l'ID du job, connectez-vous à CA APM et recherchez le job d'importation de données. Soumettez de nouveau l'importation de données à l'aide de l'ID de job valide.