Control

Studio incluye un modelo de control basado en archivos que puede aplicarse a nivel de la organización para ejercer un nivel de control sobre determinadas funcionalidades.

Las capacidades actuales son:

• aplica por Studio, Studio Pro o StudioX, y cualquier combinación de estos.
• 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 varios ajustes de diseño y ubicación.
• deshabilita la funcionalidad Enviar comentarios.

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.

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

Ten en cuenta que si tienes instalado UiPathStudioSetup.exe, debes modificar la ruta a la fuente local a C:\Users\CurrentUser\AppData\Local\UiPath\app-Studio_version.

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"
    },
    "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 Backstage > Ayuda, en Política de la empresa.

Perfiles de Studio y enviar comentarios

El archivo de control puede contener políticas para los usuarios de Studio, Studio Pro y StudioX; no obstante, estas deben estructurarse por perfil. Las políticas de Studio deben separarse de las de StudioX y de las de Studio Pro, como se indica a continuación:

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

Parámetros	Valores
"Perfiles"	Para Studio: Development Para StudioX: Business Para Studio Pro: StudioPro los tres se aceptan en el mismo archivo.
"Shell" > "IsFeedbackEnabled", "HideGettingStartedScreen"	true o false.

Uso de orígenes del paquete

Al utilizar el archivo de control, el acceso, la adición o la eliminación de orígenes del paquete pueden estar restringidos para Studio, StudioX, Studio Pro o cualquier combinación de los tres.

{
    "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://www.myget.org/F/workflow/",
                "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 Gestionar paquetes.
		"Source"	Origen de fuente escrito entre comillas "" visible en Gestionar 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.

Configuración de Studio

Configura los ajustes encontrados en Inicio (vista Backstage de Studio) > Configuración. Para obtener más información, consulta Configurar los ajustes de Studio.

{
      "SourceControl": {
        "CheckInBeforePublishParam": {
          "AllowEdit": false,
          "Value": false
        }
      },
      "Workflow": {
        "DefaultProjectLanguageParam": {
          "Value": VisualBasic,
          "AllowEdit": false
        },
        "DockedAnnotationsParam": {
          "AllowEdit": false,
          "Value": true
        },
        "IsCollapsedViewSlimParam": {
          "AllowEdit": false,
          "Value": false
        },
        "AnalyzeOnPublishParam": {
          "AllowEdit": false,
          "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"
        },
        "ModernBehaviorParam": {
          "AllowEdit": false,
          "Value": false
        },
        "ObjectRepositoryEnforcedParam": {
          "AllowEdit": false,
          "Value": false
        }
      },
}

Hay dos parámetros disponibles para cada opción:

• "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 "Control de origen":

Configuración de la vista Backstage	Parámetros	Valor
Check-In mandatorio antes de Publicar	"CheckInBeforePublishParam"	true o false.

En "Flujo de trabajo":

Configuración de la vista Backstage	Parámetros	Valor
Use el lenguaje C#	"DefaultProjectLanguageParam" Nota: las modificaciones de este parámetro se aplican solo en el perfil de Studio Pro.	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.
Vista reducida de las actividades contraídas	"IsCollapsedViewSlimParam"	true o false.
Aplicar Analizador antes de Publicar	"AnalyzeOnPublishParam"	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.
Repositorio de Objetos obligatorio	"ObjectRepositoryEnforcedParam"	true o false.

En "ObjectBrowser":

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

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"	Identificador de la regla, p. ej., 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 : dado 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

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:

Nota: Aplicar una política de control mediante un activo de Orchestrator que haga referencia a la ruta del archivo o contenga los contenidos de archivo está disponible a partir de Studio v2020.10.4. Esta funcionalidad requiere Orchestrator v2020.10 o posterior.

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.

     Nota: la aplicación de políticas por usuario funciona en la versión Studio v2020.10.8 y posteriores para Automation Cloud Orchestrator, y la versión Studio v2020.10.9 y posteriores para On-Premises Orchestrator.

     

Usar un activo de Orchestrator

Nota: Aplicar una política de control mediante un activo de Orchestrator que haga referencia a la ruta del archivo o contenga los contenidos de archivo está disponible a partir de Studio v2020.10.4. Esta funcionalidad requiere Orchestrator v2020.10 o posterior.

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 para usuarios distintos añadiendo valores por usuario y pegando distintos parámetros.

     Nota: la aplicación de políticas por usuario funciona en la versión Studio v2020.10.8 y posteriores para Automation Cloud Orchestrator, y la versión Studio v2020.10.9 y posteriores para On-Premises Orchestrator.

     

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: 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.