Referenční informace k kódu chyby toku cloudu

Tento článek slouží k řešení nejběžnějších chyb v Power Automate tocích cloudu. Každá položka vysvětluje, co chyba znamená, proč k ní dochází a jak ji opravit.

Poznámka:

Tento odkaz platí pro všechny licenční úrovně toku cloudu Power Automate. Informace o chybách specifických pro toky plochy najdete v tématu Řešení chyb toku plochy.

Chyby v době návrhu

K těmto chybám dochází při ukládání, ověřování nebo publikování toku.

NeplatnáŠablona

Význam: Definice toku obsahuje chybu syntaxe ve výrazu nebo konfiguraci akce.

Běžné příčiny:

  • Nezávorky nebo uvozovky ve výrazu
  • Odkazování na výstup akce, který neexistuje (překlep v názvu akce)
  • Použití funkce s nesprávným počtem argumentů (například createArray() bez argumentů)
  • Neshoda typů ve výrazu konstanty (například int('abc') ) div(100, 0)– modul je ověří za šetřinou dobu.
  • Vkládání výrazů z dokumentace obsahující neviditelné znaky Unicode

Postup opravy:

  1. Otevření akce zvýrazněné červeně v návrháři
  2. Zkontrolujte výraz na řádku vzorců. Hledejte chybějící () znaky nebo ' znaky.
  3. Ověřte, že názvy akcí ve výrazech přesně odpovídají (rozlišují se malá a velká písmena): outputs('Get_item') ne outputs('Get Item').
  4. Pokud výraz vypadá správně, odstraňte ho a znovu ho zadejte ručně, abyste odebrali skryté znaky.

Tip

Názvy akcí ve výrazech používají místo mezer podtržítka. Pokud má vaše akce název "Získat položku", je odkaz na výraz .outputs('Get_item')

Související informace: ExpressionEvaluationFailed, FlowCheckerError

FlowCheckerError

Význam: Kontrola toku našla jeden nebo více problémů s ověřováním, které brání uložení.

Běžné příčiny:

  • Požadované pole je prázdné v jedné nebo více akcích.
  • Pro akci konektoru není vybrané připojení.
  • Výraz odkazuje na hodnotu dynamického obsahu z paralelní větve (není zaručeno, že existuje).
  • Vstupy aktivačních událostí jsou neúplné

Postup opravy:

  1. Výběrem banneru chyby v horní části návrháře zobrazte úplný seznam problémů.
  2. Výběrem každé chyby přejdete na ovlivněnou akci.
  3. Vyplňte požadovaná pole, opravte přerušené výrazy a vyberte připojení.
  4. Uložte to znovu. Kontrola se spustí automaticky při uložení.

Související informace: InvalidTemplate, MissingRequiredProperty

DuplicateActionName

Význam: Dvě nebo více akcí v toku mají stejný interní název.

Běžné příčiny:

  • Kopírování akce bez přejmenování
  • Import definice toku, která byla ručně upravena s duplicitními klíči
  • Přejmenování akce na název, který už používá jiná akce ve stejném oboru

Postup opravy:

  1. V toku vyhledejte akce s identickými názvy (zkontrolujte také uvnitř Apply to Each a Scope kontejnerech).
  2. Přejmenujte jeden z duplicit. V akci vyberte nabídku ... a pak vyberte Přejmenovat.
  3. Aktualizujte všechny výrazy, které odkazují na přejmenovanou akci: outputs('Old_Name') na outputs('New_Name').

Související informace: InvalidTemplate

MissingRequiredProperty

Význam: Požadované vstupní pole akce nebo triggeru je prázdné.

Běžné příčiny:

  • Přidání akce konektoru, ale nedokončování konfigurace
  • Token dynamického obsahu, který se přeložil na prázdný, se použil v požadovaném poli.
  • Tok importovaný z řešení, ve kterém nejsou nastavené proměnné prostředí

Postup opravy:

  1. Otevřete akci označenou příznakem chyby.
  2. Vyhledejte pole označená červenou hvězdičkou (*), která jsou prázdná.
  3. Vyplňte požadovanou hodnotu, a to buď statickým textem, nebo tokenem dynamického obsahu.
  4. U toků řešení zkontrolujte, že všechny proměnné prostředí mají v cílovém prostředí hodnoty.

