Xestionar variables e o panel de variables

O panel de variables mostra as variables de entrada e saída que se pasaron aos fluxos de escritorio e Power Automate . Tamén mostra todas as variables utilizadas no fluxo de escritorio actual en Variables de fluxo.

A través deste panel, pode buscar variables, renomealas, atopar os seus usos, marcalas como sensibles, fixalas e filtralas por tipo. O filtrado permítelle seleccionar se aplicalo ás variables fixadas ou non.

O visor de valores variables

Cando se executa un fluxo, o valor actual de cada variable é visible xunto ao seu nome. Seleccione a icona de borrador na parte inferior do panel de variables para borrar todos os valores actuais.

Nota

Power Automate omite automaticamente as variables das accións desactivadas. Activa unha acción desactivada para que as súas variables estean dispoñibles no panel de variables.

Para examinar o valor dunha variable con máis detalle, prema dúas veces sobre ela. O visor de valores de variables mostra o tipo de datos da variable seleccionada e amplía calquera ficha de datos ou tabelas de datos para mostrar o seu contido.

Algúns tipos de datos poden conter elementos aniñados. Por exemplo, un obxecto personalizado pode conter outro obxecto personalizado nas súas propiedades. Para ver as propiedades do elemento aniñado, seleccione Máis.

Seleccione a icona da frecha na parte superior do diálogo para volver ao elemento principal.

Cambiar o nome dunha variable de escritorio

Para cambiar o nome dunha variable de fluxo de escritorio, fai clic co botón dereito sobre o seu nome e selecciona Cambiar nome. Power Automate actualiza automaticamente o nome da variable en todas as súas aparicións.

Importante

Se tenta cambiar o nome dunha variable a un nome existente, Power Automate pediralle que confirme a fusión das dúas variables. A fusión non intencionada pode afectar a funcionalidade do teu fluxo e causar erros, así que asegúrate de que a fusión sexa desexable.

Variables de entrada e saída

Power Automate permite o intercambio de datos entre a nube e os fluxos de escritorio a través das variables de entrada e saída, o que lle permite ampliar as capacidades de automatización

Ademais, pode usar variables de entrada para establecer valores manualmente cando os fluxos se activan a través da consola.

Para obter máis información sobre o paso de datos entre os fluxos da nube e do escritorio, consulta Activar fluxos do escritorio desde os fluxos da nube.

Crear unha variable de entrada

Para crear unha variable de entrada:

1. Seleccione o botón máis (+) no panel de variables e despois Entrada.

   

2. Cando apareza o diálogo Nova variable de entrada , enche os seguintes campos:

   • Nome da variable: o nome da variable no fluxo do escritorio.
   • Tipo de datos: o tipo de variable: texto, número, booleano, obxecto personalizado, lista ou táboa de datos.
   • Valor predeterminado: o valor predeterminado cando o fluxo pasa polo deseñador de fluxos ou a consola. Cando creas un obxecto personalizado, unha lista ou unha variable de entrada de táboa de datos, Power Automate permíteche construír o valor predeterminado mediante un editor visual ou JSON.
   • Nome externo: o nome externo é o nome que aparece no deseñador de fluxos na nube e no diálogo de entradas de fluxo cando se chama o fluxo desde a consola.
   • Descrición: a descrición da variable que aparece na nube e no deseñador de fluxos de escritorio ao chamar ao fluxo.
   • Marcar como sensible: define se marcar a variable como sensible ou non. Podes atopar información sobre variables sensibles en Variables sensibles.
   • Marcar como opcional: define se é obrigatorio ou non encher esta variable de entrada. Ao marcar unha variable de entrada como opcional, permites que reciba valores en branco e omites pasar un valor real, o que non provoca un erro. Podes atopar información sobre as variables de entrada opcionais en Variables de entrada opcionais.

   Nota

   O Nome da variable, Tipo de datos e Nome externo son necesarios para crear unha variable de entrada.

   Importante

   Se escolle un nome de variable de fluxo existente para unha nova variable de entrada, Power Automate pediralle que confirme a fusión das dúas variables. A combinación non intencionada pode afectar a funcionalidade do teu fluxo e provocar erros. Ademais, non pode usar o nome dunha variable de entrada ou saída existente.

   

