Servicios de administrador
Algunas capacidades solo están disponibles para un usuario administrador en ThingWorx. Por ejemplo, los menús Supervisión e Importar/Exportar (y los servicios asociados) solo están visibles para los administradores. Los siguientes servicios solo los puede ejecutar un usuario administrador que pertenezca al grupo de usuarios Administradores.
Servicios de los tableros
• GetDashboard: permite localizar un tablero por ID.
• ShareDashboard: solo el propietario o creador del tablero puede compartirlo, además del usuario administrador.
• RemoveSharedOrganizationUnit: solo el usuario administrativo o el creador/propietario del tablero pueden ejecutar este servicio.
Servicios de entidad raíz
• GetOwner: se devuelve el propietario de una entidad. Consulte Propiedad para obtener más información.
• SetOwner: se asigna un propietario a una entidad.
• CreateThingWithOwner: se asigna el propietario de una entidad durante la creación, en lugar de utilizar el valor por defecto.
• CreateThingShapeWithOwner: permite asignar al usuario especificado el propietario de una entidad en el momento de su creación, en lugar de utilizar el usuario que la crea.
• CreateThingTemplateWithOwner: permite asignar al usuario especificado el propietario de una entidad en el momento de su creación, en lugar de utilizar el usuario que la crea.
• CloneThingWithOwner: permite asignar al usuario especificado el propietario de una entidad en el momento de su creación, en lugar de utilizar el usuario que la crea.
• CloneThingShapeWithOwner: permite asignar al usuario especificado el propietario de una entidad en el momento de su creación, en lugar de utilizar el usuario que la crea.
• CloneThingTemplateWithOwner: permite asignar al usuario especificado el propietario de una entidad en el momento de su creación, en lugar de utilizar el usuario que la crea.
• RequestEdit: para la entidad definida, el usuario que llama al servicio se convierte en el editor. El modo de edición para el usuario anterior se cancela y aparece un mensaje de aviso antes de que se realicen cambios. El cambio más reciente realizado se respetará.
Información de recursos/sesión
• TerminateUserSessions: se anulan todas las sesiones activas para un usuario.
 |
