Gestisci la console dell'applicazione JICS in AWS Blu Age - AWS Modernizzazione del mainframe
Gestione delle risorse JICSAltroEndpoint di gestione degli utenti JAC

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestisci la console dell'applicazione JICS in AWS Blu Age

Il componente JICS è il supporto AWS Blu Age per la modernizzazione delle risorse CICS legacy. L'applicazione web della console dell'applicazione JICS è dedicata all'amministrazione delle risorse JICS. I seguenti endpoint consentono di eseguire le attività di amministrazione senza dover interagire con l'interfaccia utente JAC. Ogni volta che un endpoint richiede l'autenticazione, la richiesta dovrà includere i dettagli di autenticazione (nome utente/password in genere, come richiesto dall'autenticazione di base). Gli endpoint per l'applicazione Web della console dell'applicazione JICS utilizzano il percorso root. /jac/

Gestione delle risorse JICS

Tutti i seguenti endpoint sono correlati alla gestione delle risorse JICS, che consente agli amministratori JICS di gestire le risorse su base giornaliera.

Elenca ELENCHI e GRUPPI JICS

LIST e GROUPS sono le principali risorse container proprietarie all'interno del componente JICS. Tutte le risorse JICS devono appartenere a un GRUPPO. I gruppi possono appartenere alle LISTE, ma ciò non è obbligatorio. Le LISTE potrebbero anche non esistere in un determinato ambiente JICS, ma la maggior parte delle volte le LISTE servono a fornire un ulteriore livello di organizzazione delle risorse. Per ulteriori informazioni sull'organizzazione delle risorse CICS, vedere Risorse CICS.

  • Metodo supportato: GET

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/listJicsListsAndGroups

  • Argomenti: Nessuno

  • Restituisce: un elenco di JicsContainer oggetti serializzati, sia LISTS che GROUPS, in formato JSON.

Risposta di esempio:

[
    {
      "name": "Resources",
      "children": [
        {
          "jacType": "JACList",
          "name": "MURACHS",
          "isActive": true,
          "children": [
            {
              "jacType": "JACGroup",
              "name": "MURACHS",
              "isActive": true,
              "children": []
            }
          ]
        },
        {
          "jacType": "JACGroup",
          "name": "TEST",
          "isActive": true,
          "children": []
        }
      ],
      "isExpanded": true
    }
  ]

Recupera risorse JICS

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/retrieveJicsResources

  • Argomenti: un payload JSON che rappresenta le risorse JICS che si desidera recuperare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.request.RetrieveOperationRequest

  • Restituisce: un elenco di oggetti JicsResource serializzati. Gli oggetti non vengono restituiti in un ordine particolare e sono di diversi tipi, come PROGRAM, TRANSACTION, FILE e così via.

Elenca JICS GROUPS

  • Metodo supportato: GET

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/listJicsGroups

  • Argomenti: Nessuno

  • Restituisce un elenco di JicsContainer oggetti serializzati (GROUPS) in formato JSON. I GROUPS vengono restituiti senza le relative informazioni LIST.

Risposta di esempio:

[
    {
      "jacType": "JACGroup",
      "name": "MURACHS",
      "isActive": true,
      "children": []
    },
    {
      "jacType": "JACGroup",
      "name": "TEST",
      "isActive": true,
      "children": []
    }
  ]

Elenca JICS GROUPS per un determinato ELENCO

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/listGroupsForList

  • Argomenti: un payload JSON, che rappresenta la LISTA JICS di cui GROUPS stai cercando. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACList

    Richiesta di esempio:

    {
    "jacType":"JACList",
    "name":"MURACHS",
    "isActive":true
  }

  • Restituisce un elenco di JicsContainer oggetti serializzati (GROUPS) in formato JSON, che sono allegati alla lista specificata. I GROUPS vengono restituiti senza le relative informazioni LIST.

    Risposta di esempio:

    [
    {
      "jacType": "JACGroup",
      "name": "MURACHS",
      "isActive": true,
      "children": []
    }
  ]

ELENCA le risorse JICS per un determinato GRUPPO

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/listResourcesForGroup

  • Argomenti: un payload JSON, che rappresenta il JICS GROUP di cui state cercando le risorse. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACGroup Non è necessario specificare tutti i campi per il GRUPPO, ma il nome è obbligatorio.

    Richiesta di esempio:

    {
    "jacType":"JACGroup",
    "name":"MURACHS",
    "isActive":true
  }

  • Restituisce un elenco di JicsResource oggetti serializzati, di proprietà del gruppo specificato. Gli oggetti non vengono restituiti in un ordine particolare e sono di diversi tipi, come PROGRAM, TRANSACTION, FILE e così via.

