Governança

O Studio vem com um modelo de governança baseado em arquivo, o qual pode ser aplicado em nível organizacional para exercer um nível de controle sobre certas funcionalidades.

Os recursos atuais são:

• aplicar por Studio, Studio Pro ou StudioX e qualquer combinação entre eles.
• restrict usage of package feeds from the Manage Packages window and Backstage View>Settings > Manage Sources.
• enforce organizational development standards using Workflow Analyzer rules.
• enforce several design and location settings.
• disable Send Feedback functionality.

Assista o vídeo a seguir para obter uma visão geral dos recursos de governança disponíveis no Studio, bem como uma demonstração de como usá-los no StudioX.

To enforce a governance policy, start by generating a governance file from Studio, then configure the file using the parameters it contains, and apply the policy in one of the following ways:

• Using a local file (for testing purposes) - Place the governance file in the Roaming folder on the machine where Studio is installed.
• Using an external file (for large deployments) - Place the governance file at a path (for example, an HTTP/HTTPS server) referenced by either a registry key or an asset in Orchestrator.
• Using an asset in Orchestrator- Copy the contents of the governance file to an asset in Orchestrator.

Gerar Arquivo da Governança

O primeiro passo na aplicação dos padrões de desenvolvimento de sua organização é gerar um arquivo de governança a partir do Studio ou criar manualmente um arquivo semelhante que incorporaria todos ou parte dos recursos que listamos acima.

Importante:

O arquivo de governança deve ser do tipo .config com o nome de uipath.policies.config.

Para gerar um arquivo de governança com a configuração atual do Studio, acesse a Exibição Backstage > guia Help e selecione Gerar Arquivo de Governança. O arquivo exportado pode ser compartilhado entre os membros de sua equipe.

Use o botão abaixo para baixar o exemplo que inclui todas as regras do Analisador de Fluxo de Trabalho. Modifique o exemplo para atender às necessidades de sua organização.

Fazer download de amostra

Lembre-se que, se você instalou o UiPathStudioSetup.exe, precisará mudar o caminho do feed Local para C:\Users\CurrentUser\AppData\Local\UiPath\app-Studio_version.

Configurar o Arquivo de Governança

Versão do Arquivo e Rótulo do Arquivo

Os arquivos de governança podem ter diferentes versões e um nome personalizado.

{
    "Metadata": {
        "Version": "1.0"
    },
    "Info": {
        "Name": "Sample Policy Registry Key"
    }
}

Parâmetros	Valores
"Metadata" > "Version"	major.minor between quotation marks ""
"Info" > "Name"	Rótulo escrito entre aspas '''' visible in Backstage > Help, under Company Policy.

Perfis do Studio e Enviar Feedback

O arquivo de governança pode conter políticas para os usuários de Studio, Studio Pro e StudioX. Entretanto, elas devem ser estruturadas por perfil. As políticas do Studio devem ser separadas daquelas do StudioX e das do Studio Pro, conforme apresentado no exemplo abaixo:

{
    "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
"Profiles"	Para o Studio: Development Para o StudioX: Business Para o Studio Pro: StudioPro todos os três são aceitos no mesmo arquivo.
"Shell" > "IsFeedbackEnabled", "HideGettingStartedScreen"	A true ou false.

Uso das Origens do Pacote

Acessar, adicionar ou remover origens de pacote podem ser restrito por Studio, StudioX, Studio Pro ou qualquer combinação dos três, usando o arquivo de governança.

{
    "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
"Package Manager"	"AllowAddRemoveFeeds"		A true ou false.
	"AllowEnableDisableFeeds"		A true ou false.
	"AllowOrchestratorFeeds"		A true ou false.
	"Feeds"	“Nome”	Rótulo escrito entre aspas '''' visible in Manage Packages.
		"Source"	Origem do feed escrita entre aspas "" visible in Manage Packages.
		"IsEnabled"	A true ou false.

