Guia do Usuário Cancelar

Guia de instalação do Cloud Foundry para o Adobe Sign for SAP SuccessFactors

Visão geral

O guia de instalação do Cloud Foundry para o Adobe Sign for SAP SuccessFactors explica como integrar o Adobe Sign ao SAP SuccessFactors. O SAP Success Factors é um software de gerenciamento de capital humano e um pacote de gerenciamento de talentos baseado em nuvem.

A integração Adobe Sign for SuccessFactors amplia as funcionalidades do Adobe Sign no SuccessFactors por meio do ambiente do Cloud Foundry do SAP BTP. Isso inclui uma integração de gerenciamento de recrutamentos (RCM) que permite que os usuários enviem cartas de oferta a um mesmo destinatário usando o SuccessFactors. Os documentos assinados são armazenados no perfil do(a) candidato(a), e a assinatura é feita por meio de notificações por email.

Para instalar e usar o Adobe Sign for SAP SuccessFactors por meio do ambiente SAP BTP do Cloud Foundry, você precisa realizar as seguintes etapas:

Saiba como solucionar problemas comuns na instalação do Adobe Sign SAP SuccessFactor.

Registrar e configurar o seu sistema do SAP SuccessFactors

Para registrar e configurar o sistema do SAP SuccessFactors, você precisa realizar as seguintes etapas:

Implantar o aplicativo Adobe Sign for SuccessFactors

Quando terminar de configurar o Adobe Sign for SAP SuccessFactors, é necessário implantar o aplicativo Adobe Sign. Siga as etapas abaixo para implantar o aplicativo:

  1. Baixe o arquivo de implantação e extraia o conteúdo para uma pasta local.

  2. Use qualquer editor para editar o arquivo manifest.yml e substitua <company> pelo nome da sua empresa e <api> pelos detalhes da API encontrados no cockpit.

    Detalhes do arquivo de exemplo:

    <company> = 10384

    <api> =  eu10.hana.ondemand.com

    applications = # AdobeSign application

    name = AdobeSign--10384

    memory = 1024M

    timeout = 300

    routes = route: adobesign10384.cfapps.eu10.hana.ondemand.com

    cloud-foundry-env

  3. Verifique se os serviços a seguir estão sendo usados para o #AdobeSign application:

    - sap_hcmcloud_core_odata

    - xsuaa

    - destination

    - connectivity

    Observação:

    Se o banco de dados do HANA for criado para manter as credenciais do usuário, remova o “#” para habilitar o serviço “hana_adobe” no arquivo manifest.yml.

  4. Certifique-se de que apenas o serviço xsuaa é usado em #Application Router:

    - xsuaa

  5. Habilite os seguintes parâmetros removendo o “#” do início da linha no arquivo manifest.yml:

    • SF_OPERATOR_AS_APPROVER: esse parâmetro mapeia o “nome da propriedade” do tipo “JobRequisitionOperator” disponível na entidade de requisição de trabalho para o fluxo de trabalho do aprovador. O endereço de email do aprovador é preenchido automaticamente com sua função na seção Destinatários da página Composição de assinatura (Enviar).
    • SF_OPERATOR_AS_CC: esse parâmetro mapeia o “nome da propriedade” do tipo “JobRequisitionOperator” disponível na entidade de requisição de trabalho para o fluxo de trabalho de CC. O endereço de email do operador especificado é preenchido automaticamente no campo CC da página Composição de assinatura (Enviar), garantindo que receba uma notificação quando a carta de oferta for enviada ao candidato.
    • JOB_APP_STATUS_LABEL_FOR_OFFER_REJECTED: esse parâmetro atualiza automaticamente o status de candidatura de emprego diferente do valor padrão “Oferta recusada” quando o candidato rejeita a carta de oferta.

    Valores de parâmetro de amostra:

    • SF_OPERATOR_AS_APPROVER: fornecedor
    • SF_OPERATOR_AS_CC: hiringManager
    • JOB_APP_STATUS_LABEL_FOR_OFFER_REJECTED: oferta recusada
    Observação:

    Consulte Guia do Recrutamento do Adobe Sign for SAP SuccessFactors para saber mais sobre o uso desses parâmetros.

    Habilite os seguintes parâmetros no arquivo manifest.yml para implantar o pacote do Acrobat Sign for SuccessFactors.

  6. Salve o arquivo manifest.yml na mesma pasta.

    Ele será usado posteriormente na implantação.

  7. Baixe e instale a interface de linha de comando do Cloud Foundry da seguinte maneira:

    1. Acesse as ferramentas de desenvolvimento do SAP.
    2. Em Interface da linha de comando do SAP BTP (btp CLI), baixe o arquivo Interface de linha de comando do BTP para o seu sistema operacional.
    install-sap-btp-command-line-interface

  8. Abra o console do Cloud Foundry e conecte-se à conta do BTP da seguinte maneira:

    1. Execute cf api <api name>localize o valor <api name> no cockpit.
    2. Execute cf login para autenticar-se na subconta.
    cf-login

  9. Execute cf push -f <PATH_TO_APP_MANIFEST> para implantar o aplicativo.

    execute-cf-push