Související informace: FlowCheckerError

Chyby výrazů za běhu

K těmto chybám dochází, když se tok spustí a výraz se nedá vyhodnotit.

ExpressionEvaluationFailed

Význam:

Výraz se nepodařilo vyhodnotit za běhu, protože skutečná data neodpovídají očekávanému výrazu. K této chybě dochází pouze v případě, že výraz používá dynamické hodnoty (proměnné, tělo triggeru, výstupy akcí), které nelze zkontrolovat v době úspory.

Poznámka:

Pokud výraz používá pouze konstantní hodnoty (například int('abc') nebo div(100, 0)), modul toku chybu zachytí při úspoře místo toho jako InvalidTemplate .

Běžné příčiny:

  • Volání int() proměnné, která obsahuje nečíselný řetězec za běhu
  • Přístup k vlastnosti objektu null (outputs('Get_item')?['body/title'] když Get_item nevrátil nic)
  • Neshoda formatDateTime() formátu data nebo parseDateTime() v případech, kdy formát pochází z proměnné
  • Dělení nulou, pokud je dělitel dynamickou hodnotou, která se stane 0

Postup opravy:

  1. Otevřete neúspěšné spuštění a výběrem neúspěšné akce zobrazte výraz a vstupní hodnoty.
  2. Zabalte rizikové výrazy pomocí kontrol null: if(empty(triggerBody()?['value']), 'default', triggerBody()?['value']).
  3. Slouží coalesce() k poskytnutí záložních hodnot: coalesce(outputs('Get_item')?['body/title'], 'Untitled').
  4. Před převodem ověřte datové typy: if(isInt(variables('input')), int(variables('input')), 0).

Tip

Seznamte se s knihovnou vzorů výrazů připravených k použití s bezpečným zpracováním null v kuchařce výrazů pro cloudové toky.

Související informace: InvalidTemplate, ContentConversionFailed

ContentConversionFailed

Význam: Tok nemohl převést data z jednoho typu na jiný mezi akcemi.

Běžné příčiny:

  • Předání řetězce, ve kterém se očekává celé číslo nebo logická hodnota
  • Odeslání pole do akce, která očekává jeden objekt
  • Řetězec data v neočekávaném formátu (například DD/MM/YYYY podle MM/DD/YYYY očekávání)
  • Binární obsah (soubor) předaný textovému vstupu

Postup opravy:

  1. Zkontrolujte vstupy neúspěšné akce v historii spuštění. Porovnejte skutečný typ hodnoty s tím, co akce očekává.
  2. Použití explicitních převodních funkcí: int(), float(), string()bool(), , . json()
  3. U kalendářních dat použijte parseDateTime() explicitní národní prostředí nebo formatDateTime() normalizaci před předáním.
  4. Pro pole použijte first() k extrahování jedné položky, pokud podřízená akce očekává jednu hodnotu.

Související informace: ExpressionEvaluationFailed

Chyby připojení a ověřování

K těmto chybám dochází, když se tok nemůže ověřit v připojené službě.

InvalidConnection

Význam: Odkaz na připojení v toku odkazuje na přerušené, odstraněné nebo prošlé připojení.

Běžné příčiny:

  • Uživatel, který připojení vytvořil, změnil heslo nebo resetoval vícefaktorové ověřování.
  • Připojení bylo odstraněno ze stránky Připojení.
  • Správce odebral připojení přes Centrum pro správu Power Platform.
  • Tok se naimportoval do prostředí, ve kterém připojení neexistuje.

Postup opravy:

  1. Otevřete tok v režimu úprav. Akce s poškozenými připojeními zobrazují ikonu upozornění.
  2. Vyberte akci a vyberte Změnit připojení nebo Přidat nové připojení.
  3. Přihlaste se pomocí příslušných přihlašovacích údajů a vytvořte nové připojení.
  4. Uložte a otestujte tok.

Important

U produkčních toků zvažte použití připojení instančního objektu místo osobních uživatelských připojení. Platnost připojení instančního objektu nevyprší, když uživatel změní heslo nebo opustí organizaci.

