Úpravy toků desktopového uživatelského rozhraníEdit desktop UI flows

Toky desktopového uživatelského rozhraní automatizují desktopové aplikace pro Windows.Desktop UI flows automate Windows desktop applications. Další informace o problémech, na které můžete narazit, jejich alternativních řešeních a scénářích, které v této verzi nejsou podporované, najdete v části Známé problémy.Please refer to the Known issues to learn more about issues you might run into, workarounds for those issues, and scenarios that are not supported in this release.

PožadavkyPrerequisites

Tok desktopového uživatelského rozhraní.A desktop UI flow. Pokud ho nemáte, vytvořte si ho, abyste v něm mohli provádět úpravy.Create a desktop UI flow now if you don't have one to edit.

Úprava akcíEdit actions

Úprava akcíEdit actions

V rámci úprav nahrávky můžete:You can edit your recording to:

  • Změnit hodnotu pro akce, které ji podporují.Modify the value for actions that support it.
  • Odstranit krok.Delete a step.
  • Odstranit nahrávku.Delete the recording.
  • Přetažením změnit pořadí akcí.Change the order of actions with drag and drop. Při této akci postupujte obezřetně, protože může narušit konzistentnost vaší nahrávky.Do exercise caution with this as it may break the consistency of your recording.

Pokročilé parametry vám umožňují změnit následující:Advanced parameters let you change:

  • Zpoždění po provedení akce.The delay after the action is performed. Změnou PT0S na PT1S můžete například přidat 1sekundové zpoždění.For example, you can add a one second delay by changing PT0S to PT1S. To se hodí tehdy, když má cílová aplikace pomalou dobu odezvy, která se nedokončí ještě před dalším krokem toku uživatelského rozhraní.This can be useful when the target application has a slow response time that doesn’t complete before the next step of your UI flow. Můžete také explicitně přidat akce zpoždění tak, aby mohly být použity například ve smyčkách.You can also add delay actions explicitly so that they can be used in loops, for example.
  • Selektor pro cílový prvek uživatelského rozhraní.The selector for the target user interface element.

Přidání nahrávkyAdd a recording

Tok uživatelského rozhraní můžete nahrávat v rámci více relací.You may want to record your UI flow in multiple sessions. Po dokončení první nahrávky je možné pokračovat tímto způsobem:After you've completed your first recording you can proceed as follows:

  1. Přihlásit se k Power Automate.Sign into Power Automate.

  2. Vyberte Moje toky > Toky uživatelského rozhraní.Select My flows > UI flows.

  3. Vyberte tok uživatelského rozhraní, který chcete upravit.Select the UI flow that you want to edit.

    Obrázek zobrazující tok uživatelského rozhraní, který má být upraven

  4. Vyberte položku Upravit.Select Edit.

  5. Vyberte Nový krok.Select New step.

    Nový krokNew step

  6. V seznamu akcí vyberte Nahrát aplikaci.Select Record app from the list of actions.

    Nahrát aplikaciRecord app

  7. Vyberte Spustit záznamník.Select Launch recorder.

    Výběr spuštění záznamníkuSelect launch recorder

    Nahoře na obrazovce se zobrazí ovládací prvek záznamníku.The recorder control displays at the top of your screen.

    Ovládací prvek záznamníkuThe recorder-control

  8. Spusťte aplikaci, kterou chcete nahrát.Start the app that you want to record.

    Tip

    Když je ukazatel myši na ovládacím prvku v aplikaci, ovládací prvek se zvýrazní modrým obrysem.As your mouse hovers over controls in the app, you'll notice that a blue outline highlights each control. Před výběrem ovládacího prvku vždy počkejte na modré zvýraznění.Always wait for the blue highlight before you select a control.

    Pokud se modré zvýraznění kolem prvku nezobrazí, nemusí se správně nahrát.If the blue highlight doesn't display around the element, it might not be recorded properly.

  9. V ovládacím prvku záznamníku vyberte Nahrávání.Select Record from the recorder control.

  10. Proveďte kroky v uživatelském rozhraní aplikace, kterou nahráváte, a potom v ovládacím prvku záznamníku vyberte Hotovo.Perform the steps in the user interface of the app you are recording, and then select Done on the recorder control.

  11. Vyberte Uložit a tok uživatelského rozhraní otestujte.Select Save, and then test your UI flow.\

Při spuštění zadejte argumenty příkazového řádkuProvide command line arguments at launch

Po zaznamenání akcí toků uživatelského rozhraní můžete zadat argumenty příkazového řádku pro aplikace, které se spouštějí tokem uživatelského rozhraní.After you record your UI flows actions, you can provide command line arguments for the apps that your UI flows launch.

Postupujte podle těchto pokynů a přidejte argumenty příkazového řádku do aplikací, které spouští váš tok uživatelského rozhraní:Follow these steps to add command line arguments to the apps that your UI flow launches:

  1. Zaznamenejte tok uživatelského rozhraní pomocí desktopového záznamníku.Record a UI flow with the desktop recorder.

  2. Vyberte Hotovo na rekordéru a pak vyberte akci spuštění aplikace a rozbalte ji.Select Done on the recorder, select the application launch action to expand it.

    Snímek obrazovky používá jako příklad Notepad ++.The screenshot uses Notepad++ as an example.

    Zobrazí krok aplikace spuštěníDisplays the launch application step

  3. Vyberte Zobrazit rozšířené možnosti.Select Show advanced options.

    Kliknutím na odkaz zobrazíte rozšířené možnostiSelect the link to reveal the advanced options

  4. Zde zadejte argumenty příkazového řádku:Provide the command line arguments here:

    Zobrazí textové pole pro argumenty příkazového řádkuDisplays the text field for the command line arguments

  5. Pro svou aplikaci můžete zadat jakýkoli platný argument příkazového řádku.You can provide any valid command line argument for your application.

Důležité

Nepředávejte citlivý text jako hesla prostřednictvím argumentů příkazového řádku.Do not pass sensitive text like passwords through command line arguments.

