Comparteix a través de


Administrar les variables i la subfinestra de variables

La subfinestra de variables mostra les variables d'entrada i sortida passades des de i cap als fluxos d'escriptori Power Automate . També mostra totes les variables utilitzades en el flux d'escriptori actual a Variables de flux.

A través d'aquesta subfinestra, podeu cercar variables, canviar-ne el nom, trobar-ne els usos, marcar-les com a sensibles, ancorar-les i filtrar-les per tipus. El filtratge permet seleccionar si voleu aplicar-lo a les variables ancorades o no.

Captura de pantalla de la subfinestra de variables.

El visor de valors variables

Quan s'executa un flux, el valor actual de cada variable és visible al costat del seu nom. Seleccioneu la icona d'esborrar a la part inferior de la subfinestra de variables per esborrar tots els valors actuals.

Nota

Power Automate Omet automàticament les variables de les accions inhabilitades. Habiliteu una acció inhabilitada per fer que les seves variables estiguin disponibles a la subfinestra de variables.

Captura de pantalla d'alguns valors de la subfinestra de variables.

Per examinar el valor d'una variable amb més detall, feu-hi doble clic. El visualitzador de valors de variables mostra el tipus de dades de la variable seleccionada i amplia les files de dades o taules de dades per mostrar-ne el contingut.

Captura de pantalla del visor de valors variables.

Alguns tipus de dades poden contenir elements imbricats. Per exemple, un objecte personalitzat pot contenir un altre objecte personalitzat a les seves propietats. Per veure les propietats de l'element imbricat, seleccioneu Més.

Captura de pantalla d'un objecte personalitzat principal al visualitzador de valors variables.

Seleccioneu la icona de fletxa a la part superior del diàleg per tornar a l'element principal.

Captura de pantalla d'un objecte personalitzat secundari, exemple del visualitzador de valors variables.

Canvi de nom d'una variable d'escriptori

Per canviar el nom d'una variable de flux d'escriptori, feu clic amb el botó dret sobre el seu nom i seleccioneu Canvia el nom. Power Automate Actualitza automàticament el nom de la variable en totes les seves ocurrències.

Important

Si intenteu canviar el nom d'una variable a un nom existent,us Power Automate demanarà que confirmeu la fusió de les dues variables. La fusió involuntària pot afectar la funcionalitat del vostre flux i provocar errors, així que assegureu-vos que la fusió sigui desitjable.

Captura de pantalla de l'opció Canvia el nom de la variable.

Variables d'entrada i sortida

Power Automate Permet l'intercanvi de dades entre fluxos de núvol i escriptori a través de les variables d'entrada i sortida, cosa que us permet ampliar les capacitats d'automatització

A més, podeu utilitzar variables d'entrada per establir valors manualment quan els fluxos s'activen a través de la consola.

Per obtenir més informació sobre el pas de dades entre els fluxos del núvol i de l'escriptori, consulteu Activa els fluxos d'escriptori dels fluxos del núvol.

Crear una variable d'entrada

