techframewirk
commented
2 years ago Publish a Intent to search for Jobs with a particular skillset
{
"context": {
"domain": "dsep:jobs",
"country": "IND",
"city": "string",
"action": "on_search",
"core_version": "0.9.3",
"bap_id": "mock_bap.com",
"bap_uri": "https://mock_bap.com/protocol",
"transaction_id": "string",
"message_id": "string",
"timestamp": "2021-12-22T11:53:29.434Z"
},
"message": {
"intent": {
"provider": {
"locations": [
{
"gps":"lat,lon",
"city": {
"code": "string"
},
"country": {
"code": "string"
}
}
]
},
"item": {
"descriptor": {
"name":"Javascript Developer"
},
"price": {
"currency": "INR",
"minimum_value": "expected salary range",
"maximum_value": "expected salary range"
},
"time": {
"duration": "P3Y"
},
"tags": {
"skills": "comma separated list of skill keywords"
}
},
"category": {
"id": "category_id",
"descriptor": {
"name": "Developer"
}
}
}
}
}message.intent.provider.locations will have options to express the intent of where the job offers should be from. The GPS coordinate can be passed in gps if that level of location accuracy is required. The STD code of the city can be passed in city.code to get results from a city. ISO country codes can be used in country.code if required.
message.intent.item.descriptor.name can be used to search using the job role title.
message.intent.item.time.duration property is used give the experience of the candidate.
message.intent.item.tags.skills can be used to pass on a comma separated list of skill keywords which can be used for fetching job offers matching the skills.
message.intent.category can be used to specify the category of the job offers. id can be used if the category_id is known and descriptor.name can be used to search with category name.
Publish a Recruitment catalog of job openings with two categories : Internship, Full-time Employment
Here I have added part-time employment as well.
{
"context": {
"domain": "dsep:jobs",
"country": "IND",
"city": "string",
"action": "on_search",
"core_version": "0.9.3",
"bap_id": "mock_bap.com",
"bap_uri": "https://mock_bap.com/protocol",
"bpp_id": "mock_bpp.com",
"bpp_uri": "https://mock_bpp.com/protocol",
"transaction_id": "string",
"message_id": "string",
"timestamp": "2021-12-22T11:53:29.434Z"
},
"message": {
"catalog": {
"bpp/providers": [
{
"id": "ABC",
"descriptor": {
"name": "ABC Consultancy Services"
},
"categories": [
{
"id": "fulltime",
"descriptor": {
"name": "Full-time employment",
"short_desc": "A full-time job is employment in which a person works a minimum number of hours defined as such by their employer."
}
},
{
"id": "internship",
"descriptor": {
"name": "Internship",
"short_desc": "An internship is a period of work experience offered by an organization for a limited period of time."
}
},
{
"id": "parttime",
"descriptor": {
"name": "Part-time employment",
"short_desc": "A part-time job is a form of employment that carries fewer hours per week than a full-time job."
}
},
{
"id": "it",
"descriptor": {
"name": "IT",
"short_desc": "Information Technology industry which comprises information technology services, consulting, and outsourcing."
}
},
{
"id": "developer",
"parent_category_id": "it",
"descriptor": {
"name": "Developer",
"short_desc": "A computer programmer, sometimes called a software developer, a programmer or more recently a coder (especially in more informal contexts), is a person who creates computer software."
}
},
{
"id": "devops",
"parent_category_id": "it",
"descriptor": {
"name": "DevOps",
"short_desc": "DevOps is a set of practices that combines software development (Dev) and IT operations (Ops)."
}
}
],
"locations": [
{
"id": "siruseri",
"descriptor": {
"name": "ABC Siruseri",
"images": [
"string"
]
},
"gps": "lat,long",
"address": {
"name": "ABC Siruseri",
"building": "Test building",
"street": "Test street",
"locality": "Siruseri",
"city": "Chennai",
"state": "Tamil Nadu",
"country": "IND",
"area_code": "695030"
}
},
{
"id": "elec_city",
"descriptor": {
"name": "ABC Bangalore",
"images": [
"string"
]
},
"gps": "lat,long",
"address": {
"name": "ABC Bangalore",
"building": "Test building",
"street": "Test street",
"locality": "Electronic City",
"city": "Bangalore",
"state": "Karnataka",
"country": "IND",
"area_code": "695030"
}
}
],
"items": [
{
"id": "js_dev",
"descriptor": {
"name": "Senior Javascript Developer",
"short_desc": "Summary of role",
"long_desc": "Job description"
},
"price": {
"currency": "INR",
"offered_value": "CTC"
},
"category_ids": [
"developer",
"full-time"
],
"location_id": "siruseri",
"time": {
"label": "experience",
"duration": "P5Y"
},
"recommended": true,
"tags": {
"skills": "js,nodejs,angular,react"
}
},
{
"id": "dev_ops_engg",
"descriptor": {
"name": "Senior DevOps Engineer",
"short_desc": "Summary of role",
"long_desc": "Job description"
},
"price": {
"currency": "INR",
"offered_value": "CTC"
},
"category_ids": [
"devops",
"full-time"
],
"location_id": "elec_city",
"time": {
"label": "experience",
"duration": "P5Y"
},
"recommended": true,
"tags": {
"skills": "ci/cd,github actions,aws,kubernetes,docker,gcp"
}
}
]
}
]
}
}
}message.catalog.bpp/providers.descriptor will have details of the employer that has the job opening.
message.catalog.bpp/providers.categories will have categories that the job offers in the catalog can belong to. Full-time, part-time and internship can be top level categories. Top level sectors like IT, Manufacturing etc will be categories with sub categories. Here in the above example devops and developer are subcategories to IT.
message.catalog.bpp/providers.locations will have the various locations or offices of the employer where there are job openings.
message.catalog.bpp/providers.items will have all the job openings for the employer. descriptor.name will have the job title, descriptor.short_desc can be used to give a summary of the role and descriptor.long_desc can be used to give the full job description. price.offered_value can have the salary offered for the role. time.duration can be used to represent the minimum experience that the role requires. location_id can be used to specify which office the job offer is for. This will be a reference to an object in message.catalog.bpp/providers.locations array. category_ids will have the categories to which the job offer belongs to. The skills required from the job can be given in tags.skills as comma separated keywords.
ravi-prakash-v
@techframewirk need example JSONs to be published for the following APIs
search
on_search