Control

Nota: esta página documenta el modelo de control basado en archivos disponible para Studio. Para obtener información sobre cómo implementar políticas desde Automation Ops, consulta la Guía de Automation Ops.

Para garantizar que los usuarios de Studio se adhieren a los estándares de desarrollo y cumplen ciertas normas, las organizaciones pueden aplicar políticas de control que controlan las funcionalidades de Studio.

Puedes aplicar políticas de control de una de las siguientes formas:

• Crear e implementar políticas desde Automation Ops, una aplicación web fácil de usar.
• Usa un modelo de control basado en archivos que consiste en crear un archivo de política JSON e implementar el archivo localmente, externamente o a través de Orchestrator.

Las capacidades actuales son:

• aplica diferentes políticas por perfil de Studio.
• restringe el uso de fuentes de paquetes desde la ventana Gestionar paquetes y la Vista Backstage>Configuración > Administrar fuentes.
• aplica estándares de desarrollo organizativo mediante reglas del Analizador de flujos de trabajos.
• aplica las configuraciones de diseño y ubicación y configura varias configuraciones que no están disponibles en Studio.
• permite el envío de datos de uso de Studio a tu organización.
• aplica el uso de repositorios específicos para el control de origen de GIT.

Consulta el siguiente vídeo para ver una descripción general de las capacidades de control disponibles en Studio y una demostración de cómo utilizarlas en StudioX.

Para aplicar una política de control, empieza generando un archivo de control de Studio y, a continuación configura el archivo utilizando los parámetros que contenga y aplicando la política de una de las siguientes formas:

• Usar un archivo local (con fines de prueba): sitúa el archivo de control en la carpeta Itinerancia de la máquina en la que tienes instalado Studio.
• Usar un archivo externo (para implementaciones grandes): sitúa el archivo de control en una ruta (por ejemplo, un servidor HTTP/HTTPS) referenciada por una clave de registro o un activo de Orchestrator.
• Usar un activo en Orchestrator: copia los contenidos del archivo de control en un activo de Orchestrator.

Generar el archivo de control

El primer paso para cumplir las normas de desarrollo en tu organización es generar un archivo de control desde Studio o crear manualmente un archivo similar que incorporaría la totalidad o una parte de las capacidades enumeradas anteriormente.

Importante: el archivo de control debe ser de tipo .config con el siguiente nombre uipath.policies.config.

Para generar un archivo de control con tu configuración actual de Studio, vete a Vista Backstage > pestaña Ayuda y selecciona Generar archivo de control. Puedes compartir con tu equipo el archivo exportado.

Nota: Si Automation Ops está habilitado para su organización, se le pedirá que seleccione si desea generar un tipo de política Clásico o Moderno. Selecciona la opción clásica para el modelo de control basado en archivos. La opción moderna genera políticas que pueden importarse en Automation Ops para una migración fácil a ese modelo.

Utiliza el siguiente botón para descargar la muestra que incluye todas las reglas del analizador de flujo de trabajo. Modifica la muestra para adaptarla a las necesidades de tu organización.

Descargar muestra

Configura el archivo de control

Versión de archivo y etiqueta de archivo

Los archivos de control pueden tener diferentes versiones y un nombre personalizado.

{
    "Metadata": {
        "Version": "1.0"
                "LastUpdatedUtc": "2021-08-25T07:49:26.3089368Z",
                "Availability": null
    },
    "Info": {
        "Name": "Sample Policy Registry Key"
    }
}

Parámetros	Valores
"Metadatos" > "Versión"	major.minor entre comillas ""
"Información" > "Nombre"	Etiqueta escrita entre comillas "", visible en Inicio > Ayuda, en la Política de la empresa.

Perfiles de Studio

El archivo de control puede contener políticas tanto para los usuarios de Studio como para los de StudioX; sin embargo, deben estructurarse por perfil. Las políticas para Studio deben estar separadas de las de para StudioX, como se muestra en el ejemplo siguiente:

{
    "Profiles": {
        "Development": {
            "Shell": {
                "IsFeedbackEnabled": true,
                "HideGettingStartedScreen": false
            },
            "PackageManager": {},
            "Analyzer": {}
        },
        "Business": {
            "Shell": {
                "IsFeedbackEnabled": true,
                "HideGettingStartedScreen": false
            },
            "PackageManager": {},
            "Analyzer": {}
        }
    }
}

Parámetros	Valores
"Perfiles"	Para Studio: Development Para StudioX: Business Puedes añadir ambos perfiles en el mismo archivo.

Configuraciones que los usuarios no pueden configurar desde Studio

Los parámetros en "Shell" te permiten evitar las ejecuciones de producción desde StudioX al establecer un límite para el número de ejecuciones que puede realizar un usuario en un proyecto sin cambios.

Además, puedes configurar si el formulario de comentarios y la pantalla de bienvenida están disponibles para los usuarios.

{
      "Shell": {
        "IsFeedbackEnabled": true,
        "HideGettingStartedScreen": false,
        "RequireUserPublish": {
          "PermittedConsecutiveRuns": 3,
          "DialogMessage": null,
          "LogToQueue": {
            "QueueName": "NameOfQueue",
            "QueueFolder": "NameOfQueueFolder"
          }
        }
      }
}