Quando a implantação for concluída, verifique no cockpit se os dois aplicativos a seguir estão em execução:

  • Ponto de acesso do aplicativo Adobe Sign: é usado para configurar o bloco e os modelos do SAP SuccessFactors.
  • Ponto de acesso do roteador do aplicativo Adobe Sign: é usado para obter o botão do modelo do SAP SuccessFactors.
space-dev-applications

Observação:

Para criar ou atualizar um parâmetro no arquivo manifest.yml após implantar o pacote do Acrobat Sign for SuccessFactors v3.0.0, acesse Variáveis fornecidas pelo usuário e selecione Editar para modificar o valor do parâmetro ou escolha Criar variável para adicionar um parâmetro. Depois de concluído, reinicie o aplicativo.

Caixa de diálogo do aplicativo com acesso às variáveis fornecidas pelo usuário

Provisionamento do SuccessFactors

Adicionar um campo para armazenar cartas de oferta assinadas

Para adicionar um novo campo à página “Recrutador” (página “Candidatura a emprego”) a fim de armazenar a carta de oferta assinada, siga estas etapas: 

  1. Abra o aplicativo de provisionamento e baixe o Modelo de candidatura e requisição de emprego.

    add-field

  2. Para exibir um novo campo no formulário, adicione uma nova definição de campo no modelo de candidatura Requisição.

    <field-definition id="adobeSignAttachment" type="multiattachment" required="false" custom="true" public="false" readOnly="false" anonymize="false" forward-intact="false" sensitive="false"> 

     <field-label mime-type="text-plain"><![CDATA[Adobe Offer Signed]]></field-label> 

    <field-description><![CDATA[Adobe Offer Signed]]></field-description> 

    </field-definition>

  3. Adicione permissões de campo com base no método de implementação de um ou vários estágios.
    Veja a seguir um exemplo de permissões para implementação em um estágio.

    provisioning-add-field-permission

  4. Faça upload dos modelos em “Provisionamento” e verifique as alterações feitas. 

  5. Texto de etapa

Adicionar um botão para salvar as cartas de oferta

Para adicionar um botão para salvar as cartas de oferta na página “Recrutador”, siga as etapas abaixo:

  1. Abra o aplicativo de provisionamento e exporte o pacote de idiomas.

    Consulte este exemplo de arquivo de origem do aplicativo de provisionamento.

    export-lang

  2. Selecione seu idioma e clique em Baixar rótulos padrão.

    Isso baixará um arquivo CSV que deve ser configurado, conforme mostrado abaixo.

    add-button-1

  3. Importe o pacote de idiomas atualizado (.csv) para o provisionamento.

    Consulte este exemplo de arquivo de pacote de idiomas a ser enviado para provisionamento.

    add-button-2

