Was this page helpful?

Listing Available Vacancies Example

    jobFeed plugin

    A plugin that exports all job vacancies into a .json file is avalible at atollon github. 

    https://gitlab.atollon.com/josefrous...in/tree/master

    The plugin is prepared to be deployed as a part of mod.workflow. For installation guide please look at the github wiki of the plugin. 

    Naming convention

    If you are deploying the jobFeed plugin please follow theese guidelines for unified naming and location conventions.

    1. All plugins and plugin folders belong to asp user. 
    2. Plugins are located in -> /var/lib/asp/instance/{INSTANCE NAME}/plugins/{NAME OF PLUGIN eg. jobFeed}
    3. jobFeed plugin output is saved like -> /var/lib/asp/www/{INSTANCE NAME}-feed/jobFeed-{specific id}-en.json
      • (Eg. the /var/lib/asp/www/allaround-feed folder belongs to asp!)

     

    Below you can find simple example of tool that will allow you to list open positions / vacancies available in Atollon Fisherman application.

    JSON feed of available positions

    For easier vacancy listing, every client can configure her vacancy feeds. Every language has a different resource. These JSON feeds can be customized per target medium, the following one is an example of the resource for default web integration. 

    {
        "version" : "2012-04-23T18:25:43.511Z",
        "language" : "cz",
        "responceLink" : "https://client.atollon.com/client/candidateImport",
        "vacancies":
        [
            {
                "vacancyId" : 987654321,
                "html" : false,
                "name" : "Vedoucí prodejny iSetos",
                "descriptionShort" : "Hledame vedouciho prodejny apple produktu.",
                "descriptionFull" : " Naplni prace je pracovat s ekonomickými ukazateli prodejny (tržby, mzdové náklady, produktivita práce atd.), zabezpečit plynulý chod prodejny, efektivně organizovat práce na prodejně",
                "requirements" : "Samostatný v rozhodování, flexibilní, s vysokým pracovním nasazením, proaktivní, optimista, diplomat a motivátor.",
                "offer" : " Možnost seberealizace v zajímavé, odpovědné a samostatné práci. Zázemí velké a stabilní firmy s dlouhou historií na českém trhu.",
                "client" : "Atraktivni firma s mladym kolektivem.",
                "footer" : "Pokud se vam nabidka libi, nevahejte a napiste. Nezapomente pripojit pruvodni dopis!",
                "salaryText" : "20 000 - 30 000 CZK",
                "min" : 20000,
                "max" : 30000,
                "currency" : "CZK",
                "fields" :
                [
                    {
                         "type" : 6,
                         "value" : "Plný úvazek",
                         "valueId" : 6001   
                    },{
                         "type" : 6,
                         "value" : "Polovicni úvazek",
                         "valueId" : 6002   
                    },{
                         "type" : 6,
                         "value" : "ICO",
                         "valueId" : 6003   
                    },{
                         "type" : 6,
                         "value" : "Smlouva o dilo",
                         "valueId" : 6004
                    },{
                         "type" : "city",
                         "value" : "Praha",
                         "valueId" : 100000000   
                    },{
                         "type" : "region",
                         "value" : "Stredni cechy",
                         "valueId" : 100000001
                    },{
                         "type" : 2,
                         "value" : "Marketing",
                         "valueId" : 20006   
                    },{
                         "type" : 2,
                         "value" : "Prodej",
                         "valueId" : 20007   
                    },{
                         "type" : "country",
                         "value" : "CZ",
                         "valueId" : 30008
                    },{
                         "type" : 3,
                         "value" : "EN",
                         "valueId" : 30009
                    }
                ],
                "contact" :
                {
                    "name" : "Steve Jobs",
                    "phone" : "+420 777 654 321",
                    "mail" : "steve@apple.com"
                },
                "priority" : 0,
                "trackingCode" : "bflmpsvz",
                "status" : "initial",
                "attachments" :
                [
                    {
                        "filename" : "logo.png",
                        "link" : "http://client.atollon.com/client/logo.png",
                        "type" : 1
                    },{
                        "filename" : "foto1.png",
                        "link" : "http://client.atollon.com/client/foto1.png",
                        "type" : 2
                    },{
                        "filename" : "foto2.png",
                        "link" : "http://client.atollon.com/client/foto2.png",
                        "type" : 2
                    }
                ]
            }
        ]
    }
    

    Despite the fact the advertisement has texts in several fields (description, requirements...), it depends on the client implementation, whether one large HTML text is used, containing all of the information, or advertisement is fully structured, where the final look is solved on the side of presentation layer (client corporate web).

     

    Static fields

    Statics fields from output are:

    • country
    • region
    • city
    • zip

    Job advertisement response

    For job responce check function sending candidates to atollon. Do not forget to set tracking code into reaction, so we can measure the performance of the advertisement. 

    Available positions list by API (old way)

    Following paragraphs descripe the way, this you can access available positions via API.

    Assets

    What you need to have

    1. Create "public-web" user account to access Atollon Recruitment

    In this example, we are using sample demo user account.

    2. MD5 hash of user password

    You can create it in Linux console:

    echo -n "password" | md5sum

    3. Get your instance URI

    In this example, the instance URI is the following:

    https://demo-fisherman.atollon.com/a...rvices/atollon

    4. Get your instance "server" name

    In this example, we're using "demo-fisherman"

    If you want to load WSDL definitions, you may find them in server's root. For this project we'll need:

    https://demo-fisherman.atollon.com/main.wsdl

    https://demo-fisherman.atollon.com/recruitment.wsdl

    https://demo-fisherman.atollon.com/project.wsdl

    5. Organization ID (how to get Organization ID is shown in example below)

    Get Session ID

    Quick Login

    Once you have the above assets, you can login to the instance to get the session ID.

    Quick Login Request

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://atollon.com/enterprise/wsdl">
       <soapenv:Header/>
       <soapenv:Body>
          <wsdl:QuickLogin>
             <server>demo-fisherman</server>
             <password>21232f297a57a5a743894a0e4a801fc3</password>
             <userName>joe</userName>
          </wsdl:QuickLogin>
       </soapenv:Body>
    </soapenv:Envelope>

    Quick Login Response

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
       <soapenv:Body>
          <atollon:QuickLoginResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:atollon="http://atollon.com/enterprise/wsdl">
             <result>OK</result>
             <id>newsession</id>
             <session>67FA00B8EE4FD1BC74879356CF1F42E223EDD5F04408</session>
             <userId>108026000</userId>
          </atollon:QuickLoginResponse>
       </soapenv:Body>
    </soapenv:Envelope>

    Get Organization ID

    We need to get Organization ID that is required in further queries.

    List Organization Function

    List Organization Request

    To get Organization IDs, you can list them:
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://atollon.com/enterprise/wsdl">
       <soapenv:Header/>
       <soapenv:Body>
          <wsdl:ListOrganization>
             <server>demo-fisherman</server>
             <session>67FA00B8EE4FD1BC74879356CF1F42E223EDD5F04408</session>
          </wsdl:ListOrganization>
       </soapenv:Body>
    </soapenv:Envelope>

    List Organization Response

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
       <soapenv:Body>
          <atollon:ListOrganizationResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:atollon="http://atollon.com/enterprise/wsdl">
             <result>OK</result>
             <time>0.00548506</time>
             <count>1</count>
             <ORGANIZATION>
                <acl>TREE000000001024</acl>
                <comment/>
                <id>1085000</id>
                <name>Atollon Fisherman</name>
             </ORGANIZATION>
          </atollon:ListOrganizationResponse>
       </soapenv:Body>
    </soapenv:Envelope>

    In our example, the Organization ID is 1085000. This is default organization ID for Atollon Fisherman application. So if you did not create new organization ID, you can use this.

    Get Open Positions / Vacancies

    The SearchPosition function used below returns list of available positions, once in Atollon Fisherman the following Vacancy Web Options are set:

    1. The Vacancy status is Active
    2. The Web Options: "Show on Web" is checked
    3. The Valid From .. To is in the range of Today's date

    Search Position / List Available Vacancies

    Available Vacancies Listing Request

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:wsdl="http://atollon.com/enterprise/wsdl">
       <soapenv:Header/>
       <soapenv:Body>
          <wsdl:SearchPosition>
             <server>demo-fisherman</server>
             <session>67FA00B8EE4FD1BC74879356CF1F42E223EDD5F04408</session>
         <organization>1085000</organization>
          </wsdl:SearchPosition>
       </soapenv:Body>
    </soapenv:Envelope>
    

    Available Vacancies Listing Response

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
       <soapenv:Body>
          <atollon:SearchPositionResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:atollon="http://atollon.com/enterprise/wsdl">
             <result>OK</result>
             <time>0.09457779</time>
             <count>4</count>
             <ROWS>
                <ROW>
                   <acl>TREE000000002922</acl>
                   <id>125573000</id>
                   <name>Vacancy: IT Manager</name>
                </ROW>
                <ROW>
                   <acl>TREE000000003374</acl>
                   <id>132221000</id>
                   <name>PR Manager</name>
                </ROW>
                <ROW>
                   <acl>TREE000000003866</acl>
                   <id>134168000</id>
                   <name>Vacancy</name>
                </ROW>
                <ROW>
                   <acl>TREE000000003949</acl>
                   <id>134347000</id>
                   <name>HR Manager</name>
                </ROW>
             </ROWS>
          </atollon:SearchPositionResponse>
       </soapenv:Body>
    </soapenv:Envelope>

    Comments

    You must login to post a comment.

    Attach file

    Attachments