Partajați prin

Gestionarea variabilelor și panoul de variabile

  • Articol

Panoul de variabile arată variabilele de intrare și de ieșire transmise către și de la Power Automate fluxurile desktop. De asemenea, afișează toate variabilele utilizate în fluxul desktop curent sub Variabile flux.

Prin acest panou, puteți să căutați variabile, să le redenumiți, să găsiți utilizările lor, să le marcați ca sensibile, să le fixați și să le filtrați după tip. Filtrarea vă permite să selectați dacă să o aplicați variabilelor fixate sau nu.

Captură de ecran a panoului de variabile.

Vizualizatorul de valori variabile

Când rulează un flux, valoarea curentă a fiecărei variabile este vizibilă lângă numele acesteia. Selectați pictograma radieră din partea de jos a panoului de variabile pentru a șterge toate valorile curente.

Notă

Power Automate omite automat variabilele acțiunilor dezactivate. Activați o acțiune dezactivată pentru a face variabilele sale disponibile în panoul de variabile.

Captură de ecran a unor valori din panoul de variabile.

Pentru a examina valoarea unei variabile mai detaliat, faceți dublu clic pe ea. Vizualizatorul de valori variabile afișează tipul de date al variabilei selectate și extinde orice datarows sau datatables pentru a le afișa conținutul.

Captură de ecran a vizualizatorului cu valori variabile.

Anumite tipuri de date pot conține elemente imbricate. De exemplu, un obiect personalizat ar putea să conțină un alt obiect personalizat în proprietățile sale. Pentru a vizualiza proprietățile elementului imbricat, selectați Mai multe.

Captură de ecran a unui obiect personalizat părinte în vizualizatorul de valori variabile.

Selectați pictograma săgeată din partea de sus a casetei de dialog pentru a reveni la elementul părinte.

Captură de ecran a unui obiect personalizat copil, exemplu de vizualizare a valorii variabile.

Redenumirea unei variabile desktop

Pentru a redenumi o variabilă de flux de desktop, faceți clic dreapta pe numele acesteia și selectați Redenumiți. Power Automate actualizează automat numele variabilei în toate aparițiile acesteia.

Important

Dacă încercați să redenumiți o variabilă cu un nume existent, Power Automate vă va solicita să confirmați îmbinarea celor două variabile. Îmbinarea neintenționată poate afecta funcționalitatea fluxului dvs. și poate cauza erori, așa că asigurați-vă că îmbinarea este de dorit.

Captură de ecran a opțiunii Redenumire variabilă.

Variabile de intrare și de ieșire

Power Automate vă permite să faceți schimb de date între fluxurile cloud și desktop folosind variabile de intrare și ieșire, extinzând capabilitățile de automatizare. Variabilele de intrare și de ieșire vă permit, de asemenea, să transmiteți informații între fluxurile desktop prin acțiunea „Run flux desktop”.

În plus, puteți utiliza variabilele de intrare pentru a seta manual valorile atunci când fluxurile sunt declanșate prin consolă.

Pentru a găsi mai multe informații despre transmiterea datelor între fluxurile cloud și desktop, consultați Declanșați fluxurile desktop din fluxurile cloud.

Creați o variabilă de intrare

