Candidatos para contratação

Aplica-se a estes aplicativos do Dynamics 365:
Recursos Humanos

Este artigo descreve a entidade Candidato para contratação para o Dynamics 365 Human Resources.

Nome físico: mshr_hcmcandidatetohireentity

Descrição

Esta entidade fornece detalhes de candidatos usados para criar um trabalhador no Dynamics 365 Human Resources. Ela é usada para ler todos os registros de candidatos e criar registros de candidatos internos e externos, permitindo que você crie detalhes pessoais para o novo candidato.

Ao criar um registro de candidato externo que será um novo registro de pessoa no sistema, você não deve definir um número de participante (pessoa) que lance um novo registro de candidato. O novo registro de entidade de pessoa é criado com o novo registro de candidato.

Quando você criar um registro de candidato interno (um candidato ao cargo que já tem um registro de funcionário com a empresa), defina o número de participante (pessoa) do registro que já existe para a pessoa para a propriedade mshr_partynumber no registro de candidato, em vez de definir informações pessoais (como nome, sexo ou data de nascimento) que seriam usados para criar um novo registro de pessoa.

Representação JSON

        {
            "mshr_candidateid": "String",
            "mshr_partynumber": "String",
            "mshr_partytype": "String",
            "mshr_recruitingrequestid": "String",
            "mshr_positionid": "String",
            "mshr_firstname": "String",
            "mshr_middlename": "String",
            "mshr_lastnameprefix": "String",
            "mshr_lastname": "String",
            "mshr_gender": Int,
            "mshr_birthdate": "Date",
            "mshr_citizenshipcountrycode": "String",
            "mshr_veteranstatusid": "String",
            "mshr_isdisabledveteran": Int,
            "mshr_availabilitydate": "Date",
            "mshr_iswillingtorelocate": Int,
            "mshr_comments": "String",
            "mshr_applicantintegrationresult": Int,
            "mshr_donothirereasoncodeid": "String",
            "mshr_dataareaid": "String",
            "_mshr_dataareaid_id_value": "Guid",
            "_mshr_fk_person_id_value": "Guid",
            "_mshr_fk_recruitingrequest_id_value": "Guid",
            "_mshr_fk_position_id_value": "Guid",
            "mshr_hcmcandidatetohireentityid": "Guid",
            "_mshr_fk_veteranstatus_id_value": "Guid",
            "_mshr_fk_reasoncode_id_value": "Guid",
            "mshr_militaryserviceenddate": "Guid",
            "mshr_militaryservicestartdate": "Guid"
            "mshr_militaryserviceenddate": "Date",
            "mshr_militaryservicestartdate": "Date"
        }

Propriedades