ELENCA le risorse JICS per un determinato GRUPPO (alternativa che utilizza un nome)

  • Metodo supportato: POST

  • Richiede l'autenticazione

  • Percorso: /api/services/rest/jicsservice/listResourcesForGroupName

  • Argomenti: il nome del GRUPPO che possiede le risorse che stai cercando.

  • Restituisce: un elenco di JicsResource oggetti serializzati, di proprietà del gruppo specificato. Gli oggetti vengono restituiti senza un ordine particolare e sono di diversi tipi, come PROGRAM, TRANSACTION, FILE e così via.

Modifica dei GRUPPI proprietari di diverse LISTE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/editGroupsList

  • Argomenti: una rappresentazione JSON di una raccolta di LISTE con GRUPPI di bambini;

    Richiesta di esempio:

    [      
  {
        "jacType": "JACList",
        "name": "MURACHS",
        "isActive": true,
        "children": [
          {
            "jacType": "JACGroup",
            "name": "MURACHS",
            "isActive": true,
            "children": []
          },
          {
            "jacType": "JACGroup",
            "name": "TEST",
            "isActive": true,
            "children": []
          }
        ]
  }
]

    Prima di questa modifica, solo il gruppo denominato «MURACHS» apparteneva alla LISTA denominata «MURACHS». Con questa modifica, si «aggiunge» il gruppo denominato «TEST» alla LISTA denominata «MURACHS».

  • Restituisce un valore booleano. Se il valore è 'true', le modifiche di LISTS sono state mantenute correttamente nell'archivio JICS sottostante.

Eliminare un ELENCO

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteList

  • Argomenti: un payload JSON, che rappresenta l'ELENCO JICS da eliminare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACList

  • Restituisce un valore booleano. Se il valore è 'true', l'eliminazione di LIST è stata eseguita correttamente sull'archivio JICS sottostante.

Eliminare un GRUPPO

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteGroup

  • Argomenti: un payload JSON, che rappresenta il JICS GROUP da eliminare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACGroup

  • Restituisce un valore booleano. Se il valore è 'true', l'eliminazione GROUP è stata eseguita con successo sullo storage JICS sottostante.

Eliminare una TRANSAZIONE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteTransaction

  • Argomenti: un payload JSON, che rappresenta la transazione JICS da eliminare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACTransaction

  • Restituisce un valore booleano. Se il valore è 'true', l'eliminazione di TRANSACTION è stata eseguita correttamente sullo storage JICS sottostante.

Eliminare un PROGRAMMA

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteProgram

  • Argomenti: un payload JSON, che rappresenta il programma JICS da eliminare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACProgram

  • Restituisce un valore booleano. Se il valore è 'true', l'eliminazione del PROGRAMMA è stata eseguita correttamente sulla memoria JICS sottostante.

Eliminare un FILE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteFile

  • Argomenti: un payload JSON, che rappresenta il file JICS da eliminare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACFile

  • Restituisce un valore booleano. Se il valore è 'true', l'eliminazione del FILE è stata eseguita correttamente sulla memoria JICS sottostante.

Elimina un TDQUEUE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteTDQueue

  • Argomenti: un payload JSON, che rappresenta il JICS TDQUEUE da eliminare. Questa è la serializzazione JSON di un file `com.netfective.bluage.jac.entities. JACTDQueue`oggetto.

  • Restituisce un valore booleano. Se il valore è 'true', l'eliminazione di TDQUEUE è stata eseguita correttamente sullo storage JICS sottostante.

Eliminare un TSMODEL

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteTSModel

  • Argomenti: un payload JSON, che rappresenta il JICS TSMODEL da eliminare. Questa è la serializzazione JSON di un file `com.netfective.bluage.jac.entities. JACTSModel`oggetto.

  • Restituisce un valore booleano. Se il valore è 'true', l'eliminazione TSMODEL è stata eseguita correttamente sull'archivio JICS sottostante.

Elimina elementi

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/deleteElements

  • Argomenti: un payload JSON che rappresenta gli elementi JICS da eliminare.

  • Restituisce un valore booleano che true indica che l'eliminazione è stata eseguita correttamente nell'archivio JICS sottostante.

Crea una LISTA

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createList

  • Argomenti: un payload JSON, che rappresenta la LISTA JICS da creare. Questa è la serializzazione JSON di un file `com.netfective.bluage.jac.entities. JACList`oggetto.

  • Restituisce un valore booleano. Se il valore è 'true', l'ELENCO è stato creato correttamente nell'archivio JICS sottostante.

