Salesforce

Esegue il crawling dei documenti archiviati in Salesforce.

IBM Cloud Pak for Data IBM Software Hub

Queste informazioni si applicano solo alle distribuzioni installate. Per ulteriori informazioni sulla connessione a Salesforce da un'installazione gestita, vedere Salesforce.

Quali documenti vengono carrellati

  • Gli articoli di Knowledge vengono indicizzati solo se la loro versione è pubblicata e la loro lingua è en-us.
  • Vengono sottoposti a scansione solo i documenti supportati da Discovery ; tutti gli altri vengono ignorati. Per ulteriori informazioni, vedere Tipi di file supportati.
  • Quando una fonte viene ricaricata, i nuovi documenti vengono aggiunti, i documenti aggiornati vengono modificati nella versione corrente e i documenti eliminati vengono eliminati dall'indice della raccolta durante l'aggiornamento.
  • Tutti i connettori dell'origine dati Discovery sono di sola lettura. Indipendentemente dalle autorizzazioni concesse all'account di crawl, Discovery non scrive, aggiorna o cancella mai alcun contenuto nell'origine dati originale.

Discovery può eseguire il crawling dei seguenti oggetti:

  • Tutti gli oggetti predefiniti e personalizzati ai quali si ha accesso
  • Account
  • Contatti
  • Casi
  • Contratti
  • Articoli di conoscenza
  • Allegati

Requisiti dell'origine dati

Oltre ai requisiti della sorgente dati per tutte le distribuzioni installate, la sorgente dati Salesforce deve soddisfare i seguenti requisiti:

  • L'istanza a cui si intende collegarsi deve far parte di un piano Enterprise o superiore.
  • È necessario ottenere le licenze di servizio necessarie per l'origine dati a cui ci si vuole collegare. Per ulteriori informazioni sulle licenze, contattare l'amministratore di sistema dell'origine dati.

Per ulteriori informazioni su Salesforce, consultare la documentazione per gli sviluppatori di Salesforce.

Fase preliminare

Per effettuare il crawling dei documenti in Salesforce, Discovery utilizza un file Web Service Description Language (WSDL). Il file WSDL definisce un servizio Web per generare un'API che gestisce l'accesso.

Se si intende eseguire il crawling di documenti sia da un'istanza Sandbox che da un'istanza Production di Salesforce, è necessario stabilire una connessione a ciascun servizio web separatamente. È necessario scaricare i file JAR da ciascun servizio Web e impostare raccolte separate.

Per informazioni sul download dei file JAR WSDL, consultare i seguenti link:

  1. Scarica i seguenti file JAR:

    • force-partner.jar (da WSDL partner)
    • force-metadata.jar (da WSDL metadati)
    • force-wsc.jar (da Web Service Connector (WSC) Force.com)
    • commons-beanutils.jar (da Apache Commons BeanUtils)

  2. Comprimere i file JAR in un file compresso. Il file compresso verrà caricato su Discovery nella procedura successiva.

Connessione a una fonte di dati Salesforce

Dal progetto Discovery, completare i seguenti passaggi:

  1. Nel riquadro di navigazione, scegliere Gestione collezioni.

  2. Fare clic su Nuova raccolta.

  3. Fare clic su Salesforce, quindi fare clic su Avanti.

  4. Dare un nome alla collezione.

  5. Se la lingua dei documenti in Salesforce non è l'inglese, selezionare la lingua appropriata.

    Per un elenco delle lingue supportate, vedi Supporto linguistico.

  6. Opzionale: Modificare la pianificazione della sincronizzazione.

    Per ulteriori informazioni, vedere Opzioni di pianificazione delrawl.

  7. Nella sezione Specificare ciò che si vuole cercare, inserire i valori nei seguenti campi:

    Nome utente
    Il nome utente per chiamare l'API dell' Salesforce.
    Password
    La password dell'utente specificato.
    Token di sicurezza
    Il token di sicurezza dell'utente per chiamare l'API Salesforce.
    File archivio zip Jar
    Caricare un file compresso contenente i file JAR scaricati in precedenza. Oppure selezionare un file compresso caricato in precedenza per riutilizzarlo.

  8. Opzionale: espandere la sezione Impostazioni proxy per aggiungere le informazioni necessarie se si utilizza un server proxy per accedere al server di origine dati.

    • Abilita impostazioni proxy: impostare l'interruttore su On, quindi aggiungere le seguenti informazioni:

      Nome utente
      Il nome utente del server proxy da utilizzare per l'autenticazione, se il server proxy richiede l'autenticazione. Se non si conosce il nome utente, è possibile ottenerlo dall'amministratore del server proxy.
      Password
      La password del server proxy da utilizzare per l'autenticazione, se il server proxy richiede l'autenticazione. Se non si conosce la password, la si può ottenere dall'amministratore del server proxy.
      Nome host o indirizzo IP del server proxy
      Il nome host o l'indirizzo IP del server proxy.
      Numero porta del server proxy
      La porta di rete a cui si desidera connettersi sul server proxy.

  9. Nella sezione Tipi di oggetto*, specificare i tipi di oggetto da strisciare.

    La modalità di funzionamento predefinita prevede la ricerca per indicizzazione di tutti i tipi di oggetto.

    • Per i nomi oggetto personalizzati, accoda __c per una corrispondenza alla convenzione API Salesforce per i nomi oggetto personalizzati. Ad esempio, per strisciare MyCustomObject, specificare MyCustomObject__c.
    • Non specificare un oggetto commento, come FeedComment, CaseComment, IdeaComment, senza specificare anche l'oggetto radice corrispondente, come FeedItem, Case e Idea.
    • Se specifichi un oggetto tag, devi anche specificarne l'elemento parent. Ad esempio, non specificare l'oggetto " AccountTag " senza specificare anche l'oggetto " Account ".

  10. Se si desidera che il crawler estragga il testo dalle immagini del sito, espandere Altre impostazioni di elaborazione e impostare Applica il riconoscimento ottico dei caratteri (OCR) su On.

    Quando l'OCR è abilitato e i documenti contengono immagini, l'elaborazione richiede più tempo. Per ulteriori informazioni, vedere Riconoscimento ottico dei caratteri.

  11. Fai clic su Finish.

La collezione viene creata rapidamente. L'elaborazione dei dati richiede più tempo per l'aggiunta alla raccolta.

Se si desidera controllare i progressi, andare alla pagina Attività. Nel riquadro di navigazione, fare clic su Gestione raccolte, quindi fare clic per aprire la raccolta.