Variáveis proprietárias da Quipata

Variáveis GenericValue

A variável GenericValue é um tipo de variável que pode armazenar qualquer tipo de dados, incluindo texto, números, datas e arrays e é específica do UiPath Studio.

As variáveis GenericValue são convertidas automaticamente em outros tipos de variável para executar determinadas ações. No entanto, é importante usar esses tipos de variáveis cuidadosamente, pois a conversão pode não ser a correta para o seu projeto.

O UiPath Studio tem um mecanismo de conversão automático das variáveis GenericValue que você pode orientar para o resultado desejado definindo cuidadosamente suas expressões. Leve em consideração que o primeiro elemento na sua expressão será usado como diretriz para a operação executada pelo Studio. Por exemplo, quando você tenta adicionar duas variáveis GenericValue, caso a primeira da expressão esteja definida como String, o resultado será a concatenação de ambas. Se estiver definida como um Inteiro, o resultado será a soma delas.

Métodos .NET compatíveis

Nome/Sintaxe	Description
CompararCom Função GenericValue.CompareTo(other As GenericValue) As Integer Função GenericValue.CompareTo(obj As Object) As Integer	[Clique aqui para obter detalhes.][1] [1]: https://msdn.microsoft.com/pt-br/library/system.string.compareto(v=vs.110).aspx (v=vs.110).aspx
Contém Função GenericValue.Contains(other As String) As Boolean	[Clique aqui para obter detalhes.][2] [2]: https://msdn.microsoft.com/en-us/library/dy85x1sa(v=vs.110).aspx Usado para verificar se uma variável string contém ou não uma determinada substring. Por exemplo, se você quiser verificar se uma frase contém uma palavra específica, a expressão deve ser [SentenceVariable].Contains("term"), onde [SentenceVariable]é a variável GenericValue contendo a frase e "term"será a palavra a ser pesquisada. Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
É igual a Função GenericValue.Equals(other As GenericValue) As Boolean Função GenericValue.Equals(obj As Object) As Boolean	[Clique aqui para obter detalhes.][3] [3]: https://msdn.microsoft.com/pt-br/library/system.string.equals(v=vs.110).aspx
ObterCódigoHash Função GenericValue.GetHashCode() As Integer	[Clique aqui para obter detalhes.][5] [5]: https://msdn.microsoft.com/pt-br/library/system.string.format(v=vs.110).aspx
ObterTipo Função Object.GetType() As Type	[Clique aqui para obter detalhes.][6] [6]: https://msdn.microsoft.com/pt-br/library/system.object.getty(v=vs.110).aspx
ObterCódigoTipo Função GenericValue.GetTypeCode() As TypeCode	[Clique aqui para obter detalhes.][7] [7]: https://msdn.microsoft.com/pt-br/library/system.string.gettypecode(v=vs.110).aspx
ÍndiceDe Função GenericValue.IndexOf(value As String) As Integer Função GenericValue.IndexOf(value As String, purchaseType As StringComparison) As Integer Função GenericValue.IndexOf(value As String, startIndex As Integer) As Integer Função GenericValue.IndexOf(value As String, startIndex As Integer, CompareType As StringComparison) As Integer	[Clique aqui para obter detalhes.][8] [8]: https://msdn.microsoft.com/pt-br/library/system.string.indexof(v=vs.110).aspx Usado para retornar o índice de uma substring contida dentro de uma variável string. Por exemplo, se você quiser encontrar o índice da palavra "localizar" dentro da frase "Encontre "localizar" nesta frase", a expressão deve ser [SentenceVariable].IndexOf("locate"), onde [SentenceVariable]é a variável GenericValue contendo a frase e "locate" será o termo a ser pesquisado. Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
Tamanho Function GenericValue.Lenght() As Integer	[Clique aqui para obter detalhes.][9] [9]: https://msdn.microsoft.com/en-us/library/system.string.length(v=vs.110).aspx Usado para retornar o número de caracteres em uma variável string. Por exemplo, se você quiser saber quantas letras tem uma palavra, a expressão deve ser [WordVariable].Length, onde [WordVariable]é a variável GenericValue contendo a palavra. Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
Substituir Função GenericValue.Replace(oldValue As String, new value As String) As String	[Clique aqui para obter detalhes.][10] [10]: https://msdn.microsoft.com/pt-br/library/system.string.replace(v=vs.110).aspx Usado para substituir dados contidos dentro de uma variável string. Por exemplo, se você quiser alterar um caminho de arquivo local C:\ExampleFolder\Main.xamlpara o caminho de arquivo do servidor C:/ExampleFolder/Main.xamlcorrespondente, a expressão deve ser [PathVariable].Replace("\","/")onde [PathVariable]é a variável GenericValue contendo o caminho do arquivo, "\"será o caractere a ser substituído e "/"será o caractere usado para substituí-lo. Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
Dividir Função GenericValue.Split(ParamArray separator As Char()) As String() Function GenericValue.Split(ParamArray separator As String()) As String() Fnção GenericValue.Split(separator As Char(), options As StringSplitOptions) As String() Function GenericValue.Split(separator As String(), options As StringSplitOptions) As String()	[Clique aqui para obter detalhes.][11] [11]: https://msdn.microsoft.com/pt-br/library/system.string.split(v=vs.110).aspx Usado para retornar componentes individuais de uma variável string. Por exemplo, se você quiser extrair o ano de um formato MM.DD.YYYY a expressão deve ser [DateVariable].Split(".".ToCharArray)(2), onde [DateVariable]é a variável GenericValue contendo a data, "."é o caractere usado como separador, .ToCharArrayé um método que cria um intervalo com os elementos delimitados pelo separador e (2)representa o índice do elemento a ser retornado, no nosso caso, o ano. Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
Substring Função GenericValue.Substring(startIndex As Integer) As String Função GenericValue.Substring(startIndex As Integer, length As Integer) As String	[Clique aqui para obter detalhes.][12] [12]: https://msdn.microsoft.com/en-us/library/system.string.substring(v=vs.110).aspx Usado para retornar uma substring contida em uma variável string. Por exemplo, se você quiser extrair uma palavra da frase "Há 100 máquinas disponíveis" a expressão deve ser [SentenceVariable].Substring(10,3), onde [SentenceVariable] é a variável GenericValue contendo a frase, 10 será o índice do primeiro caractere a ser retornado e 3 será o comprimento da substring contando do primeiro caractere. Neste exemplo, a substring resultante será "100". Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
ParaBoliano Função GenericValue.ToBoolean(provider As IFormatProvider) As Boolean	[Clique aqui para obter detalhes.][13] [13]: https://msdn.microsoft.com/pt-br/library/bb346937(v=vs.110).aspx
ParaByte Function GenericValue.ToByte(provider As IFormatProvider) As Byte	[Clique aqui para obter detalhes.][14] [14]: https://msdn.microsoft.com/pt-br/library/bb355898(v=vs.110).aspx
ParaCar Function GenericValue.ToChar(provider As IFormatProvider) As Char	[Clique aqui para obter detalhes.][15] [15]: https://msdn.microsoft.com/pt-br/library/bb335877(v=vs.110).aspx
ParaDecimal Function GenericValue.ToDecimal(provider As IFormatProvider) As Decimal Função GenericValue.ToDecimal(format As NumberStyles) As Decimal	[Clique aqui para obter detalhes.][17] [17]: https://msdn.microsoft.com/pt-br/library/bb359959(v=vs.110).aspx
ParaDobro Function GenericValue.ToDouble(provider As IFormatProvider) As Double Função GenericValue.ToDouble(format As NumberStyles) As Double	[Clique aqui para obter detalhes.][18] [18]: https://msdn.microsoft.com/pt-br/library/bb154906(v=vs.110).aspx
ParaInt Função GenericValue.ToInt(culture As IFormatProvider) As Integer? Function GenericValue.ToInt() As Integer?	Usado para converter um valor especificado em um número inteiro nulificável. Observação: ao usar este método com uma variável GenericValue de dados do tipo Boolianos, os valores "True" e "False" são convertidos, respectivamente para 1 e 0.
ParaInt16 Function GenericValue.ToInt16(provider As IFormatProvider) As Short	[Clique aqui para obter detalhes.][20] [20]: https://msdn.microsoft.com/en-us/library/bb293091(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Boolianos, os valores "True" e "False" são convertidos, respectivamente para 1 e 0.
ParaInt32 Function GenericValue.ToInt32(provider As IFormatProvider) As Integer	[Clique aqui para obter detalhes.][21] [21]: https://msdn.microsoft.com/en-us/library/bb300452(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Boolianos, os valores "True" e "False" são convertidos, respectivamente para 1 e 0.
ParaInt64 Function GenericValue.ToInt64(provider As IFormatProvider) As Long	[Clique aqui para obter detalhes.][22] [22]: https://msdn.microsoft.com/en-us/library/bb359566(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Boolianos, os valores "True" e "False" são convertidos, respectivamente para 1 e 0.
ParaMenor Function GenericValue.ToLower() As String	[Clique aqui para obter detalhes.][23] [23]: https://msdn.microsoft.com/pt-br/library/system.string.tolower(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
ParaMenorInvariável Function GenericValue.ToLowerInvariant() As String	[Clique aqui para obter detalhes.][24] [24]: https://msdn.microsoft.com/pt-br/library/system.string.toloumerinivariant(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
ParaSByte Função GenericValue.ToSByte(provider As IFormatProvider) As SByte	[Clique aqui para obter detalhes.][25] [25]: https://msdn.microsoft.com/pt-br/library/bb342232(v=vs.110).aspx
ParaÚnico Function GenericValue.ToSingle(provider As IFormatProvider) As Single	[Clique aqui para obter detalhes.][26] [26]: https://msdn.microsoft.com/pt-br/library/bb360375(v=vs.110).aspx
ParaString Function GenericValue.ToString(formatProvider As IFormatProvider) As String Função GenericValue.ToString(format As String, formProvider As IFormatProvider) As String Função GenericValue.ToString() As String	[Clique aqui para obter detalhes.][27] [27]: https://msdn.microsoft.com/pt-br/library/system.string.tostring(v=vs.110).aspx
ParaTipo Função GenericValue.ToType(conversionType As Type, provider As IFormatProvider) As Object	[Clique aqui para obter detalhes.][29] [29]: https://msdn.microsoft.com/pt-br/library/bb358540(v=vs.110).aspx
ParaUInt16 Função GenericValue.ToUInt16(provider As IFormatProvider) As UShort	[Clique aqui para obter detalhes.][30] [30]: https://msdn.microsoft.com/en-us/library/bb337265(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Boolianos, os valores "True" e "False" são convertidos, respectivamente para 1 e 0.
ParaUInt32 Função GenericValue.ToUInt32(provider As IFormatProvider) As UInteger	[Clique aqui para obter detalhes.][31] [31]: https://msdn.microsoft.com/en-us/library/bb357762(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Boolianos, os valores "True" e "False" são convertidos, respectivamente para 1 e 0.
ParaUInt64 Função GenericValue.ToUInt64(provider As IFormatProvider) As Ulong	[Clique aqui para obter detalhes.][32] [32]: https://msdn.microsoft.com/en-us/library/bb155099(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Boolianos, os valores "True" e "False" são convertidos, respectivamente para 1 e 0.
ParaMaior Function GenericValue.ToUpper() As String	[Clique aqui para obter detalhes.][33] [33]: https://msdn.microsoft.com/en-us/library/system.string.toupper(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
ParaMaiorInvariável Function GenericValue.ToUpperInvariant() As String	[Clique aqui para obter detalhes.][33] [34]: https://msdn.microsoft.com/pt-br/library/system.string.toupperinvariant(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
Cortar Função GenericValue.Trim(ParamArray trimChars As Char()) As String Function GenericValue.Trim() As String	[Clique aqui para obter detalhes.][35] [35]: https://msdn.microsoft.com/pt-br/library/system.string.trim(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
ReduzirFim Função GenericValue.TrimEnd(ParamArray trimChars As Char()) As String	[Clique aqui para obter detalhes.][36] [36]: https://msdn.microsoft.com/pt-br/library/system.string.trimend(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.
ReduzirInício Function GenericValue.TrimStart(ParamArray trimChars As Char()) As String	[Clique aqui para obter detalhes.][37] [37]: https://msdn.microsoft.com/pt-br/library/system.string.trimstart(v=vs.110).aspx Observação: ao usar este método com uma variável GenericValue de dados do tipo Int, Float ou Booleana, os dados serão convertidos automaticamente para String e gerenciados como tal.