Související informace: ConnectionNotConfigured, ConnectionAuthorizationFailed

ConnectionNotConfigured

Význam: Akce vyžaduje připojení, ale nebyla vybrána žádná.

Běžné příčiny:

  • Tok se naimportoval z řešení a odkazy na připojení se nenamapovaly
  • Byla přidána nová akce, ale krok připojení se přeskočil.
  • Odkaz na připojení odkazuje na proměnnou prostředí bez hodnoty.

Postup opravy:

  1. Otevřete tok v režimu úprav a vyhledejte akci s upozorněním na připojení.
  2. V rozevíracím seznamu vyberte existující připojení nebo vytvořte nové.
  3. V případě toků řešení přejděte na>Odkazy na výchozí připojení>.
  4. Nastavte připojení pro každý odkaz.

Související informace: InvalidConnection

Neautorizováno (401)

Význam: Rozhraní API odmítlo požadavek, protože ověřovací token je neplatný nebo vypršela jeho platnost.

Běžné příčiny:

  • Platnost tokenu OAuth vypršela a připojení se nepodařilo automaticky aktualizovat
  • Účet uživatele byl zakázán nebo změněno heslo.
  • Platnost tajného klíče instančního objektu nebo certifikátu vypršela
  • Zásady podmíněného přístupu zablokovaly přihlášení (geografická oblast, dodržování předpisů zařízením)

Postup opravy:

  1. Přejděte na Power Automate>Připojení a vyhledejte připojení používané neúspěšnou akcí.
  2. Pokud se u připojení zobrazí upozornění, vyberte Opravit připojení a znovu se ověřte.
  3. U připojení instančního objektu obměňte tajný klíč v Microsoft Entra ID a aktualizujte připojení.
  4. Zkontrolujte Microsoft Entra ID protokoly přihlášení pro bloky podmíněného přístupu: Azure portal>Microsoft Entra ID>Podpory vyfiltrujte název aplikace.

Související informace: Zakázáno (403) a ConnectionAuthorizationFailed

Zakázáno (403)

Význam: Ověřený uživatel nebo aplikace nemá oprávnění k provedení požadované operace.

Běžné příčiny:

  • Zásada ochrany před únikem informací (Ochrana před únikem informací) blokuje akci konektoru nebo konektoru v tomto prostředí.
  • Uživatel nemá oprávnění k cílovému prostředku (například žádný přístup k zápisu do SharePoint list)
  • Správce omezil konektor prostřednictvím nastavení na úrovni tenanta.
  • Konektor vyžaduje licenci Premium a uživatel je v počátečním plánu.

Postup opravy:

  1. Zkontrolujte zásady ochrany před únikem informací:Zásady data> pro správu Power Platform. Vyhledejte zásady, které blokují konektor ve skupině vašeho prostředí.
  2. Ověřte, že má uživatel připojení správná oprávnění k cílové službě (SharePoint oprávnění lokality, role zabezpečení Dataverse a podobné).
  3. Pokud se jedná o problém s konektorem Premium, ověřte, že vlastník toku nebo volající má licenci Power Automate Premium.
  4. Pokud je potřeba upravit zásadu ochrany před únikem informací, obraťte se na správce.

Související informace: Neautorizováno (401), DirectApiAuthorizationRequired

ConnectionAuthorizationFailed

Význam: Připojení existuje, ale jeho uložené přihlašovací údaje už nejsou platné.

Běžné příčiny:

  • Změna hesla uživatele nebo resetování metody MFA
  • Platnost obnovovacího tokenu OAuth vypršela (běžně se připojení nepoužívané po dobu 90 dnů)
  • Správce zrušil souhlas s aplikací v Microsoft Entra ID
  • Sdílené připojení nesdíleli vlastník

Postup opravy:

  1. Otevřete Power Automate>Pojení.
  2. Vyhledejte ovlivněné připojení.
  3. Vyberte připojení a pak vyberte Opravit připojení , aby se znovu ověřilo.
  4. Pokud používáte sdílené připojení, požádejte vlastníka připojení, aby ho znovu sdílel.
  5. U účtů služeb nastavte připomenutí kalendáře, aby se přihlašovací údaje před vypršením platnosti obměna obměna přihlašovacích údajů.

