Was this page helpful?

Creating job advertisements

    Sometimes clients have their own tools to create write and post job advertisements. But since the candidate reactions are funneled into the Atollon, it is better to have also those job advertisements saved into the system. This brings us the possibility to track the source of the candidate, track the job offering he is replying to or notify the user who is supposed to react etc. 

    Here are the example requests how it can be done.

    Login

    Simple way how to log into system. If you use Atollon Identity token system etc., use the login you know from there.

    <wsdl:QuickLogin>
            <server>demo</server>
            <password>67298af7457e65ebfd0ae4faea1caa59</password> <!--  password in MD5 -->
            <userName>user@demo</userName> <!-- username -->
    </wsdl:QuickLogin>
         
    <ns1:QuickLoginResponse xmlns:ns1="http://atollon.com/enterprise/wsdl">
             <result>OK</result>
             <id>newsession</id>
             <session>3809269F3032FE263D1175C3174DC653561D47964808</session>
             <userId>53000</userId>
    </ns1:QuickLoginResponse>

     

    Find Position by refId

    We need to link the job advertisement to some position (which is represented by project in atollon), so we find the position we are refering to - in this example by refId.

    <wsdl:ListFPA>
             <server>demo</server>
             <session>3809269F3032FE263D1175C3174DC653561D47964808</session>
             <flatView>true</flatView>
             <FILTER_PROJECT>
                <COL>
                   <name>refId</name>
                   <type>equals</type>
                   <value>KL55549-0001</value> <!-- refId of position -->
                </COL>
             </FILTER_PROJECT>
    </wsdl:ListFPA>
    
    <ns1:ListFPAResponse xmlns:ns1="http://atollon.com/enterprise/wsdl">
       <result>OK</result>
       <time>0.11564612</time>
       <count>1</count>
       <ITEMS>
          <ITEM>
             <subitems>0</subitems>
             <PROJECT>
                <created>2018-12-10T11:01:11.514116</created>
                <createdByName>martin@demo</createdByName>
                <customState>172973000</customState>
                <customStateName>40%</customStateName>
                <dimension1 ns2:nil="true" xmlns:ns2="http://www.w3.org/2001/XMLSchema-instance"/>
                <dimension2 ns2:nil="true" xmlns:ns2="http://www.w3.org/2001/XMLSchema-instance"/>
                <dimension3 ns2:nil="true" xmlns:ns2="http://www.w3.org/2001/XMLSchema-instance"/>
                <folder>39029683000</folder>
                <id>58625471000</id>
                <firstContactDate ns2:nil="true" xmlns:ns2="http://www.w3.org/2001/XMLSchema-instance"/>
                <lastContactDate ns2:nil="true" xmlns:ns2="http://www.w3.org/2001/XMLSchema-instance"/>
                <lastDocDate ns2:nil="true" xmlns:ns2="http://www.w3.org/2001/XMLSchema-instance"/>
                <masterProjectId ns2:nil="true" xmlns:ns2="http://www.w3.org/2001/XMLSchema-instance"/>
                <masterProjectName/>
                <modified>2018-12-10T11:07:07.232422</modified>
                <modifiedByName>martin@demo</modifiedByName>
                <name>Pilot</name>
                <organization>1085000</organization>
                <primaryContact/>
                <primaryContactName/>
                <projectType>116893000</projectType>
                <projectTypeName>00. Open position</projectTypeName>
                <refId>KL55549-0001</refId>
                <state>2</state>
                <contextParent>39029683000</contextParent>
                <contextParentName>NASA</contextParentName>
             </PROJECT>
          </ITEM>
       </ITEMS>
    </ns1:ListFPAResponse>
    

    Create Job Advertisement

    We have the ID of position so we can create the job advertisement refering to the position. Message template is generic object with many fields. Usage of the fields depends on the client implementation. Some clients want to keep the object simple, so they use just jobDescription element, some of them want to keep the data structured (so they can fully use the different layouts on different platforms) so they use more fields. We use only several text fields in this example but you can also use attachments, codebooks of skills, location codebooks, language lists. Those codebook items are implemented by JOB_DESCRIPTION_ITEMS, track your request in lagoon so you can see the possibilities. 

    <wsdl:NewMessageTemplate>
          <server>demo</server>
          <session>3809269F3032FE263D1175C3174DC653561D47964808</session>
          <messageTemplate>
            <templateName>Spacecraft pilot for SpaceX</templateName>
            <isDraft>0</isDraft>
            <html>0</html>
            <type>51</type>
            <language>2607000</language> <!-- Langueage of job advertisement - ID in the system. Do not include this element if you do not want to specify -->
            <isDefault>0</isDefault>
            <projectId>58625471000</projectId> <!-- ID of project you are refering to -->
            <ADVERTISEMENT> <!-- Non of the fields in ADVERTISEMENT is mandatory, use only those you want, if you want to use HTML, excape the HTML -->
              <jobDescription>&lt;div ALIGN="left"&gt;&lt;FONT FACE="helvetica,arial,sans-serif" style="font-size:12px" COLOR="#000000" &gt;We are looking for a person willing to risk his own life and collect absolutely no credit for it. You need to be almost perfect in almost every possible aspect of your profesional carreer and willing to recieve mediocore salary. This position is opened by our favorite client NASA.&lt;/FONT&gt;&lt;/div&gt;</jobDescription>
              <requirements>&lt;div ALIGN="left"&gt;&lt;FONT FACE="helvetica,arial,sans-serif" style="font-size:12px" COLOR="#000000" &gt;20 years jet pilot&lt;/FONT&gt;&lt;/div&gt;&lt;div ALIGN="left"&gt;&lt;FONT FACE="helvetica,arial,sans-serif" style="font-size:12px" COLOR="#000000" &gt;PHD in physics, math and IT&lt;/FONT&gt;&lt;/div&gt;</requirements>
              <offer>&lt;div ALIGN="left"&gt;&lt;FONT FACE="helvetica,arial,sans-serif" style="font-size:12px" COLOR="#000000" &gt;60 000 USD&lt;/FONT&gt;&lt;/div&gt;&lt;div ALIGN="left"&gt;&lt;FONT FACE="helvetica,arial,sans-serif" style="font-size:12px" COLOR="#000000" &gt;Dentist care&lt;/FONT&gt;&lt;/div&gt;</offer>
              <clientInfo>&lt;div ALIGN="left"&gt;&lt;FONT FACE="helvetica,arial,sans-serif" style="font-size:12px" COLOR="#000000" &gt;Nasa is the key player in the process of understanding the universe and discovering things like teflon etc.&lt;/FONT&gt;&lt;/div&gt;</clientInfo>
              <contactName>Jim Morhard</contactName>
              <contactPhone>+420777123456</contactPhone>
              <contactMail>jim.morhard@nasa.com</contactMail>
              <salaryCurrency>2324000</salaryCurrency> <!-- ID in system -->
              <salaryMin>70000</salaryMin>
              <salaryMax>90000</salaryMax>
              <salaryText>About 80,000 USD</salaryText>
              <KEYWORDS/>
            </ADVERTISEMENT>
            <JOB_DESCRIPTION_ITEMS/>
          </messageTemplate>
    </wsdl:NewMessageTemplate>
    
    <ns0:Envelope xmlns:ns0="http://schemas.xmlsoap.org/soap/envelope/">
       <ns0:Body>
          <ns1:NewMessageTemplateResponse xmlns:ns1="http://atollon.com/enterprise/wsdl">
             <result>OK</result>
             <time>0.19103098</time>
             <newId>58703618000</newId>
          </ns1:NewMessageTemplateResponse>
       </ns0:Body>
    </ns0:Envelope>
    

     

    Create tracking object for advertisement

    When the job advertisement is ready, you can create tracking object called MessageAction. MessageAction represents publishing of the job advertisement, so there is one created MessageAction created for every single media you use (company web, facebook, twitter etc.). Creation of the MessageAction will generate you tracking code by which you can identify the candidate. You can save reference to message template, which allows us to track the job advertisement (which leads us to position), contactReference which represents the medium you are publishin to, user you would like to link to etc.

    If your tracking code comes from external job advertisement system, create just one messageAction and fill the code in request (can not begin with the symbol _ ). This message action will have reference to the advertisement (and position also), but wont be able to track the medium.

    <wsdl:CreateMessageAction>
             <server>demo</server>
            <session>3809269F3032FE263D1175C3174DC653561D47964808</session>
            <ROW>
              <code>bflmpsvz</code> <!-- tracking code, must be unique and can not start with symbol _ -->
              <messageTemplate>58703606000</messageTemplate> <!-- id of created message template -->
              <contactReference>124515000</contactReference> <!-- id of channel you are referencing to, for example jobs.cz, facebook... -->
              <userId>0</userId> <!-- userId of user you want to refer to. If you do not want to refer to an user, 0 -->
              <validFrom>2019-01-03T00:00:00</validFrom> <!-- Validity, if you are not concerned about the validity of the tracking object, use Date.now() -->
              <validTo>2019-01-31T00:00:00</validTo> <!-- Validity, if you are not concerned about the validity of the tracking object, use Date.now() -->
              <status>1</status>
            </ROW>
    </wsdl:CreateMessageAction>
    
    <ns1:CreateMessageActionResponse xmlns:ns1="http://atollon.com/enterprise/wsdl">
             <result>OK</result>
             <time>0.12557101</time>
             <count>0</count>
             <id>58703621000</id>
    </ns1:CreateMessageActionResponse>

     

    Managing contact reference

    Tracking objects link to several objects - message template, user, folder... and contact reference. In this paragraph I will describe what it is for and how to manage it. Contact reference is basically a representation of candidate channel. Every contact can have a reference to contact reference so we can track, where does he come from - it could be a candidate added by consultant, it could be job advertisement reaction from web, etc. So for instance if you want to track, which reactions come from jobs.cz, you create contact reference called jobs.cz and put this contact reference into tracking actions. The type of the contact reference will be advertiseme, so it will appear at the job advertisement UI as one of possible media). You can manage contact reference in the UI in Options and tool > Marketing channels.

    Was this page helpful?
    Tag page (Edit tags)
    • No tags
    Page statistics
    380 view(s), 3 edit(s), and 12118 character(s)

    Comments

    You must login to post a comment.

    Attach file

    Attachments