Per crear una variable d'entrada:

  1. Seleccioneu el botó més (+) a la subfinestra de variables i, a continuació, Entrada.

    Captura de pantalla del botó que crea una nova variable d'entrada.

  2. Quan aparegui el diàleg Variable d'entrada nova, empleneu els camps següents:

    • Nom de la variable: el nom de la variable al flux de l'escriptori.
    • Tipus de dades: El tipus de variable: text, nombre , booleà, objecte personalitzat, ... llista o taula de dades.
    • Valor per defecte: el valor per defecte quan el flux s'executa a través del dissenyador de flux o la consola. Quan creeu un objecte personalitzat, una llista o una variable d'entrada de taula de dades, Power Automate us permet construir el valor per defecte mitjançant un editor visual o JSON. Captura de pantalla d'una variable d'entrada d'objecte personalitzada a l'editor visual.
    • Nom extern: el nom extern és el nom que apareix al dissenyador de fluxos al núvol i al diàleg d'entrades de flux quan es crida el flux des de la consola.
    • Descripció: La descripció de la variable que apareix al núvol i al dissenyador de fluxos d'escriptori mentre truqueu al flux.
    • Marca com a sensible: defineix si s'ha de marcar la variable com a sensible o no. Podeu trobar informació sobre variables sensibles a Variables sensibles.
    • Marca com a opcional: defineix si emplenar aquesta variable d'entrada és obligatori o no. Si marqueu una variable d'entrada com a opcional, permeteu que rebi valors en blanc i ometi passar un valor real, cosa que no provoca cap error. Podeu trobar informació sobre variables d'entrada opcionals a Variables d'entrada opcionals.

    Nota

    Els camps Nom de la variable, Tipus de dades iNom extern són necessaris per crear una variable d'entrada.

    Important

    Si trieu un nom de variable de flux existent per a una nova variable d'entrada, Power Automate us demanarà que confirmeu la fusió de les dues variables. La fusió involuntària pot afectar la funcionalitat del flux i provocar errors. A més, no podeu utilitzar el nom d'una variable d'entrada o de sortida existent.

    Captura de pantalla del diàleg per crear una nova variable d'entrada.

Quan activeu els fluxos d'escriptori directament a través de la consola, no un flux de núvol, el diàleg Entrades de flux us demana que definiu valors per a les variables d'entrada manualment. Per a objectes personalitzats, llistes i taules de dades, el diàleg us permet emplenar valors mitjançant un editor visual o JSON.

Captura de pantalla del diàleg Entrades de flux.

Crear una variable de sortida

Per crear una variable de sortida:

  1. Seleccioneu el botó més (+) a la subfinestra de variables i, a continuació , Sortida.

    Captura de pantalla del botó que crea una nova variable de sortida.

  2. Quan aparegui el diàleg Variable de sortida nova, empleneu els camps següents:

    • Nom de la variable: el nom de la variable al flux de l'escriptori.
    • Tipus de dades: El tipus de variable: text, nombre , booleà, objecte personalitzat, ... llista o taula de dades.
    • Nom extern: el nom extern és el nom que apareix al dissenyador de fluxos de núvol.
    • Descripció: La descripció de la variable que apareix al núvol o al dissenyador de flux d'escriptori mentre crida al flux.
    • Marca com a sensible: defineix si s'ha de marcar la variable com a sensible o no. Podeu trobar informació sobre variables sensibles a Variables sensibles.

    Nota

    Els camps Nom de la variable, Tipus de dades iNom extern són necessaris per crear una variable de sortida.

    Important

    Si trieu un nom de variable de flux existent per a una nova variable de sortida, Power Automate us demanarà que confirmeu la fusió de les dues variables. La fusió involuntària pot afectar la funcionalitat del flux i provocar errors. A més, no podeu utilitzar el nom d'una variable d'entrada o de sortida existent.

    Captura de pantalla del diàleg per crear una nova variable de sortida.

Gestionar les variables d'entrada i sortida

Totes les variables d'entrada i sortida creades estan disponibles a la secció adequada de la subfinestra de variables.

Podeu utilitzar aquesta subfinestra per canviar el nom, actualitzar, suprimir, trobar els usos, ancorar i filtrar cada variable d'entrada/sortida. El filtratge permet seleccionar si voleu aplicar-lo a les variables ancorades o no.

Captura de pantalla de la secció de variables que mostra les variables d'entrada i sortida.

Per actualitzar una variable d'entrada/sortida:

  1. Feu clic amb el botó dret sobre el seu nom a la subfinestra de variables i seleccioneu Edita.

    Important

    Si intenteu canviar el nom d'una variable d'entrada o sortida a un nom de variable de flux existent, Power Automate us demanarà que confirmeu la fusió de les dues variables. La fusió involuntària pot afectar la funcionalitat del flux i provocar errors. A més, no podeu utilitzar el nom d'una variable d'entrada o de sortida existent.

    Captura de pantalla de l'opció d'edició de variables d'entrada i sortida.

  2. Al diàleg Edita la variable d'entrada /sortida, actualitzeu els camps desitjats i seleccioneu Desa per aplicar els canvis.

    Captura de pantalla del diàleg per editar variables d'entrada i sortida.