Configuración de Studio	Parámetros	Valores
Habilita o deshabilita el formulario Enviar comentarios al que se puede acceder desde la barra de título de Studio.	"IsFeedbackEnabled"	true o false.
Habilita o deshabilita la pantalla de bienvenida con los enlaces a UiPath Academy, un vídeo introductorio y tutoriales que se muestra cuando los usuarios abren Studio.	"HideGettingStartedScreen"	true o false.
Los parámetros en "RequireUserPublish" te permiten limitar el número de ejecuciones consecutivas que pueden activarse desde Studio para un proyecto que no tiene cambios, y configurar ajustes de registro para los eventos en los que se excede el límite. Esto se puede utilizar para evitar que los usuarios activen ejecuciones de producción desde Studio. Como procedimiento recomendado, los proyectos que están listos para producción, deberían publicarse en Orchestrator y ejecutarse desde UiPath Assistant.	"RequireUserPublish" 1	N/D
Número máximo de veces consecutivas que se puede ejecutar un proyecto sin cambios.	"EjecucionesConsecutivasPermitidas" 1	Especifica el número permitido de veces. Si el valor es null o un número negativo, no habrá límite.
Mensaje que se le muestra al usuario en un cuadro de diálogo cuando se supera el número de ejecuciones consecutivas. El cuadro de diálogo pide al usuario que publique el proyecto o que cancele la ejecución.	"DialogMessage"	Especifica un mensaje personalizado para que se muestre entre comillas "". Si el valor es null, se utilizará el siguiente mensaje: Parece que realizas ejecuciones de producción directamente desde tu proyecto. Tu organización necesita que publiques tu proyecto en Orchestrator y que lo ejecutes desde tu UiPath Assistant.
Los parámetros en "LogToQueue" te dan la posibilidad de configurar dónde registra eventos una cola de Orchestrator. La siguiente información se registra para cada evento: nombre de usuario, nombre de proyecto, hash del archivo principal XAML y marca de tiempo de la máquina local.	"LogToQueue"	N/D
Cola de Orchestrator en la que se guardan los registros.	"QueueName"	Especifica el nombre de la cola entre comillas "". Si el valor es null, no se guardará ningún registro.
Carpeta de Orchestrator que contiene la cola en la que se guardarán los registros.	"QueueFolder"	Especifica el nombre de la carpeta de Orchestrator entre comillas "". Si el valor es null, no se guardará ningún registro.

1: los cambios afectan solo al perfil de StudioX.

Uso de orígenes del paquete

Puedes restringir el acceso, la adición o la eliminación de orígenes de paquetes en Studio o StudioX mediante el archivo de control.

{
    "PackageManager": {
        "AllowAddRemoveFeeds": false,
        "AllowEnableDisableFeeds": false,
        "AllowOrchestratorFeeds": true,
        "Feeds": [{
                "Name": "Organization Internal Feed",
                "Source": "https://[company].pkgs.visualstudio.com/_packaging/nuget-packages/nuget/v3/index.json",
                "IsEnabled": true
            },
            {
                "Name": "Official",
                "Source": "https://uipath.pkgs.visualstudio.com/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json",
                "IsEnabled": true
            }
        ]
    }
}

Parámetros		Valores
"Administrador de paquetes"	"AllowAddRemoveFeeds"		true o false.
	"AllowEnableDisableFeeds"		true o false.
	"AllowOrchestratorFeeds"		true o false.
	"Feeds"	"Nombre"	Etiqueta escrita entre comillas "", visible en Administrar paquetes.
		"Source"	Origen de la fuente escrita entre comillas "", visible en Administrar paquetes.
		"IsEnabled"	true o false.

Si los parámetros "AllowAddRemoveFeeds" y "AllowEnableDisableFeeds" se establecen en true, el usuario puede modificar las fuentes disponibles en el Administrador de paquetes. Si se realizan cambios, estos son persistentes al reiniciar Studio.

Si el parámetro "AllowOrchestratorFeeds" se establece en true y el Robot está conectado a Orchestrator, los usuarios no pueden deshabilitar las fuentes predeterminadas de Orchestrator.

Las fuentes que se definen en el archivo de control se añaden a la sección Orígenes del paquete predeterminados en la ventana Gestionar paquetes y el usuario puede añadir las fuentes personalizadas (si cuenta con los derechos necesarios en el archivo de control) a la sección Orígenes del paquete definidos por el usuario.

Ten en cuenta que la ruta hacia la fuente Local para las instalaciones por usuario es C:\Users\CurrentUser\AppData\Local\Programs\UiPath\Studio\Packages.

Configuración del panel Actividades (solo en StudioX)

La configuración en ActivitiesManager te permite ocultar actividades específicas y aplica el uso del filtro Mostrar desarrollador en StudioX.

"ActivitiesManager": {
        "AllowShowDeveloper": false,
        "HiddenActivities": ["UiPath.Mail.Activities.Business.GmailApplicationCard","UiPath.Mail.Activities.Business.OutlookApplicationCard"]
}

Configuración	Parámetros	Valor
Permite que los usuarios seleccionen el filtro Mostrar desarrollador en el panel de actividades en StudioX. Si se establece en False, la opción no estará disponible.	"AllowShowDeveloper"	true o false.
Una lista de actividades que se ocultará del panel Actividades.	"HiddenActivities"	Especifica los nombres de la actividad en la matriz, separados por comas. En el ejemplo siguiente, se han ocultado las actividades Usar Gmail y Utilizar la aplicación Outlook de escritorio. "HiddenActivities": ["UiPath.Mail.Activities.Business.GmailApplicationCard", "UiPath.Mail.Activities.Business.OutlookApplicationCard"]

