Format Value

UiPath.Core.Activities.FormatValue

Associa um formato específico a um valor genérico que pode ser usado com operações .ToString e Parse. Os formatos disponíveis são Number, DateTime, Currency e Percentage.

Propriedades

A

• Valor — o valor a ser formatado. Esse campo aceita apenas variáveis GenericValue.

Entrada

• Formato — especifica o formato a ser aplicado ao valor.

Comum

• NomeDeExibição - o nome de exibição da atividade.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Exemplo de uso da atividade Format Value

O exemplo abaixo explica como usar a atividade Format Value processando valores atribuídos e formatando-os conforme desejado.

É assim que um processo de automação pode ser construído:

1. Abra o Studio e crie um Processo.

2. Arraste um contêiner Sequência para o Designer de Fluxo de Trabalho.

   • Crie a seguinte variável:

     Nome da variável	Tipo de Variável	Valor Padrão
     formattedValue	GenericValue

3. Arraste uma atividade Assign para dentro do contêiner Sequence.

   • Adicione a variável formattedValue no campo Para.
   • Adicione a expressão DateTime.Now no campo Valor para receber a data real.

4. Arraste uma atividade Format Value abaixo da atividade Assign.

   • Adicione a variável formattedValue no campo Valor.

5. Clique no botão Definir Formato da atividade Format Value para configurar o formato dos dados.

   • Selecione a opção DateTime na lista suspensa Tipo de Formato.
   • Selecione o estilo de data de exibição desejado na lista suspensa Padrão.
   • Clique no botão OK para fechar o configurador.

6. Coloque uma atividade Log Message abaixo da atividade Format Value.

   • Selecionar a opção Informações do botão suspenso Nível.
   • Adicione a expressão "Today is: "+formattedValue no campo Mensagem. Isso exibe a mensagem Hoje é e a data real, usando o formato selecionado anteriormente.

7. Arraste uma atividade Assign abaixo da atividade Log Message

   • Adicione a variável formattedValue no campo Para.
   • Adicione o valor 19000.1234 no campo Valor. Isso representa o valor real usado para formatação.

8. Arraste uma atividade Format Value abaixo da atividade Assign.

   • Adicione a variável formattedValue no campo Valor.

9. Clique no botão Definir Formato da atividade Format Value para configurar o formato dos dados. Isso formata o valor adicionado na atividade Assign anterior e determina o número de decimais usado.

   • Selecione a opção Number na lista suspensa Tipo de Formato.
   • Adicione o valor 2 no campo Dígitos Decimais.
   • Selecione a opção . na lista suspensa Separador Decimal.
   • Adicione o valor , no campo Separador de Grupos.
   • Clique no botão OK para fechar o configurador.

10. Coloque uma atividade Log Message abaixo da atividade Format Value.

    • Selecione a opção Info na lista suspensa Nível.
    • Adicione a expressão "This decimal number is: "+formattedValue no campo Mensagem. Isso exibe a mensagem Este número decimal é e o número real.

11. Arraste uma atividade Assign abaixo da atividade Log Message.

    • Adicione a variável formattedValue no campo Para.
    • Adicione o valor 1.142 no campo Valor. Esse valor representa a paridade atual entre euro e dólar.

12. Arraste uma atividade Format Value abaixo da atividade Assign.

    • Adicione a variável formattedValue no campo Valor.

13. Clique no botão Definir Formato da atividade Format Value para configurar o formato dos dados.

    • Selecione a opção Moeda na lista suspensa Tipo de Formato.
    • Adicione o valor 3 no campo Dígitos Decimais.
    • Selecione a opção . na lista suspensa Separador Decimal.
    • Selecione a opção $ na lista suspensa Símbolo.
    • Adicione o valor , no campo Separador de Grupos.
    • Clique no botão OK para fechar o configurador.

14. Coloque uma atividade Log Message abaixo da atividade Format Value.

    • Selecionar a opção Informações do botão suspenso Nível.
    • Adicione a expressão "1 euro is: "+formattedValue no campo Mensagem. Isso exibe a mensagem 1 euro é e o valor real de um euro convertido em dólares.

15. Arraste uma atividade Assign abaixo da atividade Log Message.

    • Adicione a variável formattedValue no campo Para.
    • Adicione o valor 0.6666 no campo Valor. Esse valor é usado para exibir a porcentagem após a formatação dos dados.

16. Arraste uma atividade Format Value abaixo da atividade Assign.

    • Adicione a variável formattedValue no campo Valor.

17. Clique no botão Definir Formato da atividade Format Value para configurar o formato dos dados.

    • Selecione a opção Porcentagem na lista suspensa Tipo de Formato.
    • Adicione o valor 2 no campo Dígitos Decimais.
    • Selecione a opção . na lista suspensa Separador Decimal.
    • Adicione a expressão % ao campo Símbolo.
    • Adicione a expressão , ao campo Separador de Grupos.
    • Clique no botão OK para fechar o configurador.

18. Coloque uma atividade Log Message abaixo da atividade Format Value.

    • Selecione a opção Info na lista suspensa Nível.
    • Adicione a expressão "2/3 is: "+formattedValue no campo Mensagem. Isso exibe a mensagem 2/3 é e seu equivalente percentual.

    • É assim que seu fluxo de trabalho deve ficar:

      
      

      

      
      

19. Execute o processo de automação. Os dados fornecidos são processados e exibidos, de acordo com as especificações, no painel Saída.

    Baixe o exemplo