Přidání proměnnéAdd a variable

Proměnné můžete použít k provádění více akcí v rámci vašich toků uživatelského rozhraní.You can use variables to perform multiple actions within your UI flows. Například můžete pomocí proměnné spočítat, kolikrát byla operace provedena ve smyčce.For example, you can use a variable to count how many times an operation was performed in a loop. Nebo můžete použít proměnnou k vytvoření pole řetězců s odečty obrazovky provedenými ve smyčce.Or, you can use a variable to create an string array with the screen readings done in a loop.

Tip

Můžete použít celočíselné, plovoucí, booleovské, řetězcové, maticové a objektové datové typy proměnných.You can use integer, float, Boolean, string, array, and object variable data types.

Po vytvoření proměnné můžete provádět další úkoly, například:After you create a variable, you can perform other tasks, for example:

  • Zvýšení nebo snížení proměnné o konstantní hodnotu, což je známo také jako přírůstek a úbytek.Increase or decrease the variable by a constant value, also known as increment and decrement.
  • Vložení nebo připojení hodnoty proměnné jako poslední položku v řetězci nebo poli.Insert or append the variable’s value as the last item in a string or array.
  • Přiřazení jiné hodnoty proměnné.Assign a different value to a variable.

Chcete-li vytvořit a použít proměnné v toku uživatelského rozhraní, postupujte takto:Follow these steps to create and use variables in a UI flow:

  1. Přejděte na začátek toku uživatelského rozhraní a vyberte Přidat akci.Go to the beginning of the UI flow and select Add an action.

    Výběr akceSelect add an action

  2. Hledejte slovo proměnná a poté vyberte akci Inicializovat proměnnou v rámci integrované kategorie.Search for the word variable, and then select the Initialize variable action under the built-in category.

    Výběr akce pro inicializaci proměnnéSelect the initialize variable action

  3. Inicializujte proměnnou tak, aby vyhovovala vašim potřebám.Initialize the variable to type that meets your needs.

    Inicializujte proměnnou na potřebný typInitialize the variable to the type you need

Tip

Pokud váš scénář automatizace uživatelského rozhraní zahrnuje čtení hodnot z obrazovky ve smyčce, můžete toho dosáhnout inicializací proměnné jako typu pole.If your UI automation scenario involves reading values from a screen in a loop, you could achieve this by initializing the variable as an array type.

Poté v toku uživatelského rozhraní vyberte akci proměnné Připojit k poli a poté použít výstup akce Získat text ze seznamu dynamického obsahu.Then, within the UI flow, select the Append to Array variable action, and then use the output of Get Text action from dynamic content list.

Můžete připojit k poli ve smyčceYou can append to an array in a loop

Kroky kopírování a vkládáníCopy and paste steps

Můžete kopírovat akce a rozsahy, použít Přidat akci pro výběr zkopírovaných akcí a rozsahů z mé schránky a poté je vložit na jiné místo ve stejném toku uživatelského rozhraní.You can copy actions and scopes, use Add an action to select the copied actions and scopes from My clipboard, and then paste them into another location within the same UI flow.

Toky uživatelského rozhraní automaticky přejmenují zkopírované akce a rozsahy jedinečným názvem.UI flows automatically renames the copied actions and scopes with a unique name. Pokud zkopírovaný rozsah obsahuje jiný rozsah, vnořená struktura se zachová, když ho vložíte z mojí schránky.If the copied scope contains another scope, the nested structure is retained when you paste it from My clipboard.

Důležité

Tato funkce podporuje kopírování a přidávání akcí ve stejném rozsahu.This feature supports copying and adding actions within the same scope. Akce nelze vložit do jiných rozsahů nebo toků uživatelského rozhraní.You cannot paste actions into other scopes or UI flows.

Chcete-li zkopírovat a vložit akce a rozsahy, postupujte takto:Follow these steps to copy and then paste actions and scopes:

  1. Vyberte a potom vyberte Zkopírovat do mé schránky pro akci nebo rozsah, který chcete kopírovat.Select , and then select Copy to my clipboard for the action or scope that you want to copy.

    Pohled na kopírovací schránkuView of the copy clipboard

  2. Najeďte myší na cílové umístění a poté vyberte Přidat akci.Hover over the target location, and then select Add an action.

    Tip

    Můžete vybrat Přidat akci přímo, pokud je na konci rozsahu nebo toku uživatelského rozhraní.You can select Add an action directly if it is at the end of the scope or UI flow.

    Výběr možnosti Přidat akciAdd an action selected

  3. Vyberte Moje schránka a poté vyberte akci nebo rozsah, které jste zkopírovali.Select My clipboard, and then select the action or scope you copied.

    Výběr akce kopírováníSelect the copied action

  4. Všimněte si, že toky uživatelského rozhraní vloží kartu akce s jedinečným názvem.Notice that UI flows pastes the action card with a unique name.

    Zobrazit nový název zkopírované akceView the new name of the copied action

  5. Všimněte si také, že jakékoli akce se snímky obrazovky si je také ponechají pro snadnou referenci.Also notice that any actions with screenshots will also retain them for easy reference.

    Zobrazit zachované snímky obrazovkyView retained screenshots

    Více zachovaných snímků obrazovkyMore retained screenshots

Okamžité vložení rozsahu po soběPaste a scope immediately after itself

Poznámka

Pokud rozsah nemá akci Zavřít aplikaci a uživatel zkopíruje rozsah a poté vloží rozsah bezprostředně za stávající rozsah, vložené akce se provedou pouze v rámci první instance aplikace.If a scope does not have a Close Application action, and the user copies the scope and then pastes the scope immediately after the existing scope, the pasted actions will only be performed within the first application instance.

Vložení rozsahuPaste a scope

V tomto příkladu budou provedeny zvýrazněné akce Kliknutí levým tlačítkem 11 a Opakované stisknutí kláves v první aplikaci Poznámkový blok a bude spuštěna další instance poznámkového bloku.In this example, the highlighted actions Left click 11 and Replay keystrokes will be performed in the first Notepad application, and another notepad instance will be launched.

