Argomento precedente: Aggiunta di un filtro CORSArgomento successivo: Implementazione delle policy


Chiamata del servlet CAFedSearch tramite REST

Il servlet CAFedSearch presenta un'interfaccia RESTful che consente di inviare le richieste di ricerca tramite client di ricerca personalizzati, programmi e interfacce utente.

Questa interfaccia RESTful accetta solo le richieste HTTP Collection GET che seguono la specifica di OpenSearch. Sono supportate le risposte JSON e XML. Ogni richiesta deve contenere un token BOPSID di Service Desk che è possibile ottenere dai servizi Web SOAP o RESTful di CA SDM.

Procedere come descritto di seguito:

  1. Acquisire un token BOPSID mediante servizi Web RESTful di CA SDM.
  2. Acquisire una chiave di accesso REST inviando una richiesta HTTP POST sulla risorsa rest_access con le credenziali di accesso.

    Inoltre, è possibile ottenere un token BOPSID con la chiave di accesso REST inviando una richiesta HTTP POST sulla risorsa bopsid.

  3. Per informazioni sull'invio delle richieste ai servizi Web RESTful di CA SDM, consultare i file di esempio nella seguente directory di CA SDM:
    NX_ROOT\samples\sdk\rest\java
    
  4. Per utilizzare l'API di ricerca federata per eseguire una ricerca, inviare una richiesta HTTP GET sulla risorsa di ricerca, trasferire i criteri di ricerca e il token BOPSID tramite l'URL di CA SDM.
    GET 
    
    http://<sdmhostname>:<FS_TOMCAT_PORT>/cafedsearch/sdm/search?q=<searchTerms>&source=<adapterName>&BOPSID=<bopsidToken>&userid=<userId>
    
    searchTerms

    Specifica un elenco di parole chiave delimitato da spazi. Deve essere codificato con URL.

    adapterName

    Specifica il nome del motore di ricerca indicato nel campo Codice origine di ricerca del record mediante l'utilità di configurazione degli adapter.

    Altri argomenti supportati sono i seguenti:

    index

    Specifica il primo indice desiderato nei risultati di ricerca. Deve essere un numero intero maggiore o uguale a 1.

    page

    Specifica la prima pagina desiderata nei risultati di ricerca. Deve essere un numero intero maggiore o uguale a 1.

    size

    Specifica il numero di risultati per pagina desiderati dal client di ricerca.

    type

    I valori validi: JSON o XML.