Pentru a crea o variabilă de intrare:

  1. Selectați butonul plus (+) din panoul de variabile și apoi Intrare.

    Captură de ecran a butonului care creează o nouă variabilă de intrare.

  2. Când apare dialogul Nouă variabilă de intrare , completați următoarele câmpuri:

    • Nume variabilă: numele variabilei din fluxul desktop.
    • Tip de date: tipul variabilei: text, număr, boolean, personalizat obiect, list, datatable sau instanță.
    • Valoare implicită: valoarea implicită atunci când fluxul trece prin proiectantul de flux sau prin consolă. Când creați un obiect personalizat, o listă sau o variabilă de intrare pentru un tabel de date, Power Automate vă permite să construiți valoarea implicită printr-un editor vizual sau JSON. Captură de ecran a unei variabile de intrare a unui obiect personalizat în editorul vizual.
    • Subtip de date: tipul exact al instanței (disponibil numai când Instanță a fost selectată anterior ca tip de date): Excel, Word, Outlook sau Access.
    • Nume extern: numele extern este numele care apare în proiectantul de flux în cloud și în dialogul de intrare a fluxului la apelarea fluxului din consolă.
    • Descriere: descrierea variabilei care apare în designerul de flux cloud și desktop în timpul apelării fluxului.
    • Marcare ca sensibilă: definește dacă se marchează variabila ca sensibilă sau nu. Puteți găsi informații despre variabilele sensibile în Variabilele sensibile.
    • Marcați ca opțional: definește dacă popularea acestei variabile de intrare este obligatorie sau nu. Prin marcarea unei variabile de intrare ca opțională, îi permiteți să primească valori Blank și să omiteți transmiterea unei valori reale, ceea ce nu duce la o eroare. Puteți găsi informații despre variabilele de intrare opționale în Variabilele de intrare opționale.

    Notă

    Câmpurile Nume variabilă, Tipul de date și Nume extern sunt necesare pentru a crea o variabilă de intrare.

    Notă

    Variabilele de intrare de tip instanță (Excel, Word, Outlook sau Access) nu acceptă valorile implicite. Fluxurile cu aceste intrări pot rula prin acțiunea „Run desktop flow” a unui alt flux desktop sau prin proiectant pentru testare sau depanare. În rulările de proiectant, variabilele de intrare ale instanței pot fi inițializate temporar utilizându-le ca variabile produse ale acțiunilor respective de Lansare sau Atașare.

    Important

    Dacă alegeți un nume de variabilă de flux existent pentru o nouă variabilă de intrare, Power Automate vă va solicita să confirmați îmbinarea celor două variabile. Îmbinarea neintenționată poate afecta funcționalitatea fluxului dvs. și poate cauza erori. De asemenea, nu puteți utiliza numele unei variabile de intrare sau de ieșire existente.

    Captură de ecran a casetei de dialog pentru a crea o nouă variabilă de intrare.

Când declanșați fluxuri desktop direct prin consolă, nu un flux cloud, caseta de dialog Intrari flux vă solicită să setați manual valorile pentru variabilele de intrare. Pentru obiecte, liste și tabele de date personalizate, caseta de dialog vă permite să completați valori folosind un editor vizual sau JSON.

Captură de ecran a casetei de dialog Intrări flux.

Creați o variabilă de ieșire

Pentru a crea o variabilă de ieșire:

  1. Selectați butonul plus (+) din panoul de variabile și apoi Ieșire.

    Captură de ecran a butonului care creează o nouă variabilă de ieșire.

  2. Când apare dialogul Nouă variabilă de ieșire , completați următoarele câmpuri:

    • Nume variabilă: numele variabilei din fluxul desktop.
    • Tip de date: tipul variabilei: text, număr, boolean, personalizat obiect, list, datatable sau instanță.
    • Subtip de date: tipul exact al instanței (disponibil numai când Instanță a fost selectată anterior ca tip de date): Excel, Word, Outlook sau Access.
    • Nume extern: numele extern este numele care apare în designerul de flux cloud.
    • Descriere: descrierea variabilei care apare în designerul de flux cloud sau desktop în timpul apelării fluxului.
    • Marcare ca sensibilă: definește dacă se marchează variabila ca sensibilă sau nu. Puteți găsi informații despre variabilele sensibile în Variabilele sensibile.

    Notă

    Câmpurile Nume variabilă, Tipul de date și Nume extern sunt necesare pentru a crea o variabilă de ieșire.

    Important

    Dacă alegeți un nume de variabilă de flux existent pentru o nouă variabilă de ieșire, Power Automate vă va solicita să confirmați îmbinarea celor două variabile. Îmbinarea neintenționată poate afecta funcționalitatea fluxului dvs. și poate cauza erori. De asemenea, nu puteți utiliza numele unei variabile de intrare sau de ieșire existente.

    Captură de ecran a casetei de dialog pentru a crea o nouă variabilă de ieșire.

Gestionați variabilele de intrare și de ieșire

Toate variabilele de intrare și de ieșire create sunt disponibile în secțiunea corespunzătoare a panoului de variabile.

Puteți folosi acest panou pentru a redenumi, actualiza, șterge, găsi utilizări, fixați și filtrați fiecare variabilă de intrare/ieșire. Filtrarea vă permite să selectați dacă să o aplicați variabilelor fixate sau nu.

Captură de ecran a secțiunii panoului de variabile care afișează variabilele de intrare și de ieșire.