Se os parâmetros "AllowAddRemoveFeeds" e "AllowEnableDisableFeeds" estiverem definidos como true, o usuário poderá modificar os feeds disponíveis no Gerenciador de Pacotes. Se forem feitas alterações, elas persistirão quando o Studio for reiniciado.

Se o parâmetro "AllowOrchestratorFeeds" for definido como true e o Robô estiver conectado ao Orchestrator, os usuários não poderão desabilitar os feeds padrão do Orchestrator.

Os feeds definidos no arquivo de governança são adicionados à seção das origens do pacote Padrão na janela Gerenciar Pacotes e o usuário pode adicionar feeds personalizados (se tiverem os privilégios necessários no arquivo de governança) à seção Origens de pacote definidas pelo usuário.

Configurações do Studio

Configure settings found in Home (Studio Backstage View) > Settings. For more information, see Configuring Studio Settings.

{
      "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
        }
      },
}

Para cada opção há dois parâmetros disponíveis:

• "AllowEdit" - Indique se os usuários têm ou não permissão de alterar a definição padrão configurada pelo arquivo de governança (true para permitir e false para negar).
• "Valor" - Indique a configuração padrão, conforme descrita nas tabelas a seguir.

Em "SourceControl":

Configuração do Backstage	Parâmetros	Valor
Impor o Check-In antes da Publicação	"CheckInBeforePublishParam"	A true ou false.

Em "Workflow":

Configuração do Backstage	Parâmetros	Valor
Usar Linguagem C#	"DefaultProjectLanguageParam" Changes to this parameter take effect only in the Studio Pro profile.	CSharp Se "AllowEdit" for false - Permitir somente C#. Se "AllowEdit" for true - Definir a linguagem #C como padrão e permitir que os usuários mudem a linguagem padrão. VisualBasic Se "AllowEdit" for false - Permitir somente VB. Se "AllowEdit" for true — definir a linguagem padrão como VB e permitir que os usuários alterem a linguagem padrão.
Criar anotações encaixadas	"DockedAnnotationsParam"	A true ou false.
Exibição Fina para Atividades Recolhidas	"IsCollapsedViewSlimParam"	A true ou false.
Impor o Analisador antes da Publicação	"AnalyzeOnPublishParam"	A true ou false.
Impor o Analisador antes de Executar	"AnalyzeOnRunParam"	A true ou false.
Analisar Somente Arquivos XAML do RPA	"AnalyzeRpaXamlsOnlyParam"	A true ou false.
Localização das Regras do Analisador de Fluxo de Trabalho	"AdditionalAnalyzerRulePathParam"	null - Use a localização padrão. Para alterar a local, insira o caminho para a pasta em que as regras personalizadas estão armazenadas entre aspas.
Caminho do projeto	DefaultProjectFolderParam	null - Use a localização padrão. Para alterar a local, insira o caminho para a pasta em que as regras personalizadas estão armazenadas entre aspas.
URL de Publicação do processo	"DefaultProcessPublishUrlParam"	null - Use a localização padrão. Para alterar o local, insira o caminho entre aspas.
URL de Publicação da biblioteca	"DefaultLibraryPublishUrlParam"	null - Use a localização padrão. Para alterar o local, insira o caminho entre aspas.
URL de Publicação de modelos de projeto	"DefaultTemplatePublishUrlParam"	Para alterar o local, insira o caminho entre aspas.
Use a Moderna para novos projetos	"ModernBehaviorParam"	A true ou false.
Repositório de Objetos imposto	"ObjectRepositoryEnforcedParam"	A true ou false.

Em "ObjectBrowser":

Configuração do Backstage	Parâmetros	Valor
Enviar Descritores de Interface Gráfica anônimos	"SendUiDescriptors"	Seja true ou false

Regras do Analisador de Fluxo de Trabalho