Propriedade Nome físico Tipo	Usar	Descrição
ID da entidade de candidato a ser contratado mshr_hcmcandidatetohireentityid GUID	Somente leitura Obrigatório Gerado pelo sistema	Um identificador exclusivo gerado pelo sistema para o registro de entidade.
ID do Candidato mshr_candidateid Cadeia de caracteres	Somente leitura Obrigatório Gerado pelo sistema	Um identificador exclusivo para a entidade.
Número do participante mshr_partynumber Cadeia de caracteres	Somente leitura Obrigatório	O número do participante (pessoa) do registro da pessoa do candidato.
Valor da ID da pessoa _mshr_fk_person_id_value GUID	Somente leitura Obrigatório Chave estrangeira: mshr_dirpersonentityid de mshr_direpersonentity	O identificador exclusivo gerado pelo sistema para o registro de participante (pessoa) do candidato.
Tipo de participante mshr_partytype Conjunto de opções mshr_dirpartytype	Somente leitura Obrigatório	O tipo de participante do registro, conforme definido no conjunto de opções mshr_dirpartytype. Para essa entidade, o tipo será sempre "Pessoa".
ID da solicitação de recrutamento mshr_recruitingrequestid Cadeia de caracteres	Gravação única Opcional	Faz referência à solicitação de recrutamento que esse candidato preenche.
Valor da ID de solicitação de recrutamento _mshr_fk_recruitingrequest_id_value GUID	Ler/gravar Opcional Chave estrangeira: mshr_hcmrecruitingrequestentityid de mshr_hcmrecruitingrequestentity	O identificador exclusivo gerado pelo sistema da solicitação de recrutamento preenchida pelo candidato.
ID da posição mshr_positionid Cadeia de caracteres	Ler/gravar Opcional	A ID da posição para a qual o candidato está sendo considerado.
Valor de ID de posição _mshr_fk_position_if_value GUID	Somente leitura Opcional Chave estrangeira: mshr_hcmpositionv2entityid de mshr_hcmpositionv2entity	Identificador da posição gerada pelo sistema para a qual o candidato está sendo considerado.
Nome mshr_firstname Cadeia de caracteres	Ler/gravar Obrigatório	Nome do candidato.
Nome do Meio mshr_middlename Cadeia de caracteres	Ler/gravar Opcional	Nome do meio do candidato.
Prefixo do sobrenome mshr_lastnameprefix Cadeia de caracteres	Ler/gravar Opcional	Prefixo do sobrenome do candidato.
Sobrenome mshr_lastname Cadeia de caracteres	Ler/gravar Opcional	Sobrenome do candidato.
Sexo mshr_gender conjunto de opções mshr_hcmpersongender	Ler/gravar Opcional	O sexo do candidato.
Data de nascimento mshr_birthdate Datetime	Ler/gravar Opcional	A data de nascimento do candidato.
Código de país da cidadania mshr_citizenshipcountrycode Seqüência de caracteres	Ler/gravar Opcional	Especifica o país/região em que o candidato tem cidadania. Os códigos de país válidos estão em mshr_logisticaddresscountryregionentity.
ID de situação militar mshr_veteranstatusid Cadeia de caracteres	Ler/gravar Opcional	Indica a situação militar do candidato.
Valor de ID de situação militar _mshr_fk_veteranstatus_id_value GUID	Somente leitura Opcional Chave estrangeira: mshr_hcmveteranstatusentityid de mshr_hcmveteranstatusentity	Identificador exclusivo gerado pelo sistema para o registro de entidade de situação militar.
Data de início do serviço militar mshr_militaryservicestartdate Datetime	Ler/gravar Opcional	A data inicial do serviço militar do candidato.
Data de término do serviço militar mshr_militaryserviceenddate Datetime	Ler/gravar Opcional	A data final do serviço militar do candidato.
É Veterano Desabilitado mshr_isdisabledveteran conjunto de opções mshr_noyes	Ler/gravar Opcional	Indica se o candidato tem situação militar desabilitada.
Data de disponibilidade mshr_availabilitydate Datetime	Ler/gravar Opcional	A primeira data em que o candidato estará disponível para trabalhar.
Está disposto a ser realocado mshr_iswillingtorelocate conjunto de opções mshr_noyes	Ler/gravar Opcional	Indica se o candidato está disposto a ser realocado para a posição.
Comentários mshr_comments Cadeia de caracteres	Ler/gravar Opcional	Comentários a serem usados pelo recrutador ou gerente de contratação.
Resultado de integração de aplicativo mshr_applcantintegrationresult Conjunto de opções mshr_applicantintegrationresult	Ler/gravar Obrigatório	O status do candidato no processo de contratação relacionado à integração.
ID de código de motivo de não contratação mshr_donothirereasoncodeid Cadeia de caracteres	Ler/gravar Opcional	Um código de motivo opcionalmente fornecido quando o status (resultado da integração do aplicativo) é definido como "Não contratado".
Valor da ID do código de motivo _mshr_fk_reasoncode_id_value GUID	Somente leitura Opcional Chave estrangeira: mshr_hcmreasoncodeentityid da entidade mshr_hcmreasoncodeentity	Identificador exclusivo gerado pelo sistema para o código de motivo de Não contratação.
ID da área de dados mshr_dataareaid Cadeia de caracteres	Ler/gravar Opcional	Especifica a entidade legal (empresa).
Valor da ID da área de dados _mshr_dataareaid_id_value GUID	Somente leitura Opcional Chave estrangeira: cdm_companyid da entidade cdm_company	Valor GUID gerado pelo sistema identificando a entidade legal (empresa).

Consulte também

Introdução da API de integração do sistema de acompanhamento de candidatos
Exemplo de consulta de candidato a ser contratado