Pentru a actualiza o variabilă de intrare/ieșire:

  1. Faceți clic dreapta pe numele acestuia în panoul de variabile și selectați Editare.

    Important

    Dacă încercați să redenumiți o variabilă de intrare sau de ieșire la un nume de variabilă de flux existent, Power Automate vă va solicita să confirmați îmbinarea celor două variabile. Îmbinarea neintenționată poate afecta funcționalitatea fluxului dvs. și poate cauza erori. De asemenea, nu puteți utiliza numele unei variabile de intrare sau de ieșire existente.

    Captură de ecran a opțiunii de editare a variabilelor de intrare și de ieșire.

  2. În caseta de dialog Editare variabile de intrare/ieșire , actualizați câmpurile dorite și selectați Salvare pentru a aplica modificările.

    Captură de ecran a casetei de dialog pentru editarea variabilelor de intrare și de ieșire.

Variabile sensibile

Important

Fluxurile dezvoltate în versiunile mai vechi de Power Automate pentru desktop (v.2.13 sau mai vechi) rămân neafectate de funcționalitatea variabilelor sensibile atâta timp cât nu le editați. Dacă rulați fluxuri desktop existente prin consolă sau portal fără a le edita, acestea vor păstra vechiul comportament și vor funcționa ca înainte.

Pentru a aplica noua funcționalitate, editați și salvați fluxurile cu Power Automate pentru desktop v.2.14 sau o versiune ulterioară. Power Automate va converti variabilele de intrare criptate anterioare și variabilele criptate produse de Obține parola de la CyberArk acțiune în variabile text marcate ca sensibile.

Unele scenarii de automatizare gestionează informații confidențiale și necesită o gestionare specială a variabilelor care stochează și utilizează date sensibile în timpul rulării. Fluxurile desktop acceptă crearea de variabile sensibile, ale căror valori sunt mascate în timpul depanării în panoul de variabile al designerului de flux.

În plus, dacă v-ați conectat cu un cont premium de organizație, valorile variabilelor sensibile nu sunt stocate în istoricul Run din portal, atunci când fluxurile desktop rulează prin consolă sau fluxurile cloud.

Orice variabilă poate deveni sensibilă, independent de tipul ei. Sensibilitatea se aplică la nivel variabil, astfel încât listele, rândurile de date, tabele de date și obiectele personalizate devin sensibile în ansamblu. Nu există nicio modalitate de a marca un element de listă, o coloană de date sau o proprietate variabilă ca fiind sensibilă într-o variabilă altfel nesensibilă.

Puteți utiliza, manipula și procesa variabile sensibile în fiecare acțiune fără nicio limitare, ca orice altă variabilă. În plus, le puteți combina cu alte variabile și le puteți include în expresii. În acest caz, jurnalele tratează întreaga expresie ca fiind sensibilă.

Designerul de flux tratează sensibilitatea ca pe o mască pe care o puteți activa și dezactiva. Astfel, puteți demasca variabilele sensibile pentru a le vedea valorile și le puteți masca din nou pentru a le ascunde valorile.

Important

Variabilele sensibile nu sunt menite să ofere protecție împotriva datelor codificate. Nu ar trebui să codificați datele critice în text simplu, cum ar fi parolele și codurile PIN, în proprietățile acțiunilor precum Setați variabila, chiar dacă variabilele menționate sunt marcate ca fiind sensibile. Jurnalele de flux desktop vor fi protejate, dar valorile codificate sunt vizibile în modal și definiția fluxului în Microsoft Dataverse.

Pentru a găsi mai multe informații despre intrările sensibile din fluxurile cloud, consultați Gestionați intrările sensibile, cum ar fi parolele.

Notă

  • Valoarea unei variabile sensibile este vizibilă atunci când o trimiteți în afara fluxurilor desktop sau este afișată prin acțiunea Afișați mesajul .
  • Sensibilitatea nu este moștenită în variabile. Dacă adăugați sau atribuiți o variabilă sensibilă unei alte variabile, variabila rezultată nu va fi sensibilă în mod implicit. Excepția de la această regulă se aplică numai tipurilor de variabile de acreditări. Variabilele de acreditare, produse fie de acțiunea respectivă, fie de reatribuire dintr-o altă variabilă, sunt întotdeauna sensibile, iar sensibilitatea lor este impusă. Aceeași excepție se aplică și proprietății „Parolă” a tipurilor de variabile de acreditări.
  • Marcarea unei variabile ca fiind sensibilă ascunde valorile acesteia din rezumatul acțiunii Setare variabilă .
  • Detaliile de intrare ale acțiunii Setare variabilă nu sunt vizibile în jurnalele de flux de pe desktop atunci când variabilele conținute au fost marcate ca sensibile.
  • Mascarea variabilelor sensibile în timpul depanării oferă doar o formă de bază de protecție dezvoltatorilor de la terți care se uită la ecranele lor.