Tip

Podrobný kurz problémů s připojením podle konektoru (SharePoint, Outlook, SQL Server, Dataverse, HTTP) najdete v Nabídky připojení v cloudových tocích.

Související informace: InvalidConnection, Neautorizováno (401)

Chyby konektoru a rozhraní API

Tyto chyby pocházejí z podřízené služby, která tok volá.

Akce se nezdařila.

Význam: Akce vrátila stav selhání. Toto je obecná obálka. Skutečné podrobnosti o chybě jsou v textu výstupu akce.

Běžné příčiny:

  • Podřízené rozhraní API vrátilo chybu 4xx nebo 5xx.
  • Podřízený tok (volaný prostřednictvím spuštění podřízeného toku) selhal.
  • Vlastní konektor vrátil neočekávaný formát odpovědi.
  • Nastavení konfigurace a spuštění akce způsobilo, že se spustila po předchozím selhání.

Postup opravy:

  1. Otevřete neúspěšné spuštění a vyberte neúspěšnou akci.
  2. Rozbalte výstupy a zobrazte skutečnou chybovou zprávu a stavový kód z rozhraní API.
  3. Opravte základní problém na základě konkrétní chyby rozhraní API (zkontrolujte položky 400, 401, 403 a 404 v tomto odkazu).
  4. Pokud by se akce měla spustit i v případě selhání předchozích akcí, zkontrolujte její konfiguraci spuštění po nastavení.

Související informace: BadRequest (400), Nenalezeno (404)

BadRequest (400)

Význam: Rozhraní API konektoru odmítlo požadavek, protože vstupní data jsou poškozená nebo neplatná.

Běžné příčiny:

  • Odeslání pole s nesprávným datovým typem (řetězec místo čísla nebo naopak)
  • Požadovaná pole chybí v textu požadavku.
  • Neplatné znaky v názvech souborů nebo názvech položek seznamu
  • Překročení limitu délky pole (například SharePoint jednořádkový text = 255 znaků)

Postup opravy:

  1. Otevřete neúspěšnou akci v historii spuštění a v části Vstupy zobrazte přesně to, co se odeslalo.
  2. Porovnejte vstupy s očekávaným schématem rozhraní API (zkontrolujte dokumentaci ke konektoru).
  3. Sanitize user input with replace() to strip invalid characters before passing to the action.
  4. Použijte substring() nebo take() zkracujte dlouhé hodnoty na maximální délku pole.

Související informace: ActionFailed, ContentConversionFailed

Nenalezeno (404)

Význam: Prostředek, ke které se akce pokouší získat přístup, neexistuje.

Běžné příčiny:

  • Přejmenování nebo odstranění SharePoint list, knihovny nebo webu
  • Byla odebrána složka Outlook nebo kanál Teams.
  • Tok odkazuje na pevně zakódované ID prostředku, který již neexistuje.
  • Tabulku nebo řádek Dataverse odstranil jiný proces.

Postup opravy:

  1. Zkontrolujte, že prostředek stále existuje v cílové službě.
  2. Pokud byla přejmenována, aktualizujte akci tak, aby používala nový název nebo ID.
  3. Pokud je to možné, nahraďte pevně zakódovaná ID dynamickým vyhledáváním (například "Získat položky" filtrem místo "Získat položku" statickým ID).
  4. Přidání zpracování chyb: Nakonfigurujte další akci, která se spustí po>selhání , a bez odkladu zpracujte chybu 404.

Související informace: ActionFailed

Chyby triggeru

Tyto chyby se týkají triggerů toku, které se neaktivují nebo selhávají.

TriggerConditionNotMet

Význam: Trigger vyhodnotil jeho podmínku a zjistil, že událost by neměla spustit spuštění toku.

Běžné příčiny:

  • Výraz podmínky triggeru se vždy vyhodnotí jako false (chyba logiky).
  • Podmínka triggeru odkazuje na pole, které v datové části triggeru neexistuje.
  • Došlo k události, ale data neodpovídají filtru (například Při vytvoření položky s podmínkou Stav, ale stav byl prázdný).