Nota

La LIST verrà sempre creata vuota. Allegare GROUPS alla LIST richiederà un'altra operazione.

Creare un GRUPPO

  • Metodo supportato: POST

  • Richiede l'autenticazione e i seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createGroup

  • Argomenti: un payload JSON, che rappresenta il JICS GROUP da creare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACGroup

  • Restituisce un valore booleano. Se il valore è 'true', il GROUP è stato creato correttamente nell'archivio JICS sottostante.

Nota

Il GROUP verrà sempre creato vuoto. L'associazione di RESOURCES al GROUP richiederà operazioni aggiuntive (la creazione di risorse le collegherà automaticamente a un determinato GRUPPO.

Considerazioni comuni sulla creazione di RISORSE

Tutti i seguenti endpoint sono correlati alla creazione di JICS RESOURCES e condividono alcuni vincoli comuni: nel payload della richiesta da inviare all'endpoint, il campo deve essere valutato. groupName

Vincolo di proprietà del GRUPPO:

Nessuna risorsa può essere creata senza essere collegata a un gruppo esistente e l'endpoint utilizza GroupName per recuperare il gruppo a cui verrà collegata questa risorsa. groupNameDeve puntare al nome di un GROUP esistente. Verrà inviato un messaggio di errore con HTTP STATUS 400 se non punta a un gruppo esistente nell'archivio JICS sottostante. groupName

Vincolo di unicità all'interno di un GRUPPO:

Una determinata risorsa con un determinato nome deve essere unica all'interno di un determinato gruppo. Il controllo dell'unicità verrà eseguito da ciascun endpoint di creazione di risorse. Se il payload specificato non rispetta il vincolo di unicità, l'endpoint invierà una risposta con HTTP STATUS 400 (BAD REQUEST). Vedi la risposta di esempio riportata di seguito.

Payload di esempio: si tenta di creare la transazione «ARIT» nel gruppo «TEST», ma in quel gruppo esiste già una transazione con quel nome.

{
    "jacType":"JACTransaction",
    "name":"ARIT", 
    "groupName":"TEST", 
    "isActive":true
  }

Viene visualizzata la seguente risposta di errore:

{
    "timestamp": 1686759054510,
    "status": 400,
    "error": "Bad Request",
    "path": "/jac/api/services/rest/jicsservice/createTransaction"
  }

L'ispezione dei log dei server confermerà l'origine del problema:

2023-06-14 18:10:54 default         TRACE - o.s.w.m.HandlerMethod                    - Arguments: [java.lang.IllegalArgumentException: Transaction already present in the group, org.springframework.security.web.header.HeaderWriterFilter$HeaderWriterResponse@e34f6b8]
2023-06-14 18:10:54 default         ERROR - c.n.b.j.a.WebConfig                      - 400
java.lang.IllegalArgumentException: Transaction already present in the group
	at com.netfective.bluage.jac.server.services.rest.impl.JicsServiceImpl.createElement(JicsServiceImpl.java:1280)

Crea una TRANSAZIONE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createTransaction

  • Argomenti: un payload JSON, che rappresenta la TRANSAZIONE JICS da creare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACTransaction

  • Restituisce un valore booleano. Se il valore è 'true', la TRANSACTION è stata creata con successo nell'archivio JICS sottostante.

Crea un PROGRAMMA

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createProgram

  • Argomenti: un payload JSON, che rappresenta il PROGRAMMA JICS da creare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACProgram

  • Restituisce un valore booleano. Se il valore è 'true', il PROGRAMMA è stato creato con successo nella memoria JICS sottostante.

Crea un FILE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createFile

  • Argomenti: un payload JSON, che rappresenta il FILE JICS da creare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACFile

  • Restituisce un valore booleano. Se il valore è 'true', il FILE è stato creato correttamente nell'archivio JICS sottostante.

Crea un TDQUEUE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createTDQueue

  • Argomenti: un payload JSON, che rappresenta il JICS TDQUEUE da creare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACTDQueue

  • Restituisce un valore booleano. Se il valore è 'true', TDQUEUE è stato creato con successo nella memoria JICS sottostante.

Crea un TSMODEL

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createTSModel

  • Argomenti: un payload JSON, che rappresenta il JICS TSMODEL da creare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACTSModel

  • Restituisce un valore booleano dove true indica che la creazione di elementi è stata eseguita con successo nella memoria JICS sottostante.