Pentru a marca o variabilă ca sensibilă, faceți clic dreapta pe ea în panoul de variabile și selectați Marcați ca sensibilă. Pentru a împiedica o variabilă să fie sensibilă, faceți clic dreapta pe ea și selectați Marcați ca nesensibilă.

Captură de ecran a opțiunii de a marca o variabilă ca fiind sensibilă.

În afară de meniurile contextuale, puteți folosi pictograma dedicată de lângă fiecare variabilă pentru a o marca ca sensibilă sau nesensibilă.

Captură de ecran a pictogramei pentru a marca o variabilă ca fiind sensibilă.

Variabile sensibile de intrare și ieșire

Când creați sau editați o variabilă de intrare sau de ieșire, puteți selecta Marcați ca sensibilă în dialogul respectiv pentru a o face sensibilă.

Captură de ecran a casetei de dialog pentru a adăuga o nouă variabilă de intrare.

Valoarea implicită a unei variabile de intrare este vizibilă în dialogul de creare sau editare când sensibilitatea este activată. Această valoare există doar în scopuri de testare și depanare, deoarece trebuie să inițializați fiecare intrare în rulările de producție prin portal sau consolă. Valorile implicite nu sunt protejate în modalele de acțiune și în definiția fluxului în Dataverse.

Pe de altă parte, valoarea implicită nu este vizibilă în panoul de variabile și în dialogul Intrare flux , care apare atunci când rulați un flux de desktop cu variabile de intrare prin consolă.

Pictograma ochi pentru a dezvălui valoarea nu este disponibilă decât dacă ștergeți valoarea implicită a textului și furnizați una nouă. Noile valori sunt vizibile la popularea altor tipuri de date în afară de text.

Captură de ecran a dialogului de intrare a fluxului cu o variabilă sensibilă.

Variabile de intrare opționale

Când creați sau editați o variabilă de intrare sau de ieșire, puteți selecta Marcați ca opțional în dialogul respectiv pentru a o face opțională.

Captură de ecran a mărcii ca control opțional.

În mod implicit, variabilele de intrare sunt obligatorii, ceea ce înseamnă că trebuie să furnizați:

  • O valoare implicită la crearea acesteia, astfel încât să poată fi utilizată în timpul depanării (inițiate de consolă) rulează în cazul în care nu treceți o altă valoare.
  • O valoare de tipul respectiv pentru a asigura o execuție corectă.

Dacă o variabilă de intrare este marcată ca opțională, ambele variante de mai sus pot fi omise, deoarece poate primi valori Blank .

Setarea valorii implicite a intrărilor opționale la Gol

Variabile text

Pentru a seta valoarea implicită a unei variabile text la Alb:

  • Setați proprietatea Tip de date la Text.
  • Activați controlul Marcați ca opțional .
  • Asigurați-vă că proprietatea Valoare implicită este goală.

Captură de ecran a configurației de introducere a variabilei de text pentru a utiliza gol ca valoare implicită.

Intrare numerică goală

Pentru a seta valoarea implicită a unei variabile numerice la Alb:

  • Setați Tipul de date proprietatea la Număr.
  • Activați controlul Marcați ca opțional .
  • Asigurați-vă că proprietatea Valoare implicită este goală.

Captură de ecran a configurației de introducere a variabilelor numerice pentru a utiliza gol ca valoare implicită.

Intrare booleană goală

Pentru a seta valoarea implicită a unei variabile booleene la Blank:

  • Setați proprietatea Tip de date la Boolean.
  • Activați controlul Marcați ca opțional .
  • Asigurați-vă că proprietatea Valoare implicită este setată la <Blank>.

Captură de ecran a configurației de intrare a variabilelor booleene pentru a utiliza gol ca valoare implicită.

Intrare de obiect personalizat goală

Pentru a seta valoarea implicită a unui obiect personalizat la Alb:

  • Setați proprietatea Tip de date la Obiect personalizat.
  • Activați controlul Marcați ca opțional .
  • Asigurați-vă că proprietatea Valoare implicită este setată la <Blank>. Pentru a realiza acest lucru, selectați Editare lângă proprietate și în fereastra Editare obiect personalizat , activați controlul editor JSON . Ștergeți tot conținutul, apoi selectați Salvare.