Variables sensibles

Important

Els fluxos desenvolupats en versions anteriors de per a l'escriptori (v.2.13 o anteriors) no es veuran afectats per la funcionalitat de Power Automate les variables sensibles mentre no els editeu. Si executeu fluxos d'escriptori existents a través de la consola o el portal sense editar-los, mantindran el comportament antic i funcionaran com abans.

Per aplicar la nova funcionalitat, editeu i deseu els fluxos amb Power Automate per a l'escriptori v.2.14 o superior. Power Automate convertirà variables d'entrada xifrades anteriors i variables xifrades produïdes per l'acció Obtén la contrasenya a variables de CyberArk text marcades com a sensibles.

Alguns escenaris d'automatització gestionen informació confidencial i requereixen un maneig especial de variables que emmagatzemen i utilitzen dades sensibles durant el temps d'execució. Els fluxos d'escriptori admeten la creació de variables sensibles, els valors de les quals s'emmascaren durant la depuració a la subfinestra de variables del dissenyador de flux.

A més, si heu iniciat la sessió amb un compte premium de l'organització, els valors de les variables sensibles no s'emmagatzemen a l'historial d'execucions del portal, quan els fluxos d'escriptori s'executen a través de la consola o els fluxos del núvol.

Qualsevol variable pot arribar a ser sensible, independentment del seu tipus. La sensibilitat s'aplica al nivell de variable, de manera que les llistes, les files de dades, les taules de dades i els objectes personalitzats es tornen sensibles en conjunt. No hi ha manera de marcar un element de llista, una columna de taula de dades o una propietat variable com a sensible en una variable no sensible.

Podeu utilitzar, manipular i processar variables sensibles en cada acció sense cap limitació, com qualsevol altra variable. A més, podeu combinar-los amb altres variables i incloure'ls a les expressions. En aquest cas, els registres gestionen tota l'expressió com a sensible.

El dissenyador de flux gestiona la sensibilitat com una màscara que podeu activar i desactivar. Per tant, podeu desemmascarar variables sensibles per veure'n els valors i emmascarar-les de nou per amagar-ne els valors.

Important

Les variables sensibles no estan pensades per proporcionar protecció sobre les dades codificades. No heu de codificar dades crítiques en text pla, com ara contrasenyes i PIN, a les propietats d'accions com ara Defineix la variable , encara que aquestes variables estiguin marcades coma sensibles. Els registres de flux d'escriptori estaran protegits, però els valors codificats són visibles en el modal i la definició de flux en Microsoft Dataverse.

Per obtenir més informació sobre entrades sensibles en fluxos al núvol, vegeu Administrar entrades sensibles, com ara contrasenyes.

Nota

  • El valor d'una variable sensible és visible quan l'envieu fora dels fluxos d'escriptori o es mostra mitjançant l'acció Mostra el missatge .
  • La sensibilitat no és heretable en variables. Si afegiu o assigneu una variable sensible a una altra variable, la variable resultant no serà sensible de manera predeterminada.
  • Marcar una variable com a sensible amaga els seus valors del resum de l'acció Defineix la variable .
  • Els detalls d'entrada de l'acció Defineix la variable no són visibles als registres de flux de l'escriptori quan les variables contingudes s'han marcat com a sensibles.
  • L'emmascarament de variables sensibles durant la depuració només proporciona una forma bàsica de protecció als desenvolupadors davant de tercers que miren les seves pantalles.

Per marcar una variable com a sensible, feu-hi clic amb el botó dret a la subfinestra de variables i seleccioneu Marca com a sensible. Per evitar que una variable sigui sensible, feu-hi clic amb el botó dret i seleccioneu Marca com a no sensible.

Captura de pantalla de l'opció de marcar una variable com a sensible.