K řešení tohoto problému instance mají uživatelé dvě možnosti:To address this instance issue, users have two options:

  1. Pokud chcete provést akce pouze v první instanci aplikace, můžete zkopírovat a vložit pouze relevantní akce v prvním rozsahu.If you only want to perform the action(s) in the first application instance, you can copy and paste only the relevant actions in the first scope. Chcete-li zkopírovat a vložit celý rozsah najednou, měli byste odebrat akci Spustit ve vloženém rozsahu, abyste zabránili spuštění cizí instance aplikace.If you want to copy and paste the entire scope at once, you should remove the Launch action in the pasted scope to prevent launching an extraneous application instance.

    Pouze relevantní akceRelevant actions only

  2. Pokud chcete provést akce v samostatné instanci aplikace, můžete přidat akci Zavřít aplikaci v prvním oboru, takže druhý rozsah bude mít vlastní instanci.If you want to perform the action(s) in a separate application instance, you can add a Close application action in the first scope, so that the second scope will have its own instance.

    Samostatná instance aplikaceSeparate application instance

Přidání smyčkyAdd a loop

Toky uživatelského rozhraní mají podporu pro pole.UI flows have support for arrays. Pomocí pole přidejte smyčku k provádění opakujících se kroků v toku uživatelského rozhraní.Use an array, to add a loop to perform repetitive steps in a UI flow. Můžete přenést různé typy polí z toku do vašeho toku UI, včetně např. složitých polí ze seznamu SharePoint.You can pass in different types of arrays from a flow to your UI flow, including complex arrays from a SharePoint list, for example.

Poznámka

Chcete-li přidat smyčku, musíte upravit stávající tok uživatelského rozhraní.You must edit an existing UI flow to add a loop.

Zde jsou kroky k vytvoření smyčky v toku uživatelského rozhraní:Here are the steps to create a loop in a UI flow:

  1. Upravte tok uživatelského rozhraní, do kterého chcete přidat smyčku.Edit the UI flow to which you want to add the loop.

    Vyberte tlačítko Upravit pro tok uživatelského rozhraníSelect the edit button for the UI flow

  2. Přejděte do vstupní části průvodce a vyberte možnost Nastavení vstupů.Navigate to input section of the wizard, and then select Set up inputs.

    Vyberte Nastavení vstupůSelect Set up inputs

  3. Vyberte Pole pro označení, že chcete vytvořit typ vstupu pole.Select Array to indicate that you want to create an array input type.

    Výběr poleSelect Array

  4. Zadejte podrobnosti pro pole včetně názvu, pole ve formátu JSON a popis pole.Enter the details for the array including a name, the array in JSON format, and a description for the array.

    Podrobnosti poleDetails of the array

    Tip

    Pokud používáte komplexní pole ze seznamu SharePoint, nemusíte vytvářet pole ručně.If you are using a complex array from a SharePoint list, you don't have to create the array manually. Pole můžete zkopírovat z toku a vložit do prostředního pole.You can copy the array from a flow and paste it into the middle box.

  5. Vyberte Další.Select Next.

  6. Vyberte Přidat akci.Select Add an action .

  7. Vyhledejte „do každého“ > Vestavěný > a poté vyberte Použít na každý.Search for "to each" > Built-in > and then select Apply to each.

    Zvolte použít na každou akciSelect the apply to each action

  8. Vyberte Vyberte výstup z předchozích kroků, vyberte pole, které jste definovali dříve, z dynamického obsahu.Select Select an output from previous steps, select the array you defined earlier from the Dynamic content.

    Přidejte pole z dynamického obsahuAdd the array from dynamic content

  9. Přetáhněte akce, které chcete opakovat, a vložte je na kartu Použít na každý.Drag the actions you want to repeat and drop them onto the Apply to each card.

    Například jsem vložil LeftClick 4 na kartu Použít na každý na následujícím obrázku.For example, I've dropped the LeftClick 4 onto the Apply to each card in the following image.

    Přetáhněte krok, který chcete opakovat, do pole z dynamického obsahuDrag the step you want to repeat onto the array from dynamic content

  10. Podle potřeby nahraďte vstupní tokeny vytvořené během záznamu vstupními hodnotami pole.Replace the input tokens created during the recording with the array input values as needed.

Tip

Pokud je pole jednoduchý řetězec nebo celé číslo, můžete použít Aktuální položka přímo z dynamického obsahu, jak je to zobrazeno na následujícím obrázku.If the array is a simple string or integer array, you can use the Current item directly from the Dynamic content, like the following image. Můžete také použít výrazy.You can also use expressions.

Použít aktuální položku

Známá omezení:Known Limitations:

  1. Smyčky vyžadují statické selektory.Loops require static selectors. To znamená, že prvek uživatelského rozhraní (UX), u kterého se opakovaná akce děje, se nesmí změnit.This means that the user interface (UX) element on which the repetitive action happens must not change.
  2. Výstupní operace nejsou aktuálně podporovány.Output operations are not currently supported.
  3. U komplexních objektů pole, které je třeba předat z toku, jako je seznam Sharepoint, uveďte příklad užitečného zatížení tohoto objektu.For complex array objects that need to be passed from a flow, like a Sharepoint list, provide an example payload of that object. Chcete-li získat užitečné zatížení, můžete spustit tok bez kroku toku uživatelského rozhraní a poté zkopírovat výstup akce do středního textového pole (Přidat ukázková data), když definujete pole.To get the payload, you can run the flow without the UI flow step, and then copy the output of the action into the middle (Add sample data) text box when you define the array.
  4. Pro složité typy objektů pole musíte použít výrazy.You must use expressions for complex array object types. Například použijte výraz items(‘Apply to each’)[‘’], kdeFor example, use the expression items(‘Apply to each’)[‘’], where je název konkrétního objektu ve vstupním poli.is name of the specific object within the input array.