Captură de ecran a configurației de introducere a obiectelor personalizate pentru a utiliza gol ca valoare implicită.

Intrare în listă goală

Pentru a seta valoarea implicită a unei liste la Alb:

  • Setați proprietatea Tip de date la List.
  • Activați controlul Marcați ca opțional .
  • Asigurați-vă că proprietatea Valoare implicită este setată la <Blank>. Pentru a realiza acest lucru, selectați Editare lângă proprietate și în fereastra Editare listă , activați controlul editor JSON . Ștergeți tot conținutul, apoi selectați Salvare.

Captură de ecran a configurației de intrare a listei pentru a utiliza gol ca valoare implicită.

Intrare în tabel de date necompletat

Pentru a seta valoarea implicită a unui tabel de date la Alb:

  • Setați proprietatea Tip de date la Datatable.
  • Activați controlul Marcați ca opțional .
  • Asigurați-vă că proprietatea Valoare implicită este setată la <Blank>. Pentru a realiza acest lucru, selectați Editare lângă proprietate și, în fereastra Editare tabel de date , activați controlul editor JSON . Ștergeți tot conținutul, apoi selectați Salvare.

Captură de ecran a configurației de intrare a tabelului de date pentru a utiliza gol ca valoare implicită.

Editați variabilele în timpul depanării unui flux desktop

În consola de proiectare, Power Automate desktop-ul acceptă editarea tipurilor de variabile comune în timp ce rulează fluxul în depanator. În prezent, tipurile de date acceptate includ valorile text, numerice, datetime și booleene.

Cum să editați variabile în timp ce rulați un flux în depanator

Există două metode pe care le puteți folosi pentru a începe modificarea manuală a valorilor variabilelor de flux în consola de proiectare.
Plasați un punct de întrerupere la un moment dat înainte de a doriți să modificați valoarea variabilei de flux. Rulați fluxul și apoi așteptați până când fluxul se întrerupe la punctul de întrerupere selectat. Panoul pentru variabile de flux este în colțul din dreapta jos al consolei – găsiți numele variabilei în listă și faceți dublu clic lângă acesta pentru a deschide vizualizatorul de variabile.

Modificați o valoare numerică:

Deschideți variabila care necesită editare, plasați cursorul pe câmpul de introducere și editați manual valoarea numerică. Alternativ, există butoane pentru a număra în sus sau în jos de la valoarea curentă în partea dreaptă a intrării în vizualizatorul de variabile. Rețineți că nu puteți schimba valoarea cu altceva decât numeric.

Captură de ecran a variabilei numerice în curs de modificare în vizualizatorul de variabile.

Modificați o valoare de text:

Deschideți variabila care necesită editare, plasați cursorul pe câmpul de introducere și editați manual valoarea textului. Există o casetă de selectare pentru a include textul în câmpul de introducere, ceea ce vă facilitează vizualizarea în editor. Variabilele cu valoare text acceptă numere ca intrări, dar rețineți că dacă modificați această valoare și încercați să o transmiteți unei acțiuni cu un parametru de intrare care acceptă doar valoare numerică, fluxul aruncă o eroare de excepție când ajunge la acel punct.

Captură de ecran a variabilei text în curs de modificare în vizualizatorul de variabile.

Modificați o valoare booleană:

Deschideți variabila care necesită editare, plasați cursorul pe câmpul de intrare și apoi editați manual valoarea booleană. Utilizați lista derulantă pentru a selecta adevărat sau fals.

Captură de ecran a variabilei booleene care se modifică în vizualizatorul de variabile.

Modificați o valoare datetime:

Deschideți variabila care necesită editare, plasați cursorul pe câmpul de introducere și editați manual valoarea datetime. Există un mesaj de avertizare care apare în vizualizatorul de variabile dacă introduceți o valoare care nu este acceptabilă.

Captură de ecran a variabilei datetime în curs de modificare în vizualizatorul de variabile.

Probleme și limitări cunoscute

  • Problemă: Fluxurile create sau editate cu Power Automate pentru desktop versiunea 2.14 sau o versiune superioară sunt incompatibile cu versiunile mai vechi ale Power Automate pentru desktop. Nu puteți folosi versiuni mai vechi de Power Automate pentru desktop pentru a deschide sau a rula aceste fluxuri.

    Soluții: Niciuna.