Postup opravy:

  1. Přejděte do nastavení triggeru a zkontrolujte výraz podmínky triggeru.
  2. Otestujte podmínku na známé datové části události. Pomocí náhledu kódu na triggeru zobrazte nezpracované schéma.
  3. Dočasně odeberte podmínku, aktivujte tok ručně a zkontrolujte výstup triggeru a ověřte názvy a hodnoty polí.
  4. Opravte výraz a znovu povolte podmínku.

Související informace: ExpressionEvaluationFailed

Chyby vypršení časového limitu a omezování

K těmto chybám dochází, když tok nebo akce překročí limity času nebo rychlosti.

ActionTimedOut

Význam: Jedna akce překročila nakonfigurovaný časový limit a byla zrušena.

Běžné příčiny:

  • Akce HTTP volání pomalého externího rozhraní API s výchozím vypršením časového limitu 100 sekund
  • Čekání na schválení s vypršením platnosti, které uplynulo
  • Nahrávání nebo stahování velkých souborů přes pomalé připojení
  • Dotaz Dataverse vracející příliš mnoho řádků bez stránkování

Postup opravy:

  1. Otevřete nastavení akce a zvyšte hodnotu časového limitu (doba trvání ISO 8601, PT5M například 5 minut).
  2. V případě akcí HTTP zkontrolujte, jestli má externí rozhraní API schéma dlouhotrvající operace (dotazování s opakováním).
  3. Pro Službu Dataverse přidejte $filter sadu výsledků a $top snižte ji.
  4. Pro schválení nastavte přiměřené vypršení platnosti a přidejte větev časového limitu, která bude zpracovávat odpovědi.

Související informace: OperationTimedOut

OperationTimedOut

Význam: Dlouhotrvající operace (čekání webhooku, schválení, dotazování HTTP) překročila maximální dobu čekání.

Běžné příčiny:

  • Akce webhooku HTTP čekající na zpětné volání, které nikdy nepřišlo
  • Akce schválení bez vypršení platnosti a dosažení limitu 30denního spuštění toku
  • Akce Zpoždění do uplynutí 30denního limitu doby trvání běhu je nastavená na datum
  • Externí služba se neposlala a nikdy neodeslala očekávanou odpověď.

Postup opravy:

  1. Vždy nastavte explicitní časové limity pro akce webhooku a schválení.
  2. V případě akcí webhooku HTTP implementujte větev časového limitu se spuštěním konfigurace po>vypršení časového limitu.
  3. Dlouhé čekání rozdělte do kratších segmentů pomocí smyčky s denními kontrolami.
  4. V případě limitu 30denního běhu přepracujte dlouhotrvající procesy tak, aby používaly vzor "relay": Ukončete aktuální spuštění a spusťte nový se stavem předaným přes Dataverse nebo soubor.

Important

Toky cloudu mají maximální dobu běhu 30 dnů. U procesů, které trvá déle, je rozdělte na několik spuštění toku se sdíleným stavem.

Související informace: ActionTimedOut

WorkflowRunActionRepetitionQuotaExceededed

Význam: Smyčka Apply to Each překročila maximální počet iterací (výchozí hodnota: 100 000 pro premium, 5 000 pro profily výkonu).

Běžné příčiny:

  • Zpracování velké tabulky SharePoint list nebo Dataverse bez prvního filtrování
  • Vnořené Apply to Each smyčky násobí počty iterací (100 x 100 = 10 000)
  • Get items Akce vracející všechny řádky místo filtrované podmnožina

Postup opravy:

  1. Přidejte filtry do akce zdroje dat, abyste snížili počet položek před smyčkou.
  2. Místo filtrování uvnitř smyčky používejte akce OData $filter a $topNačíst položky .
  3. U velkých datových sad dávková práce napříč několika toky pomocí tokenů stránkování nebo rozsahů kalendářních dat.
  4. Zvažte použití Select nebo Filter array akce místo Apply to Each toho, když potřebujete transformovat nebo filtrovat pouze data.

Související informace: FlowRunQuotaExceeded

FlowRunQuotaExceed

Význam: Tok nebo tenant překročil denní limit provádění akcí.