PTC recomienda utilizar este servicio para terminar la sesión de un usuario inmediatamente antes de tomar otra acción administrativa, como borrar la cuenta del usuario, etc.
|
Subsistema de plataforma
• SetAllowMethodSwitch: permite el cambio de método con los parámetros de solicitud (true no es seguro). Consulte Actualización del método de solicitud y el filtrado de tipo de contenido.
• SetFilterContentType: se filtra el tipo de contenido en las solicitudes (false no es seguro). Consulte Actualización del método de solicitud y el filtrado de tipo de contenido.
• GetDataConnectSettings: se recuperan las configuraciones de DataConnect en el subsistema de plataforma.
• SetDataConnectSettings: se definen las configuraciones de DataConnect en el subsistema de plataforma.
Subsistema de gestión de usuarios
• GetPlatformSessionTimeout: se devuelve el tiempo de espera de la sesión de conexión en minutos.
Importación y exportación (opciones de menú en Composer)
• Importar/Exportar
• Importar/Exportar entidades de control de origen
• Importar desde fichero/Exportar a fichero
|
|
Los administradores pueden autorizar importaciones realizadas por usuarios que no sean administradores.
|
Registro
Antes de ThingWorx 9.6.0, había servicios en entidades de registro; es decir, ApplicationLog, ConfigurationLog, CommunicationLog, ScriptLog, SecurityLog) que ayudan a los desarrolladores a obtener y definir registros y niveles de subregistros. Solo se tenía acceso a estos servicios a través del servicio personalizado o una suscripción.
A partir de ThingWorx 9.6.0, se han introducido los siguientes servicios genéricos en LoggingSubsystem. Es recomendable que estos servicios los ejecuten solo los usuarios administradores.
|
|
PTC recomienda utilizar estos servicios en lugar de Logback.xml.
|
|
Servicio
|
Entrada
|
Salida
|
Descripción
|
||
|---|---|---|---|---|---|
|
GetLogLevels
|
InfoTable
dataShape: "EntityList"
|
Servicio genérico para devolver los niveles de registro disponibles.
|
|||
|
GetSubLoggerLevels
|
logType (STRING)
|
InfoTable
dataShape: "FieldValuePair"
|
Permite obtener una lista de subregistradores y sus niveles para logType especificado.
|
||
|
GetLogLevel
|
logType (STRING)
|
InfoTable
dataShape: "EntityList"
|
El servicio toma la entrada como registrador y obtiene el nivel de registro actual.
|
||
|
SetLogLevel
|
logType (STRING)
level (STRING)
|
Servicio para definir el nivel de registro del respectivo tipo de registro.
|
|||
|
GetSubLoggerLevel
|
subloggerName (STRING)
logType (STRING)
|
InfoTable
dataShape: "FieldValuePair"
|
El servicio toma la entrada como subregistrador y tipo de registro, y obtiene el nivel de registro actual del subregistrador especificado.
|
||
|
SetSubLoggerLevel
|
logType (STRING)
subloggerName (STRING)
level (STRING)
|
Servicio para definir el nivel de registro del subregistrador especificado.
|
|||
|
ResetSubLoggerLevel
|
logType (STRING)
subloggerName (STRING)
|
Permite quitar nivel de subregistro para el registrador y el subregistrador determinados.
|
|||
|
ResetAllSubLoggerLevels
|
logType (STRING)
|
Permite quitar todos los niveles del subregistrador para el tipo de registro dado.
|
|
|
En caso de definir el nivel de registro en DEBUG o TRACE, se producirá un aumento exponencial del volumen de registro para los registros correspondientes. Las configuraciones se introducen en LoggingSubsystem para redefinir el nivel de registro después del intervalo mencionado. Consulte los detalles de configuración de LoggingSubsystem.
|
Funciones del sistema de ficheros
• DumpFileTransferHistory: servicio de utilidad que vuelca el historial de transferencias en la memoria.
• AbortFileTransfer: se fuerza un trabajo de transferencia de ficheros a VALIDADO.
Proveedores de persistencia
• GetStreamDataProcessingSettings: se devuelve la tabla de configuración para las opciones del procesador de flujo.
• GetValueStreamDataProcessingSettings: se devuelve la tabla de configuración para las opciones del procesador de flujo de valor.
• UpdateStreamDataProcessingSettings: se actualizan las opciones de la persistencia de datos de flujo.
• UpdateValueStreamDataProcessingSettings: se actualizan las opciones de la persistencia de datos de flujo de valor.
• GetPersistentPropertyDataProcessingPerformanceMetrics: este servicio expone las métricas del procesador de flujos del proveedor de persistencia. Con este servicio también se exponen las métricas de cada cola individual, así como de todas las colas. De forma interna, el procesador de flujos divide la cola del proveedor de persistencia en muchas colas más pequeñas para mejorar el rendimiento. El tamaño de cada cola individual = maximumQueueSize/numberOfProcessingThreads.
Subsistema de procesamiento de alertas
• GetAlertProcessorSettings: se devuelve la tabla de configuración para las opciones del procesador de alertas.
• UpdateAlertProcessorSettings: se actualizan las opciones del procesamiento de alertas.
Subsistema de procesamiento de eventos
• GetEventQueueProcessorSettings: se devuelve la tabla de configuración para las opciones del procesador de cola de eventos.
Subsistema de registro
• GetLoggingSettings: se devuelve la tabla de configuración para las opciones de registro.
• UpdateLoggingSettings: se actualizan las opciones del registro.
Subsistema de plataforma
• DeleteExtensionPackage: se borra el elemento ExtensionPackage especificado y todas las extensiones asociadas si no están en uso.
• GetEntityUsageReport: se devuelve el informe de uso de entidad. Consulte Informe de uso de entidad.
• WriteEntityUsageReport: se genera y escribe un informe de uso de entidad en la carpeta ThingWorxStorage. Consulte Informe de uso de entidad.
Subsistema de gestión de usuarios
• SetPlatformSessionTimeout: se definen los minutos para el tiempo de espera de una sesión cuando no hay actividad.
Administrador de seguridad
Consulte Grupos de usuarios para obtener más información sobre estos servicios.
• AssignNewPassword
• SetLanguagePreferences
• GetUserPreferenceInfo