public class TxClient extends Object
| Modifier and Type | Field and Description |
|---|---|
boolean |
ShowFullRequestBodyInExceptions
Set to
true for debugging API errors. |
| Constructor and Description |
|---|
TxClient(String accountId,
String serviceKey,
DataCenter dataCenter)
Create an SDK client to perform Tx API calls with the account information found at https://cloud.textkernel.com/tx/console
|
TxClient(String accountId,
String serviceKey,
DataCenter dataCenter,
List<String> trackingTags)
Create an SDK client to perform Tx API calls with the account information found at https://cloud.textkernel.com/tx/console
|
| Modifier and Type | Method and Description |
|---|---|
ProfessionsAutoCompleteResponse |
autocompleteProfession(String prefix)
Returns normalized professions that begin with a given prefix, based on the default language of english.
|
ProfessionsAutoCompleteResponse |
autocompleteProfession(String prefix,
List<String> languages,
String outputLanguage,
int limit)
Returns normalized professions that begin with a given prefix, based on the chosen language(s).
|
AutoCompleteSkillsResponse |
autocompleteSkill(String prefix)
Returns normalized skills that begin with a given prefix, based on the chosen language(s).
|
AutoCompleteSkillsResponse |
autocompleteSkill(String prefix,
List<String> languages,
String outputLanguage,
List<String> types,
int limit)
Returns normalized skills that begin with a given prefix, based on the chosen language(s).
|
<TTarget extends IParsedDocWithId> |
bimetricScore(ParsedJobWithId sourceJob,
List<TTarget> targetDocuments,
CategoryWeights preferredWeights,
SearchMatchSettings settings)
Score one or more target documents against a source job
|
<TTarget extends IParsedDocWithId> |
bimetricScore(ParsedResumeWithId sourceResume,
List<TTarget> targetDocuments,
CategoryWeights preferredWeights,
SearchMatchSettings settings)
Score one or more target documents against a source resume
|
CompareProfessionsResponse |
compareProfessions(int profession1,
int profession2,
String outputLanguage)
Compare two professions based on the skills associated with each.
|
CompareSkillsToProfessionResponse |
compareSkillsToProfessions(int professionCodeId,
String outputLanguage,
List<SkillScore> skills)
Compare a given set of skills to the skills related to a given profession.
|
CompareSkillsToProfessionResponse |
compareSkillsToProfessions(ParsedResume resume,
int professionCodeId,
String outputLanguage,
boolean weightSkillsByExperience)
Compare the skills of a candidate to the skills related to a job using the Ontology API.
|
CreateIndexResponse |
createIndex(IndexType type,
String indexId)
Create a new index
|
DeleteDocumentResponse |
deleteDocument(String indexId,
String documentId)
Delete an existing document from an index
|
DeleteIndexResponse |
deleteIndex(String indexId)
Delete an existing index.
|
DeleteMultipleDocumentsResponse |
deleteMultipleDocuments(String indexId,
List<String> documentIds)
Delete a group of existing documents from an index
|
ExtractSkillsResponse |
extractSkills(String text)
Extracts known skills from the given text.
|
ExtractSkillsResponse |
extractSkills(String text,
String language,
String outputLanguage,
float threshold)
Extracts known skills from the given text.
|
FormatResumeResponse |
formatResume(FormatResumeRequest request)
Format a resume into a standardized template that you provide
|
GenerateJobResponse |
generateJobDescription(GenerateJobRequest request)
Generates a job description based on specified parameters.
|
GeocodeJobResponse |
geocode(ParsedJob job,
Address address,
GeocodeCredentials geocodeCredentials)
Use this if you would like to provide an address for geocoding instead of using the one in the parsed
job.
|
GeocodeJobResponse |
geocode(ParsedJob job,
GeocodeCredentials geocodeCredentials)
Uses the address in the job (if present) to look up geocoordinates and add them into the ParsedJob object.
|
GeocodeResumeResponse |
geocode(ParsedResume resume,
Address address,
GeocodeCredentials geocodeCredentials)
Use this if you would like to provide an address for geocoding instead of using the one in the parsed
resume.
|
GeocodeResumeResponse |
geocode(ParsedResume resume,
GeocodeCredentials geocodeCredentials)
Uses the address in the resume (if present) to look up geocoordinates and add them into the ParsedResume object.
|
GeocodeAndIndexJobResponse |
geocodeAndIndex(ParsedJob job,
IndexSingleDocumentInfo indexingOptions,
Address address,
boolean indexIfGeocodeFails,
GeocodeCredentials geocodeCredentials)
Use this if you would like to provide an address for geocoding instead of using the one in the parsed
rjobesume.
|
GeocodeAndIndexJobResponse |
geocodeAndIndex(ParsedJob job,
IndexSingleDocumentInfo indexingOptions,
boolean indexIfGeocodeFails,
GeocodeCredentials geocodeCredentials)
Uses the address in the job (if present) to look up geocoordinates and add them into the ParsedJob object.
|
GeocodeAndIndexJobResponse |
geocodeAndIndex(ParsedJob job,
IndexSingleDocumentInfo indexingOptions,
GeoCoordinates coordinates,
boolean indexIfGeocodeFails,
GeocodeCredentials geocodeCredentials)
Use this if you already have latitude/longitude coordinates and simply wish to add them to your parsed job.
|
GeocodeAndIndexResumeResponse |
geocodeAndIndex(ParsedResume resume,
IndexSingleDocumentInfo indexingOptions,
Address address,
boolean indexIfGeocodeFails,
GeocodeCredentials geocodeCredentials)
Use this if you would like to provide an address for geocoding instead of using the one in the parsed
resume.
|
GeocodeAndIndexResumeResponse |
geocodeAndIndex(ParsedResume resume,
IndexSingleDocumentInfo indexingOptions,
boolean indexIfGeocodeFails,
GeocodeCredentials geocodeCredentials)
Uses the address in the resume (if present) to look up geocoordinates and add them into the ParsedResume object.
|
GeocodeAndIndexResumeResponse |
geocodeAndIndex(ParsedResume resume,
IndexSingleDocumentInfo indexingOptions,
GeoCoordinates coordinates,
boolean indexIfGeocodeFails,
GeocodeCredentials geocodeCredentials)
Use this if you already have latitude/longitude coordinates and simply wish to add them to your parsed resume.
|
GetAccountInfoResponse |
getAccountInfo()
Get the account info (remaining credits, max concurrency, etc).
|
GetAllIndexesResponse |
getAllIndexes()
Get all existing indexes
|
GetJobResponse |
getJob(String indexId,
String documentId)
Retrieve an existing job from an index
|
GetProfessionsTaxonomyResponse |
getProfessionsTaxonomy()
Get all professions in the taxonomy with associated IDs and descriptions in all supported languages.
|
GetProfessionsTaxonomyResponse |
getProfessionsTaxonomy(String language,
TaxonomyFormat format)
Get all professions in the taxonomy with associated IDs and descriptions in all supported languages.
|
GetMetadataResponse |
getProfessionsTaxonomyMetadata()
Get metadata about the professions taxonomy/service.
|
GetResumeResponse |
getResume(String indexId,
String documentId)
Retrieve an existing resume from an index
|
GetSkillsTaxonomyResponse |
getSkillsTaxonomy()
Get all skills in the taxonomy with associated IDs and descriptions in all supported languages.
|
GetSkillsTaxonomyResponse |
getSkillsTaxonomy(TaxonomyFormat format)
Get all skills in the taxonomy with associated IDs and descriptions in all supported languages.
|
GetMetadataResponse |
getSkillsTaxonomyMetadata()
Get metadata about the skills taxonomy/service.
|
IndexDocumentResponse |
indexDocument(ParsedJob job,
String indexId,
String documentId,
List<String> userDefinedTags)
Add a job to an existing index
|
IndexDocumentResponse |
indexDocument(ParsedResume resume,
String indexId,
String documentId,
List<String> userDefinedTags)
Add a resume to an existing index
|
IndexMultipleDocumentsResponse |
indexMultipleJobs(List<IndexJobInfo> jobs,
String indexId)
Add several jobs to an existing index
|
IndexMultipleDocumentsResponse |
indexMultipleResumes(List<IndexResumeInfo> resumes,
String indexId)
Add several resumes to an existing index
|
LookupProfessionCodesResponse |
lookupProfessions(List<Integer> codeIds)
Get details for the given professions in the taxonomy.
|
LookupProfessionCodesResponse |
lookupProfessions(List<Integer> codeIds,
String outputLanguage)
Get details for the given professions in the taxonomy.
|
LookupSkillCodesResponse |
lookupSkills(List<String> skillIds)
Get the details associated with given skills in the taxonomy.
|
LookupSkillCodesResponse |
lookupSkills(List<String> skillIds,
String outputLanguage)
Get the details associated with given skills in the taxonomy.
|
MatchResponse |
match(ParsedJob job,
List<String> indexesToQuery,
CategoryWeights preferredWeights,
FilterCriteria filters,
SearchMatchSettings settings,
int numResults)
Find matches for a non-indexed job.
|
MatchResponse |
match(ParsedResume resume,
List<String> indexesToQuery,
CategoryWeights preferredWeights,
FilterCriteria filters,
SearchMatchSettings settings,
int numResults)
Find matches for a non-indexed resume.
|
MatchResponse |
match(String indexId,
String documentId,
List<String> indexesToQuery,
CategoryWeights preferredWeights,
FilterCriteria filters,
SearchMatchSettings settings,
int numResults)
Find matches for a resume or job that is already indexed
|
NormalizeProfessionsResponse |
normalizeProfessions(List<String> jobTitles)
Normalize the given job titles to the most closely-related professions in the taxonomy.
|
NormalizeProfessionsResponse |
normalizeProfessions(List<String> jobTitles,
String language,
String outputLanguage)
Normalize the given job titles to the most closely-related professions in the taxonomy.
|
NormalizeSkillsResponse |
normalizeSkills(List<String> skills)
Normalize the given skills to the most closely-related skills in the taxonomy.
|
NormalizeSkillsResponse |
normalizeSkills(List<String> skills,
String language,
String outputLanguage)
Normalize the given skills to the most closely-related skills in the taxonomy.
|
ParseJobResponse |
parseJob(ParseRequest request)
Parse a job
|
ParseResumeResponse |
parseResume(ParseRequest request)
Parse a resume
|
SearchResponse |
search(List<String> indexesToQuery,
FilterCriteria query,
SearchMatchSettings settings,
PaginationSettings pagination)
Search for resumes or jobs that meet specific criteria
|
SkillsSimilarityScoreResponse |
skillsSimilarityScore(List<SkillScore> skillSetA,
List<SkillScore> skillSetB)
Determines how closely related one set of skills is to another.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(List<SkillScore> skills,
int limit,
boolean returnMissingSkills,
String outputLanguage)
Suggest professions based on a given set of skills.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(List<String> skillIds,
String outputLanguage)
Suggest professions based on a given set of skill IDs.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(ParsedJob job)
Suggest professions based on the skills within a given job.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(ParsedJob job,
int limit,
boolean returnMissingSkills,
String outputLanguage)
Suggest professions based on the skills within a given job.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(ParsedJob job,
String outputLanguage)
Suggest professions based on the skills within a given job.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(ParsedResume resume)
Suggest professions based on the skills within a given resume.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(ParsedResume resume,
int limit,
boolean returnMissingSkills,
String outputLanguage,
boolean weightSkillsByExperience)
Suggest professions based on the skills within a given resume.
|
SuggestProfessionsResponse |
suggestProfessionsFromSkills(ParsedResume resume,
String outputLanguage)
Suggest professions based on the skills within a given resume.
|
SuggestSkillsFromJobTitleResponse |
suggestSkillsFromJobTitle(String jobTitle)
Takes a job title and suggests relevant skills.
|
SuggestSkillsFromJobTitleResponse |
suggestSkillsFromJobTitle(String jobTitle,
String language,
Integer limit)
Takes a job title and suggests relevant skills.
|
SuggestSkillsResponse |
suggestSkillsFromProfessions(List<Integer> professionCodeIds,
int limit,
String outputLanguage)
Suggests skills related to given professions.
|
SuggestSkillsResponse |
suggestSkillsFromProfessions(List<Integer> professionCodeIds,
String outputLanguage)
Suggests skills related to given professions.
|
SuggestSkillsResponse |
suggestSkillsFromProfessions(ParsedJob job)
Suggests skills related to a job based on the profession title in the job.
|
SuggestSkillsResponse |
suggestSkillsFromProfessions(ParsedJob job,
String outputLanguage)
Suggests skills related to a job based on the profession title in the job.
|
SuggestSkillsResponse |
suggestSkillsFromProfessions(ParsedResume resume)
Suggests skills related to a resume based on the recent professions in the resume.
|
SuggestSkillsResponse |
suggestSkillsFromProfessions(ParsedResume resume,
String outputLanguage)
Suggests skills related to a resume based on the recent professions in the resume.
|
SuggestSkillsResponse |
suggestSkillsFromSkills(List<SkillScore> skills,
int limit,
String outputLanguage)
Returns skills related to a given skill or set of skills.
|
SuggestSkillsResponse |
suggestSkillsFromSkills(List<String> skillIds,
String outputLanguage)
Returns skills related to a given skill or set of skills.
|
SuggestSkillsResponse |
suggestSkillsFromSkills(ParsedJob job,
int limit,
String outputLanguage)
Suggests skills related to a job (but not in the job) based on the skills in the job.
|
SuggestSkillsResponse |
suggestSkillsFromSkills(ParsedJob job,
String outputLanguage)
Suggests skills related to a job (but not in the job) based on the skills in the job.
|
SuggestSkillsResponse |
suggestSkillsFromSkills(ParsedResume resume,
int limit,
String outputLanguage,
boolean weightSkillsByExperience)
Suggests skills related to a resume (but not in the resume) based on the skills in the resume.
|
SuggestSkillsResponse |
suggestSkillsFromSkills(ParsedResume resume,
String outputLanguage)
Suggests skills related to a resume (but not in the resume) based on the skills in the resume.
|
TxUIClient |
ui(MatchUISettings uiOptions)
Access methods for generating Matching UI sessions.
|
UpdateUserDefinedTagsResponse |
updateJobUserDefinedTags(String indexId,
String documentId,
List<String> userDefinedTags,
UserDefinedTagsMethod method)
Updates the user-defined tags for a job
|
UpdateUserDefinedTagsResponse |
updateResumeUserDefinedTags(String indexId,
String documentId,
List<String> userDefinedTags,
UserDefinedTagsMethod method)
Updates the user-defined tags for a resume
|
public boolean ShowFullRequestBodyInExceptions
true for debugging API errors. It will show the full JSON request body in TxException.RequestBody
true in your production system, as it increases the memory footprintpublic TxClient(String accountId, String serviceKey, DataCenter dataCenter)
accountId - - The account id for your accountserviceKey - - The service key for your accountdataCenter - - The Data Center for your account. Either DataCenter.US, DataCenter.EU, or @link DataCenter#AU}IllegalArgumentException - if the accountId, serviceKey, or dataCenter are null/emptypublic TxClient(String accountId, String serviceKey, DataCenter dataCenter, List<String> trackingTags)
accountId - - The account id for your accountserviceKey - - The service key for your accountdataCenter - - The Data Center for your account. Either DataCenter.US, DataCenter.EU or DataCenter.AUtrackingTags - - Optional tags to use to track API usage for your accountIllegalArgumentException - if the accountId, serviceKey, or dataCenter are null/emptypublic GetAccountInfoResponse getAccountInfo() throws TxException
TxException - Thrown when an API error occurspublic FormatResumeResponse formatResume(FormatResumeRequest request) throws TxException
request - The request bodyTxException - Thrown when an API error occurspublic ParseResumeResponse parseResume(ParseRequest request) throws TxException
request - The request bodyTxException - Thrown when an API error occurspublic ParseJobResponse parseJob(ParseRequest request) throws TxException
request - The request bodyTxException - Thrown when an API error occurspublic CreateIndexResponse createIndex(IndexType type, String indexId) throws TxException
type - The type of documents stored in this index. Either 'Resume' or 'Job'indexId - The ID to assign to the new index. This is restricted to alphanumeric with dashes
and underscores. All values will be converted to lower-case.TxException - Thrown when an API error occurspublic GetAllIndexesResponse getAllIndexes() throws TxException
TxException - Thrown when an API error occurspublic DeleteIndexResponse deleteIndex(String indexId) throws TxException
indexId - The index to delete (case-insensitive).TxException - Thrown when an API error occurspublic IndexDocumentResponse indexDocument(ParsedResume resume, String indexId, String documentId, List<String> userDefinedTags) throws TxException
resume - A resume generated by the Resume ParserindexId - The index the document should be added into (case-insensitive).documentId - The ID to assign to the new document. This is restricted to alphanumeric
with dashes and underscores. All values will be converted to lower-case.userDefinedTags - The user-defined tags that the resume should have, or nullTxException - Thrown when an API error occurspublic IndexDocumentResponse indexDocument(ParsedJob job, String indexId, String documentId, List<String> userDefinedTags) throws TxException
job - A job generated by the Job ParserindexId - The index the document should be added into (case-insensitive).documentId - The ID to assign to the new document. This is restricted to alphanumeric
with dashes and underscores. All values will be converted to lower-case.userDefinedTags - The user-defined tags that the resume should have, or nullTxException - Thrown when an API error occurspublic IndexMultipleDocumentsResponse indexMultipleResumes(List<IndexResumeInfo> resumes, String indexId) throws TxException
resumes - The resumes generated by the Resume Parser paired with their DocumentIdsindexId - The index the documents should be added into (case-insensitive).TxException - Thrown when an API error occurspublic IndexMultipleDocumentsResponse indexMultipleJobs(List<IndexJobInfo> jobs, String indexId) throws TxException
jobs - The jobs generated by the Job Parser paired with their DocumentIdsindexId - The index the documents should be added into (case-insensitive).TxException - Thrown when an API error occurspublic DeleteDocumentResponse deleteDocument(String indexId, String documentId) throws TxException
indexId - The index containing the documentdocumentId - The ID of the document to deleteTxException - Thrown when an API error occurspublic DeleteMultipleDocumentsResponse deleteMultipleDocuments(String indexId, List<String> documentIds) throws TxException
indexId - The index containing the documentsdocumentIds - The IDs of the documents to deleteTxException - Thrown when an API error occurspublic GetResumeResponse getResume(String indexId, String documentId) throws TxException
indexId - The index containing the resumedocumentId - The ID of the resume to retrieveTxException - Thrown when an API error occurspublic GetJobResponse getJob(String indexId, String documentId) throws TxException
indexId - The index containing the jobdocumentId - The ID of the job to retrieveTxException - Thrown when an API error occurspublic UpdateUserDefinedTagsResponse updateResumeUserDefinedTags(String indexId, String documentId, List<String> userDefinedTags, UserDefinedTagsMethod method) throws TxException
indexId - The index containing the resumedocumentId - The ID of the resume to updateuserDefinedTags - The user-defined tags to add/delete/etcmethod - Which method to use for the specified user-defined tagsTxException - Thrown when an API error occurspublic UpdateUserDefinedTagsResponse updateJobUserDefinedTags(String indexId, String documentId, List<String> userDefinedTags, UserDefinedTagsMethod method) throws TxException
indexId - The index containing the jobdocumentId - The ID of the job to updateuserDefinedTags - The user-defined tags to add/delete/etcmethod - Which method to use for the specified user-defined tagsTxException - Thrown when an API error occurspublic MatchResponse match(ParsedResume resume, List<String> indexesToQuery, CategoryWeights preferredWeights, FilterCriteria filters, SearchMatchSettings settings, int numResults) throws TxException
resume - The resume (generated by the Resume Parser) to use as the source for a match queryindexesToQuery - The indexes to find results in. These must all be of the same type (resumes or jobs)preferredWeights - The preferred category weights for scoring the results. If null,
The best values will be determined based on the source resumefilters - Any filters to apply prior to the match (a result must satisfy all the filters), or nullsettings - The settings for this match request. Use null for defaults.numResults - The number of results to show. Use 0 for the default.TxException - Thrown when an API error occurspublic MatchResponse match(ParsedJob job, List<String> indexesToQuery, CategoryWeights preferredWeights, FilterCriteria filters, SearchMatchSettings settings, int numResults) throws TxException
job - The job (generated by the Job Parser) to use as the source for a match queryindexesToQuery - The indexes to find results in. These must all be of the same type (resumes or jobs)preferredWeights - The preferred category weights for scoring the results. If null,
The best values will be determined based on the source jobfilters - Any filters to apply prior to the match (a result must satisfy all the filters), or nullsettings - The settings for this match request. Use null for defaults.numResults - The number of results to show. Use 0 for the default.TxException - Thrown when an API error occurspublic MatchResponse match(String indexId, String documentId, List<String> indexesToQuery, CategoryWeights preferredWeights, FilterCriteria filters, SearchMatchSettings settings, int numResults) throws TxException
indexId - The index containing the document you want to matchdocumentId - The ID of the document to matchindexesToQuery - The indexes to find results in. These must all be of the same type (resumes or jobs)preferredWeights - The preferred category weights for scoring the results. If null,
The best values will be determined based on the source resume/jobfilters - Any filters to apply prior to the match (a result must satisfy all the filters), or nullsettings - The settings for this match request. Use null for defaults.numResults - The number of results to show. Use 0 for the default.TxException - Thrown when an API error occurspublic SearchResponse search(List<String> indexesToQuery, FilterCriteria query, SearchMatchSettings settings, PaginationSettings pagination) throws TxException
indexesToQuery - The indexes to find results in. These must all be of the same type (resumes or jobs)query - The search query. A result must satisfy all of these criteriasettings - The settings for this search request. Use null for defaults.pagination - Pagination settings. Use null for defaults.TxException - Thrown when an API error occurspublic <TTarget extends IParsedDocWithId> BimetricScoreResponse bimetricScore(ParsedResumeWithId sourceResume, List<TTarget> targetDocuments, CategoryWeights preferredWeights, SearchMatchSettings settings) throws TxException
TTarget - Either ParsedResumeWithId or ParsedJobWithIdsourceResume - The source resumetargetDocuments - The target resumes/jobspreferredWeights - The preferred category weights for scoring the results. If null,
The best values will be determined based on the source resume.settings - The settings for this search request. Use null for defaults.TxException - Thrown when an API error occurspublic <TTarget extends IParsedDocWithId> BimetricScoreResponse bimetricScore(ParsedJobWithId sourceJob, List<TTarget> targetDocuments, CategoryWeights preferredWeights, SearchMatchSettings settings) throws TxException
TTarget - Either ParsedResumeWithId or ParsedJobWithIdsourceJob - The source jobtargetDocuments - The target resumes/jobspreferredWeights - The preferred category weights for scoring the results. If null,
The best values will be determined based on the source job.settings - The settings for this search request. Use null for defaults.TxException - Thrown when an API error occurspublic GeocodeResumeResponse geocode(ParsedResume resume, GeocodeCredentials geocodeCredentials) throws TxException
resume - The resume to insert the geocoordinates (from the address) intogeocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeResumeResponse geocode(ParsedResume resume, Address address, GeocodeCredentials geocodeCredentials) throws TxException
resume - The resume to insert the geocoordinates (from the address) intoaddress - The address to use to retrieve geocoordinatesgeocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeJobResponse geocode(ParsedJob job, GeocodeCredentials geocodeCredentials) throws TxException
job - The job to insert the geocoordinates (from the address) intogeocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeJobResponse geocode(ParsedJob job, Address address, GeocodeCredentials geocodeCredentials) throws TxException
job - The job to insert the geocoordinates (from the address) intoaddress - The address to use to retrieve geocoordinatesgeocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeAndIndexResumeResponse geocodeAndIndex(ParsedResume resume, IndexSingleDocumentInfo indexingOptions, boolean indexIfGeocodeFails, GeocodeCredentials geocodeCredentials) throws TxException
resume - The resume to geocodeindexingOptions - What index/document id to use to index the document after geocodingindexIfGeocodeFails - Indicates whether or not the document should still be added to the index if the geocode request fails.geocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeAndIndexResumeResponse geocodeAndIndex(ParsedResume resume, IndexSingleDocumentInfo indexingOptions, Address address, boolean indexIfGeocodeFails, GeocodeCredentials geocodeCredentials) throws TxException
resume - The resume to insert the geocoordinates (from the address) intoindexingOptions - What index/document id to use to index the document after geocodingaddress - The address to use to retrieve geocoordinatesindexIfGeocodeFails - Indicates whether or not the document should still be added to the index if the geocode request fails.geocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeAndIndexResumeResponse geocodeAndIndex(ParsedResume resume, IndexSingleDocumentInfo indexingOptions, GeoCoordinates coordinates, boolean indexIfGeocodeFails, GeocodeCredentials geocodeCredentials) throws TxException
resume - The resume to insert the geocoordinates intoindexingOptions - What index/document id to use to index the document after geocodingcoordinates - The geocoordinates to useindexIfGeocodeFails - Indicates whether or not the document should still be added to the index if the geocode request fails.geocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeAndIndexJobResponse geocodeAndIndex(ParsedJob job, IndexSingleDocumentInfo indexingOptions, boolean indexIfGeocodeFails, GeocodeCredentials geocodeCredentials) throws TxException
job - The job to geocodeindexingOptions - What index/document id to use to index the document after geocodingindexIfGeocodeFails - Indicates whether or not the document should still be added to the index if the geocode request fails.geocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeAndIndexJobResponse geocodeAndIndex(ParsedJob job, IndexSingleDocumentInfo indexingOptions, Address address, boolean indexIfGeocodeFails, GeocodeCredentials geocodeCredentials) throws TxException
job - The job to insert the geocoordinates (from the address) intoindexingOptions - What index/document id to use to index the document after geocodingaddress - The address to use to retrieve geocoordinatesindexIfGeocodeFails - Indicates whether or not the document should still be added to the index if the geocode request fails.geocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic GeocodeAndIndexJobResponse geocodeAndIndex(ParsedJob job, IndexSingleDocumentInfo indexingOptions, GeoCoordinates coordinates, boolean indexIfGeocodeFails, GeocodeCredentials geocodeCredentials) throws TxException
job - The job to insert the geocoordinates intoindexingOptions - What index/document id to use to index the document after geocodingcoordinates - The geocoordinates to useindexIfGeocodeFails - Indicates whether or not the document should still be added to the index if the geocode request fails.geocodeCredentials - - The credentials you want to use for geocoding (use null for built-in credentials)TxException - Thrown when an API error occurredpublic TxUIClient ui(MatchUISettings uiOptions)
txClient.UI(options).search(...)uiOptions - Options/settings for the Matching UI.
UIOptions.Username (in MatchUISettings.UIOptions),
the user will be prompted to login as soon as the Matching UI session is loadedpublic GetSkillsTaxonomyResponse getSkillsTaxonomy(TaxonomyFormat format) throws TxException
format - The format of the returned taxonomy. TaxonomyFormat.csv, only the Taxonomy.CsvOutput will be populated.TxException - Thrown when an API error occurspublic GetSkillsTaxonomyResponse getSkillsTaxonomy() throws TxException
TxException - Thrown when an API error occurspublic GetMetadataResponse getSkillsTaxonomyMetadata() throws TxException
TxException - Thrown when an API error occurspublic AutoCompleteSkillsResponse autocompleteSkill(String prefix, List<String> languages, String outputLanguage, List<String> types, int limit) throws TxException
prefix - The skill prefix to be completed. Must contain at least 1 character.languages - The language(s) used to search for matching skills (the language of the provided Prefix). A maximum of 5 languages can be provided. Must be one of the supported ISO codes.outputLanguage - The language to ouput the found skill descriptions in (default is 'en'). Must be one of the supported ISO codes.types - If specified, only these types of skills will be returned. The following values are acceptable: Professional, IT, Language, Soft, All.limit - The maximum number of returned skills. The default is 10 and the maximum is 100.TxException - Thrown when an API error occurspublic AutoCompleteSkillsResponse autocompleteSkill(String prefix) throws TxException
prefix - The skill prefix to be completed. Must contain at least 1 character.TxException - Thrown when an API error occurspublic LookupSkillCodesResponse lookupSkills(List<String> skillIds, String outputLanguage) throws TxException
skillIds - The IDs of the skills to get details about. A maximum of 100 IDs can be requested.outputLanguage - The language to use for the output skill descriptions. If not provided, defaults to en. If specified, must be one of the supported ISO codes.TxException - Thrown when an API error occurspublic LookupSkillCodesResponse lookupSkills(List<String> skillIds) throws TxException
skillIds - The IDs of the skills to get details about. A maximum of 100 IDs can be requested.TxException - Thrown when an API error occurspublic NormalizeSkillsResponse normalizeSkills(List<String> skills, String language, String outputLanguage) throws TxException
skills - The list of skills to normalize (up to 50 skills, each skill may not exceed 100 characters).language - The language of the given skills. Must be one of the supported ISO codes.outputLanguage - The language to use for the output skill descriptions. Must be one of the supported ISO codes.TxException - Thrown when an API error occurspublic NormalizeSkillsResponse normalizeSkills(List<String> skills) throws TxException
skills - The list of skills to normalize (up to 50 skills, each skill may not exceed 100 characters).TxException - Thrown when an API error occurspublic ExtractSkillsResponse extractSkills(String text, String language, String outputLanguage, float threshold) throws TxException
text - The text to extract skills from. There is a 24,000 character limit.language - The language of the input text. Must be one of the supported ISO codes.outputLanguage - The language to use for the output skill descriptions. If not provided, defaults to the input language. Must be one of the supported ISO codes.threshold - A value from [0 - 1] for the minimum confidence threshold for extracted skills. Lower values will return more skills, but also increase the likelihood of ambiguity-related errors. The recommended and default value is 0.5.TxException - Thrown when an API error occurspublic ExtractSkillsResponse extractSkills(String text) throws TxException
text - The text to extract skills from. There is a 24,000 character limit.TxException - Thrown when an API error occurspublic GetProfessionsTaxonomyResponse getProfessionsTaxonomy(String language, TaxonomyFormat format) throws TxException
language - The language parameter returns the taxonomy with descriptions only in that specified language. If not specified, descriptions in all languages are returned. Must be specified as one of the supported ISO codes.format - The format of the returned taxonomy. TaxonomyFormat.csv, only the Taxonomy.CsvOutput will be populated.TxException - Thrown when an API error occurspublic GetProfessionsTaxonomyResponse getProfessionsTaxonomy() throws TxException
TxException - Thrown when an API error occurspublic GetMetadataResponse getProfessionsTaxonomyMetadata() throws TxException
TxException - Thrown when an API error occurspublic ProfessionsAutoCompleteResponse autocompleteProfession(String prefix, List<String> languages, String outputLanguage, int limit) throws TxException
prefix - The job title prefix to be completed. Must contain at least 1 character.languages - The language(s) used to search for matching professions (the language of the provided Prefix). A maximum of 5 languages can be provided. Must be one of the supported ISO codes. Default is 'en' only.outputLanguage - The language to ouput the found professions in (default is 'en'). Must be one of the supported ISO codes.limit - The maximum number of returned professions. The default is 10 and the maximum is 100.TxException - Thrown when an API error occurspublic ProfessionsAutoCompleteResponse autocompleteProfession(String prefix) throws TxException
prefix - The job title prefix to be completed. Must contain at least 1 character.TxException - Thrown when an API error occurspublic NormalizeProfessionsResponse normalizeProfessions(List<String> jobTitles, String language, String outputLanguage) throws TxException
jobTitles - The list of job titles to normalize (up to 10 job titles, each job title may not exceed 400 characters).language - The language of the input job titles. Must be one of the supported ISO codes.outputLanguage - The language to use for descriptions of the returned normalized professions. Must be one of the supported ISO codes.TxException - Thrown when an API error occurspublic NormalizeProfessionsResponse normalizeProfessions(List<String> jobTitles) throws TxException
jobTitles - The list of job titles to normalize (up to 10 job titles, each job title may not exceed 400 characters).TxException - Thrown when an API error occurspublic LookupProfessionCodesResponse lookupProfessions(List<Integer> codeIds, String outputLanguage) throws TxException
codeIds - The profession code IDs to get details about from the Professions Taxonomy.outputLanguage - The language to use for professions descriptions (default is en). Must be an allowed ISO code. TxException - Thrown when an API error occurspublic LookupProfessionCodesResponse lookupProfessions(List<Integer> codeIds) throws TxException
codeIds - The profession code IDs to get details about from the Professions Taxonomy.TxException - Thrown when an API error occurspublic CompareProfessionsResponse compareProfessions(int profession1, int profession2, String outputLanguage) throws TxException
profession1 - A profession code ID from the Professions Taxonomy to compare.profession2 - A profession code ID from the Professions Taxonomy to compare.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic CompareSkillsToProfessionResponse compareSkillsToProfessions(int professionCodeId, String outputLanguage, List<SkillScore> skills) throws TxException
professionCodeId - The profession code ID from the Professions Taxonomy to compare the skill set to.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeskills - The skills which should be compared against the given profession. The list can contain up to 50 skills.TxException - Thrown when an API error occurspublic CompareSkillsToProfessionResponse compareSkillsToProfessions(ParsedResume resume, int professionCodeId, String outputLanguage, boolean weightSkillsByExperience) throws TxException
resume - The resume containing the skills of the candidateprofessionCodeId - The profession code ID from the Professions Taxonomy to compare the skill set to.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeweightSkillsByExperience - Whether or not to give a higher weight to skills that the candidate has more experience with.TxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromProfessions(List<Integer> professionCodeIds, int limit, String outputLanguage) throws TxException
professionCodeIds - The code IDs of the professions to suggest skills for.limit - The maximum amount of suggested skills returned. If not sure what value should be, provide 10 as default limit.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromProfessions(List<Integer> professionCodeIds, String outputLanguage) throws TxException
professionCodeIds - The code IDs of the professions to suggest skills for.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromProfessions(ParsedResume resume, String outputLanguage) throws TxException
resume - The resume to suggest skills for (based on the professions in the resume).outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromProfessions(ParsedResume resume) throws TxException
resume - The resume to suggest skills for (based on the professions in the resume).TxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromProfessions(ParsedJob job, String outputLanguage) throws TxException
job - The resume to suggest skills for (based on the professions in the resume).outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromProfessions(ParsedJob job) throws TxException
job - The resume to suggest skills for (based on the professions in the resume).TxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(ParsedResume resume, int limit, boolean returnMissingSkills, String outputLanguage, boolean weightSkillsByExperience) throws TxException
resume - The professions are suggested based on the skills within this resume.limit - The maximum amount of professions returned. If not sure what value should be, provide 10 as default limit.returnMissingSkills - Flag to enable returning a list of missing skills per suggested profession.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeweightSkillsByExperience - Whether or not to give a higher weight to skills that the candidate has more experience with.TxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(ParsedResume resume, String outputLanguage) throws TxException
resume - The professions are suggested based on the skills within this resume. Defaults limit returned to 10 and does not return missing skills. Use another overload to specify these parameters.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(ParsedResume resume) throws TxException
resume - The professions are suggested based on the skills within this resume. Defaults limit returned to 10 and does not return missing skills. Use another overload to specify these parameters.TxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(ParsedJob job, int limit, boolean returnMissingSkills, String outputLanguage) throws TxException
job - The professions are suggested based on the skills within this job.limit - The maximum amount of professions returned. If not sure what value should be, provide 10 as default limit.returnMissingSkills - Flag to enable returning a list of missing skills per suggested profession.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(ParsedJob job, String outputLanguage) throws TxException
job - The professions are suggested based on the skills within this job. Defaults limit returned to 10 and does not return missing skills. Use another overload to specify these parameters.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(ParsedJob job) throws TxException
job - The professions are suggested based on the skills within this job. Defaults limit returned to 10 and does not return missing skills. Use another overload to specify these parameters.TxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(List<SkillScore> skills, int limit, boolean returnMissingSkills, String outputLanguage) throws TxException
skills - The skills used to return the most relevant professions. The list can contain up to 50 skills.limit - The maximum amount of professions returned. If not sure what value should be, provide 10 as default limit.returnMissingSkills - Flag to enable returning a list of missing skills per suggested profession.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestProfessionsResponse suggestProfessionsFromSkills(List<String> skillIds, String outputLanguage) throws TxException
skillIds - The skill IDs used to return the most relevant professions. The list can contain up to 50 skill IDs. Defaults limit returned to 10 and does not return missing skills. Use another overload to specify these parameters.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromSkills(List<SkillScore> skills, int limit, String outputLanguage) throws TxException
skills - The skills (and optionally, scores) for which the service should return related skills. The list can contain up to 50 skills.limit - The maximum amount of suggested skills returned. The maximum is 25.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromSkills(List<String> skillIds, String outputLanguage) throws TxException
skillIds - The skill IDs for which the service should return related skills. The list can contain up to 50 skills.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromSkills(ParsedJob job, int limit, String outputLanguage) throws TxException
job - The job to suggest skills for (based on the skills in the job).limit - The maximum amount of suggested skills returned. The maximum is 25.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromSkills(ParsedJob job, String outputLanguage) throws TxException
job - The job to suggest skills for (based on the skills in the job).outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromSkills(ParsedResume resume, int limit, String outputLanguage, boolean weightSkillsByExperience) throws TxException
resume - The resume to suggest skills for (based on the skills in the resume).limit - The maximum amount of suggested skills returned. The maximum is 25.outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeweightSkillsByExperience - Whether or not to give a higher weight to skills that the candidate has more experience with.TxException - Thrown when an API error occurspublic SuggestSkillsResponse suggestSkillsFromSkills(ParsedResume resume, String outputLanguage) throws TxException
resume - The resume to suggest skills for (based on the skills in the resume).outputLanguage - The language to use for the returned descriptions. If not provided, no descriptions are returned. Must be one of the supported ISO codeTxException - Thrown when an API error occurspublic SkillsSimilarityScoreResponse skillsSimilarityScore(List<SkillScore> skillSetA, List<SkillScore> skillSetB) throws TxException
skillSetA - A set of skills (and optionally, scores) to score against the other set of skills. The list can contain up to 50 skills.skillSetB - A set of skills (and optionally, scores) to score against the other set of skills. The list can contain up to 50 skills.TxException - Thrown when an API error occurspublic GenerateJobResponse generateJobDescription(GenerateJobRequest request) throws TxException
request - The request bodyTxException - Thrown when an API error occurspublic SuggestSkillsFromJobTitleResponse suggestSkillsFromJobTitle(String jobTitle, String language, Integer limit) throws TxException
jobTitle - The title of the job for which skills are being suggested.language - Language of the suggested skills in ISO 639-1 code format.limit - Maximum number of skills to suggest. If not specified this parameter defaults to 10. This value cannot exceed 50.TxException - Thrown when an API error occurspublic SuggestSkillsFromJobTitleResponse suggestSkillsFromJobTitle(String jobTitle) throws TxException
jobTitle - The title of the job for which skills are being suggested.TxException - Thrown when an API error occursCopyright © 2024. All rights reserved.