Ao usar Ctrl + K, Ctrl + M, ou Ctrl + Shift + M diretamente no corpo da atividade Formatar Valor, a variável ou argumento criado será do tipo GenericValue. Para outras atividades, o tipo criado seguirá o tipo requerido para aquele tipo de atividade.

Exemplo de Uso de uma Variável GenericValue

Para demonstrar como uma variável GenericValue funciona, crie uma automação que executa várias operações cujos resultados dependem da forma como definiremos suas expressões. Criamos duas variáveis GenericValue de diferentes tipos de dados e exibimos os resultados no painel Saída.

1. Crie um novo projeto em branco.
2. Crie três variáveis GenericValue: Int,Str e Result.
3. Na coluna Padrão para a variável Int, digite 12, e para a variável Str, digite "34". A primeira variável é interpretada como um número inteiro e a segunda é interpretada como uma string.
   
   

   

   
   
4. Adicione uma atividade Atribuir ao painel de Projeto e conecte-a ao nó Iniciar.
5. No painel Propriedades, no campo Para adicione a variável Result.
6. No campo Valor, digite Int+ Str.
7. Adicione uma atividade Gerar Linha e conecte-a à atividade Atribuir.
8. No painel Propriedades, no campo Texto, insira a variável Result.

   O projeto deverá parecer com a captura de tela a seguir.

   
   

   

   
   