Přidání zpožděníAdd a delay

Můžete přidat zpoždění toků uživatelského rozhraní, které vám pomohou řídit běh toku uživatelského rozhraní.You can add delay in UI flows to help control the UI flow run.

Postupujte podle těchto kroků, kterými přidáte zpoždění do toku uživatelského rozhraní, který jste zaznamenali.Follow these steps to add a delay to a UI flow that you've recorded.

  1. Na požadovaném místě umístěte kurzor nad šipku a vyberte Vložit nový krok.In the desired spot, hover over the arrow and select Insert a new step. Alternativně pro přidání na konec toku rozsahu nebo uživatelského rozhraní vyberte přímo volbu Přidat akci.Alternatively, for adding it to the end of the scope or UI flow, select Add an action directly.

    Vložení kroku zpoždění

  2. Vyberte Přidat akci.Select Add an action.

    Přidání akce zpoždění

  3. Vyberte Integrované a hledejte „zpoždění“.Select Built-in, and search for "delay". Alternativně vyberte Plán > Zpoždění.Alternatively, select Schedule > Delay.

    Akce pro vyhledání zpoždění

  4. Zadejte počet, například „2“ představuje číslo jednotky.Enter the count, for example "2" to represent the number of the Unit.

  5. Vyberte jednotku, například minuty, která bude představovat délku zpoždění.Select the Unit, for example minutes, to represent the length of time for the delay.

    Následující obrázek ukazuje zpoždění o dvě minuty.The following image shows a delay of two minutes.

    Definování zpoždění

    Akce zpoždění se přidá do toku uživatelského rozhraní.The delay action is added to the UI flow. Nyní, když tok běží, dojde před spuštěním další akce ke zpoždění, které jste definovali.Now, when the flow runs, there will be a delay as you've defined before the next action runs.

Přidání zásady opakováníAdd a retry policy

Ve výchozím nastavení toky uživatelského rozhraní načítají neúspěšné kroky automatizace uživatelského rozhraní pomocí výchozího nastavení opakování a hodnoty časového limitu.By default, UI flows retries failed UI automation steps using the default retry settings and timeout value.

Postupujte podle těchto kroků a nastavte vlastní zásady opakování pro konkrétní kroky po zaznamenání toku uživatelského rozhraní.Follow these steps to set your own retry policy on specific steps after you've recorded your UI flow.

  1. Vyberte ... v kroku, ve kterém chcete změnit zásady opakování.Select ... on the step that you want to change the retry policy.

  2. Vyberte Nastavení.Select Settings.

    Otevře se karta nastavení pro tento krok.The settings card for the step opens.

    Otevřít kartu nastavení

  3. Přidejte hodnotu časového limitu do pole Doba trvání.Add a timeout value in the Duration box.

    Časový limit může být mezi jednou minutou a 24 hodinami.The timeout duration can be between one minute and 24 hours. Například musíte zadat délku časového limitu v tomto formátu: PT1M, aby reprezentovala časový limit po dobu jedné minuty nebo PT24H, aby reprezentovala časový limit 24 hodin.For example, you must enter the timeout duration in this format: PT1M to represent a timeout duration of one minute or PT24H to represent a timeout of 24 hours.

    Karta zásad opakování

    Časový limit je hodnota, kterou můžete zadat pro nastavení doby, po kterou by se tok uživatelského rozhraní měl pokusit provést akci, kterou nemůže dokončit, než ji zruší.The timeout is a value you can specify to set the length of time the UI flow should try to perform an action that it’s unable to complete before canceling it. Jakmile je akce zrušena, začínají zásady opakování.Once the action is canceled, the retry policy begins. Výchozí hodnota časového limitu je pět minut.The default timeout value is five minutes.

    V tocích uživatelského rozhraní existují tři typy opakování.There are three types of retries in UI flows.

    • VýchozíDefault
    • NezaokrouhlovatNone
    • VlastníCustom

Ve výchozím nastavení je vybrána možnost Výchozí.The Default option is selected by default. Tato výchozí hodnota je nastavena na 9 opakování.This default value is set to retry 9 times. Včetně počátečního pokusu to znamená celkem 10 pokusů.Including the initial attempt, this means a total of 10 attempts. Mezi opakováními je interval 1 sekunda.There is a 1 second interval between retries.

Pokud vyberete možnost Žádný, pak pro tento krok nejsou provedeny žádné pokusy o opakování.If you select the None option, then no retry attempts are done for this step.

Pokud chcete určit vlastní zásadu opakování, vyberte možnost Vlastní a zadejte hodnotu pro Počet opakování  a Délku intervalů.If you want to specify a custom retry policy, then select the Custom option, and enter value for Number of retries and Length of intervals.                   

Poznámka

Zásada opakování není k dispozici pro všechny kroky.The retry policy isn't available for all steps. Pokud možnosti opakování nevidíte, znamená to, že zásady nejsou pro konkrétní krok k dispozici.If you don't see the retry options, it means that the policy isn't available for the specific step.

Přidání ruční akceAdd a manual action

Po nahrání aplikace s alespoň jednou akcí můžete ručně přidat jakoukoli z níže uvedených akcí.Once you've recorded an application with at least one action, you can manually add any of the following actions for that application.

AkceAction KomentářComment
Zavření aplikaceClose application
Kliknutí pravým tlačítkem myšiRight click
Odeslání klávesSend keys Odešle klávesy a jejich kombinace, například CTRL + C.Send keys and key combinations, such as CTRL + C.
Kliknutí levým tlačítkem myšiLeft click
Získání textuGet text Přečte text z prvku uživatelského rozhraní a potom ho použije jako výstup.Read the text from a user interface element and then use it as an output.
Zadejte textEnter text
Získání stavu povolení prvkuGet element enabled Zkontroluje, jestli je prvek uživatelského rozhraní povolený nebo zakázaný.Check if a user interface element is enabled or disabled.
Vymazání prvkuClear element Vymaže hodnotu v upravitelném prvku uživatelského rozhraní.Clear the value in an editable user interface element.
Čekání po určitý počet sekundWait for seconds Počká, než přejde k dalšímu kroku.Wait before continuing to the next step.