Cando activas fluxos de escritorio directamente a través da consola, non un fluxo de nube, o cadro de diálogo Entradas de fluxo indícase que estableza os valores para as variables de entrada manualmente. Para obxectos personalizados, listas e táboas de datos, o diálogo permítelle encher valores mediante un editor visual ou JSON.

Crear unha variable de saída

Para crear unha variable de saída:

1. Seleccione o botón máis (+) no panel de variables e despois Saída.

   

2. Cando apareza o diálogo Nova variable de saída , enche os seguintes campos:

   • Nome da variable: o nome da variable no fluxo do escritorio.
   • Tipo de datos: o tipo de variable: texto, número, booleano, obxecto personalizado, lista ou táboa de datos.
   • Nome externo: o nome externo é o nome que aparece no deseñador de fluxos de nube.
   • Descrición: a descrición da variable que aparece na nube ou no deseñador de fluxo de escritorio ao chamar ao fluxo.
   • Marcar como sensible: define se marcar a variable como sensible ou non. Podes atopar información sobre variables sensibles en Variables sensibles.

   Nota

   O Nome da variable, Tipo de datos e Nome externo son necesarios para crear unha variable de saída.

   Importante

   Se escolle un nome de variable de fluxo existente para unha nova variable de saída, Power Automate pediralle que confirme a fusión das dúas variables. A combinación non intencionada pode afectar a funcionalidade do teu fluxo e provocar erros. Ademais, non pode usar o nome dunha variable de entrada ou saída existente.

   

Xestionar as variables de entrada e saída

Todas as variables de entrada e saída creadas están dispoñibles na sección correspondente do panel de variables.

Podes usar este panel para renomear, actualizar, eliminar, atopar os usos, fixar e filtrar cada variable de entrada/saída. O filtrado permítelle seleccionar se aplicalo ás variables fixadas ou non.

Para actualizar unha variable de entrada/saída:

1. Fai clic co botón dereito no seu nome no panel de variables e selecciona Editar.

   Importante

   Se tenta cambiar o nome dunha variable de entrada ou de saída a un nome de variable de fluxo existente, Power Automate pediráselle que confirme a fusión das dúas variables. A combinación non intencionada pode afectar a funcionalidade do teu fluxo e provocar erros. Ademais, non pode usar o nome dunha variable de entrada ou saída existente.

   

2. No cadro de diálogo Editar variable de entrada/saída , actualice os campos desexados e seleccione Gardar para aplicar os cambios.

   

Variables sensibles

Importante

Os fluxos desenvolvidos en versións antigas de Power Automate para escritorio (v.2.13 ou anteriores) non se ven afectados pola funcionalidade de variables sensibles mentres non as edites. Se executas fluxos de escritorio existentes a través da consola ou do portal sen editalos, manterán o comportamento antigo e funcionarán como antes.

Para aplicar a nova funcionalidade, edita e garda os fluxos con Power Automate para escritorio v.2.14 ou superior. Power Automate converterá as variables de entrada cifradas anteriores e as variables cifradas producidas pola Obter contrasinal de CyberArk acción en variables de texto marcadas como sensibles.

Algúns escenarios de automatización manexan información confidencial e requiren un tratamento especial de variables que almacenan e usan datos confidenciais durante o tempo de execución. Os fluxos de escritorio admiten a creación de variables sensibles, cuxos valores se enmascaran durante a depuración no panel de variables do deseñador de fluxos.

Ademais, se iniciaches sesión cunha conta premium da organización, os valores das variables sensibles non se almacenan no historial de execución do portal, cando os fluxos do escritorio se executan a través da consola ou os fluxos da nube.

Calquera variable pode chegar a ser sensible, independentemente do seu tipo. A sensibilidade aplícase a nivel variable, polo que as listas, as filas de datos, as táboas de datos e os obxectos personalizados son sensibles no seu conxunto. Non hai forma de marcar un elemento de lista, unha columna de táboa de datos ou unha propiedade de variable como sensibles nunha variable non sensible.