A part dels menús contextuals, podeu utilitzar la icona dedicada al costat de cada variable per marcar-la com a sensible o no sensible.

Captura de pantalla de la icona per marcar una variable com a sensible.

Variables sensibles d'entrada i sortida

Quan creeu o editeu una variable d'entrada o de sortida, podeu seleccionar Marca com a sensible al diàleg respectiu per fer-la sensible .

Captura de pantalla del diàleg per afegir una nova variable d'entrada.

El valor per defecte d'una variable d'entrada és visible en el diàleg de creació o edició quan la sensibilitat està habilitada. Aquest valor només existeix amb finalitats de prova i depuració, ja que heu d'inicialitzar cada entrada en producció que s'executa a través del portal o la consola. Els valors per defecte no estan protegits en els modals d'acció ni en la definició del flux Dataverse.

D'altra banda, el valor per defecte no és visible a la subfinestra de variables i al diàleg Entrada de flux , que apareix quan executeu un flux d'escriptori amb variables d'entrada a través de la consola.

La icona de l'ull per mostrar el valor no està disponible tret que suprimiu el valor de text predeterminat i en proporcioneu un de nou. Els valors nous són visibles quan s'emplenen altres tipus de dades a més del text.

Captura de pantalla del diàleg d'entrades de flux amb una variable sensible.

Variables d'entrada opcionals

Quan creeu o editeu una variable d'entrada o de sortida, podeu seleccionar Marca com a opcional al diàleg corresponent per fer-la opcional .

Captura de pantalla de la marca com a control opcional.

Per defecte, les variables d'entrada són obligatòries, és a dir, que heu de proporcionar:

  • S'executa un valor per defecte en crear-lo de manera que es pugui utilitzar durant la depuració (iniciat per la consola) en cas que no passeu un altre valor.
  • Un valor del tipus respectiu per assegurar la correcta execució.

Si una variable d'entrada es marca com a opcional, es poden ometre les dues anteriors perquè pot rebre valors en blanc .

Definició del valor predeterminat de les entrades opcionals en blanc

Variables de text

Per definir el valor per defecte d'una variable de text en blanc:

  • Definiu la propietat Tipus de dades a Text.
  • Habiliteu la marca com a control opcional .
  • Assegureu-vos que la propietat Valor per defecte estigui buida.

Captura de pantalla de la configuració d'entrada de variables de text per utilitzar el blanc com a valor per defecte.

Entrada numèrica en blanc

Per definir el valor per defecte d'una variable numèrica en blanc:

  • Definiu la propietat Tipus de dades a Número.
  • Habiliteu la marca com a control opcional .
  • Assegureu-vos que la propietat Valor per defecte estigui buida.

Captura de pantalla de la configuració d'entrada de variables numèriques per utilitzar el blanc com a valor per defecte.

Entrada booleana en blanc

Per definir el valor per defecte d'una variable booleana en blanc:

  • Definiu la propietat Tipus de dades a Boolean.
  • Habiliteu la marca com a control opcional .
  • Assegureu-vos que la propietat Valor per defecte estigui definida com a <En blanc>.

Captura de pantalla de la configuració d'entrada de variables booleanes per utilitzar el blanc com a valor per defecte.

Entrada d'objecte personalitzada en blanc

Per definir el valor per defecte d'un objecte personalitzat en blanc:

  • Definiu la propietat Tipus de dades a Objecte personalitzat.
  • Habiliteu la marca com a control opcional .
  • Assegureu-vos que la propietat Valor per defecte estigui definida com a <En blanc>. Per aconseguir-ho, seleccioneu Edita al costat de la propietat i, a la finestra Edita l'objecte personalitzat, habiliteu el control de l'editor JSON. Suprimiu tots els continguts i, a continuació, seleccioneu Desa.

Captura de pantalla de la configuració personalitzada d'entrada d'objectes per utilitzar el blanc com a valor predeterminat.

Entrada de llista en blanc