Při přidání ruční akce postupujte podle těchto kroků:Follow these steps to add a manual action:

  1. Přihlásit se k Power Automate.Sign into Power Automate.

  2. Vyberte Moje toky > Toky uživatelského rozhraní.Select My flows > UI flows.

  3. Vyberte tok uživatelského rozhraní, který chcete upravit.Select the UI flow that you want to edit.

    Tok uživatelského rozhraní k úpravě

  4. Vyberte položku Upravit.Select Edit.

  5. Vyberte kartu nahrávky, která obsahuje kroky, k nimž chcete přidat nový krok.Select the recording card that contains the steps to which you want to add a new step. Karta se rozbalí a zobrazí nahrané kroky.The card expands and displays the recorded steps.

    Výběr karty nahrávky

  6. Na kartě nahrávky vyberte přímo pod posledním nahraným krokem možnost Přidat akci.Select Add an action on the recording card, just below the last recorded step. Zobrazí se seznam ručních akcí uvedených výše v tomto návodu.You'll see the list of manual actions listed earlier in the walkthrough.

  7. Vyberte akci, kterou chcete přidat.Select the action you want to add. V tomto případě jsme zvolili Získání stavu povolení prvku, ale můžete vybrat jakoukoli akci, která se hodí pro váš scénář.Here, I've selected Get element enabled, but you can select any action that makes sense for your scenario.

    Výběr akce, která se má přidat

Po přidání akce je potřeba v rozšířených možnostech akce nastavit položku Selektor.Once the action is added, you will need to set the Selector in the action’s advanced options.

Rozšířené možnosti akceAction advanced options

Nastavení selektoruSet the selector

Selektor identifikuje prvek uživatelského rozhraní, na který se během přehrávání provádí akce.The selector identifies the user interface element onto which the action is performed during playback. Pokud je to možné, doporučujeme zkopírovat a vložit tento údaj ze samostatného kroku zacíleného na stejný prvek uživatelského rozhraní.We recommend that you copy/paste this information from a separate step targeting the same user interface element, if possible.

Formát selektoru je následující:The format of the selector is:

{  
   "type":"WinUIA",
   "parameters":{  
      "elementStack":[  

      ],
      "elementXPath":""
   }
}

V prvku selektoru je potřeba zadat data pro pole elementStack a elementXPath.You need to provide the data for the the elementStack and elementXPath fields of the selector element.

Pole elementStack může vypadat takto:Here is an example of what the elementStack might look like.

Zásobník prvkuElement stack

Pole elementXPath můžete zachytit pomocí záznamníku uživatelského rozhraní WinAppDriver.You can capture the elementXPath using the WinAppDriver UI Recorder.

Nástroj WADWAD tool

Před tím, než použijete výsledek v poli elementXPath selektoru, odeberte první prvek (tj. všechno před /Window).Remove the first element (everything before /Window) before using the result in elementXPath of the selector.

Otestujte proud uživatelského rozhraní, abyste se ujistili, že selektor funguje správně.Test your UI flow to confirm that your selector works correctly.

Použití pokročilých ovládacích prvkůUse advanced controls

Do toků uživatelského rozhraní můžete začlenit pokročilé ovládací prvky, jako jsou podmínky, příkazy switch case a akce pro ukončení.You can incorporate advanced controls such as conditions, switch cases, and terminate actions within your UI flows.

Tyto pokročilé operace můžete provádět v existujícím toku uživatelského rozhraní pomocí následujících kroků:You can perform these advanced operations by performing the following steps on an existing UI flow.

  1. Vyberte tok uživatelského rozhraní, který jste vytvořili, > Víc příkazů (...) > Upravit.Select the UI flow you have created > More commands (...) > Edit.

  2. U kroku toku uživatelského rozhraní, ke kterému chcete přidat logiku, vyberte + > Přidat akci.Select + > Add an action on the down arrow of UI flow step to which you want to add logic.

    Přidat akci

  3. Vyberte Built-in (Předdefinované) a vyberte jednu z dostupných akcí ovládacího prvku.Select Built-in, and then select one of the control actions available.

    Integrovaný

  4. Dokončete výraz, který je třeba vyhodnotit.Complete the expression that needs to be evaluated. Pomocí dynamického obsahu a výrazů můžete vyhodnotit podmínky a příkazy switch, které jste vytvořili.You may use dynamic content and expressions to evaluate your condition and switch controls. Kromě toho můžete použít libovolný výstup, který vygenerovaly přechozí kroky toku uživatelského rozhraní.Additionally, you can use any output that's generated from the previous UI flow steps.

    Karta Podmínka

Přidání nahrávky vzdáleného počítače pomocí rozpoznávání obrázků (Preview)Add a recording of a remote computer using image recognition (Preview)

V této funkci ještě asi uděláme změny, takže byste ji neměli používat pro normální práci.We expect changes to this feature, so you shouldn’t use it in production. Je určená jenom pro účely testování a vývoje.Use it only in test and development environments.

Rozpoznávání obrázků v tocích uživatelského rozhraní je funkce Preview a v současné době je k dispozici při nahrávání vzdáleného počítače pomocí aplikace Připojení ke vzdálené ploše (RDC).Image recognition in UI flows is a preview feature and currently available when recording a remote computer through the Remote Desktop Connection (RDC) app.  

Co je rozpoznávání obrázků?What is image recognition?

V současné době jsou toky desktopového uživatelského rozhraní primárně nahrávány pomocí rozhraní API pro usnadnění přístupu (UI Automation a WinAppDriver) k detekci ovládacích prvků ve stromu uživatelského rozhraní Microsoft Windows.Currently, desktop UI flows are primarily recorded using accessibility APIs (UI Automation and WinAppDriver) to detect the controls in the Microsoft Windows UI tree. Strom uživatelského rozhraní někdy není k dispozici, například u webových aplikací nebo aplikací Java.Sometimes, the UI tree isn't available, such as with Web-based or Java apps. Strom uživatelského rozhraní může být nespolehlivý, například když se ID ovládacího prvku často mění nebo se mění mezi relacemi.The UI tree may may be unreliable, such as when the IDs of a control change frequently or between sessions.