9. Pressione F5 para executar sua automação. Note que que, no painel Saída, a soma dos dois números é exibida.

   
   

   

   
   
10. Retorne para a atividade Atribuir adicionada anteriormente e altere o campo Valor para Str + Int para reverter a ordem das variáveis. O projeto deverá ter a seguinte aparência.
    
    

    

    
    

11. Pressione F5 para executar sua automação. Note que no painel Saída, a concatenação dos dois números é exibida.

    
    

    

    
    

Isso significa que o UiPath Studio considera o primeiro elemento definido na sua expressão como uma diretriz a respeito de qual operação executar. Se o primeiro elemento na sua expressão for um número inteiro ou uma variável GenericValue preenchida com um número inteiro, o UiPath Studio executará a soma dos elementos.

Se o primeiro elemento na sua expressão for uma string ou uma variável GenericValue preenchida como string, UiPath Studio executará a concatenação dos elementos.

Baixe o exemplo

Variáveis QueueItem

Recomendamos que você leia a página Sobre filas e transações, para ter uma visão geral sobre as filas e as transações, antes de prosseguir para a variável QueueItem.

Antes de entrar em um detalhamento profundo do assunto, certifique-se de entender a distinção entre os itens da fila (itens armazenados em uma fila no Orchestrator) e variáveis QueueItem (variáveis usadas no Studio para processar itens de fila). Nós nos referimos a eles exatamente assim: "variáveis QueueItem" e "itens de fila".