Podes usar, manipular e procesar variables sensibles en cada acción sen ningunha limitación, como calquera outra variable. Ademais, pode combinalos con outras variables e incluílos en expresións. Neste caso, os rexistros tratan toda a expresión como sensible.

O deseñador de fluxo manexa a sensibilidade como unha máscara que pode activar e desactivar. Así, pode desenmascarar variables sensibles para ver os seus valores e enmascaralas de novo para ocultar os seus valores.

Importante

As variables sensibles non están destinadas a proporcionar protección sobre os datos codificados. Non debe codificar os datos críticos en texto plano, como contrasinais e PIN, nas propiedades de accións como Establecer variable, aínda que as devanditas variables estean marcadas como sensibles. Os rexistros de fluxo do escritorio estarán protexidos, pero os valores codificados están visibles no modal e na definición de fluxo en Microsoft Dataverse.

Para atopar máis información sobre entradas confidenciais nos fluxos de nube, consulta Xestionar entradas confidenciais como contrasinais.

Nota

• O valor dunha variable sensible é visible cando a envía fóra dos fluxos do escritorio ou se amosa a través de Mostrar mensaxe acción.
• A sensibilidade non é herdable nas variables. Se engades ou asignas unha variable sensible a outra variable, a variable resultante non será sensible por defecto.
• Marcar unha variable como sensible oculta os seus valores do resumo do Establecer variable acción.
• Os detalles de entrada da acción Establecer variable non son visibles nos rexistros de fluxo do escritorio cando as variables contidas foron marcadas como sensibles.
• O enmascaramento de variables sensibles durante a depuración ofrece só unha forma básica de protección aos desenvolvedores de terceiros que miran as súas pantallas.

Para marcar unha variable como sensible, fai clic co botón dereito sobre ela no panel de variables e selecciona Marcar como sensible. Para evitar que unha variable sexa sensible, fai clic co botón dereito sobre ela e selecciona Marcar como non sensible.

Ademais dos menús contextuales, podes usar a icona dedicada ao lado de cada variable para marcala como sensible ou non.

Variables de entrada e saída sensibles

Cando crees ou edites unha variable de entrada ou de saída, podes seleccionar Marcar como sensible no cadro de diálogo respectivo para facelo sensible.

O valor predeterminado dunha variable de entrada é visible no diálogo de creación ou edición cando a sensibilidade está activada. Este valor só existe para fins de proba e depuración, xa que ten que inicializar cada entrada nas execucións de produción a través do portal ou da consola. Os valores predeterminados non están protexidos nos modais de acción e na definición de fluxo Dataverse.

Por outra banda, o valor predeterminado non está visible no panel de variables e no diálogo Entrada de fluxo , que aparece cando executas un fluxo de escritorio con variables de entrada a través da consola.

A icona do ollo para revelar o valor non está dispoñible a menos que elimine o valor de texto predeterminado e proporcione un novo. Os novos valores son visibles cando se enchen outros tipos de datos ademais do texto.

Variables de entrada opcionais

Cando creas ou editas unha variable de entrada ou de saída, podes seleccionar Marcar como opcional no cadro de diálogo respectivo para facelo opcional.

Por defecto, as variables de entrada son obrigatorias, o que significa que debes proporcionar:

• Un valor predeterminado ao crealo para que se poida usar durante a depuración (iniciada por consola) execútase no caso de que non pase outro valor.
• Un valor do tipo respectivo para garantir a correcta execución.

Se unha variable de entrada se marca como opcional, pódense omitir ambas as anteriores porque pode recibir valores en branco .

Establecendo o valor predeterminado das entradas opcionais en En branco

Variables de texto

Para establecer o valor predeterminado dunha variable de texto en En branco:

• Establece a propiedade Tipo de datos en Texto.
• Activa o control Marcar como opcional .
• Asegúrate de que a propiedade Valor predeterminado estea baleira.

Entrada numérica en branco

Para establecer o valor predeterminado dunha variable numérica como Blanco:

• Establece a propiedade Tipo de datos en Número.
• Activa o control Marcar como opcional .
• Asegúrate de que a propiedade Valor predeterminado estea baleira.

