Připojení k serveru FTP z pracovních postupů v Azure Logic Apps

  • Článek

Platí pro: Azure Logic Apps (Consumption + Standard)

Tento článek ukazuje, jak získat přístup k serveru FTP (File Transfer Protocol) z pracovního postupu v Azure Logic Apps pomocí konektoru FTP. Pak můžete vytvořit automatizované pracovní postupy, které se spouštějí při aktivaci událostmi na serveru FTP nebo v jiných systémech a spouštět akce pro správu souborů na serveru FTP.

Váš pracovní postup může například začínat triggerem FTP, který monitoruje události na serveru FTP a reaguje na ně. Trigger zpřístupní výstupy následným akcím v pracovním postupu. Váš pracovní postup může spouštět akce FTP, které vytvářejí, odesílají, přijímají a spravují soubory prostřednictvím účtu serveru FTP pomocí následujících konkrétních úloh:

  • Sledujte, kdy se přidají nebo změní soubory.
  • Vytvářet, kopírovat, odstraňovat, vypisovat a aktualizovat soubory
  • Získejte metadata a obsah souboru.
  • Správa složek

Pokud s Azure Logic Apps začínáte, projděte si následující úvodní dokumentaci:

Připojení otechnické referenční informace

Konektor FTP má různé verze založené na typu aplikace logiky a hostitelském prostředí.

Typ aplikace logiky (plán) Prostředí verze Připojení oru
Využití Azure Logic Apps s více tenanty Spravovaný konektor (třída Standard) Další informace najdete v následující dokumentaci:

- Referenční informace ke spravovanému konektoru FTP
- Spravované konektory v Azure Logic Apps
Využití Prostředí integrační služby (ISE) Spravovaný konektor (třída Standard) a verze ISE, která má různá omezení zpráv než standardní třída. Další informace najdete v následující dokumentaci:

- Referenční informace ke spravovanému konektoru FTP
- Omezení zpráv ISE
- Spravované konektory v Azure Logic Apps
Standard Azure Logic Apps a App Service Environment v3 s jedním tenantem (pouze plány Windows) Spravovaný konektor (hostovaný v Azure) a integrovaný konektor, což je poskytovatel služeb. Integrovaný konektor má přímý přístup k virtuálním sítím Azure pomocí připojovací řetězec. Další informace najdete v následující dokumentaci:

- Referenční informace ke spravovanému konektoru FTP
- Část Operace integrovaného konektoru FTP dále v tomto článku
- Spravované konektory v Azure Logic Apps
- Integrované konektory v Azure Logic Apps

Omezení

  • Kapacita a propustnost

    • Integrovaný konektor pro standardní pracovní postupy:

      Ve výchozím nastavení můžou akce FTP číst nebo zapisovat soubory, které jsou 200 MB nebo menší. Integrovaný konektor FTP v současné době nepodporuje vytváření bloků dat.

    • Spravovaný konektor nebo konektor hostovaný v Azure pro pracovní postupy Consumption a Standard

      Ve výchozím nastavení můžou akce FTP číst nebo zapisovat soubory, které jsou 50 MB nebo menší. Pokud chcete zpracovat soubory větší než 50 MB, akce FTP podporují vytváření bloků zpráv. Akce obsahu souboru Get implicitně používá bloky dat.

  • Triggery pro konektor spravovaný protokolEM FTP nebo konektor hostovaný v Azure můžou mít po zachování časového razítka poslední změny chybějící, neúplné nebo zpožděné výsledky. Na druhou stranu trigger integrovaného konektoru FTP v pracovních postupech standardní aplikace logiky toto omezení nemá. Další informace najdete v části Omezení konektoru FTP.

  • Spravovaný konektor FTP nebo konektor hostovaný v Azure může vytvořit omezený počet připojení k serveru FTP na základě kapacity připojení v oblasti Azure, ve které existuje prostředek aplikace logiky. Pokud tento limit představuje problém v pracovním postupu aplikace logiky Consumption, zvažte vytvoření pracovního postupu standardní aplikace logiky a místo toho použijte integrovaný konektor FTP.

Předpoklady

  • Účet a předplatné Azure. Pokud nemáte předplatné Azure, zaregistrujte si bezplatný účet Azure.

  • Pracovní postup aplikace logiky, ve kterém chcete získat přístup ke svému účtu FTP. Pokud chcete spustit pracovní postup pomocí triggeru FTP, musíte začít s prázdným pracovním postupem. Pokud chcete použít akci FTP, spusťte pracovní postup s jinou aktivační událostí, například triggerem opakování .

  • Další požadavky, které platí pro spravovaný konektor FTP i integrovaný konektor, najdete v referenčních informacích ke spravovaným konektorům FTP – Požadavky.

