Administra JICS la consola de aplicaciones en AWS Blu Age - AWS Modernización de mainframe

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Administra JICS la consola de aplicaciones en AWS Blu Age

El JICS componente es el soporte de la Era AWS Azul para la modernización de los CICS recursos heredados. La JICS aplicación web de la consola de aplicaciones está dedicada a administrar JICS los recursos. Los siguientes puntos finales permiten realizar las tareas de administración sin tener que interactuar con la interfaz de JAC usuario. Siempre que un punto de conexión requiera autenticación, la solicitud deberá incluir los detalles de autenticación (normalmente, nombre de usuario/contraseña, tal y como exige la autenticación básica). Los puntos finales de la JICS aplicación web de la consola de aplicaciones utilizan la ruta raíz. /jac/

JICSadministración de recursos

Todos los puntos finales siguientes están relacionados con la administración de JICS recursos, lo que permite a JICS los administradores gestionar los recursos a diario.

Enumere JICS LISTS y GROUPS

Los LIST y GROUPS son los principales recursos de contenedores propietarios del JICS componente. Todos JICS los recursos deben pertenecer aGROUP. Los grupos pueden pertenecer aLISTS, pero no es obligatorio. LISTSpuede que ni siquiera existan en un JICS entorno determinado, pero la mayoría de las veces LISTS están ahí para ofrecer un nivel adicional de organización de los recursos. Para obtener más información sobre la organización de CICS los recursos, consulte CICSrecursos.

  • Método compatible: GET

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: ninguno

  • Devuelve: una lista de JicsContainer objetos serializadosGROUPS, LISTS tanto comoJSON.

Respuesta de ejemplo:

