info:
  name: Recupero delle anagrafiche presenti a sistema
  type: http
  seq: 1
  tags:
    - persone

http:
  method: GET
  url: "{{baseUrl}}/persone"
  params:
    - name: cognome
      value: ""
      type: query
      description: cognome dell'utente (se viene utilizzato il carattere * viene applicato il like)
      disabled: true
    - name: nome
      value: ""
      type: query
      description: nome dell'utente (se viene utilizzato il carattere * viene applicato il like)
      disabled: true
    - name: codFis
      value: ""
      type: query
      description: codice fiscale dell'utente
      disabled: true
    - name: daDataMod
      value: ""
      type: query
      description: data di ultima modifica, verranno recuperati tutti i record inseriti con data di ultima modifica successiva a questa data
      disabled: true
    - name: daOraMod
      value: ""
      type: query
      description: ora, minuti e secondi dell'ultima modifica (HH:MI:SS), verranno recuperati tutti i record inseriti con orario di ultima modifica successivo a questo orario in data daDataMod. Se i secondi verranno omessi saranno impostati automaticamente a 00.
      disabled: true
    - name: persId
      value: ""
      type: query
      description: identificativo della persona
      disabled: true
    - name: identificativo U-Gov
      value: ""
      type: query
      description: identificativo di U-Gov che permette di ritirare le informazioni dei responsabili.
      disabled: true
    - name: start
      value: ""
      type: query
      description: |
        utilizzato insieme a `limit` per indicare la paginazione sui record; `start` indica il numero del primo record da caricare (se non indicato viene utilizzato 0)
      disabled: true
    - name: limit
      value: ""
      type: query
      description: |
        utilizzato insieme a `start` per indicare la paginazione sui record, `limit` indica il numero di record da recuperare (a partire da `start`); 
        se non indicato viene utilizzato 50, i valori consentiti vanno da 0 a 100
      disabled: true
    - name: order
      value: ""
      type: query
      description: |
        consente di specificare un ordine per il recupero dei record. La sintassi è la seguente
         * +/- : specifica l'ordinamento (+ = ASC, - = DESC); se omesso viene utilizzato +
         * field : nome del campo da ordinare
         
         E' possibile indicare più campi separandoli da virgola (Es: +annoCorso,+adCod) 
      disabled: true
    - name: optionalFields
      value: ""
      type: query
      description: |
        specifica la lista dei campi opzionali (che non vengono recupeati di default);
        impostando il valore `ALL` vengono mostrati tutti i campi. 

        Per gli oggetti è possibile utilizzare la notazione *Ant Glob Patterns*  
        I dettagli sono presenti [qui](https://wiki.u-gov.it/confluence/display/ESSE3/Servizi+REST+su+ESSE3#ServiziRESTsuESSE3-Filtrosuicampidelleclassidimodello)

        Esempi
        * per il campo childObj con la poprietà childProp utilizzare la notazione `childProp.prop1`
        * Per visualizzare tutte le proprietà di childObj utilizzare la notazione `childProp.*`
        * Per visualizzare tutte le proprietà di childObj e di tutti i discendenti utilizzare la notazione `childProp.**`
      disabled: true
  auth: inherit

settings:
  encodeUrl: true
  timeout: 0
  followRedirects: true
  maxRedirects: 5
  forwardAuthorizationHeader: true

examples:
  - name: 200 Response
    description: Successful response
    request:
      url: "{{baseUrl}}/persone"
      method: GET
      params:
        - name: cognome
          value: ""
          type: query
          description: cognome dell'utente (se viene utilizzato il carattere * viene applicato il like)
          disabled: true
        - name: nome
          value: ""
          type: query
          description: nome dell'utente (se viene utilizzato il carattere * viene applicato il like)
          disabled: true
        - name: codFis
          value: ""
          type: query
          description: codice fiscale dell'utente
          disabled: true
        - name: daDataMod
          value: ""
          type: query
          description: data di ultima modifica, verranno recuperati tutti i record inseriti con data di ultima modifica successiva a questa data
          disabled: true
        - name: daOraMod
          value: ""
          type: query
          description: ora, minuti e secondi dell'ultima modifica (HH:MI:SS), verranno recuperati tutti i record inseriti con orario di ultima modifica successivo a questo orario in data daDataMod. Se i secondi verranno omessi saranno impostati automaticamente a 00.
          disabled: true
        - name: persId
          value: ""
          type: query
          description: identificativo della persona
          disabled: true
        - name: identificativo U-Gov
          value: ""
          type: query
          description: identificativo di U-Gov che permette di ritirare le informazioni dei responsabili.
          disabled: true
        - name: start
          value: ""
          type: query
          description: |
            utilizzato insieme a `limit` per indicare la paginazione sui record; `start` indica il numero del primo record da caricare (se non indicato viene utilizzato 0)
          disabled: true
        - name: limit
          value: ""
          type: query
          description: |
            utilizzato insieme a `start` per indicare la paginazione sui record, `limit` indica il numero di record da recuperare (a partire da `start`); 
            se non indicato viene utilizzato 50, i valori consentiti vanno da 0 a 100
          disabled: true
        - name: order
          value: ""
          type: query
          description: |
            consente di specificare un ordine per il recupero dei record. La sintassi è la seguente
             * +/- : specifica l'ordinamento (+ = ASC, - = DESC); se omesso viene utilizzato +
             * field : nome del campo da ordinare
             
             E' possibile indicare più campi separandoli da virgola (Es: +annoCorso,+adCod) 
          disabled: true
        - name: optionalFields
          value: ""
          type: query
          description: |
            specifica la lista dei campi opzionali (che non vengono recupeati di default);
            impostando il valore `ALL` vengono mostrati tutti i campi. 

            Per gli oggetti è possibile utilizzare la notazione *Ant Glob Patterns*  
            I dettagli sono presenti [qui](https://wiki.u-gov.it/confluence/display/ESSE3/Servizi+REST+su+ESSE3#ServiziRESTsuESSE3-Filtrosuicampidelleclassidimodello)

            Esempi
            * per il campo childObj con la poprietà childProp utilizzare la notazione `childProp.prop1`
            * Per visualizzare tutte le proprietà di childObj utilizzare la notazione `childProp.*`
            * Per visualizzare tutte le proprietà di childObj e di tutti i discendenti utilizzare la notazione `childProp.**`
          disabled: true
    response:
      status: 200
      statusText: OK
      body:
        type: text
        data: ""
  - name: 422 Response
    description: parametri Errati
    request:
      url: "{{baseUrl}}/persone"
      method: GET
      params:
        - name: cognome
          value: ""
          type: query
          description: cognome dell'utente (se viene utilizzato il carattere * viene applicato il like)
          disabled: true
        - name: nome
          value: ""
          type: query
          description: nome dell'utente (se viene utilizzato il carattere * viene applicato il like)
          disabled: true
        - name: codFis
          value: ""
          type: query
          description: codice fiscale dell'utente
          disabled: true
        - name: daDataMod
          value: ""
          type: query
          description: data di ultima modifica, verranno recuperati tutti i record inseriti con data di ultima modifica successiva a questa data
          disabled: true
        - name: daOraMod
          value: ""
          type: query
          description: ora, minuti e secondi dell'ultima modifica (HH:MI:SS), verranno recuperati tutti i record inseriti con orario di ultima modifica successivo a questo orario in data daDataMod. Se i secondi verranno omessi saranno impostati automaticamente a 00.
          disabled: true
        - name: persId
          value: ""
          type: query
          description: identificativo della persona
          disabled: true
        - name: identificativo U-Gov
          value: ""
          type: query
          description: identificativo di U-Gov che permette di ritirare le informazioni dei responsabili.
          disabled: true
        - name: start
          value: ""
          type: query
          description: |
            utilizzato insieme a `limit` per indicare la paginazione sui record; `start` indica il numero del primo record da caricare (se non indicato viene utilizzato 0)
          disabled: true
        - name: limit
          value: ""
          type: query
          description: |
            utilizzato insieme a `start` per indicare la paginazione sui record, `limit` indica il numero di record da recuperare (a partire da `start`); 
            se non indicato viene utilizzato 50, i valori consentiti vanno da 0 a 100
          disabled: true
        - name: order
          value: ""
          type: query
          description: |
            consente di specificare un ordine per il recupero dei record. La sintassi è la seguente
             * +/- : specifica l'ordinamento (+ = ASC, - = DESC); se omesso viene utilizzato +
             * field : nome del campo da ordinare
             
             E' possibile indicare più campi separandoli da virgola (Es: +annoCorso,+adCod) 
          disabled: true
        - name: optionalFields
          value: ""
          type: query
          description: |
            specifica la lista dei campi opzionali (che non vengono recupeati di default);
            impostando il valore `ALL` vengono mostrati tutti i campi. 

            Per gli oggetti è possibile utilizzare la notazione *Ant Glob Patterns*  
            I dettagli sono presenti [qui](https://wiki.u-gov.it/confluence/display/ESSE3/Servizi+REST+su+ESSE3#ServiziRESTsuESSE3-Filtrosuicampidelleclassidimodello)

            Esempi
            * per il campo childObj con la poprietà childProp utilizzare la notazione `childProp.prop1`
            * Per visualizzare tutte le proprietà di childObj utilizzare la notazione `childProp.*`
            * Per visualizzare tutte le proprietà di childObj e di tutti i discendenti utilizzare la notazione `childProp.**`
          disabled: true
    response:
      status: 422
      statusText: Unprocessable Entity
      body:
        type: text
        data: ""

docs: |
  <span class="e3rest-operation-auth-img-list"><img src="basic.png"/><img src="jwt.png"/></span>Recupera la lista degli oggetti 'Persona'. I parametri ozionali **start** e **limit** consentono di paginare i risultati. E'' possibile filtrare le persone da ricercare utilizzando i parametri di cognome nome e codice fiscale


  **Estensioni:**

  Codice Estensione|Valore|Nota
  -|-|-
  x-cache-type|lowRefreshRateUserDependent|Risorsa che varia con frequenza bassa, cache Http abilitata, cache server disabilitata. Maggiori dettagli [qui](https://wiki.u-gov.it/confluence/display/ESSE3/Servizi+REST+su+ESSE3#ServiziRESTsuESSE3-Cachingdellerichieste) 


  **Controlli di sicurezza:**
  ======
  _Nota: Il controllo per utente è verificato quando viene passato almeno uno dei controlli previsti_

  **Utente: USER_TECNICO**

  Profilo|Controllo| Funzione
  -|-|-
  UTENTE_TECNICO|funzione accessibile alle utenze tecniche per accessi ai servizi REST|Security.checkUserTecnico()

  **Utente: STUDENTE**

  Profilo|Controllo| Funzione
  -|-|-
  STUDENTE|funzione accessibile alle utenze di tipo STUDENTE|Security.checkStudente()


  Classe di modello : PersonaAnagComuni
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  persId|primaryKey
  anaperCodExt|optional
  anaperStorico|optional
  anaperConsensi|optional
  anaperContatti|optional
  datiBancari|optional
  docPers|optional
  dicHand|optional
  permSog|optional
  indirizzi|optional
  autorizzati|optional
  autorizzazioni|optional
  tutori|optional
  matur|optional
  titIt|optional
  titStra|optional
  profiliEsterni|optional
  aliasAnagrafica|optional


  Classe di modello : Persona
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  persId|primaryKey


  Classe di modello : AnaperConsensi
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  tipoConsensoCod|primaryKey


  Classe di modello : AnaperConsensiSto
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  tipoConsensoCod|primaryKey


  Classe di modello : ReplicaDicHand
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  dicHandId|primaryKey


  Classe di modello : DicHandMisComp
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  dicHandId|primaryKey


  Classe di modello : AnaperIndirizzi
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  tipoIndirizCod|primaryKey


  Classe di modello : AnaperIndirizziSto
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  tipoIndirizCod|primaryKey


  Classe di modello : DettaglioErroreAggiuntivo
  ======

  Estensioni sulle proprietà
  ----
  Proprietà | x-field-type
  -|-|
  rawValue|rawJson