Criar campo para carta de oferta no perfil do(a) candidato(a)

  1. Modifique o XML “Modelo de perfil de candidato(a)” adicionando as seguintes linhas:

    Definição de campo:

    <field-definition sensitive="false" anonymize="false" custom="true" required="false" type="text" id="cust_offerLetter">

    <field-label mime-type="text-plain"><![CDATA[Documents ]]></field-label>

    <field-label lang="pt_BR" mime-type="text-plain"><![CDATA[Offer Letter]]></field-label>

    <field-label lang="pt_BR" mime-type="text-plain"><![CDATA[Offer Letter]]></field-label>

    <field-description><![CDATA[Offer Letter ]]></field-description>

    <field-description lang="pt_BR"><![CDATA[Offer Letter]]></field-description>

    <field-description lang="pt_BR"><![CDATA[Offer Letter]]></field-description>

    </field-definition>

    Permissões do campo:

    <field-permission type="read"><role-name><![CDATA[Candidate]]>

    </role-name><country><![CDATA[*]]></country><source><![CDATA[Internal]]></source>

    <field refid="cust_offerLetter"/>

    (…)

  2. Configure o campo personalizado para relatório seguindo estas etapas:

    1. Navegue até Provisionamento > Configurar campos personalizados para relatório.
    2. Insira os campos personalizados definidos no arquivo XML.
    3. Selecione Salvar mapeamento de campos estendidos.
    4. Selecione Sincronizar dados existentes.                                                                                                                    

    Se você tiver adicionado ou alterado os campos personalizados de relatórios de candidato, essa opção atualizará todos os dados para relatório.

Modificar o modelo de carta de oferta

Para modificar o modelo de carta de oferta:

  1. Faça logon no SAP SuccessFactors com as suas credenciais de admin.

    offer-letter-admin-center

  2. Acesse Centro de administração > Recrutamento. 

    manage-offer-letter-templates

  3. Selecione Gerenciar modelos de carta de oferta.

  4. Na página exibida, selecione um modelo de carta de oferta relevante e clique em Editar.

  5. Na barra de ferramentas superior, selecione o ícone de imagem para adicionar uma nova imagem.

    toolbar-edit

  6. Para configurar as Propriedades da imagem, selecione a guia Informações da imagem e insira os seguintes detalhes:

    • Defina o valor Largura  como 100%
    • Defina o valor Altura como 117
    • Defina o URL como o URL da imagem específico da conta
    Saiba como determinar o URL de imagem específico de sua conta

  7. Selecione a guia Link e insira o URL do link específico da conta no campo URL. Em seguida, defina o menu suspenso Destino como Mesma janela(_self).

    Propriedades da imagem

Adicionar o bloco de administração do SuccessFactors

Para adicionar um bloco de admin do Adobe Sign ao SAP SuccessFactors:

  1. Faça logon no SAP SuccessFactors com as suas credenciais de admin.

  2. Selecione Gerenciar página inicial > Adicionar bloco personalizado.

    add-custom-tile

  3. Na caixa de diálogo exibida, defina as propriedades do bloco da seguinte maneira:

    • Geral:
      • Nome do bloco: AdobeSign
      • Descrição: texto livre
    • Bloco:
      • Tipo: estático
      • Bloco: Adobe Sign
      • Ícone: sap-icon://account (Você pode selecionar qualquer outro ícone adequado, conforme desejado.)
    • Navegação:
      • Destino: URL
      • Abrir link em uma nova janela/guia - Selecionado.
      • URL: adicione o link de URL para o aplicativo Java, conforme gerado a partir do roteador do aplicativo do SAP BTP no seguinte formato:
        https://***.cfapps.***.hana.ondemand.com/AdobeAdminRecruiting
      • Exemplo de URL: https://adobesignWeb10384.cfapps.eu10.hana.ondemand.com/AdobeAdminRecruiting
    • Atribuições:
      • Você deve configurar as seções da sua instância para os grupos de usuários relevantes configurados no conceito de RBP.

Verifique o conjunto de permissões OData dos usuários de recrutamento e de API especificados no destino de autenticação básica do SAP

Verifique se as permissões de recrutamento do OData a seguir estão atribuídas aos usuários de recrutamento e de API especificados no destino de autenticação básica do SAP. Se não fornecido, conceda as seguintes permissões de recrutamento do OData.

Verificar a permissão do Odata

Conectar-se ao Acrobat Sign

Depois que o bloco Admin estiver configurado, o grupo Adobe Acrobat Sign ou os administradores de conta deverão conectar o SAP SuccessFactors ao Adobe Acrobat Sign seguindo estas etapas:

  1. Faça logon na instância SAP SuccessFactors.

  2. Navegue até Página inicial e selecione o bloco Adobe Sign.

    Conectar o SAP SuccessFactors ao Adobe Acrobat Sign

  3. Na página de logon, forneça o email e a senha do administrador da conta e selecione Fazer logon.

    Conectar o SAP SuccessFactors ao Adobe Acrobat Sign

  4. Na caixa de diálogo de permissões, selecione Permitir acesso para conceder as permissões e estabelecer a conexão.

    Conectar o SAP SuccessFactors ao Adobe Acrobat Sign

    Assim que a conexão for estabelecida, uma mensagem de confirmação será exibida.

    Conectar o SAP SuccessFactors ao Adobe Acrobat Sign