[ { "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 recursos JICS

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: JSON carga útil que representa los JICS recursos que se desean recuperar. Es la JSON serialización de un com.netfective.bluage.jac.entities.request.RetrieveOperationRequest objeto.

  • Devuelve: una lista de objetos serializados. JicsResource Los objetos se devuelven sin ningún orden en particular y son de diferentes tiposPROGRAM, como TRANSACTIONFILE,,, etc.

Lista JICS GROUPS

  • Método compatible: GET

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: ninguno

  • Devuelve una lista de JicsContainer objetos serializados (GROUPS) comoJSON. GROUPSSe devuelven sin su información de propiedad. LIST

Respuesta de ejemplo:

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

Lista JICS GROUPS para un determinado LIST

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa JICS LIST lo GROUPS que estás buscando. Esta es la JSON serialización de un com.netfective.bluage.jac.entities.JACList objeto.

    Solicitud de ejemplo:

    { "jacType":"JACList", "name":"MURACHS", "isActive":true }
  • Devuelve una lista de JicsContainer objetos serializados (GROUPS) comoJSON, que están adjuntos a lo dado. LIST GROUPSSe devuelven sin su información de propiedad. LIST

    Respuesta de ejemplo:

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

LISTJICSrecursos para un determinado GROUP

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que JICS GROUP representa qué recursos estás buscando. Esta es la JSON serialización de un com.netfective.bluage.jac.entities.JACGroup objeto. No es necesario especificar todos los campos para elGROUP, pero el nombre es obligatorio.

    Solicitud de ejemplo:

    { "jacType":"JACGroup", "name":"MURACHS", "isActive":true }
  • Devuelve una lista de JicsResource objetos serializados, propiedad del objeto dadoGROUP. Los objetos se devuelven sin ningún orden en particular y son de diferentes tiposPROGRAM, como TRANSACTIONFILE,,, etc.

LISTJICSrecursos para un determinado GROUP (alternativa usar un nombre)

  • Método compatible: POST

  • Requiere autenticación

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

  • Argumentos: el nombre del GROUP propietario de los recursos que estás buscando.

  • Devuelve: una lista de JicsResource objetos serializados, propiedad del dado. GROUP Los objetos se devuelven sin ningún orden en particular y son de diferentes tiposPROGRAM, como TRANSACTIONFILE,,, etc.

Editando la propiedad GROUPS de varios LISTS

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: JSON representación de una colección LISTS con niñosGROUPS;

    Solicitud de ejemplo:

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

    Antes de esta edición, solo el grupo llamado «MURACHS» pertenecía al LIST nombre «MURACHS». Con esta edición, se «añade» el grupo denominado TEST "" al LIST denominado "MURACHS».

  • Devuelve un valor booleano. Si el valor es «verdadero», las LISTS modificaciones se han mantenido correctamente en el JICS almacenamiento subyacente.

Eliminar un LIST

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS LIST a eliminar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACList objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», la LIST eliminación se realizó correctamente en el JICS almacenamiento subyacente.

Eliminar un GROUP

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS GROUP a eliminar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACGroup objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», la GROUP eliminación se realizó correctamente en el JICS almacenamiento subyacente.

Eliminar un TRANSACTION

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa la JICS transacción que se va a eliminar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACTransaction objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», la TRANSACTION eliminación se realizó correctamente en el JICS almacenamiento subyacente.

Eliminar un PROGRAM

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa el JICS programa que se va a eliminar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACProgram objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», la PROGRAM eliminación se realizó correctamente en el JICS almacenamiento subyacente.

Eliminar un FILE

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa el JICS archivo que se va a eliminar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACFile objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», la FILE eliminación se realizó correctamente en el JICS almacenamiento subyacente.

Eliminar un TDQUEUE

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TDQUEUE a eliminar. Esta es la JSON serialización de un `com.netfective.bluage.jac.entities. JACTDQueue`objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», la TDQUEUE eliminación se realizó correctamente en el JICS almacenamiento subyacente.

Eliminar un TSMODEL

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TSMODEL a eliminar. Esta es la JSON serialización de un `com.netfective.bluage.jac.entities. JACTSModel`objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», la TSMODEL eliminación se realizó correctamente en el JICS almacenamiento subyacente.

Eliminar elementos

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: JSON carga útil que representa los JICS elementos que se van a eliminar.

  • Devuelve un valor booleano que true indica que la eliminación se realizó correctamente en el almacenamiento subyacente. JICS

Crea un LIST

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS LIST a crear. Esta es la JSON serialización de un `com.netfective.bluage.jac.entities. JACList`objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa LIST que se creó correctamente en el JICS almacenamiento subyacente.

nota

El LIST siempre se creará vacío. Adjuntarlo GROUPS al LIST testamento requerirá otra operación.

Crea un GROUP

  • Método compatible: POST

  • Requiere autenticación y las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS GROUP a crear. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACGroup objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que se GROUP ha creado correctamente en el JICS almacenamiento subyacente.

nota

El GROUP siempre se creará vacío. Adjuntarlo RESOURCES al testamento GROUP requerirá operaciones adicionales (la creación de recursos los adjuntará automáticamente a un testamento). GROUP

Consideraciones comunes RESOURCES de creación

Todos los puntos finales siguientes están relacionados con JICS RESOURCES la creación y comparten algunas limitaciones comunes: en la carga útil de la solicitud que se va a enviar al punto final, se debe groupName valorar el campo.

GROUPrestricción de propiedad:

No se puede crear ningún recurso sin estar asociado a un grupo existente, y el punto final lo utiliza groupName para recuperar el grupo al que se adjuntará este recurso. groupNameDebe apuntar al nombre de un elemento existenteGROUP. Se enviará un mensaje de error con HTTP STATUS 400 si no groupName apunta a un grupo existente en el almacenamiento JICS subyacente.

Restricción de unicidad dentro de: GROUP

Un recurso determinado con un nombre determinado tiene que ser único en un grupo determinado. La comprobación de la unicidad la realizará cada punto de conexión de creación de recursos. Si la carga útil dada no respeta la restricción de unicidad, el punto final enviará una respuesta con HTTP STATUS 400 (BADREQUEST); consulte el ejemplo de respuesta que aparece a continuación.

Ejemplo de carga útil: intentas crear la transacción 'ARIT' en el grupo 'TEST', pero ya existe una transacción con ese nombre en ese grupo.

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

Recibes la siguiente respuesta de error:

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

Al inspeccionar los registros de los servidores, se confirmará el origen 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 un TRANSACTION

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TRANSACTION a crear. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACTransaction objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que TRANSACTION se creó correctamente en el JICS almacenamiento subyacente.

Cree un PROGRAM

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS PROGRAM a crear. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACProgram objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que PROGRAM se creó correctamente en el JICS almacenamiento subyacente.

Cree un FILE

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS FILE a crear. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACFile objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que FILE se creó correctamente en el JICS almacenamiento subyacente.

Cree un TDQUEUE

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TDQUEUE a crear. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACTDQueue objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que TDQUEUE se creó correctamente en el JICS almacenamiento subyacente.

Cree un TSMODEL

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TSMODEL a crear. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACTSModel objeto.

  • Devuelve un valor booleano que true indica que la creación de elementos se realizó correctamente en el almacenamiento subyacente. JICS

Crea elementos

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa los JICS elementos que se van a crear.

  • Devuelve un valor booleano. Si el valor es «verdadero», los elementos se crearon correctamente en el JICS almacenamiento subyacente.

Actualice un LIST

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS LIST a actualizar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACList objeto. No es necesario proporcionar los elementos secundarios delLIST; el mecanismo de LIST actualización no los tendrá en cuenta.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que LIST se actualizó correctamente en el JICS almacenamiento subyacente.

Si se actualiza el indicador isActive «LIST», se propagará a todos los elementos que le pertenezcan, es decirLIST, a todos los que GROUPS sean propiedad de ellos LIST y a todos los que RESOURCES pertenezcan a ellosGROUPS. Esta es una forma cómoda de desactivar muchos recursos con una sola operación, a lo largo de varias. GROUPS

Actualiza un GROUP

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS GROUP a actualizar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACGroup objeto. No es necesario proporcionar los elementos secundarios delGROUP, el mecanismo de GROUP actualización no lo tendrá en cuenta.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que GROUP se actualizó correctamente en el JICS almacenamiento subyacente.

nota

La actualización del indicador isActive «GROUP» se propagará a todos los elementos que sean propiedad de, es decirGROUP, a todos los que RESOURCES sean propiedad deGROUP. Esta es una forma cómoda de desactivar una gran cantidad de recursos con una sola operación dentro de una determinada. GROUP

Consideraciones comunes RESOURCES sobre las actualizaciones

Todos los puntos finales siguientes tienen que ver con la actualización JICSRESOURCES. Con el groupName campo, puede cambiar la propiedad GROUP de cualquiera de ellos JICSRESOURCE, siempre que el valor del campo apunte a uno existente GROUP en el JICS almacenamiento subyacente (de lo contrario, recibirá una BAD REQUEST respuesta (HTTPSTATUS400) del punto final).

Actualice un TRANSACTION

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TRANSACTION a actualizar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACTransaction objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que TRANSACTION se actualizó correctamente en el JICS almacenamiento subyacente.

Actualice un PROGRAM

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS PROGRAM a actualizar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACProgram objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que PROGRAM se actualizó correctamente en el JICS almacenamiento subyacente.

Actualice un FILE

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS FILE a actualizar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACFile objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que FILE se actualizó correctamente en el JICS almacenamiento subyacente.

Actualice un TDQUEUE

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TDQUEUE a actualizar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACTDQueue objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que TDQueue se actualizó correctamente en el JICS almacenamiento subyacente.

Actualice un TSMODEL

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa lo que se va JICS TSMODEL a actualizar. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.JACTSModel objeto.

  • Devuelve un valor booleano. Si el valor es «verdadero», significa que TSMODEL se actualizó correctamente en el JICS almacenamiento subyacente.

Actualice los elementos

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: JSON carga útil que representa los elementos que se van a actualizar.

  • Devuelve un valor booleano que true indica que la actualización de los elementos se realizó correctamente en el almacenamiento subyacente. JICS

Elementos alterados

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: JSON carga útil que representa los elementos que se van a interrumpir.

  • Devuelve un valor booleano que true indica que el elemento upsert se utilizó correctamente en el almacenamiento subyacente. JICS

Recupera elementos

  • Método compatible: GET

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: ninguno

  • Devuelve una lista de todos los JICS recursos serializados.

JICSCRUDoperación

  • Método compatible: POST

  • Requiere autenticación y una de las siguientes funciones: ROLE _ADMIN, ROLE _ SUPER _ADMIN, ROLE _ USER

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

  • Argumentos: una JSON carga útil que representa los JICS recursos que estás buscando. Esta es la JSON serialización de un com.netfective.bluage.jac.entities.request.JicsCrudOperationRequest objeto.

  • Devuelve una JSON carga útil que representa la respuesta. Se trata de la JSON serialización de un com.netfective.bluage.jac.entities.request.JicsCrudOperationResponse objeto.

Otro

JICSestado del servidor

  • Método compatible: GET

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

  • Argumentos: ninguno

  • Devoluciones: ninguna. Una respuesta de HTTP STATUS 200 indica que el servidor está en funcionamiento.

JACpuntos finales de administración de usuarios

Utilice los siguientes puntos de conexión para administrar las interacciones de los usuarios.

Registrar a un usuario .

  • Método compatible: POST

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

  • Argumentos: ninguno

  • Devuelve la JSON serialización de un com.netfective.bluage.jac.entities.SignOn objeto, que representa al usuario cuyas credenciales se proporcionan en la solicitud actual. La contraseña está oculta en la vista del objeto devuelto. Se muestran las funciones asignadas al usuario.

Respuesta de ejemplo:

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

Probar si existe al menos un usuario en el sistema

  • Método compatible: GET

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

  • Argumentos: ninguno

  • Devuelve el valor booleano true si se ha creado al menos un usuario distinto del superadministrador predeterminado. Devuelve false lo contrario.

Grabar a un usuario nuevo

  • Método compatible: POST

  • Requiere autenticación y la ADMIN función ROLE _.

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

  • Argumentos: la JSON serialización de un com.netfective.bluage.jac.entities.SignOn objeto, que representa al usuario que se va a añadir al almacenamiento. Se deben definir las funciones del usuario; de lo contrario, es posible que el usuario no pueda utilizar la JAC función y los puntos finales.

  • Devuelve el valor booleano true si el usuario se creó correctamente. Devuelve false lo contrario.

Solicitud de ejemplo:

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

Al grabar a un usuario nuevo, solo se pueden usar los siguientes roles:

  • ROLE_ADMIN: puede gestionar JICS recursos y usuarios.

  • ROLE_USER: puede gestionar JICS los recursos pero no los usuarios.

Información de usuario

  • Método compatible: GET

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

  • Argumentos: ninguno

  • Devuelve el nombre de usuario y las funciones del usuario actualmente conectado.

Mostrar usuarios

  • Método compatible: GET

  • Requiere autenticación y la ADMIN función ROLE _.

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

  • Argumentos: ninguno

  • Devuelve una lista decom.netfective.bluage.jac.entities.SignOn, serializada comoJSON.

Eliminar un usuario

  • Método compatible: POST

  • Requiere autenticación y la ADMIN función ROLE _.

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

  • Argumentos: la JSON serialización de un com.netfective.bluage.jac.entities.SignOn objeto que representa al usuario que se va a eliminar del almacenamiento.

  • Devuelve el valor booleano true si el usuario se ha eliminado correctamente.

importante

Esta acción no se puede deshacer. El usuario eliminado no podrá volver a conectarse a la JAC aplicación.

Cierre de sesión del usuario actual

  • Método compatible: GET

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

  • Argumentos: ninguno

  • Devuelve el JSON mensaje {"success":true} si la sesión del usuario actual se ha cerrado correctamente. La HTTP sesión relacionada se invalidará.