Script de exemplo de integração de dados de terceiros

O script de tabela remota pode ser projetado para extrair registros de uma aplicação de terceiros. Este script é chamado quando é feita uma consulta para acessar dados na tabela remota.

Para usar uma tabela remota com o IntegrationHub, você precisa identificar o spoke do IntegrationHub que funciona com a aplicação de terceiros. O spoke consiste nas ações do Flow Designer que foram criadas para trazer vários subconjuntos dos dados dessa aplicação.

Por exemplo, se você precisar trazer informações de conta do aplicativo Salesforce, use o spoke do Salesforce e a ação Obter todas as contas. Veja abaixo um exemplo do script de tabela remota que acessa esta ação.

(function executeQuery(v_table, v_query) {
  try {
    // prepare inputs for the spoke actions 
    // Get All Accounts action does not have any inputs).
    var inputs = {};

    // call spoke action
    var outputs = sn_fd.FlowAPI.executeAction(
                                "sn_salesforce_spok.get_all_accounts", inputs);

    // check if Action was completed successfully
    if (outputs.status != "Success") {
      throw new Error(outputs.errorMessage);
    }

    // extract payload from the action outputs
    var accounts = outputs.accounts.data;

    // map action output data to the remote table columns and Sys Id
    for (var i = 0; i < accounts.length; i++) {
      v_table.addRow({
        "u_sf_account_id": accounts[i].name,
        "u_sf_account_name": accounts[i].label,
        // assign remote table Sys Id to the primary key of the third-party
        // record
        "sys_id": accounts[i].name,
      });
    }

  // process errors 
  } catch (error) {
     gs.addErrorMessage("Error trying to retrieve  Salesforce Accounts." +
                        "Please contact System Administrator.");
     gs.addErrorMessage("System Error: " + error.message);
  }

})(v_table, v_query);

Nota:

Nem todas as ações do IntegrationHub podem ser invocadas a partir dos scripts de tabela remota. Especificamente, as ações de fluxo de dados não podem ser chamadas a partir dos scripts. Se a ação que você deseja usar for uma Ação de fluxo de dados, talvez precise criar sua própria ação com base na etapa REST. Uma maneira fácil de criar uma ação é copiar uma ação existente e modificá-la para atingir seu objetivo. Você pode encontrar um exemplo de ações de spoke personalizadas neste tópico: Criar ações de spoke do Salesforce para recuperar oportunidades para uso na definição de tabela remota.