Díky rozpoznávání obrázků jsou místa kliknutí a další podrobnosti během přehrávání vizuálně sladěny, což značně rozšiřuje rozsah aplikací, které lze automatizovat.With image recognition, click locations and other details are visually matched during playback, greatly expanding the range of applications that can be automated.

Použití rozpoznávání obrázků k nahrávání vzdáleného počítačeUse image recognition to record a remote computer

  1. V novém nebo existujícím toku uživatelského rozhraní přejděte na kartu Vstupy a vytvořte dva nové vstupy citlivého textu, jeden pro uživatelské jméno a jeden pro heslo, které bude použito pro přihlášení ke vzdálenému zařízení.In a new or existing UI flow, go to the Inputs tab and create two new sensitive text inputs, one for the username and one for the password that will be used to log in to the remote device. Vstupy citlivého textu umožňují dynamicky předávat hodnoty při testování nebo volání toku uživatelského rozhraní z jiného toku, aniž by byly ukládány nebo protokolovány samotným tokem uživatelského rozhraní.Sensitive text inputs allow you to pass in the values dynamically when testing or calling the UI flow from another flow, without them being stored or logged by the UI flow itself.

    Citlivý textSensitive text

  2. Postupujte podle pokynů v části Přidání nahrávky pro spuštění ovládacího prvku záznamníku pro nový nebo existující tok uživatelského rozhraní.Follow the steps in Add a recording to launch the recorder control for a new or existing UI flow.

  3. Pomocí aplikace Vzdálená plocha se připojte ke vzdálenému počítači.Use the Remote Desktop app to connect to the remote computer.

  4. Roztáhněte okno aplikace Vzdálená plocha na celou obrazovku.Expand the Remote Desktop window to full screen.

  5. Vyberte Záznam z ovládacího prvku záznamníku a vyberte Rozumím v zobrazené výstraze.Select Record from the recorder control and select Got it in the alert that appears.

    Při automatickém otevření

  6. Proveďte kroky na vzdáleném počítači a poté vyberte Hotovo na ovládacím prvku záznamníku.Perform the steps on the remote computer, and then select Done on the recorder control.

  7. Vyhledejte akci Spustit vzdálenou plochu v rámci nahrávky a poté zadejte citlivý text pro uživatelské jméno a heslo.Locate the Launch Remote Desktop action within your recording, and then enter the sensitive text inputs for the username and password.

Citlivý text uživatelského jména a hesla

  1. Vyberte Uložit a tok uživatelského rozhraní otestujte.Select Save, and then test your UI flow.

Důležité

Když voláte tento tok uživatelského rozhraní z automatizovaného toku, doporučuje se použít řešení správy klíčů, například Azure Key Vault, pro načtení uživatelského jména a hesla a poté je dynamicky předat do vstupů citlivého textu v toku uživatelského rozhraní, než jej uložit do samotného toku.When you call this UI flow from an automated flow, it is recommended to use a key management solution such as Azure Key Vault to retrieve the username and password and then pass them to the sensitive text inputs in the UI flow dynamically, rather than storing them in the flow itself.

Tip

Povolte Zabezpečené vstupy v nabídce Nastavení pro akci Spustit tok uživatelského rozhraní pro desktop v toku, který volá tok uživatelského rozhraní.Enable Secure Inputs in the Settings menu for the Run a UI flow for desktop action in the flow that is calling the UI flow. Tím je zajištěno, že vstupy nejsou uloženy v historii spuštění.This ensures that the inputs are not stored in the run history.

Použití rozpoznávání obrázků k záznamu na CitrixUse image recognition to record on Citrix

Existují dvě možnosti záznamu na Citrix s toky uživatelského rozhraní.There are two options to record on Citrix with UI flows.

Možnost 1: zaznamenejte aplikaci Citrix nebo plochu, která je již na vašem počítači otevřenáOption 1: record a Citrix application or desktop already open on your machine

  1. Postupujte podle pokynů v části Přidání nahrávky pro spuštění ovládacího prvku záznamníku pro nový nebo existující tok uživatelského rozhraní.Follow the steps in Add a recording to launch the recorder control for a new or existing UI flow.
  2. Pro připojení ke vzdálenému počítači použijte aplikaci Citrix nebo vzdálenou plochu.Use the Citrix app or remote desktop to connect to the remote computer.

Zobrazení aplikace Citrix

  1. Pokud používáte vzdálenou plochu Citrix, rozbalte okno na celou obrazovku.If you are using Citrix remote desktop, expand the window to full screen.
  2. Vyberte Záznam z ovládacího prvku záznamníku a poté vyberte Chápu v zobrazeném upozornění.Select Record from the recorder control, and then select Got it in the alert that appears.
  3. Proveďte kroky v aplikaci Citrix a poté vyberte Hotovo na ovládacím prvku záznamníku.Perform the steps on Citrix, and then select Done on the recorder control.

Tip

V rámci toků uživatelského rozhraní můžete během jedné relace zaznamenat několik aplikací Citrix.UI flows, you can record several Citrix apps during the same session. Pokud jste nezaznamenali spuštění pracovního prostoru Citrix, otevřete všechny aplikace před zahájením nahrávání.Open all applications before you start recording if you have not recorded the launch of your Citrix workspace.