Fuentes de plantillas

La configuración en GestorDePlantillas te permite forzar qué fuentes de plantillas están habilitadas o deshabilitadas para tu organización.

"TemplatesManager": {
        "Feeds": [
          {
            "Name": "GettingStarted",
            "IsEnabled": true
          },
          {
            "Name": "Official",
            "IsEnabled": true
          },
          {
            "Name": "Marketplace",
            "IsEnabled": true
          }
        ]

Configuración		Parámetros	Valor
GestorDePlantillas	Transmisiones	Nombre	El nombre de la fuente escrito entre comillas. "".
		IsEnabled	true o false.

Configuración del control de origen

La configuración en "SourceControl" te permite aplicar el uso de repositorios permitidos al trabajar con GIT, y confirmar los cambios antes de publicar.

{
      "SourceControl": {
        "PublishSourceControlInfoParam": {
          "AllowEdit": false,
          "Value": false
        },
        "CheckInBeforePublishParam": {
          "AllowEdit": false,
          "Value": false
        },
       "RepositoriesConfigParam": {
          "AllowEdit": true,
          "Value": {
            "AllowSaveLocal": null,
            "AllowEditRepositories": null,
            "Repositories": [
              {
                "SourceControlType": 0,
                "Name": null,
                "Url": null,
                "DefaultFolder": null
              }
            ]
          }
       
}

El parámetro "AllowEdit" indica si los usuarios pueden o no cambiar la configuración predeterminada configurada por el archivo de control.

Configuración de Studio	Parámetros	Valor
Consulta la información de control de origen del proceso (URL del repositorio, confirmación del repositorio, rama del repositorio, URL de idea de Automation Hub y tipo de repositorio).	PublishSourceControlInfoParam	true o false.
Check-In mandatorio antes de Publicar Nota: esta configuración está disponible en Inicio > Configuración > Diseño.	"CheckInBeforePublishParam"	true o false.
Los parámetros en RepositoriesConfigParam te permiten controlar el uso de repositorios de control de origen. Esto se aplica solo para GIT.	"RepositoriesConfigParam"	N/D
Permite que los usuarios guarden proyectos localmente en su máquina.	"AllowSaveLocal" 1	true o false. Si el valor es null, el parámetro se interpretará como true. Cuando se establezca en falso, los usuarios no podrán seleccionar Este PC como la ubicación al crear un nuevo proyecto en StudioX y se guardará el proyecto en un repositorio.
Permite que los usuarios añadan y editen repositorios.	"AllowEditRepositories"	true o false. Si el valor es null, el parámetro se interpretará como true. Si se establece en false: En la vista backstage de StudioX, las opciones en Inicio > Equipo son de solo lectura y los usuarios no pueden añadir, editar o eliminar un repositorio. En Studio, los usuarios pueden añadir URL de repositorios en la ventana Clonar un repositorio GIT remoto, pero cada URL se comprueba en la lista de repositorios permitidos.
Lista de repositorios GIT permitidos. Este parámetro acepta una matriz JSON de repositorios.	"Repositories" Nota: un repositorio que ya ha sido extraído localmente por un usuario se permite para ambos perfiles incluso si no está en la lista de permitidos para alguno de ellos.	Especifica los repositorios en la matriz añadiendo los elementos Name, Url y, si lo deseas, DefaultFolder (la carpeta predeterminada del repositorio). Ejemplo de un repositorio: "Name": "%username%'s Repo", "Url": "https://github.com/uipath/%username%", "DefaultFolder": null Añadir una URL base (p. ej., https://github.com/MyOrg/) permite el uso de repositorios con URL secundarias (p. ej., https://github.com/MyOrg/RPA). Cualquier cadena que se añada entre % en los parámetros del nombre y la URL se interpretará como variables de entorno en las máquinas del usuario. Todos los espacios en el parámetro de la URL se sustituirán por guiones (-).

1: los cambios afectan solo al perfil de StudioX.

Configuración de Studio

Los siguientes parámetros te permiten configurar los ajustes que se encuentran principalmente en Inicio (vista Backstage de Studio)> Configuración. Para obtener más información, consulta Configurar los ajustes de Studio. También hay parámetros que configuran ajustes a nivel de proyecto desde la ventana Configuración del proyecto y ajustes que no se pueden configurar desde la interfaz de usuario de Studio.

{
      "Workflow": {
        "DefaultProjectLanguageParam": {
          "Value": VisualBasic,
          "AllowEdit": false
        },
        "DefaultProjectFrameworkParam": {
          "Value": "Classic",
          "AllowEdit": true
        },          
        "AllowedProjectFrameworks": {
          "Classic": true,
          "Modern": true,
          "CrossPlatform": true
        },
        "DockedAnnotationsParam": {
          "AllowEdit": false,
          "Value": true
        },
        "ShowDataManagerOnlyParam": {
          "AllowEdit": true,
          "Value": false
        },
        "ShowPropertiesInlineParam": {
          "AllowEdit": true,
          "Value": false
        },
        "IsCollapsedViewSlimParam": {
          "AllowEdit": false,
          "Value": false
        },
        "UseSmartFilePathsParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnableLineNumberingParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnableActivityOnlineRecommendationsParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnableDiscoveredActivitiesParam": {
          "AllowEdit": true,
          "Value": true
        },
        "EnforceReleaseNotes": false,
        "DisplayLegacyFrameworkDeprecation": true,
        "AnalyzeOnPublishParam": {
          "AllowEdit": false,
          "Value": false
        },
        "PublishApplicationsMetadata": true,
        "AnalyzeOnPushParam": {
          "AllowEdit": true,
          "Value": false
        },
        "AnalyzeOnRunParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AnalyzeRpaXamlsOnlyParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AdditionalAnalyzerRulePathParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultProjectFolderParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultProcessPublishUrlParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultLibraryPublishUrlParam": {
          "AllowEdit": false,
          "Value": null
        },
        "DefaultTemplatePublishUrlParam": {
          "AllowEdit": false,
          "Value": "C:\\Users\\username\\Documents\\UiPath\\.templates"
        },
        "DefaultPipTypeParam": {
          "Value": "ChildSession",
          "AllowEdit": true
        },
        "ModernBehaviorParam": {
          "AllowEdit": false,
          "Value": false
        },
        "SeparateRuntimeDependenciesParam": {
          "AllowEdit": true,
          "Value": true
        },
        "IncludeSourcesParam": {
          "AllowEdit": true,
          "Value": true
        },
        "ObjectRepositoryEnforcedParam": {
          "AllowEdit": false,
          "Value": false
        },
        "UseConnectionServiceParam": {
          "AllowEdit": true,
          "Value": false
        },
        "PlatformAutoUpdateIntervalDaysParam": {
          "AllowEdit": true,
          "Value": 7
        },
        "HideSequencesParam": {
          "AllowEdit": true,
          "Value": true
        },
        "AutoGenerateActivityOutputsParam": {
          "AllowEdit": true,
          "Value": true
        },
        "AllowedPublishFeeds": {
          "Custom": true,
          "PersonalWorkspace": true,
          "TenantPackages": true,
          "FolderPackages": true,
          "HostLibraries": true,
          "TenantLibraries": true,
          "Local": true
        }
      },
}

Para la mayoría de opciones, estarán disponibles dos parámetros:

• "AllowEdit": indica si los usuarios están o no autorizados para modificar la configuración predeterminada establecida por el archivo de control (true para autorizar, false para denegar).
• "Valor": indica la configuración predeterminada según se describe en los cuadros siguientes.

En "Flujo de trabajo":

Configuración de Studio	Parámetros	Valor
Use el lenguaje C#	"DefaultProjectLanguageParam" 1	CSharp Si "AllowEdit" es false: autoriza solo C#. Si "AllowEdit" es true: establece el lenguaje predeterminado en C# y permite que los usuarios cambien el lenguaje predeterminado. VisualBasic Si "AllowEdit" es false: autoriza solo VB. Si "AllowEdit" es true: establece el lenguaje predeterminado en VB y permite que los usuarios cambien el lenguaje predeterminado.
Crear anotaciones acopladas	"DockedAnnotationsParam"	true o false.
Mostrar solo el panel Gestor de datos	"MostrarSoloParaMostrarDatos"	true o false.
Muestra todas las propiedades de la actividad en las fichas de actividad en el panel Diseñador.	"ShowPropertiesInlineParam"	true o false.
Ocultar secuencias	"OcultarParámetroDeSecuencias"	true o false.
Genera salidas automáticamente para las actividades	"AutoGenerateActivityOutputsParam"	true o false.
Marco de destino del proyecto predeterminado	"DefaultProjectFrameworkParam" 1	"Classic" Si "AllowEdit" es false: permite solo Windows heredado (.NET Framework 4.6.1). Si "AllowEdit" es true: establece el marco de destino predeterminado en Windows: heredado y permite a los usuarios cambiar el marco de destino. "Modern" Si "AllowEdit" es false: autoriza Windows solamente. Si "AllowEdit" es true: establece el destino predeterminado en Windows y autoriza a los usuarios a cambiar el marco de destino. "Cross-platform" Si "AllowEdit" es false: autoriza multiplataforma solamente. Si "AllowEdit" es true: establece el destino predeterminado en multiplataforma y autoriza a los usuarios a cambiar el marco de destino.
Los parámetros en "AllowedProjectFrameworks" determinan los marcos de destino permitidos al crear o abrir un proyecto en el perfil de Studio. Para habilitar un marco, establece su parámetro en true. Nota: esta configuración no se puede configurar desde la IU de Studio.	"AllowedProjectFrameworks" 1	true o false. para cada uno de los siguientes: "Classic" (Windows [heredado]) "Modern" (Windows) "Cross-platform" (multiplataforma)
Utilizar rutas de archivos inteligentes	"UseSmartFilePathsParam" 2	true o false.
Habilitar numeración de líneas	"EnableLineNumberingParam"2	true o false.
Habilitar sugerencias de actividad de IA	"EnableActivityOnlineRecommendationsParam"	true o false.
Mostrar todos los paquetes de actividades oficiales que se pueden instalar en tu proyecto	"EnableDiscoveredActivitiesParam"	true o false.
Realiza un seguimiento de las aplicaciones y URL externas a las que se dirige una automatización en proyectos de Windows y multiplataforma. Es necesario instalar las últimas versiones de los paquetes de actividades. Nota: esta configuración no se puede configurar desde la IU de Studio.	"PublishApplicationsMetadata"	true o false.
Hacer que el campo Notas de la versión en el asistente de publicación sea obligatorio Nota: esta configuración no se puede configurar desde la IU de Studio.	"EnforceReleaseNotes"	true o false.
Establezca la visibilidad del mensaje que aparece al abrir un proyecto de Windows (heredado). Nota: esta configuración no se puede configurar desde la IU de Studio.	"DisplayLegacyFrameworkDeprecation"	true o false.
Vista reducida de las actividades contraídas	"IsCollapsedViewSlimParam"	true o false.
Aplicar Analizador antes de Publicar	"AnalyzeOnPublishParam"	true o false.
Aplicar Analizador antes de Insertar/Confirmar	"AnalyzeOnPushParam"	true o false.
Aplicar Analizador antes de Ejecutar	"AnalyzeOnRunParam"	true o false.
Analizar solo archivos de RPA XAML	"AnalyzeRpaXamlsOnlyParam"	true o false.
Localización de las normas del analizador de flujo de trabajo	"AdditionalAnalyzerRulePathParam"	null: utiliza la ubicación predeterminada. Para modificar la ubicación, introduce entre comillas la ruta a la carpeta en la que se almacenan las reglas personalizadas.
Ruta del proyecto	"DefaultProjectFolderParam"	null: utiliza la ubicación predeterminada. Para modificar la ubicación, introduce entre comillas la ruta a la carpeta en la que se almacenan las reglas personalizadas.
URL del proceso de publicación	"DefaultProcessPublishUrlParam"	null: utiliza la ubicación predeterminada. Para modificar la ubicación, introduce la ruta entre comillas.
Publicar la URL de la librería	"DefaultLibraryPublishUrlParam"	null: utiliza la ubicación predeterminada. Para modificar la ubicación, introduce la ruta entre comillas.
Publicar la URL de las plantillas del proyecto	"DefaultTemplatePublishUrlParam"	Para modificar la ubicación, introduce la ruta entre comillas.
Use Modern para proyectos nuevos	"ModernBehaviorParam"	true o false.
Separar las dependencias de Runtime Nota: esta configuración se encuentra en la ventana Configuración del proyecto.	"SeparateRuntimeDependenciesParam"	true o false.
Incluir orígenes Nota: esta configuración se encuentra en la ventana Configuración del proyecto.	"IncludeSourcesParam"	true o false.
Repositorio de Objetos obligatorio	"ObjectRepositoryEnforcedParam"	true o false.
Predeterminado para conexiones administradas	"UseConnectionServiceParam"	true o false.
Los parámetros bajo "AllowedPublishFeeds" determinan las ubicaciones de publicación disponibles para los usuarios. Para habilitar una ubicación de publicación, establece su parámetro en true. Nota: esta configuración no se puede configurar desde la IU de Studio.	"AllowedPublishFeeds"	true o false. para cada uno de los siguientes: "Personalizado", "EspacioDeTrabajoPersonal", "PaquetesTenant", "PaquetesDeCarpetas", "BibliotecasHost", "BibliotecasTenant", "Local".
Tipo de PiP	"DefaultPipTypeParam"	ChildSession: nueva sesión. SecondaryDesktop: nuevo escritorio.

1: los cambios afectan solo al perfil de Studio.

2: los cambios afectan solo al perfil de StudioX.

En "ObjectBrowser":

Configuración de Studio	Parámetros	Valor
Enviar descriptores de IU anónimos	"SendUiDescriptors"	true o false

Enviar datos de uso de Studio a tu organización

Los parámetros de "Telemetría" te permiten habilitar el envío de datos de uso de Studio a un recurso de Application Insights en tu portal de Azure. Estos datos te permite supervisar y analizar qué hacen los usuarios en Studio. Para habilitar esta característica, introduce la clave de instrumentación de tu instancia de Application Insights en el parámetro "instrumentation-keys".

{
       "Telemetry": {
        "TelemetryOptions": {
          "TelemetryOptionsDictonary": {
            "instrumentation-keys": ""
        }
      }
   }
}

Consulta la siguiente tabla para obtener información sobre los datos de la telemetría que se envían a Application Insights.

Acción	Nombre de evento	Datos recopilados
Se inicia Studio	StudioStarted	ID usuario de Windows ID de sesión
Se cierra Studio	StudioClosed	ID usuario de Windows ID de sesión Duración de la sesión
Se abre un proyecto	Abrir proyecto	ID usuario de Windows ID de sesión Nombre de proyecto
Se crea un proyecto 1	Nuevo proyecto NuevoProyectoCreado	ID usuario de Windows ID de sesión Nombre de proyecto
Se ejecuta el proyecto	RunProject StartDebug 2	ID usuario de Windows ID de sesión Nombre de proyecto
Se ejecuta el archivo	EjecutarDocumento StartDebug 2	ID usuario de Windows ID de sesión Nombre de proyecto
Se depura el proyecto	DebugProject StartDebug 2	ID usuario de Windows ID de sesión Nombre de proyecto
Se depura el archivo	DebugDocument StartDebug 2	ID usuario de Windows ID de sesión Nombre de proyecto
Ejecutar en esta actividad se está ejecutando	Designer_RunTo	ID usuario de Windows ID de sesión Nombre de proyecto
Se publica un proyecto	Publicar proyecto	ID usuario de Windows ID de sesión Nombre de proyecto URL de Orchestrator Nombre de la carpeta Ubicación de la publicación (fuente)
El paquete de actividad está instalado	PackageAdded	ID usuario de Windows ID de sesión Nombre del paquete Versión del paquete Nombre de proyecto
La actividad se añade a un proyecto	S.Activities.ActivityAdded	ID usuario de Windows ID de sesión Nombre de actividad Nombre del paquete Versión del paquete
El destino se indica en la actividad Automatización de IU	S.Activities.PropertyChanged	ID usuario de Windows ID de sesión

1: cuando se crea un proyecto, se genera NuevoProyecto cuando el usuario selecciona crear un nuevo proyecto en la vista Backstage de Studio, y NuevoProyectoCreado se genera cuando el usuario hace clic en el botón Crear en el cuadro de diálogo nuevo proyecto.

2 - El evento StartDebug realiza un seguimiento del robot de destino que ejecutó la operación: el robot local (Local) o un robot remoto (Orchestrator para la conexión de robots sin supervisión, Remote para la conexión de máquinas remotas).

Utilizar los datos en Application Insights

Además de los escenarios de casos de uso descritos en la documentación oficial de Microsoft, puedes probar y crear consultas mediante Log Analytics en el Azure Monitor de su instancia de Azure Insights. Para ver todos los datos posibles de un evento, puedes crear una consulta simple que explore todas sus apariciones en el rango de tiempo predefinido. Por ejemplo:

customEvents
| where name == "StudioStarted"

En la siguiente tabla encontrarás ejemplos de consultas de telemetría y una descripción de cada una de ellas. También puedes consultar la lista de problemas conocidos.

Evento	Ejemplo de consulta	Descripción de la consulta
StudioStarted Se inicia Studio	customEvents | where name == "StudioStarted" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Número de veces al día que se ha abierto Studio en los últimos 30 días, sin contar el día actual.
StudioClosed Se cierra Studio	customEvents | where name == "StudioClosed" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Número de veces al día que se ha cerrado Studio en los últimos 30 días, sin contar el día actual.
StudioClosed Se cierra Studio	customEvents | where name == "StudioClosed" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend TotalSessionTimeInSeconds = tostring(customDimensions.TotalSessionTimeInSeconds) | extend SessionId = tostring(parse_json(tostring(customDimensions.Context)) .SessionId) | summarize AvgSessionTime_inMinutes = round(avg(todouble(TotalSessionTimeInSeconds))/60,2) by bin(timestamp, 1d) | order by timestamp desc	Duración media (en minutos redondeados a dos decimales) de la sesión diaria de los últimos 30 días, sin contar el día actual.
Abrir proyecto Se abre un proyecto	customEvents | where name == "OpenProject" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Número de veces al día que se ha abierto un proyecto en los últimos 30 días, sin contar el día actual.
NuevoProyectoCreado Se crea un proyecto	customEvents | where name == "NewProjectCreated" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActionArgs = tostring(customDimensions .ActionArgs) | where ActionArgs != "" | summarize count(name) by ActionArgs, bin(timestamp, 1d) | order by timestamp desc	Número y tipo de proyectos que se han creado en los últimos 30 días, sin contar el día actual.
StartDebug El proyecto se ejecuta o se depura/El archivo se ejecuta o se depura	customEvents | where name == "StartDebug" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend RunTarget = tostring(customDimensions .RunTarget) | summarize count(name) by RunTarget, bin(timestamp, 1d) | order by timestamp desc	Número de ejecuciones que se han iniciado y para qué objetivo en los últimos 30 días, sin contar el día actual.
Designer_RunTo Ejecutar en esta actividad está en ejecución	customEvents | where name == "Designer_RunTo" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Cuántas veces se ha ejecutado Ejecutar en esta actividad en los últimos 30 días, sin contar el día actual.
Publicar proyecto Se publica un proyecto	customEvents | where name == "PublishProject" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | summarize count(name) by bin(timestamp, 1d) | order by timestamp desc	Cuántos proyectos se han publicado en los últimos 30 días, sin contar el día actual.
PackageAdded El paquete de actividad está instalado	customEvents | where name == "PackageAdded" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActionArgs = tostring(customDimensions. ActionArgs) | summarize count(name) by ActionArgs, bin(timestamp, 1d) | order by timestamp desc	Número y nombre de los paquetes que se han instalado en los últimos 30 días, sin contar el día actual.
S.Activities.ActivityAdded La actividad se añade a un proyecto	customEvents | where name == "S.Activities.ActivityAdded" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActivityType = tostring(customDimensions. ActivityType) | extend PackageName = tostring(customDimensions.PackageName) | extend PackageVersion = tostring(customDimensions.PackageVersion) | summarize count(name) by ActivityType, PackageName, PackageVersion, bin(timestamp, 1d) | order by timestamp desc	Número de actividades que se han añadido en los últimos 30 días, sin contar el día actual. Incluye el nombre y la versión del paquete del que procede cada actividad. 3
S.Activities.PropertyChanged El destino se indica en la actividad Automatización de IU	customEvents | where name == "S.Activities.PropertyChanged" | where timestamp >= startofday(ago(30d)) and timestamp <= endofday(ago(1d)) | extend ActivityType = tostring(customDimensions.ActivityType) | extend PropertyName = tostring(customDimensions.PropertyName) | summarize count(name) by ActivityType, PropertyName, bin(timestamp, 1d) | order by timestamp desc	Número de veces que se han cambiado las propiedades de las actividades utilizadas en los últimos 30 días, sin contar el día actual. Incluye los nombres de las actividades y el nombre de cada propiedad que se ha modificado.

En la siguiente tabla se enumeran los parámetros adicionales que se incluyen de forma predeterminada en los eventos.

Parámetro	Descripción	Representación en la consulta (en un evento seleccionado)
customDimensions	Colección detallada de datos y parámetros relacionados con cada evento.	customEvents | where name == "StudioStarted" | extend customDimensions
Context	Parte de la colección customDimensions que gestiona los detalles del proyecto, incluidos el perfil, el ID de usuario, el tipo de licencia, el tipo de robot y el ID de sesión.	customEvents | where name == "StudioStarted" | extend Context = parse_json(customDimensions.Context)
Entorno	Parte de la colección customDimensions que consta del nombre de la máquina, la versión del sistema operativo y el nombre de usuario.	customEvents | where name == "StudioStarted" | extend Environment = parse_json(customDimensions.Environment)

Log Analytics te permite ampliar de manera explícita cada tipo de dato que forma parte de los parámetros mencionados para que sirva de filtro o se utilice como elemento adicional de resumen. Para ello, haz clic en el icono de tres puntos situado junto a un elemento de datos del registro y, a continuación, elige ampliar los datos o utilizarlos como filtro.

Consulta la siguiente tabla para ver ejemplos de ampliación o filtrado de datos.

Ejemplo de datos	Representación en la consulta (en un evento seleccionado)
ApplicationName (extend)	customEvents | where name == "StudioStarted" | extend ApplicationName = tostring(customDimensions.ApplicationName)
LicenseType (extend)	customEvents | where name == "StudioStarted" | extend LicenseType = tostring(parse_json(tostring(customDimensions.Context)).LicenseType)
OSVersion (filtro incluido)	customEvents | where name == "StudioStarted" | where parse_json(tostring(customDimensions.Environment)).OSVersion == "Microsoft Windows NT 10.0.19043.0"
CurrentLanguage (filtro incluido)	customEvents | where name == "StudioStarted" | where parse_json(tostring(customDimensions.Context)).CurrentLanguage == "en"

Problemas conocidos

• El evento PublishProject solo muestra los detalles de los proyectos publicados en Orchestrator.
• El evento S.Activities.ActivityAdded muestra una versión incorrecta del paquete.

Reglas del analizador de flujo de trabajo

El Analizador de flujo de trabajo es la herramienta que se utiliza para verificar si los proyectos cumplen las normas de desarrollo. Utilizando el archivo de control, las organizaciones pueden aplicar reglas personalizadas ajustadas a sus necesidades en todos los proyectos de una forma centralizada.

Observaciones

• El conjunto de reglas personalizadas se puede definir de antemano en un archivo independiente de tipo .json, y puede entregarse a través de un ensamblado externo dll o un paquete de actividades personalizadas. Consulta más información sobre Crear reglas personalizadas para el Analizador de flujo de trabajo.
• El archivo de control no puede proporcionar credenciales, lo que significa que no se admiten fuentes seguras.
• Si se aplica el conjunto de reglas personalizadas, los usuarios no pueden realizar modificaciones de las reglas del Analizador de flujo de trabajo.
• Si no se referenció o insertó un conjunto de reglas personalizadas en el archivo de control, se utilizan las reglas predeterminadas del Analizador de flujo de trabajo. Si no se menciona la sección "Analizador", no se aplica el control para el Analizador de flujo de trabajo. Si se menciona la sección, aunque esté vacía, la gestión de reglas se deshabilita en Studio.
• Al aplicar las reglas de control, los paquetes de actividades integrados de Studio o UiPath se deshabilitan de forma predeterminada, salvo que se indique lo contrario en el archivo de control o en el conjunto de reglas personalizado.

Aplicar reglas

El conjunto de reglas personalizado se puede administrar de dos formas en el archivo de control uipath.policies.config:

1. Dirígete al conjunto de reglas ubicado en una de las siguientes rutas:

   • en la máquina local;
   • compartido en una máquina o un servidor de red identificable por la ruta UNC;
   • en un almacenamiento de blobs compartido, identificable por la ruta http(s).
2. Inserta el conjunto de reglas habilitando o deshabilitando reglas, mencionando sus ID, parámetros y niveles de error.

Todas las reglas personalizadas deben estar referenciadas o añadidas en la sección "Analyzer". Las reglas y los contadores deben dividirse en sus propias secciones como se ilustra a continuación:

{
    "Analyzer": {
    "AllowEdit": false,
        "ReferencedRulesConfigFile": null,
        "EmbeddedRulesConfig": {
            "Rules": [
        {
                    "Id": "ST-NMG-001",
                    "IsEnabled": false,
                    "Parameters": [{
                        "Name": "Regex",
                        "Value": null
                    }],
                    "ErrorLevel": "Error"
                }
            ],
            "Counters": [{
                "Id": "ST-ANA-009",
                "IsEnabled": true,
                "Parameters": []
            }]
        }
    }
}

Parámetros/Secciones	Valores
"AllowEdit"	Si se establece en true, los ajustes de control pasan como predeterminados, lo que permite al usuario introducir modificaciones en las reglas. Si se establece en false, no se pueden introducir modificaciones en las reglas. Si no se añade el parámetro, los usuarios tienen limitaciones para editar las reglas de forma predeterminada.
"ReferencedRulesConfigFile"	Ruta al conjunto de reglas .json Use null para aplicar reglas de "EmbeddedRulesConfig"
"EmbeddedRulesConfig"	Mantiene "Rules" y "Counters"
"Id"	Rule ID, ex. ST-NMG-001
"IsEnabled"	true o false
"Parameters"	Contiene los parámetros Name y Valuela regla Utilice [] si la regla no tiene parámetros.
"Name"	El nombre del parámetro escrito entre comillas.
"Value"	El valor del parámetro escrito entre comillas Puede ser null
"ErrorLevel"	Error, Warning, Info o Verbose.
"Counters"	Contiene los parámetros para contadores: "Id", "IsEnabled", "Parameters" 1.

1: puesto que los contadores no tienen parámetros, usa [].

Si el parámetro "AllowEdit" se establece en true, el usuario puede modificar las reglas disponibles en la ventana de configuración del Analizador de flujo de trabajo. Si se realizan cambios, estos son persistentes al reiniciar Studio.

Aplica la política de control

Aviso: Recomendamos configurar e implementar políticas utilizando Automation Ops. Para obtener más información sobre cómo crear políticas desde archivos de control generados desde Studio, consulta Crear una política de control en la guía Automation Ops.

Usar un archivo local

Si se ha almacenado localmente, el archivo de control debe estar ubicado en la siguiente ruta: %AppData%\UiPath.

Usar un archivo externo

Si se almacena externamente, la ruta al archivo de política debe definirse utilizando el Registro de Windows o un activo de Orchestrator:

Para definir la ruta del archivo utilizando el Registro de Windows:

1. Abre el Editor de registro de la máquina en la que tengas instalado Studio.
2. Localiza la siguiente clave de registro: Computer\HKEY_CURRENT_USER\Software\UiPath y pulsa Intro.
3. En el Editor de registro, haz clic derecho y selecciona Nuevo > Valor de cadena. Escribe el nombre GovernanceSource para el nuevo valor. ¡No utilices otro nombre para el valor!
4. Haz doble clic en la cadena GovernanceSource para editar. En el campo Datos de valor añade la ruta al archivo uipath.policies.config y haz clic en Aceptar.
   • Si el archivo de política se almacena localmente, un ejemplo para este campo sería C:\policies\uipath.policies.config.
   • Si el archivo de política está almacenado en un servidor, un ejemplo para este campo sería 192.168.1.1\policies\uipath.policies.config.

La clave de registro debe tener esta forma:

Para definir la ruta del archivo utilizando un activo de Orchestrator:

1. En Orchestrator, selecciona Tenant > Carpetas y añade una carpeta nueva con el nombre uipath.settings.config.
2. Asigna los usuarios para aplicar la política de control a la carpeta.

3. En la carpeta uipath.settings.config crea un activo nuevo y configúralo del siguiente modo:

   • Nombre del activo: uipath.studio.governancesource.
   • Tipo: texto.

   • Valor global: selecciona esta opción e introduce la ruta completa al archivo uipath.policies.config en el cuadro de texto.

     Opcionalmente, puedes aplicar políticas diferentes para usuarios distintos añadiendo valores por usuario con rutas a distintos archivos.

     
     

     

     
     

Usar un activo de Orchestrator

1. En Orchestrator, selecciona Tenant > Carpetas y añade una carpeta nueva con el nombre uipath.settings.config.
2. Asigna los usuarios para aplicar la política de control a la carpeta.

3. En la carpeta uipath.settings.config crea un activo nuevo y configúralo del siguiente modo:

   • Nombre del activo: uipath.studio.governancepolicy.
   • Tipo: texto.

   • Valor global: selecciona esta opción y pega todo el contenido del archivo uipath.policies.config en el cuadro de texto.

     Opcionalmente, puedes aplicar políticas diferentes a usuarios distintos añadiendo valores por usuario y pegando distintos parámetros.

     Nota:

     • Enforcing a governance policy using an Orchestrator asset that references the file path or holds the contents of the file requires Orchestrator v2020.10 or later with modern folders.
     • Los usuarios deben iniciar sesión en su cuenta en Studio para recibir políticas por usuario.
     
     

     

     
     

Aplicar y preferencia

Cuando se define una política, esta se aplica después de reiniciar Studio.

Aparece un mensaje en la ventana de configuración del Analizador de flujo de trabajo, en la ventana Enviar comentarios, en la pestaña Configuración de la vista Backstage, y en la ventana Gestionar paquetes.

Studio aplica la política de control utilizando el siguiente orden de prioridad: Automation Ops > uipath.studio.governancepolicy > uipath.studio.governancesource > Clave de registro > archivo local.

Si la política de control se elimina para el usuario, la configuración que se aplicó a través del archivo de control persiste como configuración predeterminada. Sin embargo, ahora el usuario puede modificar los ajustes que estaban restringidos cuando regía la política de control.