Známé problémy

Ve výchozím nastavení triggery, které vracejí pole, mají již povolené nastavení Rozdělit na . Když je toto nastavení povolené, trigger automaticky rozdělí pole interně vytvořením samostatné instance pracovního postupu pro zpracování každé položky pole. Všechny instance pracovního postupu běží paralelně, aby se položky pole zpracovávaly současně.

Pokud je ale povolené nastavení Rozdělit na , aktivují spravované konektory výstupy pro všechny položky pole jako seznamy. Všechny následné akce, které odkazují na tyto výstupy, musí nejprve zpracovat tyto výstupy jako seznamy. Pokud chcete zpracovat každou položku pole jednotlivě, můžete přidat další akce. Pokud chcete například iterovat tyto položky pole, můžete použít smyčku For each . U triggerů, které vracejí pouze metadata nebo vlastnosti, použijte nejprve akci, která získá metadata položky pole, a pak pomocí akce získejte obsah položek.

Tento přístup musíte použít pouze pro triggery spravovaných konektorů, ne pro integrované triggery konektorů, které vracejí výstupy pro jednu položku pole v okamžiku, kdy je povoleno nastavení Rozdělit na .

Předpokládejme například, že máte trigger spravovaného konektoru s názvem Při přidání nebo změně souboru (pouze vlastnosti), který vrací metadata nebo vlastnosti pro nové nebo aktualizované soubory jako pole. Pokud chcete získat metadata pro každý soubor samostatně, můžete použít smyčku For each iterates prostřednictvím pole. V této smyčce použijte následující akce spravovaného konektoru v zadaném pořadí:

  1. Získejte metadata souborů, abyste získali metadata jednotlivých souborů.

  2. Získejte akci obsahu souboru, abyste získali obsah jednotlivých souborů.

Přidání triggeru FTP

Pracovní postup aplikace logiky Consumption může používat pouze spravovaný konektor FTP. Pracovní postup standardní aplikace logiky ale může používat spravovaný konektor FTP a integrovaný konektor FTP. V pracovním postupu standardní aplikace logiky jsou spravované konektory také označené jako konektory Azure .

Spravovaný konektor FTP a integrovaný konektor mají k dispozici pouze jeden trigger:

  • Trigger spravovaného konektoru: Trigger FTP s názvem Při přidání nebo změně souboru (pouze vlastnosti) spustí pracovní postup aplikace logiky Consumption nebo Standard při přidání nebo změně jednoho nebo více souborů ve složce na serveru FTP. Tento trigger získá pouze vlastnosti souboru nebo metadata, nikoli obsah souboru. Pokud ale chcete získat obsah souboru, může váš pracovní postup postupovat podle tohoto triggeru s dalšími akcemi FTP.

    Další informace o tomto triggeru najdete v tématu Při přidání nebo změně souboru (pouze vlastnosti).

  • Aktivační událost integrovaného konektoru: Trigger FTP s názvem Při přidání nebo aktualizaci souboru spustí pracovní postup standardní aplikace logiky při přidání nebo změně jednoho nebo více souborů ve složce na serveru FTP. Tento trigger získá pouze vlastnosti souboru nebo metadata, nikoli obsah souboru. Pokud ale chcete získat obsah, může váš pracovní postup postupovat podle tohoto triggeru s dalšími akcemi FTP. Další informace o tomto triggeru najdete v tématu Při přidání nebo aktualizaci souboru.

Následující kroky používají Web Azure Portal, ale s příslušným rozšířením Azure Logic Apps můžete k vytvoření a úpravě pracovních postupů aplikace logiky použít také následující nástroje:

  1. Na webu Azure Portal otevřete prázdný pracovní postup aplikace logiky v návrháři.

  2. V návrháři pod vyhledávacím polem vyberte Standardní. Do vyhledávacího pole zadejte ftp.

  3. V seznamu triggerů vyberte trigger s názvem Při přidání nebo změně souboru (pouze vlastnosti).

    Screenshot shows Azure portal, Consumption workflow designer, and FTP trigger selected.

  4. Zadejte informace o připojení. Až budete hotovi, vyberte Vytvořit.

    Poznámka:

    Ve výchozím nastavení tento konektor přenáší soubory v textovém formátu. Pokud chcete přenášet soubory v binárním formátu, například kde a kdy se používá kódování, vyberte možnost binárního přenosu.

    Screenshot shows Consumption workflow designer and FTP connection profile.

  5. Po zobrazení informačního pole triggeru vyhledejte složku, kterou chcete monitorovat pro nové nebo upravené soubory.

    1. V poli Složka vyberte ikonu složky a zobrazte adresář složek.

    2. Vyberte šipku pravého úhlu (>). Přejděte do požadované složky a vyberte ji.

    Screenshot shows Consumption workflow designer, FTP trigger, and

    Vybraná složka se zobrazí v poli Složka .

    Screenshot shows Consumption workflow designer, FTP trigger, and

  6. Až budete hotovi, uložte pracovní postup.