Em geral, como o nome indica, uma variável QueueItem armazena um item que foi extraído de um contêiner de itens, uma fila. Essa extração geralmente é feita com o propósito de reutilizar os itens da fila em diferentes cenários. Digamos que você represente uma instituição bancária e tenha um relatório de depósitos de 50 clientes. Você deseja processar os dados de cada cliente que tenha depositado anteriormente um cheque On-Us menor do que $ 5000, usando um aplicativo financeiro externo. Neste caso, você pode fazer um fluxo de trabalho no qual o armazenamento de variáveis QueueItem armazene, um por vez, as informações de cada cliente. Cada entrada lida pela variável QueueItem será armazenada em um item de fila e adicionada à fila designada no Orchestrator. O resultado do processo inteiro será uma fila que contém as informações dos clientes, cada uma no item de fila correspondente.

Para processar os dados que atendem à sua condição, você deve criar outro fluxo de trabalho que extrai dessa fila criada anteriormente os itens apresentando valor menor que $5000 para cheques On-Us. O procedimento passo a passo sobre como criar esse projeto será fornecido ao final deste tópico.

Métodos .NET compatíveis

Nome/Sintaxe	Description
É igual a Função Object.Equals(obj As Object) As Boolean	Clique aqui para obter detalhes.
ObterCódigoHash Função Object.GetHashCode() As Integer	Clique aqui para obter detalhes.
ObterTipo Função Object.GetType() As Type	Clique aqui para obter detalhes.
ParaString Função Object.ToString() As String	Clique aqui para obter detalhes.

