Подключение локальных файловых систем из рабочих процессов в Azure Logic Apps
Область применения: Azure Logic Apps (Потребление + Стандартный)
В этом руководстве показано, как получить доступ к локальной общей папке из рабочего процесса в Azure Logic Apps с помощью соединителя файловой системы. Затем можно создать автоматизированные рабочие процессы, которые выполняются при активации событий в общей папке или в других системах, а также выполнять действия для управления файлами. Соединитель предоставляет следующие возможности:
- создание, получение, добавление, обновление и удаление файлов;
- создание списка файлов в папках или корневых папках;
- получение содержимого и метаданных файлов;
В этом руководстве примеры сценариев демонстрируют следующие задачи:
- Активируйте рабочий процесс при создании или добавлении файла в общую папку, а затем отправьте сообщение электронной почты.
- Активируйте рабочий процесс при копировании файла из учетной записи Dropbox в общую папку, а затем отправьте сообщение электронной почты.
Известные проблемы и ограничения
- Коннектор файловой системы в настоящее время поддерживает только файловые системы Windows в операционных системах Windows.
- Подключенные сетевые диски не поддерживаются.
технический справочник по Подключение or
Соединитель файловой системы имеет разные версии, основанные на типе приложения логики и среде узла.
| Приложение логики | Среда | Версия соединителя |
|---|---|---|
| Потребление | Мультитенантные Azure Logic Apps | Управляемый соединитель, который отображается в конструкторе под меткой "Стандартный". Дополнительные сведения см. в следующей документации: - Справочник по управляемому соединителю файловой системы - Управляемые соединители в Azure Logic Apps |
| Потребление | Среда службы интеграции (ISE) | Управляемый соединитель, который отображается в конструкторе под меткой "Стандартный " и версией ISE, которая имеет разные ограничения сообщений, отличные от класса Standard. Дополнительные сведения см. в следующей документации: - Справочник по управляемому соединителю файловой системы - Ограничения для сообщений ISE - Управляемые соединители в Azure Logic Apps |
| Стандартные | Azure Logic Apps с одним клиентом и Среда службы приложений версии 3 (только планы Windows) | Управляемый соединитель, который отображается в коллекции соединителей в разделе "Общая среда выполнения" и встроенный соединитель, который отображается в коллекции соединителей в разделе "Среда выполнения>>в приложении" и является поставщиком услуг. Встроенный соединитель отличается следующим образом: — Встроенный соединитель поддерживает только стандартные приложения логики, которые выполняются в Среда службы приложений версии 3 только с планами Windows. — Встроенная версия может подключаться непосредственно к общей папке и получать доступ к виртуальным сетям Azure с помощью строка подключения без локального шлюза данных. Дополнительные сведения см. в следующей документации: - Справочник по управляемому соединителю файловой системы - Справочник по встроенному соединителю файловой системы - Встроенные соединители в Azure Logic Apps |
Необходимые компоненты
Учетная запись и подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.
Чтобы подключиться к общей папке, применяются различные требования на основе приложения логики и среды размещения:
Рабочие процессы приложения логики потребления
В нескольких клиентах Azure Logic Apps необходимо выполнить следующие требования, если вы еще не сделали следующее:
Установите локальный шлюз данных на локальном компьютере.
Для управляемого соединителя файловой системы требуется, чтобы установка шлюза и сервер файловой системы существовали в том же домене Windows.
После добавления триггера или действия управляемого соединителя файловой системы в рабочий процесс выберите ресурс шлюза данных, созданный ранее, чтобы подключиться к файловой системе.
В среде isE не требуется локальный шлюз данных. Вместо этого можно использовать соединитель файловой системы с версиями ISE.
Стандартные рабочие процессы приложения логики
Вы можете использовать встроенный соединитель файловой системы или управляемый соединитель.
Чтобы использовать управляемый соединитель файловой системы, следуйте тем же требованиям, что и рабочий процесс приложения логики потребления в мультитенантных Azure Logic Apps.
Чтобы использовать встроенный соединитель файловой системы, рабочий процесс приложения логики уровня "Стандартный" должен выполняться в Среда службы приложений версии 3, но не требует ресурса шлюза данных.
Доступ к компьютеру с файловой системой, которую вы хотите использовать. Например, если вы устанавливаете шлюз данных на том же компьютере, что и ваша файловая система, вам потребуются учетные данные для этого компьютера.
Чтобы следовать примеру сценария в этом руководстве, вам нужна учетная запись электронной почты от поставщика, поддерживаемого Azure Logic Apps, например Office 365 Outlook, Outlook.com или Gmail. Если нужен другой поставщик, просмотрите другие поддерживаемые соединители электронной почты. В этом примере используется соединитель Office 365 Outlook с рабочей или учебной учетной записью. Если вы используете другую учетную запись электронной почты, общие шаги те же, но пользовательский интерфейс может немного отличаться.
Важно!
Только учетные записи для бизнеса G-Suite могут использовать соединитель Gmail без ограничений в приложениях логики. Если у вас есть учетная запись потребителя Gmail, вы можете использовать этот соединитель только с определенными утвержденными Google службами. Кроме того, вы можете создать клиентское приложение Google, которое будет использоваться для проверки подлинности в соединителе Gmail. Дополнительные сведения см. в статье Политики безопасности и конфиденциальности данных для соединителей Google в Azure Logic Apps.
В примере сценария действия файловой системы требуется учетная запись Dropbox, которую можно создать бесплатно.
Рабочий процесс приложения логики, в котором требуется получить доступ к общей папке. Чтобы запустить рабочий процесс с триггером файловой системы, необходимо начать с пустого рабочего процесса. Чтобы добавить действие файловой системы, запустите рабочий процесс с любым триггером.
Добавление триггера файловой системы
В портал Azure откройте пустой рабочий процесс приложения логики в конструкторе.
В конструкторе выполните следующие общие действия, чтобы добавить триггер файловой системы , который вы хотите включить в рабочий процесс.
Дополнительные сведения см. в разделе "Триггеры файловой системы". В этом примере мы также используем триггер с именем При создании файла.
В поле сведений о подключении укажите следующие сведения по мере необходимости:
Свойство Обязательное поле значение Description Имя подключения Да <имя_соединения> имя подключения; Корневая папка Да <имя корневой папки> Корневая папка файловой системы, которая обычно является основной родительской папкой и используется для относительных путей со всеми триггерами для файлов.
Например, если вы установили локальный шлюз данных, используйте локальную папку на компьютере с установкой шлюза данных. Или используйте папку для сетевой папки, к которой компьютер может получить, например\\PublicShare\\MyFileSystem.Тип проверки подлинности Нет <тип проверки подлинности> Тип аутентификации, который использует сервер файловой системы, то есть Windows. Username Да <домен-и-имя_пользователя> Домен и имя пользователя для компьютера, на котором находится файловая система.
Для соединителя управляемой файловой системы используйте одно из следующих значений с обратной косой чертой (\):
- <домен>\<имя_пользователя>
- <локальный-компьютер>\<имя_пользователя>
Например, если папка вашей файловой системы находится на том же компьютере, что и установка локального шлюза данных, вы можете использовать <локальный_компьютер>\<имя_пользователя>.
— Для соединителя файловой системы на основе ISE используйте косую черту вперед (/):
- <домен>/<имя_пользователя>
- <локальный-компьютер>/<имя_пользователя>Пароль Да <пароль> Пароль для компьютера, на котором есть файловая система. шлюз Нет — <подписка-Azure>
— <имя-ресурса-шлюза>Этот раздел применяется только к соединителю управляемой файловой системы:
- Подписка: подписка Azure, связанная с ресурсом шлюза данных
- Шлюз подключений. Ресурс шлюза данных.В следующем примере показаны сведения о подключении для триггера управляемого соединителя файловой системы:
В следующем примере показаны сведения о подключении для триггера на основе ISE файловой системы:
По завершении нажмите Создать.
Azure Logic Apps создаст и проверит подключение для гарантии его правильной работы. Если подключение настроено правильно, отобразятся варианты настройки для выбранного триггера.
Продолжите создание рабочего процесса.
Укажите необходимые сведения для триггера.
В этом примере выберите путь к папке на сервере файловой системы, чтобы проверить наличие только что созданного файла. Укажите количество возвращаемых файлов и частоту проверки.
Чтобы протестировать рабочий процесс, добавьте действие Outlook, которое отправляет сообщение электронной почты после создания файла в указанной папке файловой системы. Введите получателей, тему и текст для сообщения электронной почты. Для тестирования можете использовать свой собственный адрес электронной почты.
Совет
Чтобы добавить выходные данные из предыдущих шагов в рабочем процессе, выберите в полях редактирования триггера. Когда отобразится список динамического содержимого, выберите нужный вариант из доступных выходных данных.
Закончив работу, сохраните свой рабочий процесс.
Чтобы протестировать рабочий процесс, отправьте файл, который активирует рабочий процесс.
В случае успешного выполнения рабочий процесс отправит сообщение электронной почты о новом файле.
Добавление действия файловой системы
Пример рабочего процесса приложения логики начинается с триггера Dropbox, но можно использовать любой нужный триггер.
Откройте рабочий процесс приложения логики в конструкторе на портале Azure.
В конструкторе выполните следующие общие действия, чтобы добавить действие файловой системы , которое вы хотите выполнить в рабочий процесс.
Дополнительные сведения см. в разделе "Триггеры файловой системы". В этом примере также используется действие с именем Создать файл.
В поле сведений о подключении укажите следующие сведения по мере необходимости:
Свойство Обязательное поле значение Description Имя подключения Да <имя_соединения> имя подключения; Корневая папка Да <имя корневой папки> Корневая папка файловой системы, которая обычно является основной родительской папкой и используется для относительных путей со всеми триггерами для файлов.
Например, если вы установили локальный шлюз данных, используйте локальную папку на компьютере с установкой шлюза данных. Или используйте папку для сетевой папки, к которой компьютер может получить, например\\PublicShare\\MyFileSystem.Тип проверки подлинности Нет <тип проверки подлинности> Тип аутентификации, который использует сервер файловой системы, то есть Windows. Username Да <домен-и-имя_пользователя> Домен и имя пользователя для компьютера, на котором находится файловая система.
Для соединителя управляемой файловой системы используйте одно из следующих значений с обратной косой чертой (\):
- <домен>\<имя_пользователя>
- <локальный-компьютер>\<имя_пользователя>
Например, если папка вашей файловой системы находится на том же компьютере, что и установка локального шлюза данных, вы можете использовать <локальный_компьютер>\<имя_пользователя>.
— Для соединителя файловой системы на основе ISE используйте косую черту вперед (/):
- <домен>/<имя_пользователя>
- <локальный-компьютер>/<имя_пользователя>Пароль Да <пароль> Пароль для компьютера, на котором есть файловая система. шлюз Нет — <подписка-Azure>
— <имя-ресурса-шлюза>Этот раздел применяется только к соединителю управляемой файловой системы:
- Подписка: подписка Azure, связанная с ресурсом шлюза данных
- Шлюз подключений. Ресурс шлюза данных.В следующем примере показаны сведения о подключении для действия управляемого соединителя файловой системы:
В следующем примере показаны сведения о подключении для действия соединителя на основе ISE файловой системы:
По завершении нажмите Создать.
Azure Logic Apps создаст и проверит подключение для гарантии его правильной работы. Если подключение настроено правильно, отобразятся варианты настройки для выбранного действия.
Продолжите создание рабочего процесса.
Укажите необходимые сведения для действия.
В этом примере выберите путь к папке на сервере файловой системы, который здесь является корневой папкой. Введите имя и содержимое файла с учетом файла, отправленного в Dropbox.
Совет
Чтобы добавить выходные данные из предыдущих шагов в рабочем процессе, выберите в полях редактирования действия. Когда отобразится список динамического содержимого, выберите нужный вариант из доступных выходных данных.
Чтобы протестировать рабочий процесс, добавьте действие Outlook, которое отправляет сообщение электронной почты при создании файла действием файловой системой. Введите получателей, тему и текст для сообщения электронной почты. Для тестирования можете использовать свой собственный адрес электронной почты.
Закончив работу, сохраните свой рабочий процесс.
Чтобы протестировать рабочий процесс, отправьте файл, который активирует рабочий процесс.
В случае успешного выполнения рабочий процесс создает файл на сервере файловой системы на основе отправленного в DropBox файла и отправляет сообщение электронной почты о созданном файле.