Možnost 2: zaznamenejte spuštění aplikace/plochy Citrix z pracovního prostoru CitrixOption 2: record the launch of your Citrix application / desktop from your Citrix workspace

  1. Postupujte podle pokynů v části Přidání nahrávky pro spuštění ovládacího prvku záznamníku pro nový nebo existující tok uživatelského rozhraní.Follow the steps in Add a recording to launch the recorder control for a new or existing UI flow.

  2. Otevřete pracovní prostor Citrix na hlavním panelu.Open the Citrix workspace from the taskbar.

  3. Zadejte heslo a poté vyberte Přihlásit se.Enter your password, and then and select Log on.

    Tip

    Pokud nechcete vybrat možnost Zapamatovat heslo, použijte vstup Důvěrné informace.If you don’t want to select Remember my password, use a Sensitive text input.

    Zadání hesla aplikace Citrix

  4. Vyberte aplikaci nebo plochu, kterou chcete zaznamenat.Select the App or the Desktop you want to record.

    Zobrazí seznam aplikací, které můžete vybrat k záznamu

  5. Proveďte kroky v aplikaci Citrix a poté vyberte Hotovo na ovládacím prvku záznamníku.Perform the steps on Citrix, and then select Done on the recorder control.

Důležité

Pokud jste zaznamenali krok přihlášení, návrhář zobrazí tři aplikace rozsahu Citrix.If you recorded the log-on step, the designer displays three Citrix scope applications. To se očekává, protože přihlašovací okno je jiná aplikace než pracovní prostor Citrix.This is expected because the log-on window is a different application from the Citrix workspace.

Tip

V testovacím režimu a v režimu s obsluhou před přehráváním toku uživatelského rozhraní ověřte, že je pracovní prostor Citrix uzavřen.In test and attended mode, confirm that your Citrix workspace is closed before you playback your UI flow. Na oznamovacím panelu klikněte pravým tlačítkem myši na ikonu Citrix a volbou Ukončit zavřete pracovní prostor.From the notification bar, right-click on the Citrix icon and the select Exit to close the workspace.

Řešení problémůTroubleshooting

Pokud máte problémy s použitím důvěrných informací v přihlašovacím okně:If you have problems using sensitive text in the login window:

  1. Otevřete nabídku vstupu ze záznamníku.Open the input menu from the recorder.

  2. Vyberte pole s heslem.Select the password field.

  3. Vyberte důvěrné informace (v tomto příkladu „heslo“) v nabídce vstupu.Select your sensitive text (in this example “password”) in the input menu.

    Použití důvěrných informací jako heslo

Použití technologie OCR pro extrahování textu z obrázkůUse OCR to extract text from images

  1. Při nahrávání vašich kroků přejděte na místo textu, který chcete zachytit.While recording your steps, navigate to the location of the text that you wish to capture.

  2. Vyberte Výstupy > Extrahovat text z obrázku z ovládacího prvku záznamníku.Select Outputs > Extract Text from Image from the recorder control.

  3. Následujte výzvy a vyberte oblast ukotvení (část obrazovky, u které se neočekává, že se změní, například popisek vedle pole).Follow the prompts to select an anchor area (a section of the screen that is not expected to change, such as the label next to a field).

    Oblast ukotvení

  4. Vyberte cílovou oblast (oblast, ze které bude text extrahován pomocí OCR).Select the target area (the area from which text will be extracted using OCR).

    Cílová oblast

  5. Zadejte název výstupu.Enter a name for the output.

  6. Na ovládacím prvku záznamníku vyberte Hotovo.Select Done on the recorder control.

  7. Vyberte Uložit a tok uživatelského rozhraní otestujte.Select Save, and then test your UI flow.

Známé problémy se nahrávkami aplikace Vzdálená plochaKnown issues for Remote Desktop recordings

  1. Před zaznamenáním dalších kroků ve stejném toku uživatelského rozhraní se ujistěte, že jsou vyplněny a uloženy všechny požadované vstupy (název počítače, uživatelské jméno a heslo).Ensure that all required inputs (computer name, username, and password) are filled in and saved before recording further steps in the same UI flow.

  2. Chcete-li se připojit ke stávající relaci vzdálené plochy, musí být relace spuštěna dříve ve stejném toku uživatelského rozhraní.To attach to an existing remote desktop session, the session must have been launched earlier in the same UI flow.

  3. Doporučený způsob spuštění připojení ke vzdálené ploše (RDC) při nahrávání je z aplikace Připojení ke vzdálené ploše (mstc.exe) z nabídky Start.The recommended way to launch the Remote Desktop Connection (RDC) when recording is from the Remote Desktop Connection app (mstc.exe) from the Start menu. Pokud jsou kromě akce Spustit vzdálenou plochu nahrány také akce akce zabezpečení Windows, měly by být odebrány z návrháře tak, aby přehrávání nebylo přerušeno (k tomu může dojít, když je relace vzdálené plochy spuštěna pomocí zástupce).If Windows Security actions are recorded in addition to the Launch Remote Desktop action, they should be removed from the designer so that playback is not interrupted (this can happen when the Remote Desktop session is launched from a shortcut).

  4. Přehrávání může selhat, pokud byl tok uživatelského rozhraní zaznamenán na obrazovce s nastavením měřítka obrazovky (Nastavení Windows > Obrazovka > Změna velikosti obrazovky) nastaveným na jinou hodnotu než 100 %.Playback can fail if the UI flow was recorded on a screen with screen scaling (Windows Settings > Display > Screen Scaling) set to a value other than 100%. Pro vyřešení se ujistěte, že velikost obrazovky je před nahráváním nastavena na 100 %.As a workaround, ensure that screen scaling is set to 100% prior to recording.

Zpracování chybových podmínekHandle error conditions

Během přehrávání mohou nastat neočekávané podmínky.Unexpected conditions can arise during playback. Tyto podmínky mohou způsobit selhání toků uživatelského rozhraní.These conditions can cause your UI flows to fail. Když k neočekávaným podmínkám dojde, můžete použít pokročilé funkce zpracování chyb a vytvořit alternativní kroky.You can use advanced error handling capabilities to create alternate steps when unexpected conditions arise.