Crea elementi

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/createElements

  • Argomenti: un payload JSON che rappresenta gli elementi JICS da creare.

  • Restituisce un valore booleano. Se il valore è 'true', gli elementi sono stati creati con successo nella memoria JICS sottostante.

Aggiorna un ELENCO

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateList

  • Argomenti: un payload JSON, che rappresenta l'ELENCO JICS da aggiornare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACList Non è necessario fornire i figli del LIST; il meccanismo di aggiornamento LIST non terrà conto dei bambini.

  • Restituisce un valore booleano. Se il valore è 'true', l'ELENCO è stato aggiornato correttamente nell'archivio JICS sottostante.

L'aggiornamento del flag LIST 'isActive' si propagherà a tutti gli elementi di proprietà della LIST, ovvero a tutti i GRUPPI di proprietà della LIST e a tutte le RISORSE di proprietà di tali GRUPPI. Questo è un modo conveniente per disattivare molte risorse con un'unica operazione, su più GRUPPI.

Aggiorna un GRUPPO

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateGroup

  • Argomenti: un payload JSON, che rappresenta il JICS GROUP da aggiornare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACGroup Non è necessario fornire i figli del GROUP, il meccanismo di aggiornamento GROUP non ne terrà conto.

  • Restituisce un valore booleano. Se il valore è 'true', il GROUP è stato aggiornato correttamente nell'archivio JICS sottostante.

Nota

L'aggiornamento del flag GROUP 'isActive' si propagherà a tutti gli elementi di proprietà del GROUP, ovvero a tutte le RISORSE di proprietà del GRUPPO. Questo è un modo conveniente per disattivare molte risorse con una singola operazione all'interno di un determinato GRUPPO.

Considerazioni comuni sull'aggiornamento delle RISORSE

