Usar a Heroku para executar aplicativos do Salesforce Canvas

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

  • Entender o processo de autenticação dos aplicativos do Canvas.
  • Entender como usar o Heroku para executar aplicativos do Salesforce Canvas.

Salesforce Canvas

Com o Salesforce Canvas, você pode inserir uma interface de usuário ou um aplicativo da web em execução na Heroku na interface de usuário do Salesforce. A principal vantagem do Canvas é a capacidade de usar várias tecnologias Web de código aberto para criar um aplicativo da web que se integra facilmente ao Salesforce. O SDK do Canvas é usado do JavaScript em um aplicativo da web para acessar dados do Salesforce aos quais o usuário tem acesso. Você pode desenvolver aplicativos do Canvas em seu computador local e usar fluxos de desenvolvedor comuns para alterar o gerenciamento e a implantação.

Nos bastidores, os aplicativos do Canvas são carregados no Salesforce por um iframe. É claro que você pode carregar qualquer aplicativo da web para uma interface de usuário do Salesforce por meio de iframe mas, com o Canvas, você pode usar um protocolo de comunicação segura por meio de JavaScript para se comunicar com o Salesforce. Quando você precisar de funções além das implantadas pela API JavaScript do Canvas, poderá combinar a autenticação sob responsabilidade do Canvas com as APIs REST do Salesforce, possivelmente com o uso de um wrapper da API REST como JSforce.

Diagrama mostrando que os aplicativos Heroku podem interagir com o Salesforce através de uma ponte Javascript do Canvas

Autenticação

Os aplicativos do Canvas usam um aplicativo conectado no Salesforce e podem usar uma solicitação assinada ou o fluxo OAuth típico para lidar com a autenticação. Uma vantagem de se usar o método de solicitação assinada é percebida quando um administrador do Salesforce permite que usuários acessem o aplicativo do Canvas e nenhuma autorização imediata é necessária para que o aplicativo faça solicitações ao Salesforce. Depois que o aplicativo do Canvas é carregado, ele pode começar a acessar dados do Salesforce aos quais o usuário tem acesso.

Durante a execução de um aplicativo do Canvas no Heroku, o aplicativo precisa do segredo do consumidor do aplicativo conectado, que é fornecido a este por uma variável de configuração do Heroku, disponibilizada para o aplicativo como variável de ambiente.

Aplicativo do Canvas básico

Um aplicativo do Canvas básico carrega a biblioteca JavaScript do SDK do Canvas:

<script type="text/javascript" src="https://.salesforce.com/canvas/sdk/js/36.0/canvas-all.js"></script>
<script type="text/javascript">
    // callback to access the OAuth access token and context object
    Sfdc.canvas(function() {
        // Save the token
        Sfdc.canvas.oauth.token(window.signedRequestJson.oauthToken);
        window.alert("hello, " + window.signedRequestJson.context.user.fullName);
    });
</script>

Os dados de contexto do aplicativo dependem de onde o aplicativo está sendo executado no Salesforce. Você pode carregar aplicativos do Canvas em feeds do Chatter, guias do Chatter, layouts, cartões de memória de celular, ações de editores e páginas do Visualforce. Cada uma fornece um contexto diferente ao aplicativo do Canvas. Por exemplo, se um aplicativo do Canvas é processado em um layout da página da conta, o contexto terá os dados da conta. O JavaScript no aplicativo do Canvas poderá, assim, usar esses dados para processar a informação.

Recursos

Continue a aprender de graça!
Inscreva-se em uma conta para continuar.
O que você ganha com isso?
  • Receba recomendações personalizadas para suas metas de carreira
  • Pratique suas habilidades com desafios práticos e testes
  • Monitore e compartilhe seu progresso com os empregadores
  • Conecte-se a orientação e oportunidades de carreira