logicflow 概要

LogicFlow Overview

2017/11/18

LogicFlow-ja 小尾智之

Self Introduction

Attribute1: VB / LogicApps-Flow-PowerApps

@twit_ahf

Attribute2: 提督 / 殿 / メガネ / クマ / プロレス /もっふり

tomoyuki.obi

http://el.jibun.atmarkit.co.jp/ahf

Community: LogicFlow-ja / CLR/H

Microsoft MVP for Microsoft Azure(2017.03 ～）

https://www.facebook.com/groups/logicflowja/

Agenda

・LogicApps/Flow 概要

Session Goal

• LogicFlow が適している場面を理解する

• LogicFlow でできることを理解する

LogicFlow is iPaas

iPaasis

Integration Platformas a Service

＞ ≧

IFTTT は非常に多くのサービスと連携可能間に制御を挟まないシンプル構成

IFTTT / Flow / LogicApps

Flow / LogicApps はユーザーが制御を挟む余地があるサービス数はまだ限られている

一般ユーザー ITPro

Trigger

Action

Action

LogicFlow の構造

発生したイベントをトリガで受け取り後続のアクションで処理を行う

Price Plan

LogicApps 従量課金プラン

LogicApps AppService プラン

https://azure.microsoft.com/ja-jp/pricing/details/logic-apps/

Flow とは課金単位が異なる

1 Action

1 Action

1 Action

1 Flow

LogicApps の課金単位

Flow の課金単位

LogicApps 仕様と制限

最大実行継続時間 90 日

ストレージリテンション期間 90 日

最小繰り返し時間 1 秒

最大繰り返し間隔 500 日

ForEach レコード数 100,000

Loop Until 回数 5,000

SplitOn 最大数 100,000

ForEach 並列処理数 50

アクション実行数（5分間） 100,000

同時呼出し数 2,500

エンドポイント同時受信数 1,000

エンドポイント読取可能呼出し数 60,000

エンドポイント起動可能呼出し数 45,000

ワークフローでのアクション数 250

ワークフロー内部でのネスト数 5

1リージョンのワークフロー数 1,000

ワークフローごとのトリガ数 10

一つの式での最大文字数 8,192

アクション/トリガ名の文字数 80

コメントの文字数 256

パラメーター数 50

Microsoft Flow 料金プラン

1 ユーザー 25 LogicFlow が定義可能（リクエスト送付で拡張可能）https://flow.microsoft.com/ja-jp/pricing/

Flow プランでの機能制限

Premium 系コネクタはPlan1 / 2 でのみ利用可能

PowerApps 料金プラン

https://powerapps.microsoft.com/ja-jp/communityplan/

PowerApps コミュニティプラン

既にアカウントを所有していても作成可能

Service Connectors

Enterprise

Integration

SNS

Office365 / Dynamics365

Data Connect

Web Service

Azure Service

Online Storage

Notification Standard

Connecter

Cognitive Service

Button

Approval

Batch

Enterprise

Integration

SNS


Data Connect

Web Service

Azure Service

Online Storage


Connecter

Cognitive Service

Button

Approval

Batch

LogicApps Only

Enterprise

Integration

SNS


Data Connect

Web Service

Azure Service

Online Storage


Connecter

Cognitive Service

Button

Approval

Batch

Flow Only

Connector Detail

LogicFlow 基本コネクタ

スケジュール

OpenAPI(Swagger) 定義されたAPI 呼出

HTTPS リクエスト

RSSFTP/SFTP

HTTP/HTTPS

WebHook

Mail(SendGrid)

SMTP

変数

制御HTTP レスポンス

データ操作

PowerApps

プッシュ通知

Flow Button

HTML-テキスト変換

PowerApps用プッシュ通知

条件判断 / Condition

IF ～ THEN ～ ELSE（条件分岐）

Switch Case（条件多分岐）

繰り返し / Loop

Do Until ループ

ループが一定時間内に終了しない場合にタイムアウトとする場合はISO 8601 形式でタイムアウト条件を設定

繰り返し / Loop

ForEach ループ

規定では 20 アクションの並列動作operationOptions:Sequential で変更可能

デザイナ上だけでネストしたループも作成可能

並列動作アクション数はデザイナー上からも調整可能

ブロック化 / Scope

処理のブロック化

実行条件の構成 / RunAfter

ブロック化した場合は「ブロック内部の処理が何か一つでも失敗したら」という条件で利用できる

並列分岐 / RunAfter(2)

デザイナー上から並列動作させるアクションを直接設定可能

RunAfter 設定を変更しどのコネクタの後に実行するかを設定している

IF コネクタでエラー判定しなくともこのような形でエラー処理が作成できる

ドラッグ＆ドロップで移動可能

変数/ Variables

初期化を先に実施する必要がある

変数の初期化はループ内部では利用不可

データ操作 / Compose

関数で行っていたものがコネクタ化され簡易に利用可能

inputArguments.Select(Function(x)

Return New With {Key x.orgArg1,

Key x.orgArg2,

Key Sum(x.orgArg3)}

End Function).ToArray

選択/ Selecct

配列オブジェクトの再定義

バッチ / Batch

一定回数呼び出される定期的に実行する一定量のメッセージを受け取るなどをトリガにして起動できる

再試行ポリシー/ Retry Policy

動作エラーになったものを何回（Limit）どの程度の間隔で（Duration）再実行するかを設定

HTTP コネクタの仕様と制限

Request

Response

HTTP ステータス 200 が正常終了202 は処理継続中として Retry-After 値に基づいてポーリング

Location ヘッダの値がある場合再試行時にリクエストを投げる URL が変化

ワークフローが開始されるのはステータス 200 の時に限定される

http://blogahf.blogspot.jp/2017/07/logicflow-http.html

Trigger

CodeView 上で LogicFlow を直接記載

デザイナーでは未サポート

動作自体は問題なく可能

マルチトリガ / Multi Trigger

@triggerOutputs() 関数にて呼出時に付与されていたクエリパラメータを取得できる

Request トリガにおけるクエリパラメータ

@triggerOutputs()['queries']['test1']などでパラメータを利用可能

Workflow Function

演算子 / Operator

．

？

‘

［］

？演算子は特に重要で値がない事が想定される場合は必ず使うのがよい

関数 / Workflow Functions

Referencing functions

Collection functions

String functions

Logical functions

Conversion functions

Math functions

Date functions

URI functions

https://docs.microsoft.com/ja-jp/azure/logic-apps/

logic-apps-workflow-definition-language

インテリセンスサポートあり

Manipulation functions

Workflow functions

https://docs.microsoft.com/ja-jp/azure/logic-apps/

Functions の書き方

最初の関数のみ＠をつける必要がある(CodeView のみ）

文字列は ‘ でのみ囲める

デザイナー上で記載する場合は「詳細設定」LogicApps なら CodeView で記載するのを活用

Workflow Functions のコネクタ対応

一部関数はコネクタとして提供も行っている

Azure API App

同一サブスクリプション上にある API Apps を呼出可能

トリガ/アクション両方を利用可能

OpenAPI

API Apps での OpenAPI(Swagger)設定によりダイアログでの表示などカスタマイズ可能

メソッドなどへ属性を付与してデザイナ上の表示を指定T-Rex ライブラリも利用可能（https://github.com/nihaue/TRex）

[HttpPost, Route]

[Metadata("Create Message", "Creates a new message absolutely nowhere")]

[SwaggerResponse(HttpStatusCode.OK, Type = typeof(SampleOutputMessage))]

public async Task<IHttpActionResult> Post([FromBody]

[Metadata("Sample Input", "A sample input message")]

SampleInputMessage sampleInput)

{

return await SampleOutputMessage.FromInputAsync(sampleInput);

}

参考）https://flow.microsoft.com/ja-jp/documentation/customapi-how-to-swagger/

https://github.com/nihaue/TRex

Azure Function App

LogicFlow デザイナー上で直接 FunctionApp を記述可能（ただし js のみ）

Custom Connector

外部 API を事前に登録することで他コネクタと同様に利用させることが可能

アイコンや説明文なども設定できるので詳しくない人でも利用できるようになる

カスタムコネクタ登録

カスタムコネクタ登録により他のコネクタと比較しても判別つかない形でコネクタを提供することが可能

利用する側にとっては詳細な設定を毎回行う必要がないので利便性が高い

OnPremiss Data Gateway

Hybrid Connection

(ServiceBus – Relay)

OnPremiss Data Gateway

(ServiceBus – Queue)

OnPremiss DataGateway

対象コネクタ

DataGateway はメッセージをポーリングする方式でやり取りを行う(リアルタイム性は若干落ちる）

•ルートフォルダ：接続先 PC でのローカルパス（共有はかけなくても大丈夫）•認証タイプ：Windows 認証•ユーザー名：（マシン名）￥（アカウント）を入力AD アカウントではないので注意！•パスワード：パスワードを入力•ゲートウェイ：インストールしたゲートウェイを選択

DataGateway 利用ポート

TCP 443 (既定値) / 5671 / 5672 / 9350 ～ 9354

データ送信のみで受信は必要ない

HTTPS を強要する場合は config ファイルの書き換えかインストーラから設定

Enterprise Integration

Enterprise Integration

統合アカウント

ファイルからのエンコード

ファイルへのデコード

XML の検証 XML 変換

EDIFACT

AS2

X12特定プロトコルのコネクタは用意済

VS 上でスキーマやマップの定義を行いAzure へアップロードが必要（現時点では VS2015 限定）

BizTalk Server Architecture

BizTalk Service Architecture

オーケストレーション部分が

Enterprise Integration Pack

統合アカウントB2B などで EDI/EOS をする際の情報を登録

マップは xslt とLiquid Template に対応

LogicFlow Configration

実行履歴 / History

コネクタによっては BASE64 し結果をやり取りするものもある

バージョン履歴 / Version

編集履歴より過去のバージョンへ戻すことが可能

履歴表示時に「昇格」で復元される

テンプレート生成 / Template

Template 化することでGithub などからのデプロイも可能

新規作成時のデフォルト値を定義したテンプレートも作成可能

Azure Alert の LogicApps 呼出し

Azure の各種サービスでAlert が発生した際に実行する LogicApps を指定できる

Alert ルールはメトリックとして定義可能

Flow で定義した LogicFlow を呼出したい際はWebhook として Request コネクタで生成された URL を指定することで可能(ブレード上 LogicApps 呼出がない際も同様）

発生した Alert の集約も非常に簡単に行える

LogicApps の呼び出し元 IP アドレス

LogicAppsからアクセスした場合の IP アドレス

LogicApps のセキュリティ

LogicFlow にアクセスできるIP アドレスの制限を指定可能

Flow のセキュリティ

複数の環境を作成してユーザーを切り分ける

接続可能なコネクタルールを定義し不用意にデータ流出を行えなくする

Log Analytics

細かい設定なしでLogicApps のログ情報をOMS へと連携が可能

Flow/PowerAppsLimited

ボタン / Button

Flow モバイルアプリ導入で利用可能端末 / Web サイトより実行可能

作成したボタントリガはメニュー上にウィジェットとして配置することが可能

通知 / Notification

Flow モバイルアプリ導入で利用可能自分の端末へのプッシュ通知 / メールによる通知

PowerApps で利用可能（ブラウザ上では未対応）アプリケーション単位での通知（特定ユーザーも可）

PowerApps Notification

Notification

承認 / Approval

Flow Premium（または Office365 FreePlan）で可能活用するには Office365 ユーザーが必要

Flow モバイルアプリまたは Flow ウェブサイト上で承認行為が可能

Functions App Proxy

Function Apps Proxy と API Management Services

どちらも LogicFlow を呼び出すプロキシとして利用可能

特定のメソッドで呼び出された際にAPI を呼び出すことが可能

Function Apps Proxy

logicflow 概要

Technology