The Workflow Analyzer is the tool for verifying if projects meet development standards. Using the governance file, organizations can enforce custom rules pertaining to their needs across all projects, in a centralized manner.

Considerações

• O conjunto de regras personalizadas pode ser definido antecipadamente em um arquivo separado do tipo .json, sendo entregue por meio de uma assembly dll externa ou um pacote de atividades personalizadas. Leia mais sobre Como Criar Regras Personalizadas para o Analisador de Fluxo de Trabalho.
• O arquivo de governança não pode fornecer credenciais, o que significa que feeds seguros não são compatíveis.
• Se for aplicado um conjunto de regras personalizadas, então os usuários não poderão fazer nenhuma alteração nas regras do Analisador de Fluxo de Trabalho.
• Se um conjunto de regras personalizadas não tiver sido referenciado ou inserido no arquivo de governança, as regras padrão do Analisador de Fluxo de Trabalho serão usadas. Se a seção "Analisador" não for mencionada, a governança do Analisador de Fluxo de Trabalho não será aplicada. Se a seção for mencionada, mesmo se estiver vazia, então o gerenciamento de regras será desabilitado no Studio.
• Ao aplicar a governança, as regras integradas do Studio ou dos pacotes de atividades do UiPath são desabilitadas por padrão, a menos que mencionado de modo distinto no arquivo de governança ou nos conjunto de regras personalizadas.

Regras de Aplicação

Há duas maneiras de se gerenciar o conjunto de regras personalizadas no arquivo de governança uipath.policies.config:

1. Apontar para o conjunto de regras localizado em um dos seguintes caminhos:
   • na máquina local;
   • compartilhado em um servidor de rede ou máquina, que possa ser identificado pelo caminho do UNC;
   • em armazenamento de Blobs compartilhado, que possa ser identificado através de caminho http(s).
2. Inserir o conjunto de regras personalizadas, habilitando ou desabilitando regras, mencionando suas IDs, níveis de erro.

Todas as regras personalizadas devem ser referidas ou adicionadas na seção "Analyzer". As regras e os contadores devem ser divididos em suas próprias seções, conforme ilustrado abaixo:

