Instruction de remplacement 27
télécharger 1.45 Mb.
|
2.2.Méthodes en quasi temps réelLes méthodes en quasi temps réel vous permettent d’interagir vos offres en quasi temps réel, mais avec une seule offre à la fois. Pourquoi intituler cette section « quasi temps réel » ? La réponse est simple. Lorsque vous nous envoyez une requête en utilisant une des méthodes ci-dessous, notre réponse en temps réel contient un identifiant de transaction, ainsi qu'un message d'erreur si, pour une raison quelconque, l'offre n'a pas passé l'étape de validation. Cet identifiant de transaction équivaut à un accusé de réception indiquant que nous avons bien reçu votre offre d'emploi et qu'elle a été placée dans la file d'attente en vue de son traitement par nos services. L'offre est donc placée dans la file d'attente en temps réel, puis traitée par CareerBuilder quelques instants plus tard. Une fois que l'offre a été traitée, vous devez exécuter une deuxième transaction en utilisant l'identifiant de transaction que vous avez reçu, après quoi nous vous renverrons l'intégralité des informations de l'offre publiée (cette procédure est détaillée à la section 2.2.4). Ce léger délai est nécessaire car CareerBuilder a dissocié son système dorsal et son système frontal. Cette dissociation permet d'effectuer des opérations de maintenance d'urgence sur la base de données sans interrompre la fonction de réception des offres, et évite que les problèmes de trafic réseau n'affectent la publication des offres. Nous sommes ainsi en permanence à la disposition des personnes qui publient des offres. Les sections ci-dessous détaillent les critères applicables à chacune des méthodes de publication en quasi temps réel disponibles. 2.2.1.Transaction GatewayLa Transaction Gateway (passerelle de transaction, également appelée HTTP quasi temps réel) est une méthode de publication HTTP personnalisée destinée à interagir avec une seule offre d'emploi à la fois. Les clients utilisent la Transaction Gateway comme ils le feraient avec le formulaire d'une page Web standard. Les champs du formulaire qui forment la chaîne de publication sont les mêmes que ceux utilisés pour créer un fichier à envoyer par e-mail ou par FTP. Ils seront décrits plus loin dans ce document. Vous pouvez utiliser l'un ou l'autre des noms de format (le nom de format XML ou le nom de format texte) pour chacun des champs associés à l'offre. C'est à vous de choisir le nom de chacun des champs. Sachant que la Transaction Gateway ne gère qu'une seule offre à la fois, le concept de section d'en-tête (header) utilisé pour les méthodes groupées ne s'applique plus ici. Les parties de l'en-tête concernant l'identification sont simplement incluses dans la chaîne de publication, comme des champs standard. La partie instructions de l'en-tête (instruction de remplacement et adresse de réponse) ne s'applique pas aux méthodes en quasi temps réel et doit être laissée de côté. Un exemple détaillé d'offre d'emploi publiée par l'intermédiaire de la Transaction Gateway est présenté plus loin, mais le format de base se présente ainsi : Example: 1Format de chaîne de publication pour la Transaction Gateway. La partie « ## » de chaque champ doit être remplacée par les données réelles applicables au champ considéré. CBVendorID=##&CBAction=##&CBUserJobID=##&... 2.2.1.2.URL de la Transaction GatewayL'URL qui forme la Transaction Gateway et sur laquelle les données de l'offre doivent être publiées est la suivante : http://dpi.careerbuilder.com/webservices/dpitg.aspx 2.2.1.3.Modèle de formulaireCareerBuilder propose un modèle de formulaire pour soumettre des données d'offres d'emploi via la Transaction Gateway. Les clients peuvent l'utiliser pour faire des essais de publication. Ce modèle donne aux clients une idée du temps nécessaire au traitement des offres et des réponses que la passerelle leur fournira. Le modèle de formulaire est disponible à l'adresse : http://dpi.careerbuilder.com/WebServices/TGTestForm.aspx 2.2.2.HR-XMLCareerBuilder offre aux clients la possibilité de soumettre leurs offres via le protocole HR-XML Staffing Exchange Protocol version 2.4 ainsi que l'ancienne version 1.1. Certains des champs obligatoires sont munis d'un enveloppeur personnalisé autour du paquet HR-XML, mais les principales informations relatives à l'offre sont fournies par le paquet HR-XML standard. De plus amples détails sur la correspondance entre les champs du paquet HR-XML et ceux de CareerBuilder ainsi que d'autres informations sur la soumission des offres à CareerBuilder via HR-XML seront fournis ultérieurement. 2.2.3.Services web SOAPCareerBuilder a créé un service web que les clients peuvent utiliser pour publier des offres réelles, en remplacement de l'ancienne méthode de publication HTTP. Le service web accepte uniquement les données au format XML. Vous pouvez soumettre les données de vos offres en HR-XML comme indiqué ci-dessus ou vous pouvez créer un paquet CB-XML personnalisé contenant les champs de l'offre. Des exemples détaillés des paquets XML pouvant être envoyés au service web sont fournis plus loin. Le service web de publication d'offres d'emploi en quasi temps réel est disponible à l'adresse : http://dpi.careerbuilder.com/WebServices/RealTimeJobPost.asmx 2.2.3.1.Méthodes web disponiblesLes méthodes web suivantes sont à votre disposition sur le service web RealTimeJobPost. Si vous utilisez .NET pour structurer vos données, vous préférerez peut-être créer un proxy web vers la méthode ProcessJob. Sinon, il vous faudra sans doute utiliser une des deux autres, en fonction du type de paquet de données que vous créez pour envoyer vos offres.
ProcessJob est la principale méthode web du service web RealTimeJobPost. Elle exécute tout le travail de publication, de modification et de suppression des offres sur le site CareerBuilder pour les publications de type Transaction Gateway. La méthode web utilise les paramètres suivants :
Il s'agit du paquet XML contenant les données de l'offre. Ces données peuvent être au format CB-XML personnalisé ou au format HR-XML. Ce qui suit est un exemple de requête et de réponse SOAP. Le texte des espaces réservés doit être remplacé par les valeurs réelles. POST /WebServices/RealTimeJobPost.asmx HTTP/1.1 Host: dpi.careerbuilder.com Content-Type: text/xml; charset=utf-8 Content-Length: longueur SOAPAction: “http://dpi.careerbuilder.com/WebServices/RealTimeJobPost/ProcessJob” xmlns:xsd=“http://www.w3.org/2001/XMLSchema” xmlns:soap=“http://schemas.xmlsoap.org/soap/envelope/”> HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: longueur xmlns:xsd=“http://www.w3.org/2001/XMLSchema” xmlns:soap=“http://schemas.xmlsoap.org/soap/envelope/”> xmlns=“http://dpi.careerbuilder.com/WebServices/RealTimeJobPost”> chaîne de caractères chaîne de caractères
Cette méthode web doit servir aux clients à envoyer les données sur le service web au format CB-XML personnalisé et à recevoir les réponses sous forme de texte brut. C'est indispensable pour quiconque ne peut pas appeler une méthode web en utilisant des types de données complexes. Selon le logiciel que vous utilisez pour structurer les données de l'offre et les saisir sur le service Web, il est possible que vous ne puissiez pas utiliser la méthode ProcessJob. En effet, les types de données XML et booléen sont considérés comme « complexes ». Pour atténuer ce problème, CareerBuilder a créé la méthode web ProcessTGJob qui gère exclusivement les chaînes de caractères composées de types de données de base. En arrière-plan, elle convertit les données que vous envoyez au type de données approprié et utilise la méthode ProcessJob pour faire le travail. Après avoir reçu l'objet réponse, ProcessTGJob convertit, à son tour, la réponse en chaînes de caractères qu'elle renvoie à l'appelant. Si vous pouvez appeler directement ProcessJob, nous vous recommandons de le faire. Non seulement cela évitera les conversions inutiles dans un sens et dans l'autre, mais cela évitera également à CareerBuilder d'avoir à faire les mêmes conversions. Ce qui suit est un exemple de requête et de réponse SOAP. Le texte des espaces réservés doit être remplacé par les valeurs réelles. POST /WebServices/RealTimeJobPost.asmx HTTP/1.1 Host: dpi.careerbuilder.com Content-Type: text/xml; charset=utf-8 Content-Length: longueur SOAPAction: “http://dpi.careerbuilder.com/WebServices/RealTimeJobPost/ProcessTGJob” xmlns:xsd=“http://www.w3.org/2001/XMLSchema” xmlns:soap=“http://schemas.xmlsoap.org/soap/envelope/”> HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: longueur xmlns:xsd=“http://www.w3.org/2001/XMLSchema” xmlns:soap=“http://schemas.xmlsoap.org/soap/envelope/”> xmlns=“http://dpi.careerbuilder.com/WebServices/RealTimeJobPost”> chaîne de caractères
Cette méthode web doit servir aux clients à envoyer les données sur le service Web au format HR-XML et à recevoir les réponses sous forme de texte brut. C'est indispensable pour quiconque ne peut pas appeler une méthode web en utilisant des types de données complexes. Selon le logiciel que vous utilisez pour structurer les données de l'offre et les saisir sur le service Web, il est possible que vous ne puissiez pas utiliser la méthode ProcessJob. En effet, les types de données XML et booléennes sont considérées comme « complexes ». Pour atténuer ce problème, CareerBuilder a créé la méthode Web ProcessHRXMLJob qui gère exclusivement les types de données de base. En arrière-plan, elle convertit les données que vous envoyez au type de données approprié et utilise la méthode ProcessJob pour faire le travail. Après avoir reçu l'objet réponse, ProcessHRXMLJob convertit, à son tour, la réponse en chaines de caractères qu'elle renvoie à l'appelant. Si vous pouvez appeler directement ProcessJob, nous vous recommandons de le faire. Non seulement cela évitera les conversions inutiles dans un sens et dans l'autre, mais cela évitera également à CareerBuilder d'avoir à faire les mêmes conversions. Ce qui suit est un exemple de requête et de réponse SOAP. Le texte des espaces réservés doit être remplacé par les valeurs réelles. POST /WebServices/RealTimeJobPost.asmx HTTP/1.1 Host: dpi.careerbuilder.com Content-Type: text/xml; charset=utf-8 Content-Length: longueur SOAPAction: “http://dpi.careerbuilder.com/WebServices/RealTimeJobPost/ProcessHRXMLJob” xmlns:xsd=“http://www.w3.org/2001/XMLSchema” xmlns:soap=“http://schemas.xmlsoap.org/soap/envelope/”> xmlns=“http://dpi.careerbuilder.com/WebServices/RealTimeJobPost”> HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: longueur xmlns:xsd=“http://www.w3.org/2001/XMLSchema” xmlns:soap=“http://schemas.xmlsoap.org/soap/envelope/”> xmlns=“http://dpi.careerbuilder.com/WebServices/RealTimeJobPost”> chaîne de caractères 2.2.4.RealTimeJobStatusUne fois que la requête de publication initiale a été envoyée au moyen d'une des méthodes ci-dessus, une deuxième transaction doit avoir lieu avec notre service web RealTimeJobStatus pour obtenir la réponse complète de la publication. Nous vous recommandons de lancer ce deuxième appel quelques minutes après l'appel initial afin de donner à notre système de file d'attente le temps de traiter la publication. Ce qui suit est un exemple de requête et de réponse SOAP 1.1. Le texte des espaces réservés doit être remplacé par les valeurs réelles. POST /WebServices/RealTimeJobStatus.asmx HTTP/1.1 Host: dpi.careerbuilder.com Content-Type: text/xml; charset=utf-8 Content-Length: longueur SOAPAction: “http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus/GetJobPostStatus” HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: longueur chaîne de caractères chaîne de caractères
Après un appel RealTimeJobPost, vous recevez une réponse synchrone (immédiate). Cette réponse peut contenir un message d'erreur. À cette étape, des vérifications sont réalisées pour voir si les champs obligatoires sont conformes, mais nous ne réalisons pas de validation complète. La réponse contient également l'identifiant de la transaction. Cette valeur doit être enregistrée du côté du client car elle sera nécessaire pour l'appel ultérieur à RealTimeJobStatus. Cette méthode doit être appelée si le client souhaite connaître le statut de publication de son offre. Contrairement aux systèmes groupés, les offres publiées de manière transactionnelle n'envoient pas de réponse par e-mail. Cette méthode est décrite à la page http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus.asmx Vous pouvez lancer l'appel en utilisant SOAP, HTTP-Post ou HTTP-Get. Sachant qu'ils ne transmettent qu'une seule variable, il est possible de le faire sous la forme d'une URL directe du genre : http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus.asmx/GetJobPostStatus?sTGDID=TP7N03K6H4JP4CW1RN9Q Succès http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus.asmx/GetJobPostStatus?sTGDID=TP7N03K6H4JP4CW1RN9Q http://www.w3.org/2001/XMLSchema-instance“ xmlns:xsd=“http://www.w3.org/2001/XMLSchema“ xmlns=“http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus“> JCPRI0 12/06/2012 11:59:59 PM Succès The job has successfully posted to CB Échec L'offre n'a pas été publiée. Le client doit corriger l'erreur. S'il ne comprend pas ce que le message d'erreur signifie, il peut trouver des informations complémentaires ici : http://dpi.careerbuilder.com/Site/Support/DPIJobErrors/DPIJobErrorList.aspx http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus.asmx/GetJobPostStatus?sTGDID=TP7N09460DY0ND65KTPQ http://www.w3.org/2001/XMLSchema-instance“ xmlns:xsd=“http://www.w3.org/2001/XMLSchema“ xmlns=“http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus“> Échec Placé en file d'attente L'offre a été reçue par CB mais n'a pas encore été traitée. La DPI utilise une file d'attente lorsqu'elle reçoit de nombreuses offres d'emploi en même temps. Cette réponse signifie que CB n'a pas encore traité l'offre. Il est conseillé aux clients de revérifier le statut de l'offre dans quelques minutes. Nous conseillons d'effectuer cet appel toutes les 5 minutes. http://www.w3.org/2001/XMLSchema-instance“ xmlns:xsd=“http://www.w3.org/2001/XMLSchema“ xmlns=“http://dpi.careerbuilder.com/WebServices/RealTimeJobStatus“> Placé en file d'attente ^ Table des matières Chapitre 3 |
similaire:
 | | ||
| | ||
 | | «établissement d’activités physiques et sportives» auprès de la ddcs 31 service Jeunesse et Sports | |
| «instruction, instruire, degré de lumière, traité de morale». Valeur instructive du roman | | |
| «mures» afin de leur donner les atouts nécessaires à leur intégration dans n’importe quelle société donnée | | «la Nation garantit l’égal accès de l’enfant et de l’adulte à l’instruction, à la formation et à la culture; l’organisation de l’enseignement... |