Salesforce

Rastrear documentos que estão armazenados no Salesforce.

IBM Cloud Pak for Data IBM Software Hub

Essas informações se aplicam apenas a implementações instaladas. Para obter mais informações sobre como se conectar ao Salesforce a partir de uma implantação gerenciada, consulte Salesforce.

Quais documentos são rastreados

  • Os artigos de conhecimento são rastreados somente se sua versão for publicada e seus idiomas forem en-us.
  • Somente os documentos compatíveis com o site Discovery são rastreados; todos os outros são ignorados. Para obter mais informações, consulte Tipos de arquivos suportados.
  • Quando uma fonte é rastreada novamente, novos documentos são adicionados, documentos atualizados são modificados para a versão atual e documentos excluídos são excluídos do índice da coleção durante a atualização.
  • Todos os Discovery conectores de fonte de dados são somente leitura. Independentemente das permissões concedidas à conta de rastreamento, Discovery nunca grava, atualiza ou exclui qualquer conteúdo na fonte de dados original.

Discovery pode rastrear os seguintes objetos:

  • Todos os objetos padrão e personalizados aos quais você tem acesso
  • Contas
  • Contatos
  • Casos
  • Contratos
  • Artigos de conhecimento
  • Anexos

Requisitos da origem de dados

Além dos requisitos da fonte de dados para todas as implantações instaladas, sua fonte de dados Salesforce deve atender aos seguintes requisitos:

  • A instância à qual você planeja se conectar deve fazer parte de um plano Enterprise ou superior.
  • Você deve obter as licenças de serviço necessárias para a fonte de dados à qual deseja se conectar. Para obter mais informações sobre licenças, entre em contato com o administrador do sistema da fonte de dados.

Para obter mais informações sobre o Salesforce, consulte a Salesforce.

Etapa de pré-requisito

Para rastrear documentos no Salesforce, o Discovery usa um arquivo WSDL (Web Service Description Language). O arquivo WSDL define um serviço da Web para gerar uma API que gerencia o acesso.

Se você planeja rastrear documentos de uma instância Sandbox e Production do Salesforce, deve estabelecer uma conexão com cada serviço da Web separadamente. Você deve baixar os arquivos JAR de cada serviço da Web e configurar coleções separadas.

Para obter informações sobre o download dos arquivos JAR WSDL, consulte os links a seguir:

  1. Faça download dos arquivos JAR a seguir:

    • force-partner.jar (do WSDL do parceiro)
    • force-metadata.jar (do WSDL dos metadados)
    • force-wsc.jar (do Web Service Connector (WSC) do Force.com)
    • commons-beanutils.jar (do Apache Commons BeanUtils)
  2. Comprima os arquivos JAR em um arquivo compactado. Você fará o upload do arquivo compactado para Discovery no próximo procedimento.

Conectando-se a uma fonte de dados Salesforce

Em seu projeto Discovery, conclua as seguintes etapas:

  1. No painel de navegação, escolha Gerenciar coleções.

  2. Clique em New collection (Nova coleção ).

  3. Clique em Salesforce e, em seguida, clique em Next.

  4. Dê um nome à coleção.

  5. Se o idioma dos documentos no Salesforce não for o inglês, selecione o idioma apropriado.

    Para obter uma lista de idiomas suportados, consulte Suporte ao idioma.

  6. Opcional: Alterar o cronograma de sincronização.

    Para obter mais informações, consulte Opções de agendamento de rastreamento.

  7. Na seção Especifique o que você deseja rastrear, insira valores nos seguintes campos:

    Nome do usuário
    O nome de usuário para chamar a API Salesforce.
    Senha
    A senha do usuário especificado.
    Token de segurança
    O token de segurança do usuário para chamar a API Salesforce.
    Arquivo zip de jarro
    Carregue um arquivo compactado que contenha os arquivos JAR que você baixou anteriormente. Ou selecione um arquivo compactado que você carregou anteriormente para reutilizá-lo.
  8. Opcional: expanda a seção Configurações de proxy para adicionar informações necessárias se estiver usando um servidor proxy para acessar o servidor da fonte de dados.

    • Ativar configurações de proxy: defina a chave como On e, em seguida, adicione as seguintes informações:

      Nome do usuário
      O nome de usuário do servidor proxy a ser usado para autenticação, se o servidor proxy exigir autenticação. Se você não souber o nome de usuário, poderá obtê-lo com o administrador do servidor proxy.
      Senha
      A senha do servidor proxy a ser usada para autenticação, se o servidor proxy exigir autenticação. Se você não souber sua senha, poderá obtê-la com o administrador do seu servidor proxy.
      Nome do host ou endereço IP do servidor proxy
      O nome do host ou o endereço IP do servidor proxy.
      Número da porta do servidor proxy
      A porta de rede à qual você deseja se conectar no servidor proxy.
  9. Na seção Tipos de objetos*, especifique os tipos de objetos a serem rastreados.

    O comportamento padrão é efetuar crawl de todos os tipos de objeto.

    • Para nomes de objetos customizados, anexe __c para corresponder à convenção da API do Salesforce para nomes de objetos customizados. Por exemplo, para rastrear MyCustomObject, especifique MyCustomObject__c.
    • Não especifique um objeto de comentário, como FeedComment, CaseComment, IdeaComment, sem especificar também o objeto raiz correspondente, como FeedItem, Case e Idea.
    • Se um objeto de tag for especificado, o pai dele também deverá ser. Por exemplo, não especifique o objeto AccountTag sem especificar também o objeto Account.
  10. Se quiser que o rastreador extraia texto de imagens no site, expanda Mais configurações de processamento e defina Aplicar reconhecimento óptico de caracteres (OCR) como On.

    Quando o OCR está ativado e seus documentos contêm imagens, o processamento demora mais. Para obter mais informações, consulte Reconhecimento óptico de caracteres.

  11. Clique em Finish.

A coleção é criada rapidamente. Leva mais tempo para os dados serem processados à medida que são adicionados à coleção.

Se quiser verificar o progresso, vá para a página Activity (Atividade). No painel de navegação, clique em Gerenciar coleções e, em seguida, clique para abrir a coleção.