Propriedades compatíveis

Nome/Sintaxe	Description
AtribuídoA Propriedade QueueItem.AssignedTo As String	Clique aqui para obter detalhes.
DueDate Propriedade QueueItem.DueDate As Date?	A data e a hora mais recente na qual o item deve ser processado. Se estiver vazio, o item pode ser processado a qualquer momento.
DeferDate Propriedade QueueItem.DueDate As Date?	A data e a hora mais antiga remota na qual o item está disponível para o processamento. Se estiver vazio, o item estará disponível para ser processado de imediato.
Id Propriedade QueueItem.Id As Long?	Clique aqui para obter detalhes.
ChaveDoItem Propriedade QueueItem.ItemKey As Guid	O identificador exclusivo de cada item. Por exemplo, 1bf829e1-cd6b-4275-a364-19db3cfe09c7.
Prioridade Propriedade QueueItem.Priority As QueueItemPriority	A prioridade do item de fila conforme definido no Studio no campo Prioridade no painel Propriedades.
ExceçãoNoProcessamento Propriedade QueueItem.ProcessingException As ProcessingException	A exceção de processamento de um item apresentando erro.
Progresso Propriedade QueueItem.Progress As String	Informações personalizadas sobre o progresso de um item de fila cujo status seja EmProgresso.
IdDeDefiniçãoDeFila Propriedade QueueItem.QueueDefinitionId As Long	O identificador exclusivo da fila sob a qual um item/transação de fila tenha sido criado.
QueueName Propriedade QueueItem.QueueName As String	O nome da fila contendo os itens processados.
Referência Propriedade Referência do Item da Fila Como String	Um valor especificado pelo usuário para facilitar a identificação de itens de fila.
TentativaNo Propriedade QueueItem.RetryNo As Integer	O número de vezes que o item foi recuperado.
ReviewStatus Propriedade QueueItem.ReviewStatus As String	O status de revisão do item de fila conforme recuperado do Orchestrator.
VersãoDaLinha Propriedade QueueItem.RowVersion As Byte()	Um campo interno usado para estampagem de versão. Ele será atualizado sempre que uma propriedade da transação atual seja alterada.
ConteúdoEspecífico Propriedade QueueItem.SpecificContent As Dictionary(Of String, Object)	Uma coleção de pares de valores chave contendo dados personalizados associados à transação atual, conforme configurado na atividade Adicionar Item de Fila.
HoraDeInícioDaTransação Propriedade QueueItem.StartTransactionTime As Date?	A hora e a data em que o processamento de transações teve início.
Status Propriedade QueueItem.Status As QueueItemStatus	O status do item de fila conforme recuperado do Orchestrator.

Exemplo de Uso de uma Variável QueueItem

Devido à natureza deste exemplo, dividimos esta seção em duas partes, cada uma representando um dos dois fluxos de trabalho principais utilizado ao se trabalhar com filas e itens de fila:

• Carregando itens em uma fila
• Processando as Transações de uma Fila

Carregar itens para uma fila

Para demonstrar como adicionar itens a uma fila, crie uma automação que processa entradas contidas em um arquivo .xlsx. Digamos que você represente uma instituição bancária e tenha um relatório de depósitos de 50 clientes. Você deseja processar os dados de cada cliente que depositou anteriormente um Cheque On-Us menor do que $ 5000, usando um aplicativo financeiro de externo. O relatório contém o nome do cliente, o valor de Cheque On-Us e dois valores adicionais, digamos Compensação e Cheque Terceiros. Criamos um fluxo de trabalho no qual a variável QueueItem armazena, um por vez, as informações de cada cliente. Cada entrada lida pela variável QueueItem é então armazenada em um item de fila e adicionada à fila designada no Orchestrator. O resultado final do processo é uma fila que contém informações específicas para cada cliente. Antes de prosseguir para o fluxo de trabalho em si, pode ser interessante dar uma olhada no relatório dos clientes aqui. Trabalharemos com a planilha "Relatórios de Julho".