Alterar status de candidatura a emprego (opcional)

Você pode adicionar um novo status, “Oferta Aceita” no processo de Candidatura a emprego usando as seguintes etapas:

  1. Acesse Configuração do status de candidato no provisionamento > Editar base.

  2. Na caixa de diálogo exibida:

    • Defina o Tipo como Em andamento.
    • Insira o Nome do status como Oferta Aceita.

    O status Novo estará disponível para adição a qualquer um dos conjuntos de status disponíveis para a instância.

    Acrobat Sign for SAP SuccessFactors: alteração do status de candidatura de emprego

  3. Acesse Provisionamento > Configuração de status do candidato > Adicionar novo.

    O conjunto de status recém-criado é preenchido com os status do sistema, e você pode adicionar outros status da base ao pipeline.

    Acrobat Sign for SAP SuccessFactors: alteração do status de candidatura de emprego

  4. Para usar o status em seu processo de recrutamento, navegue até Editar configuração de status do candidato e edite o Conjunto de status marcado como “Padrão”.

    Acrobat Sign for SAP SuccessFactors: alteração do status de candidatura de emprego

  5. Selecione Adicionar novo e, na lista de opções, selecione o status como Oferta aceita e defina todas as opções necessárias.

    Acrobat Sign for SAP SuccessFactors: alteração do status de candidatura de emprego

    Acrobat Sign for SAP SuccessFactors: alteração do status de candidatura de emprego

    Acrobat Sign for SAP SuccessFactors: alteração do status de candidatura de emprego

Solução de problemas

Veja abaixo alguns problemas comuns que podem surgir durante a configuração e o uso do Acrobat Sign for SAP SuccessFactors:  

Erro de conexão ao selecionar o bloco do administrador do Adobe Sign: Você precisa ser um assinante pago do Adobe Sign para usar essa integração com o SuccessFactors

Este problema poderá surgir para usuários que não possuem acesso de administrador de conta ou grupo ao Adobe Sign. Verifique se o usuário usado para estabelecer a conexão entre o Adobe Sign e o SAP SuccessFactors por meio do bloco de administração do Adobe Sign é um(a) admin de conta/grupo no Adobe Sign.

Interface de solução de problemas do Adobe Sign

Erro na carta de oferta ao selecionar Enviar usando o Adobe Sign: Conecte-se ao Adobe Sign!

Esse erro ocorre quando não é possível estabelecer a conexão entre o SuccessFactors e o Adobe Sign. Faça logon no bloco de administração do Adobe Sign com as credenciais de admin de conta/grupo para criar a conexão com o Adobe Sign antes de enviar a carta de oferta para o candidato.

Erro ao selecionar o bloco de administrador do Adobe Sign: O redirect_uri tem um domínio inválido

Para corrigir o erro de domínio inválido, siga estas etapas:

  1. No cockpit, navegue até a subconta e selecione Serviços > Instâncias e assinaturas.

  2. Em Instâncias, clique no ícone Serviço de gerenciamento de autorizações e confiança e selecione Atualizar.

  3. Na seção Parâmetros, faça upload do seguinte JSON e substitua <router-App-url> pelo link específico para o aplicativo Java gerado pelo roteador de aplicativos do SAP BTP.

    Por exemplo, se o URL do aplicativo de roteamento for este: https://adobesignWeb10384.cfapps.eu10.hana.ondemand.com                   

    O par de chave-valor “redirect-uris” no JSON a seguir deve ser: "redirect-uris": ["https://adobesignWeb10384.cfapps.eu10.hana.ondemand.com/**"]

    Modelo JSON:
    {

    "xsappname": "extension-app",

    "tenant-mode": "dedicated",

    "oauth2-configuration": {

    "redirect-uris": [

    "<<router-App-url>>/**"

    ]

    }

    }

  4. Selecione Atualizar instância.

Receba ajuda com mais rapidez e facilidade

Novo usuário?