Per definir el valor per defecte d'una llista en blanc:

  • Definiu la propietat Tipus de dades a la llista.
  • Habiliteu la marca com a control opcional .
  • Assegureu-vos que la propietat Valor per defecte estigui definida com a <En blanc>. Per aconseguir-ho, seleccioneu Edita al costat de la propietat i, a la finestra Edita la llista , habiliteu el control de l'editor JSON. Suprimiu tots els continguts i, a continuació, seleccioneu Desa.

Captura de pantalla de la configuració d'entrada de llista per utilitzar el blanc com a valor per defecte.

Entrada de la taula de dades en blanc

Per definir el valor per defecte d'una taula de dades en blanc:

  • Definiu la propietat Tipus de dades a Datatable.
  • Habiliteu la marca com a control opcional .
  • Assegureu-vos que la propietat Valor per defecte estigui definida com a <En blanc>. Per aconseguir-ho, seleccioneu Edita al costat de la propietat i, a la finestra Edita la taula de dades, habiliteu el control de l'editor JSON. Suprimiu tots els continguts i, a continuació, seleccioneu Desa.

Captura de pantalla de la configuració d'entrada de la taula de dades per utilitzar el blanc com a valor per defecte.

Editeu variables mentre depureu un flux d'escriptori

A la consola de disseny, Power Automate l'escriptori admet l'edició de tipus de variables comunes mentre s'executa el flux al depurador. Actualment, els tipus de dades admesos inclouen, text, numèric, datetime i valors booleans.

Com editar variables mentre s'executa un flux al depurador

Hi ha dos mètodes que podeu utilitzar per començar a modificar manualment els valors de les variables de flux a la consola de disseny.
Col·loqueu un punt d'interrupció en algun moment abans de voler canviar el valor de la variable de flux. Executeu el flux i, a continuació, espereu fins que el flux s'aturi al punt d'interrupció seleccionat. La subfinestra de variables de flux es troba a l'extrem inferior dret de la consola: cerqueu el nom de la variable a la llista i feu-hi doble clic al costat per obrir el visor de variables.

Modifiqueu un valor numèric:

Obriu la variable que requereix edició, col·loqueu el cursor al camp d'entrada i editeu manualment el valor numèric. Alternativament, hi ha botons per comptar cap amunt o cap avall des del valor actual a la part dreta de l'entrada al visor de variables. Tingueu en compte que no podeu canviar el valor a una altra cosa que no sigui numèrica.

Captura de pantalla de la variable numèrica que s'està modificant en el visor de variables.

Modifiqueu un valor de text:

Obriu la variable que requereix edició, col·loqueu el cursor al camp d'entrada i editeu manualment el valor del text. Hi ha una casella de selecció per embolicar text dins del camp d'entrada, que us facilita la visualització a l'editor. Les variables de valor de text accepten números com a entrades, però tingueu en compte que si modifiqueu aquest valor i intenteu passar-lo a una acció amb un paràmetre d'entrada que només accepta valor numèric, el flux llança un error d'excepció quan arriba a aquest punt.

Captura de pantalla de la variable de text que s'està modificant al visor de variables.

Modifiqueu un valor booleà:

Obriu la variable que requereix edició, col·loqueu el cursor al camp d'entrada i, a continuació, editeu manualment el valor booleà. Utilitzeu la llista desplegable per seleccionar true o false.

Captura de pantalla de la variable booleana que s'està modificant al visor de variables.

Modifiqueu un valor datetime:

Obriu la variable que requereix edició, col·loqueu el cursor al camp d'entrada i editeu manualment el valor datetime. Hi ha un missatge d'advertiment que apareix al visor de variables si introduïu un valor que no és acceptable.

Captura de pantalla de la variable datetime que s'està modificant al visor de variables.

Problemes i limitacions coneguts

  • Issue: Els fluxos creats o editats amb per a la versió d'escriptori 2.14 o superior són incompatibles amb Power Automate versions anteriors de per a l'escriptori Power Automate . No podeu utilitzar versions anteriors de per a l'escriptori Power Automate per obrir o executar aquests fluxos.

    Solucions: Cap.