Sem mais delongas:

1. Crie uma nova sequência.
2. Adicione uma atividade Escopo do Aplicativo Excel dentro da sequência e defina o local da pasta de trabalho no painel Propriedades da atividade.
3. Na seção Do , adicione uma atividade Read Range para ler o intervalo desejado de valores do relatório e armazená-los em uma variável DataTable . No nosso caso, digite "A1-D51" ou simplesmente deixe o valor padrão, """, o que o que significa que a planilha inteira será lida.
4. No campo Nome da Planilha digite o nome da planilha, ou seja, “July Report”.
5. No campo Tabela de Dados, pressione Ctrl + K para criar uma nova variável DataTable que armazenará o intervalo de dados lidos anteriormente. Nomeie-a DataTable1 ou algo semelhante. O painel Variáveis também deve exibir a variável recém-criada da seguinte maneira:
   
   

   

   
   
6. Em seguida, adicione uma atividade Para Cada Linha ao painel Projeto e preencha os campos em branco com "linha" e o nome da variável DataTable , DataTable1respectivamente. Esta atividade executa a ação definida na seção Corpo para cada linha na tabela de dados. A seção Ação deve ter uma aparência semelhante à seguinte captura de tela até este ponto:
   
   

   

   
   
7. Na seção Corpo da atividade Para Cada Linha, adicione uma atividade Adicionar Item de Fila. Isso adiciona um item a uma fila (definido abaixo nas etapas 8 e 12), para cada linha na planilha.
8. No painel Propriedades, no campo NomeDaFila , digite o nome da fila na qual você deseja armazenar seus itens, digamos ReportQueue.

9. Na seção Entrada, clique no botão correspondente ao campo InformaçõesSobreoItem para abrir a janela InformaçõesSobreoItem. Crie 4 argumentos, cada um correspondendo a uma coluna do relatório. Defina-os da seguinte maneira:

   • Name, mantendo os valores padrão para Direção e Tipo e com Valor definido como row(0).ToString. Isso recupera o valor da coluna apresentando o contador 0 para cada linha na pasta de trabalho, em nosso caso o nome do cliente.
   • CashIn, mantendo os valores padrão para Direção e Tipo e com Valor definido como row(1).ToString. Isso recupera o valor da coluna apresentando o contador 1 para cada linha na pasta de trabalho, no nosso caso o valor de Compensação.
   • OnUsCheck, mantendo os valores padrão para Direção e Tipo e com Valor definido como row(2).ToString. Isso recupera o valor da coluna apresentando o contador 2 para cada linha na pasta de trabalho, no nosso caso o valor do Cheque On-Us.
   • NotOnUsCheck, mantendo os valores padrão para Direção e Tipo e com Valor definido como row(3).ToString. Isso recupera o valor da coluna apresentando o contador 3 para cada linha na pasta de trabalho, no nosso caso o valor do Cheque Terceiros.

10. A janela InformaçõesSobreoItem deve ter aparência semelhante à seguinte captura de tela:

    
    

    

    
    
11. Conecte o Robô do Studio ao Orchestrator. Para detalhes sobre como fazer isso, clique aqui.
12. Navegue até https://platform.uipath.com, Faça login usando suas credenciais e crie uma fila, ReportQueue para armazenar os itens. Certifique-se de que o nome usado acima (etapa 8) seja o mesmo usado nesta etapa.
13. Retorne para o Studio. Neste ponto seu fluxo de trabalho deve estar isento de erros e funcionando corretamente, assim, a próxima etapa será disponibilizá-lo para o Orchestrator. Para tal, clique em Projeto > Publicar.

14. Para executar o processo, clique em Projeto > Executar.

    Observação: leve em consideração que, após o processamento, os itens da fila se tornam transações e são tratados posteriormente como tal.
15. Navegue até https://platform.uipath.com novamente e exiba as transações.

Processando as Transações de uma Fila

Para demonstrar como adicionalmente processar transações de uma fila, criaremos um segundo fluxo de trabalho que recupera da fila apropriada as transações com um valor de cheque On-Us menor do que $5000. Para cada transação que atenda a essa condição, os valores serão coletados e introduzidos em um aplicativo exemplo externo. Demais transações serão rotuladas como exceções.

1. Acesse Projeto > Novo > Fluxograma para criar um novo arquivo no projeto iniciado acima.
2. Adicione uma atividade Abrir Aplicativo para abrir o aplicativo externo de exemplo. Conecte-a ao nó Iniciar.
3. Preencha os detalhes necessários (Nome de Exibição, NomedeArquivo, e Seletor) no painel Propriedades e configure a atividade para fazer login com as credenciais correspondentes. Use adminpara o campo NomedeUsuário e passwordpara o campo Senha.
4. No campo NomeDeArquivo, preencha o caminho do aplicativo.
5. No campo Seletor, usando o Editor de Seletor, defina o seletor para UIDemo.
6. Adicione uma atividade Interrupção Necessária ao painel Projeto e conecte-a à atividade Abrir Aplicativo.

7. Adicione uma atividade Decisão de Fluxo ao painel Projeto e conecte-a à atividade Interrupção Necessária. Estas duas últimas atividades verificam se você interrompeu o trabalho durante a execução. Isso oferece a possibilidade de se fazer configurações adicionais ao fluxo de trabalho com o intuito de executar diversas rotinas de segurança após a interrupção ser disparada. Veja abaixo um exemplo de uma tal rotina:

   • Adicione uma atividade Mensagem de Log e conecte-a à ramificação Verdadeiro da decisão de fluxo adicionada anteriormente.
   • No painel Propriedades, no campo Mensagem, digite "Requisição de Interrupção do Processo" ou algo semelhante a ser exibido caso a interrupção seja disparada.
   • Adicione uma atividade Fechar Aplicativo e conecte-a à atividade Mensagem de Log adicionada anteriormente.
   • No painel Propriedades, no campo NomeDeExibição após Fechar Aplicativo, digite UIDemo.exe UIDemo.
8. Adicione uma atividade Obter Item de Transação à ramificação Falso da decisão de fluxo adicionada anteriormente (etapa 7). Esta atividade recupera os itens de transação da fila e armazena-os um por vez, a cada iteração do loop, em uma variável QueueItem.
9. No painel Propriedades, no campo NomeDeFila digite o nome da fila que armazenará seus itens. No nosso caso, conforme definido na seção Carregando Itens numa Fila, o nome será "FilaRelatório".
10. No campo ItemDaTransação pressione Ctrl+K para criar a variável QueueItem que armazenará cada item da transação. Nomeie-a "TransItem" ou algo semelhante.
11. Adicione uma atividade Decisão de Fluxo ao painel Projeto e conecte-a à atividade Adquirir Item da Transação.
12. No painel Propriedades, no campo Condição, digite TransItem isNot Nothing. Esta atividade verifica o valor de cada item para determinar se o fim da fila foi atingido.
13. Conecte a ramificação Falso da decisão de fluxo à atividade Mensagem de Log criada na etapa 7. Isso garante que o job será interrompido ao se atingir o fim da fila.
14. Adicione outra atividade Decisão de Fluxo ao painel Projeto e conecte-a à ramificação Verdadeiro da decisão de fluxo criada na etapa 11.
15. No painel Propriedades, no campo Condição, digite cint(TransItem.SpecificContent("OnUSCheck").ToString) < 5000, onde:
    • cint converte uma variável do tipo string para uma do tipo integer.
    • TransItem é a variável QueueItem (etapa 18) usada para armazenar os itens.
    • SpecificContent("OnUSCheck") Recupera o conteúdo do argumento Cheque On Us para cada item.
    • .ToString converte o conteúdo da variável QueueItem em uma variável string.
    • < 5000 é a condição contra a qual é efetuada a verificação.

      A expressão acima converte o valor OnUSCheck em cada variável QueueItem em uma variável string que será convertida posteriormente em um número inteiro. A conformidade do valor assim obtido será verificada pela condição.

16. Adicione uma atividade Definir Status de Transação ao painel Projeto e conecte-a à ramificação Falso da decisão de fluxo anterior (etapa 13).
17. No painel Propriedades, certifique-se de que o campo Status esteja definido para Fracasso e TipodeErro para Empresarial. Desta maneira, se o valor do cheque OnUs for maior ou igual a 5000, a transação será marcada como fracassada sob uma exceção Empresarial.
18. No campo ItemDeTransação adicione a variável TransItem.
19. No campo Motivo, digite "Valor de cheque OnUs é maior que 5000" ou algo semelhante para exibir no caso das transações fracassadas.
20. Conecte a atividade Definir Status de Transação à atividade Interrupção Necessária (etapa 6), para criar um loop e processar a próxima transação na fila.
21. Adicione uma atividade Sequência ao painel Projeto e conecte-a à ramificação Verdadeiro da decisão de fluxo anterior (etapa 13). Dentro da sequência, adicione uma atividadeTeste de Captura e configure-a para que quaisquer potenciais erros sejam rotulados corretamente como erros de aplicativos ao processar os itens.
22. Abra o aplicativo de UIDemo e faça login com o nome de usuário admine a senha password.

23. Execute a seguinte série de atividades para cada um dos campos Compensado, Cheque On Us e Cheque Terceiros no aplicativo UIDemo:

    • Na atividade Teste de Captura anterior, adicione uma atividade Entrada de Digitação.
    • Clique em Indicar na Tela e selecione na interface UIDemo, o campo vazio correspondente a Compensado.
    • No painel Propriedades, no campo Texto, digite transItem.SpecificContent("CashIn").ToString. Cada termo da expressão se encontra explicado acima (etapa 15). Esta expressão converte o valor em cada variável QueueItem em uma variável string.
    • Certifique-se de que a opção Simular Tipo esteja selecionada.

24. Na aba Projeto, na seção Assistente, clique em Extração de Tela e aponte para o número de transação no aplicativo UIDemo.

    
    

    

    
    
25. No Assistente de Extração de Tela, escolha um método de extração e clique em Concluir. Isso insere uma atividade Extração de Tela no seu fluxo de trabalho. Certifique-se de posicioná-la após as atividades Entrada de Digitação anteriores e defina o campo Texto como uma nova variável, digamos TransactionValue. Isso recupera o número de transação para cada item de fila que atenda à condição inicial.
26. Adicione uma atividade Definir Status de Transação após a atividade Extração de Tela.
27. No painel Propriedades, certifique-se de que o campo Status esteja definido para Sucesso, e TipodeErro para Aplicativo. Assim, caso o conjunto de valores seja introduzido com sucesso no aplicativo, o status da transação será definido como Sucesso; caso contrário, será classificado como uma exceção de aplicativo.
28. Na janela Saída, defina um novo argumento e adicione a variável criada anteriormente, TransactionValue(etapa 25) como valor.
29. No campo Item de transação, adicione a variável TransItem.
30. Adicione uma atividade Clicar à atividade Sequência após as atividades Entrada de Digitação.
31. Clique em Indicar na tela e selecione o botão Aceitar na interface do UIDemo. Certifique-se de que a opção Tipo de Simulação esteja selecionada.

32. A atividade Teste de Captura deverá ter uma aparência semelhante à seguinte captura de tela:

    
    

    

    
    
33. Retorne para o fluxograma e conecte a atividade anterior Sequência (etapa 21) à atividade Interrupção Necessária (etapa 6) para criar um loop e processar a próxima transação na fila.

34. O fluxograma deve ter aparência semelhante à seguinte captura de tela:

    
    

    

    
    
35. Para executar o processo, clique em Projeto > Executar.
36. Após a conclusão da execução, você pode navegar até https://platform.uipath.com e exibir as transações processadas com os detalhes de processamento correspondentes:

• Transação Bem-Sucedida

  
  

  

  
  

• Transação Fracassada

  
  

  

  
  

Baixe o exemplo