Postup je následující.Here are the steps to do so.

  1. Přihlaste se k Power Automate přes svůj pracovní nebo školní účet.Sign into Power Automate with your school or work account.

  2. Vyberte Moje toky > Toky uživatelského rozhraní.Select My flows > UI flows.

  3. Vyberte Více příkazů (tři svislé tečky u toku uživatelského rozhraní, který chcete upravit).Select More commands (the three vertical dots for the UI flow you want to edit).

  4. Vyberte položku Upravit.Select Edit.

  5. Vyberte šipku dolů, která se nachází bezprostředně před krokem toku uživatelského rozhraní, ke kterému chcete přidat zpracování chyb, a pak vyberte + (Vložit nový krok).Select the down arrow that's located immediately before the UI flow step to which you want to add error handling, and then select + (Insert new step).

    Na následujícím obrázku vkládáme nový krok před krok PostElementText 1.In the following image, we're inserting the new step before the PostElementText 1 step. To znamená, že pokud krok PostElementText 1 selže, pak se spustí alternativní kroky, které definujete v dalším kroku.This means that if PostElementText 1 fails, the alternate steps that you define next, run.

    Obrázek vložení nového kroku

  6. Vyberte Přidat paralelní větev.Select Add a parallel branch.

    Obrázek znázorňující přidání paralelní větve a další možnosti

  7. Vyberte akci, kterou chcete provést v paralelní větvi v případě, že dojde k chybě při spuštění toku uživatelského prostředí.Select the action that you want to perform in the parallel branch if there's a failure when the UI flow runs.

    Můžete vybrat Nahrát aplikaci a vytvořit nový záznam pro paralelní větev nebo vybrat Ukončit v předdefinovaných akcích a v případě, že došlo k chybě, tak ukončit tok uživatelského rozhraní bez výpadku.You can select Record app to do a new recording for the parallel branch or select Terminate from the Built-in actions to exit the UI flow exit gracefully if there's a failure.

    Obrázek znázorňující možnosti paralelní větve

    Poznámka

    Ve výchozím nastavení se akce, kterou přidáte do paralelní větve, spustí jenom v případě, že se předchozí krok nezdařil.By default, the action that you add in the parallel branch runs only if the previous step fails. V paralelní větvi můžete vybrat ... > Nakonfigurovat vlastnost runAfter a změnit výchozí chování.You can select ... on the parallel branch > Configure run after to change the default behavior.

    Obrázek znázorňující možnosti, včetně konfigurace vlastnosti runAfter

  8. Na této obrazovce můžete vybrat podmínku, při které se má paralelní větev spustit.From this screen, you can select the condition on which you want the parallel branch to execute. Můžete vybrat jednu ze čtyř dostupných možností.You can select from one of the four options available.

    Obrázek znázorňující možnosti runAfter

    Poznámka: Tok uživatelského rozhraní nebudete moct uložit, pokud má hlavní i paralelní větev nastavenou na spuštění při stejné podmínce.Note: You will not be able to save a UI flow that has both the main branch and parallel branch set to execute on the same condition.

Povolení přehrávání podle souřadnicEnable coordinate-based playback

Přehrávání podle souřadnic používá jako nouzové řešení relativní posun obrazovkových souřadnic. Ten pomáhá tokům uživatelského rozhraní najít cílové objekty, které výchozí architektura automatizace uživatelského rozhraní Windows nemůže během přehrávání najít.Coordinate-based playback uses relative screen coordinate offset as a fallback that helps UI flows find target objects that the default Windows UI automation framework is unable to find during playback.

Tady jsou některé z důvodů, proč výchozí architektura automatizace uživatelského rozhraní Windows nemůže během přehrávání najít cílové objekty:Here are some of the reasons why the default Windows UI automation framework might not find target objects during playback:

  • Starší aplikace, které automatizujete, nemusejí používat programovací technologie podporující architekturu automatizace uživatelského rozhraní Windows.The legacy application that you're automating might not use programming technologies that support the Windows UI automation framework.
  • Aplikace nebo její ovládací prvky nemusí mít jedinečnou cestu XPath, název nebo identifikátory automatizace uživatelského rozhraní.The application or its controls may not have a unique UI automation XPath, name, or IDs.
  • Aplikace má dynamické ovládací prvky, jejichž názvy nebo identifikátory se mohly změnit.The application has dynamic controls whose names or IDs could change.
  • Aplikace má ovládací prvky, které nemají názvy, identifikátory, jedinečné identifikátory atd.The application has controls that do not have names, IDs, unique identifiers, etc.

Tip

Aby se zlepšila přesnost přehrávání podle souřadnic, používejte stejné měřítko a rozlišení a také maximalizujte cílovou aplikaci během nahrávání.Use the same scale and resolution and also maximize the target application during recording to improve the accuracy of coordinate-based playback.

Po nahrání skriptu toku uživatelského rozhraní postupujte takto:Follow these steps after you've recorded a UI flow script:

  1. Rozbalte krok, který spouští nebo připojuje aplikaci.Expand the step that launches or attaches the application.

    To je obvykle první krok nahrávacího skriptu.This is usually the first step of the recording script.

  2. Vyberte Zobrazit rozšířené možnosti.Select Show advanced options.

  3. Najděte vlastnosti Použít přehrávání podle souřadnic.Find Use coordinate playback properties.

  4. V seznamu vyberte Ano a povolte tak přehrávání podle souřadnic.Select Yes from the list to enable coordinate-based playback.

Tip

Možnost Použít přehrávání podle souřadnic můžete povolit nebo zakázat pro jednotlivé aplikace a použít tak toto nastavení pro všechny kroky prováděné u příslušné aplikace.You can enable or disable Use coordinate playback for each application to apply the setting to all steps performed on that application.

Upozornění

Při přehrávání podle souřadnic může automatizace vybrat ovládací prvky, které nejsou součástí cílové aplikace, a to z různých důvodů, například když se uživatelské rozhraní cílových aplikací výrazně mění.With coordinate-based playback, the automation may select controls that are not part of the target application due to a variety of reasons, for example, when the UI of the target applications changes dramatically.

Další krokyNext steps