Když pracovní postup uložíte, tento krok automaticky publikuje aktualizace do nasazené aplikace logiky, která je aktivní v Azure. Pouze s triggerem váš pracovní postup pouze kontroluje server FTP na základě zadaného plánu. Musíte přidat akci, která reaguje na trigger a provede něco s výstupy triggeru.

Přidání akce FTP

Pracovní postup aplikace logiky Consumption může používat pouze spravovaný konektor FTP. Pracovní postup standardní aplikace logiky ale může používat spravovaný konektor FTP a integrovaný konektor FTP. Každá verze má více akcí. Například spravované i integrované verze konektoru mají své vlastní akce pro získání metadat souborů a získání obsahu souboru.

  • Akce spravovaného konektoru: Tyto akce se spouští v pracovním postupu aplikace logiky Consumption nebo Standard.

  • Předdefinované akce konektoru: Tyto akce se spouštějí jenom v pracovním postupu standardní aplikace logiky.

Následující kroky používají Web Azure Portal, ale s příslušným rozšířením Azure Logic Apps můžete k vytvoření a úpravě pracovních postupů aplikace logiky použít také následující nástroje:

Než budete moct použít akci FTP, váš pracovní postup už musí začínat triggerem, což může být jakýkoliv druh, který zvolíte. Můžete například použít obecnou integrovanou aktivační událost Opakování ke spuštění pracovního postupu podle konkrétního plánu.

  1. Na webu Azure Portal otevřete pracovní postup aplikace logiky v návrháři.

  2. Najděte a vyberte akci FTP, kterou chcete použít.

    Tento příklad pokračuje akcí s názvem Získat metadata souboru, abyste mohli získat metadata pro jednu položku pole.

    1. V návrháři pod triggerem nebo jinými akcemi vyberte Nový krok.

    2. Pod vyhledávacím polem Zvolit operaci vyberte Standardní.

    3. Do vyhledávacího pole zadejte metadata souboru FTP get.

    4. V seznamu akcí vyberte akci s názvem Získat metadata souboru.

    Screenshot shows the Azure portal, Consumption workflow designer, search box with

  3. V případě potřeby zadejte informace o připojení. Až budete hotovi, vyberte Vytvořit.

    Poznámka:

    Ve výchozím nastavení tento konektor přenáší soubory v textovém formátu. Pokud chcete přenášet soubory v binárním formátu, například kde a kdy se používá kódování, vyberte možnost binárního přenosu.

    Screenshot shows Consumption workflow designer and FTP connection profile for an action.

  4. Jakmile se zobrazí informace o akci Získat metadata souboru, klikněte do pole Soubor, aby se otevřel seznam dynamického obsahu.

    Teď můžete vybrat výstupy z předchozího triggeru.

  5. V seznamu dynamického obsahu v části Při přidání nebo změně souboru vyberte Seznam ID souborů.

    Screenshot shows Consumption workflow designer,

    Vlastnost File teď odkazuje na výstup triggeru Seznam ID souborů.

  6. V návrháři v akci Získat metadata souboru vyberte Nový krok.

  7. Pod vyhledávacím polem Zvolit operaci vyberte Standardní.

  8. Do vyhledávacího pole zadejte obsah souboru ftp get.

  9. V seznamu akcí vyberte akci s názvem Získat obsah souboru.

    Screenshot shows the Azure portal, Consumption workflow designer, search box with

  10. Jakmile se zobrazí pole Získat informace o akci obsahu souboru, klikněte do pole Soubor , aby se otevřel seznam dynamického obsahu.

    Teď můžete vybrat výstupy z předchozího triggeru a dalších akcí.

  11. V seznamu dynamického obsahu v části Získat metadata souboru vyberte ID, které odkazuje na soubor, který byl přidán nebo aktualizován.

    Screenshot shows Consumption workflow designer,

    Vlastnost Soubor teď odkazuje na výstup akce ID .

    Screenshot shows Consumption workflow designer,

  12. Až budete hotovi, uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.