Běžné příčiny:

  • Počáteční/bezplatná licence: 6 000 akcí za den na uživatele
  • Licence Premium: 40 000 akcí za den na uživatele
  • Procesní licence: 250 000 akcí za den na tok
  • Tok náročný na smyčku využívající tisíce akcí na spuštění

Postup opravy:

  1. Zkontrolujte aktuální využití v centru pro správu Power Platform>Analytics>Power Automate.
  2. Optimalizujte toky tak, aby používaly méně akcí: Nahradit u každého pomocí příkazu Vybrat/Filtrovat, dávkové operace, snížit frekvenci dotazování.
  3. Pokud úloha potřebuje více kapacity, upgradujte úroveň licence.
  4. Rozprostřete úlohy mezi více toků nebo naplánujte spouštění velkých objemů v době mimo špičku.

Poznámka:

Přečtěte si další informace o denních limitech akcí podle úrovně licence v Power Automate omezeních a konfiguraci.

Související informace: WorkflowRunActionRepetitionQuotaExceeded, DirectApiAuthorizationRequired

Chyby licencování

DirectApiAuthorizationRequired

Význam: Tok používá prémiový konektor, ale volající nemá licenci Premium.

Běžné příčiny:

  • Tok s prémiovými konektory (HTTP, SQL Server, Dataverse, vlastní konektory) je spuštěný uživatelem v počáteční Microsoft 365 licenci.
  • Vlastník toku má premium, ale aktivační uživatel ne (licence volajícího záleží, ne vlastníka).
  • Vlastník plánovaného toku ztratil licenci Premium
  • Kontextový tok se oddělil od své aplikace Power App, aby byl mimo kontext.

Postup opravy:

  1. Určete, který konektor vyžaduje premium. Chybová zpráva ji obvykle pojmenuje.
  2. Přiřaďte uživateli, který tok aktivuje nebo spustí, licenci Power Automate Premium.
  3. U plánovaných nebo automatizovaných toků se ujistěte, že vlastník toku má licenci Premium.
  4. Zvažte, jestli je licence procesu (podle toku) nákladově efektivnější pro vysoce objemové sdílené toky. S tokovou skupinou můžete také sdílet jednu licenci procesu až mezi 25 toky.

Související informace: Zakázáno (403), FlowRunQuotaExceed

Stručná referenční tabulka

Chyba Category Nejpravděpodobnější oprava
NeplatnáŠablona Čas návrhu Oprava syntaxe výrazů
ExpressionEvaluationFailed Za běhu Přidání kontrol null, ověření typů
Akce se nezdařila. Za běhu Kontrola výstupů akcí pro chybu rozhraní API
FlowCheckerError Čas návrhu Vyplnění požadovaných polí, oprava připojení
InvalidConnection Připojení Opětovné ověření připojení
ConnectionNotConfigured Připojení Výběr nebo vytvoření připojení
Neautorizováno (401) Auth Oprava připojení, obměna přihlašovacích údajů
Zakázáno (403) Auth Kontrola zásad ochrany před únikem informací, oprávnění
BadRequest (400) API Ověření formátu vstupních dat
Nenalezeno (404) API Ověření existence prostředku, aktualizace odkazů
TriggerConditionNotMet Aktivační událost Kontrola výrazu podmínky triggeru
ActionTimedOut Přerušení zápasu Zvýšení časového limitu v nastavení akce
DuplicateActionName Čas návrhu Přejmenování jedné z duplicitních akcí
MissingRequiredProperty Čas návrhu Vyplňování povinných polí
ContentConversionFailed Za běhu Použití explicitních převodů typů
WorkflowRunActionRepetitionQuotaExceededed Řízení výkonu/omezování rychlosti Filtrování dat před smyčkou
DirectApiAuthorizationRequired Licence Přiřazení prémiové licence volajícímu
FlowRunQuotaExceed Řízení výkonu/omezování rychlosti Optimalizace počtu akcí, upgrade licence
ConnectionAuthorizationFailed Připojení Oprava připojení, opětovné ověření
OperationTimedOut Přerušení zápasu Nastavení explicitních časových limitů, použití modelu předávání

Poznámka: Autor vytvořil tento článek s pomocí umělé inteligence. Další informace