Tutti i seguenti endpoint riguardano l'aggiornamento di JICS RESOURCES. Utilizzando il groupName campo, è possibile modificare il GROUP proprietario di qualsiasi RISORSA JICS, a condizione che il valore del campo punti a un GROUP esistente nell'archivio JICS sottostante (in caso contrario, si riceverà una risposta BAD REQUEST (HTTP STATUS 400) dall'endpoint).

Aggiorna una TRANSAZIONE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateTransaction

  • Argomenti: un payload JSON, che rappresenta la TRANSAZIONE JICS da aggiornare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACTransaction

  • Restituisce un valore booleano. Se il valore è 'true', la TRANSAZIONE è stata aggiornata correttamente nell'archivio JICS sottostante.

Aggiorna un PROGRAMMA

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateProgram

  • Argomenti: un payload JSON, che rappresenta il PROGRAMMA JICS da aggiornare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACProgram

  • Restituisce un valore booleano. Se il valore è 'true', il PROGRAMMA è stato aggiornato correttamente nella memoria JICS sottostante.

Aggiornare un FILE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateFile

  • Argomenti: un payload JSON, che rappresenta il FILE JICS da aggiornare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACFile

  • Restituisce un valore booleano. Se il valore è 'true', il FILE è stato aggiornato correttamente nell'archivio JICS sottostante.

Aggiorna un TDQUEUE

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateTDQueue

  • Argomenti: un payload JSON, che rappresenta il JICS TDQUEUE da aggiornare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACTDQueue

  • Restituisce un valore booleano. Se il valore è 'true', è TDQueue stato aggiornato con successo nella memoria JICS sottostante.

Aggiorna un TSMODEL

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateTSModel

  • Argomenti: un payload JSON, che rappresenta il JICS TSMODEL da aggiornare. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.JACTSModel

  • Restituisce un valore booleano. Se il valore è 'true', TSMODEL è stato aggiornato correttamente nella memoria JICS sottostante.

Aggiorna elementi

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/updateElements

  • Argomenti: un payload JSON che rappresenta gli elementi da aggiornare.

  • Restituisce un valore booleano che true indica che l'aggiornamento degli elementi è stato eseguito correttamente nell'archivio JICS sottostante.

Elementi Upsert

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/upsertElements

  • Argomenti: un payload JSON che rappresenta gli elementi da sconvolgere.

  • Restituisce un valore booleano dove true indica che gli elementi upsert sono stati utilizzati con successo nella memoria JICS sottostante.

Recupera elementi

  • Metodo supportato: GET

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/retrieveElements

  • Argomenti: Nessuno

  • Restituisce un elenco di tutte le risorse JICS serializzate.

Operazione JICS CRUD

  • Metodo supportato: POST

  • Richiede l'autenticazione e uno dei seguenti ruoli: ROLE_ADMIN, ROLE_SUPER_ADMIN, ROLE_USER

  • Percorso: /api/services/rest/jicsservice/jicsCrudOperation

  • Argomenti: un payload JSON che rappresenta le risorse JICS che stai cercando. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.request.JicsCrudOperationRequest

  • Restituisce un payload JSON che rappresenta la risposta. Questa è la serializzazione JSON di un oggetto. com.netfective.bluage.jac.entities.request.JicsCrudOperationResponse

Altro

Stato di salute del server JICS

  • Metodo supportato: GET

  • Percorso: /api/services/rest/jicsserver/serverIsUp

  • Argomenti: Nessuno

  • Restituzioni: nessuna. Una risposta HTTP STATUS 200 indica che il server è attivo e funzionante.

Endpoint di gestione degli utenti JAC

Utilizza i seguenti endpoint per gestire le interazioni con gli utenti.

Registrazione di un utente

  • Metodo supportato: POST

  • Percorso: /api/services/security/servicelogin/login

  • Argomenti: Nessuno

  • Restituisce la serializzazione JSON di un com.netfective.bluage.jac.entities.SignOn oggetto, che rappresenta l'utente le cui credenziali sono fornite nella richiesta corrente. La password è nascosta alla vista nell'oggetto restituito. I ruoli assegnati all'utente vengono elencati.

Risposta di esempio:

{
    "login": "some-admin",
    "password": null,
    "roles": [
      {
        "id": 0,
        "roleName": "ROLE_ADMIN"
      }
    ]
  }

Verifica se nel sistema esiste almeno un utente

  • Metodo supportato: GET

  • Percorso: /api/services/security/servicelogin/hasAccount

  • Argomenti: Nessuno

  • Restituisce il valore booleano true se è stato creato almeno un utente diverso dall'utente super amministratore predefinito. Restituisce altrimentifalse.

Registrazione di un nuovo utente

  • Metodo supportato: POST

  • Richiede l'autenticazione e il ruolo ROLE_ADMIN.

  • Percorso: /api/services/security/servicelogin/recorduser

  • Argomenti: la serializzazione JSON di un com.netfective.bluage.jac.entities.SignOn oggetto, che rappresenta l'utente da aggiungere allo storage. I ruoli per l'utente devono essere definiti, altrimenti l'utente potrebbe non essere in grado di utilizzare la struttura e gli endpoint JAC.

  • Restituisce il valore booleano true se l'utente è stato creato con successo. Restituisce altrimentifalse.

Richiesta di esempio:

{
    "login": "simpleuser",
    "password": "simplepassword",
    "roles": [
      {
        "id": 2,
        "roleName": "ROLE_USER"
      }
    ]
  }

È possibile utilizzare solo i seguenti ruoli durante la registrazione di un nuovo utente:

  • ROLE_ADMIN: può gestire le risorse e gli utenti JICS.

  • ROLE_USER: può gestire le risorse JICS ma non gli utenti.

Informazioni sull'utente

  • Metodo supportato: GET

  • Percorso: /api/services/security/servicelogin/userInfo

  • Argomenti: Nessuno

  • Restituisce il nome utente e i ruoli dell'utente attualmente connesso.

Elenco degli utenti

  • Metodo supportato: GET

  • Richiede l'autenticazione e il ruolo ROLE_ADMIN.

  • Percorso: /api/services/security/servicelogin/listusers

  • Argomenti: Nessuno

  • Restituisce un elenco dicom.netfective.bluage.jac.entities.SignOn, serializzato come JSON.

Eliminazione di un utente

  • Metodo supportato: POST

  • Richiede l'autenticazione e il ruolo ROLE_ADMIN.

  • Percorso: /api/services/security/servicelogin/deleteuser

  • Argomenti: la serializzazione JSON di un com.netfective.bluage.jac.entities.SignOn oggetto che rappresenta l'utente da rimuovere dall'archivio.

  • Restituisce il valore booleano true se l'utente è stato rimosso con successo.

Importante

Questa operazione non può essere annullata. L'utente eliminato non sarà in grado di connettersi nuovamente all'applicazione JAC.

Disconnetti l'utente corrente

  • Metodo supportato: GET

  • Percorso: /api/services/security/servicelogout/logout

  • Argomenti: Nessuno

  • Restituisce il messaggio JSON {"success":true} se l'utente corrente è stato disconnesso con successo. La sessione HTTP correlata verrà invalidata.