{
    "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/Seções	Valores
"AllowEdit"	Se definidas como true, as configurações de governança são passadas como padrão, o que permite ao usuário alterar as regras. Se definidas como false, não podem ser feitas mudanças nas regras. Se o parâmetro não for adicionado, por padrão os usuários ficam impedidos de editar regras.
"ReferencedRulesConfigFile"	Caminho para o conjunto de regras .json Use null para aplicar as regras do "EmbeddedRulesConfig"
"EmbeddedRulesConfig"	Contém "Rules" e "Counters"
"Id"	Rule ID, ex. ST-NMG-001
"IsEnabled"	Seja true ou false
"Parameters"	Contém Name e Valuedo parâmetro da regra Use [] se a regra não tiver parâmetros.
"Name"	O nome do parâmetro escrito entre aspas.
"Value"	O valor do parâmetro escrito entre aspas Pode ser null
"ErrorLevel"	Seja Error, Warning, Info ou Verbose.
"Counters"	Contém parâmetros para os contadores: "Id", "IsEnabled", "Parameters" 1.

1 - Como os contadores não têm parâmetros, utilize [].

Se o parâmetro "AllowEdit" for definico como true, o usuário poderá modificar as regras disponíveis disponíveis na janela de configurações do Analisador de Fluxo de Trabalho. Se forem feitas alterações, elas persistirão quando o Studio for reiniciado.

Aplicar a Política de Governança

Como usar um arquivo local

Se armazenado localmente, o arquivo de governança deve localizar-se no seguinte caminho: %AppData%\UiPath.

Como usar um arquivo externo

Se armazenado externamente, o caminho para o arquivo de política deve ser definido usando o Registro do Windows ou um ativo do Orchestrator:

Para definir o caminho do arquvo usando o Registro do Windows:

1. Abra o Editor de Registros na máquina em que o Studio estiver instalado.
2. Localize a seguinte chave de registro: Computer\HKEY_CURRENT_USER\Software\UiPath e pressione Enter.
3. No Editor de Registros, clique com o botão direito do mouse e selecione Novo > Valor de String. Digite no nome GovernanceSource para obter o novo valor. Não use outro nome para o valor!
4. Clique duas vezes na string GovernanceSource para editar. No campo Dados do valor, adicione o caminho para o arquivo uipath.policies.config e clique em OK.
   • Se o arquivo de política for armazenado localmente, um exemplo para este campo seria C:\policies\uipath.policies.config.
   • Se o arquivo de política for armazenado em um servidor, um exemplo para este campo seria 192.168.1.1\policies\uipath.policies.config.

A chave de registro deve ser parecido com este:

Para definir o caminho do arquivo usando um ativo do Orchestrator:

Observação:

Enforcing a governance policy using an Orchestrator asset that references the file path or holds the contents of the file is available starting with Studio v2020.10.4. This functionality requires Orchestrator v2020.10 or later.

1. No Orchestrator, selecione Tenant > Pastas e adicione uma nova pasta chamada de uipath.settings.config
2. Designar os usuários aos quais aplicar a política de governança em relação à pasta.
3. Na pasta de uipath.settings.config, crie um ativo e configure-o da seguinte maneira:

   • Nome do ativo - uipath.studio.governancesource.

   • Tipo — texto.

   • Valor Global – Selecione esta opção e insira o caminho completo para o arquivo uipath.policies.config na caixa de texto.

     Opcionalmente, você pode aplicar políticas diferentes para usuários diferentes, adicionando valores por usuário com caminhos para arquivos diferentes.

     Observação:

     • A imposição de políticas por usuário funciona no Studio v2020.10.8 e posterior para o Automation Cloud Orchestrator e no Studio v2020.10.9 e posterior para o On-Premises
     • Os usuários precisam estar conectados à sua conta no Studio para receber políticas por usuário.

     Orchestrator.

     

Como usar um ativo do Orchestrator

Observação:

Enforcing a governance policy using an Orchestrator asset that references the file path or holds the contents of the file is available starting with Studio v2020.10.4. This functionality requires Orchestrator v2020.10 or later.

1. No Orchestrator, selecione Tenant > Pastas e adicione uma nova pasta chamada de uipath.settings.config
2. Designar os usuários aos quais aplicar a política de governança em relação à pasta.
3. Na pasta de uipath.settings.config, crie um ativo e configure-o da seguinte maneira:

   • Nome do ativo - uipath.studio.governancepolicy.

   • Tipo — texto.

   • Valor Global – Selecione esta opção e cole o conteúdo completo do arquivo uipath.policies.config na caixa de texto.

     Opcionalmente, você pode aplicar políticas diferentes para usuários diferentes ao adicionar valores por usuário e colar parâmetros diferentes.

     Observação:

     Enforcing policies per user works in Studio v2020.10.8 and later for Automation Cloud Orchestrator, and Studio v2020.10.9 and later for On-Premises Orchestrator.

     

Aplicação e Precedência

Quando uma política é definida, ela é aplicada depois que o Studio é reiniciado.

Uma mensagem aparece na janela de configurações do Analisador de Fluxo de Trabalho, a jajela Enviar Feedback, na guia Configurações na Exibição Backstage e na janela Gerenciar Pacotes.

O Studio aplica a política de governança, usando a seguinte ordem de precedência: uipath.studio.governancepolicy > uipath.studio.governancesource> Chave do registro > arquivo local.

Se a política de governança for removida em relação ao usuário, as configurações que tiverem sido aplicadas por meio do arquivo de governança serão persistidas como padrões. Entretanto, agora o usuário terá a opção de alterar as configurações que eram restritas quando a política de governança estava em vigor.