Entrada booleana en branco

Para establecer o valor predeterminado dunha variable booleana como Blanco:

• Establece a propiedade Tipo de datos en Booleano.
• Activa o control Marcar como opcional .
• Asegúrate de que a propiedade Valor predeterminado estea definida como <En branco>.

Entrada de obxecto personalizado en branco

Para establecer o valor predeterminado dun obxecto personalizado como Blanco:

• Establece a propiedade Tipo de datos en Obxecto personalizado.
• Activa o control Marcar como opcional .
• Asegúrate de que a propiedade Valor predeterminado estea definida como <Blanco>. Para conseguilo, seleccione Editar a carón da propiedade e na xanela Editar obxecto personalizado , active a Editor JSON control. Elimina todos os contidos e, a continuación, selecciona Gardar.

Entrada de lista en branco

Para establecer o valor predeterminado dunha lista como Blanco:

• Establece a propiedade Tipo de datos en Lista.
• Activa o control Marcar como opcional .
• Asegúrate de que a propiedade Valor predeterminado estea definida como <Blanco>. Para conseguilo, seleccione Editar a carón da propiedade e na xanela Editar lista , active a Control do editor JSON . Elimina todos os contidos e, a continuación, selecciona Gardar.

Entrada da táboa de datos en branco

Para establecer o valor predeterminado dunha táboa de datos como Blanco:

• Establece a propiedade Tipo de datos en Datatable.
• Activa o control Marcar como opcional .
• Asegúrate de que a propiedade Valor predeterminado estea definida como <En branco>. Para conseguilo, seleccione Editar a carón da propiedade e na xanela Editar táboa de datos , active a Control do editor JSON . Elimina todos os contidos e, a continuación, selecciona Gardar.

Edita variables ao depurar un fluxo de escritorio

Na consola de deseño, Power Automate o escritorio admite a edición de tipos de variables comúns mentres se executa o fluxo no depurador. Actualmente, os tipos de datos admitidos inclúen valores de texto, numéricos, de data, hora e booleanos.

Como editar variables mentres se executa un fluxo no depurador

Hai dous métodos que podes empregar para comezar a modificar manualmente os valores das variables de fluxo na consola de deseño.
Coloque un punto de interrupción nalgún momento antes de querer cambiar o valor da variable de fluxo. Execute o fluxo e despois agarde ata que o fluxo se deteña no punto de interrupción seleccionado. O panel de variables de fluxo está na esquina inferior dereita da consola: busca o nome da variable na lista e fai dobre clic ao seu carón para abrir o visor de variables.

Modificar un valor numérico:

Abra a variable que require edición, coloque o cursor no campo de entrada e edite manualmente o valor numérico. Alternativamente, hai botóns para contar cara arriba ou abaixo desde o valor actual no lado dereito da entrada no visor de variables. Teña en conta que non pode cambiar o valor a outro que non sexa numérico.

Modificar un valor de texto:

Abra a variable que require edición, coloque o cursor no campo de entrada e edite manualmente o valor do texto. Hai unha caixa de verificación para envolver o texto no campo de entrada, o que facilita a visualización no editor. As variables de valor de texto aceptan números como entradas, pero ten en conta que se modifica este valor e tenta pasalo a unha acción cun parámetro de entrada que só acepta valor numérico, o fluxo xera un erro de excepción cando chega a ese punto.

Modificar un valor booleano:

Abra a variable que require edición, coloque o cursor no campo de entrada e, a continuación, edite manualmente o valor booleano. Use a lista despregable para seleccionar verdadeiro ou falso.

Modificar un valor de data e hora:

Abra a variable que require edición, coloque o cursor no campo de entrada e edite manualmente o valor da data e hora. Hai unha mensaxe de aviso que aparece no visor de variables se introduce un valor que non é aceptable.

Limitacións e problemas coñecidos

• Problema: Os fluxos creados ou editados con Power Automate para a versión de escritorio 2.14 ou superior son incompatibles con versións anteriores de Power Automate para escritorio. Non podes usar versións antigas de Power Automate para escritorio para abrir ou executar estes fluxos.

  Solucións: Ningún.