Otestování pracovního postupu

Pokud chcete zkontrolovat, jestli váš pracovní postup vrací očekávaný obsah, přidejte další akci, která vám odešle obsah z přidaného nebo aktualizovaného souboru. Tento příklad používá akci Office 365 Outlook s názvem Odeslat e-mail.

  1. Pod akcí Získat obsah souboru přidejte akci Office 365 Outlook s názvem Odeslat e-mail. Pokud máte místo toho účet Outlook.com, přidejte akci Outlook.com Odeslat e-mail a odpovídajícím způsobem upravte následující kroky.

    1. V návrháři v akci Získat obsah souboru vyberte Nový krok.

    2. Pod vyhledávacím polem Zvolit operaci vyberte Standardní.

    3. Do vyhledávacího pole zadejte office 365 outlook odeslat e-mail. V seznamu akcí vyberte akci Office 365 Outlook s názvem Odeslat e-mail.

    Screenshot shows Consumption workflow designer and

  2. V případě potřeby se přihlaste ke svému e-mailovému účtu.

  3. Do pole s informacemi o akci zadejte požadované hodnoty a uveďte všechny další parametry nebo vlastnosti, které chcete testovat.

    Můžete například zahrnout výstup obsahu souboru z akce Získat obsah souboru. Chcete-li najít tento výstup, postupujte takto:

    1. V akci Získat obsah souboru klikněte do pole Text, aby se otevřel seznam dynamického obsahu.

    2. V seznamu dynamického obsahu vedle možnosti Získat obsah souboru vyberte Zobrazit další.

      Screenshot shows Consumption workflow designer,

    3. V seznamu dynamického obsahu v části Získat obsah souboru vyberte Obsah souboru.

      Vlastnost Text nyní odkazuje na výstup akce Obsah souboru.

      Screenshot shows Consumption workflow designer,

  4. Uložte pracovní postup aplikace logiky.

  5. Pokud chcete pracovní postup spustit a aktivovat, na panelu nástrojů návrháře vyberte Spustit spuštění aktivační události>. Přidejte soubor do složky FTP, kterou váš pracovní postup monitoruje.

Operace integrovaného konektoru FTP

Integrovaný konektor FTP je k dispozici pouze pro pracovní postupy standardní aplikace logiky a poskytuje následující operace:

Trigger Popis
Při přidání nebo aktualizaci souboru Spusťte pracovní postup aplikace logiky při přidání nebo aktualizaci souboru v zadané složce na serveru FTP.

Poznámka: Tento trigger získá pouze metadata nebo vlastnosti souboru, nikoli obsah souboru. Pokud ale chcete získat obsah, může váš pracovní postup postupovat podle tohoto triggeru pomocí akce Získat obsah souboru.
Akce Popis
Vytvořit soubor Vytvořte soubor pomocí zadané cesty k souboru a obsahu souboru.
Odstranit soubor Odstraňte soubor pomocí zadané cesty k souboru.
Získat obsah souboru Získejte obsah souboru pomocí zadané cesty k souboru.
Získání metadat souboru Pomocí zadané cesty k souboru získejte metadata nebo vlastnosti souboru.
Výpis souborů a podsložek ve složce Získejte seznam souborů a podsložek v zadané složce.
Aktualizovat soubor Aktualizujte soubor pomocí zadané cesty k souboru a obsahu souboru.

Při přidání nebo aktualizaci souboru

ID operace: whenFtpFilesAreAddedOrModified

Tento trigger spustí pracovní postup aplikace logiky při přidání nebo aktualizaci souboru v zadané složce na serveru FTP. Trigger získá pouze metadata nebo vlastnosti souboru, ne žádný obsah souboru. Pokud ale chcete získat obsah, může váš pracovní postup postupovat podle tohoto triggeru pomocí akce Získat obsah souboru.

Parametry

Název Klíč Požaduje se Typ Popis
Cesta ke složce folderPath True string Cesta ke složce vzhledem ke kořenovému adresáři.
Počet souborů, které se mají vrátit maxFileCount False integer Maximální počet souborů, které se mají vrátit z jednoho spuštění triggeru. Platné hodnoty jsou v rozsahu od 1 do 100.

Poznámka: Ve výchozím nastavení je povoleno nastavení Rozdělit při a vynutí tento trigger zpracovat každý soubor jednotlivě paralelně.
Časové razítko pro přeskočení starších souborů oldFileCutOffTimestamp False dateTime Doba, kdy se má použít k ignorování starších souborů. Použijte formát YYYY-MM-DDTHH:MM:SSčasového razítka . Pokud chcete tuto funkci zakázat, nechte tuto vlastnost prázdnou.

Vrácení

Pokud je povoleno nastavení Rozdělit při triggeru, trigger vrátí metadata nebo vlastnosti pro jeden soubor najednou. V opačném případě trigger vrátí pole, které obsahuje metadata každého souboru.

Name Type
Seznam souborů BlobMetadata

Vytvořit soubor

ID operace: createFile

Tato akce vytvoří soubor pomocí zadané cesty k souboru a obsahu souboru. Pokud soubor již existuje, tato akce tento soubor přepíše.

Důležité

Pokud odstraníte nebo přejmenujete soubor na serveru FTP ihned po vytvoření v rámci stejného pracovního postupu, může operace vrátit chybu HTTP 404 , která je navržena. Abyste se tomuto problému vyhnuli, před odstraněním nebo přejmenování nově vytvořených souborů zahrňte 1 minutu. K přidání tohoto zpoždění do pracovního postupu můžete použít akci Zpoždění.

Parametry

Název Klíč Požaduje se Typ Popis
Cesta k souboru filePath True string Cesta k souboru, včetně přípony názvu souboru,pokud existuje, vzhledem k kořenovému adresáři.
Obsah souboru fileContent True string Obsah souboru.

Vrácení

Tato akce vrátí objekt BlobMetadata s názvem Body.

Name Type
Název souboru metadat string
Cesta k souboru metadat souborů string
Velikost souboru metadat string
Metadata souborů BlobMetadata

Odstranit soubor

ID operace: deleteFtpFile

Tato akce odstraní soubor pomocí zadané cesty k souboru.

Parametry

Název Klíč Požaduje se Typ Popis
Cesta k souboru filePath True string Cesta k souboru, včetně přípony názvu souboru,pokud existuje, vzhledem k kořenovému adresáři.

Vrácení

Nic

Získat obsah souboru

ID operace: getFtpFileContent

Tato akce získá obsah souboru pomocí zadané cesty k souboru.

Parametry

Název Klíč Požaduje se Typ Popis
Cesta k souboru path True string Cesta k souboru, včetně přípony názvu souboru,pokud existuje, vzhledem k kořenovému adresáři.

Vrácení

Tato akce vrátí obsah souboru jako binární hodnotu s názvem File content.

Name Type
Obsah souboru Binární

Získání metadat souboru

ID operace: getFileMetadata

Tato akce získá metadata nebo vlastnosti souboru pomocí zadané cesty k souboru.

Parametry

Název Klíč Požaduje se Typ Popis
Cesta k souboru path True string Cesta k souboru, včetně přípony názvu souboru,pokud existuje, vzhledem k kořenovému adresáři.

Vrácení

Tato akce vrátí následující výstupy:

Name Type
Název souboru string
Cesta k souboru string
Velikost souboru string
Čas poslední aktualizace string
Metadata souborů BlobMetadata

Výpis souborů a podsložek ve složce

ID operace: listFilesInFolder

Tato akce získá seznam souborů a podsložek v zadané složce.

Parametry

Název Klíč Požaduje se Typ Popis
Cesta ke složce folderPath True string Cesta ke složce vzhledem ke kořenovému adresáři.
Obsah souboru fileContent True string Obsah souboru

Vrácení

Tato akce vrátí pole s názvem Response a obsahuje objekty BlobMetadata.

Name Type
Odezva Pole s objekty BlobMetadata

Aktualizovat soubor

ID operace: updateFile

Tato akce aktualizuje soubor pomocí zadané cesty k souboru a obsahu souboru.

Důležité

Pokud odstraníte nebo přejmenujete soubor na serveru FTP ihned po vytvoření v rámci stejného pracovního postupu, může operace vrátit chybu HTTP 404 , která je navržena. Abyste se tomuto problému vyhnuli, před odstraněním nebo přejmenování nově vytvořených souborů zahrňte 1 minutu. K přidání tohoto zpoždění do pracovního postupu můžete použít akci Zpoždění.

Parametry

Název Klíč Požaduje se Typ Popis
Cesta k souboru filePath True string Cesta k souboru, včetně přípony názvu souboru,pokud existuje, vzhledem k kořenovému adresáři.
Obsah souboru fileContent True string Obsah souboru

Vrácení

Tato akce vrátí objekt BlobMetadata s názvem Body.

Name Type
Text BlobMetadata

Další kroky