Industrial App Store

リファレンス

Intelligent Plant の Industrial App Store は、クラウドベースのアプリケーションとサービスがオンサイトの Process Data Historians および Alarm & Event Logs と対話できるようにするアーキテクチャの上に構築されています。 Industrial App Store コネクタを使用して、フローにプラントデータを導入します。

このコネクタは、次の製品および地域で利用可能です。

Service	クラス	地域
Logic Apps	標準	以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD)
Power Automate	プレミアム	以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD)
Power Apps	プレミアム	以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD)

お問い合わせ先
件名	Intelligent Plant
[URL]	https://appstore.intelligentplant.com
メール	support@intelligentplant.com

Connector Metadata
発行者	Intelligent Plant
Web サイト	https://appstore.intelligentplant.com
プライバシーポリシー	https://appstore.intelligentplant.com/Content/assets/legal/IAS-PrivacyPolicy.html
カテゴリ	IoT; ビジネスインテリジェンス

Industrial App Store Power Automate コネクタ

Intelligent Plant は、統合 API を通じてさまざまな Historian Data すべてとの対話を可能にする Industrial App Store を開発しました。 2020 年 5 月の初めに、Intelligent Plant は、公式に Microsoft 認定の Power Automate 用 Industrial App Store コネクタをリリースしました。簡単なリアルタイム更新オプションや複雑なアーキテクチャソリューションがなくても、重い SQL クエリまたは Excel ドキュメントの照会の必要がなくなります。Industrial App Store に接続するだけで、標準で Aspentech IP.21、OSIsoft PI、Honeywell Dynamo、OPC DA & HDA、Siemensなどに接続することができます。これにより、ユーザーはさまざまなソースからのデータを Microsoft Automate フローに取り込み、これまで不可能だったインサイトを提供することができます。リアルタイムの更新により、エンジニアによる資金の節約の決定が促され、プラントの安全性と効率も向上します。詳細については、こちらを参照してください。

IAS - Power Platform 統合

前提条件

Linked In、Google、または Microsoft アカウントを使用してログインするだけで、Industrial App Store に登録できます。 Microsoft Entra ID との同期もサポートされていて、職場の資格情報を使用したログインもできます。
デモデータソースを使用していろいろ試してみることができますが、ヒストリアンデータに接続する場合は、App Store Connect をインストールするだけで、標準のデータソースドライバーを使用してデータに接続できます!

資格情報の入手方法

Linked In、Google、または Microsoft アカウントを使用してログインします。 Microsoft Entra ID との同期もサポートされていて、職場の資格情報を使用したログインもできます。

IAS - ログイン

コネクタの使用を開始する

フロー内のアクションとして Industrial App Store を追加し、クエリの 1 つを指定して、タグ名、開始時間、終了時間などのパラメーターを入力するだけです! データ取得の例:

開始Power Automate
Microsoft Power Autoamte に移動します。必要な場合はログインします。
フローを新規作成する
左側のメニューで :heavy_plus_sign: 作成を押し、インスタントフローまたはスケジュール済みフローを選択して、選択を確認します。

Industrial App Store コネクタ - Autoamte - 開始する

サインイン
資格情報を使用してサインインします。

注意: これはフローごとに初回に行うだけです。同じ接続資格情報を他のフローで再利用することができます

Industrial App Store コネクタ - Autoamte - ログイン

パラメーターを入力します
次の値を使用して必要なパラメーターを入力します。

件名	値	メモ
データソース名	DNS - 変数	作成時に App Store Connect で提供されたデータソース名を使用します。
クエリのタグ	タグ - 変数	ヒストリアンタグを指定します。
開始時刻	2001-01-01	クエリの絶対または相対開始時間。
終了時刻	2001-03-01	クエリの絶対または相対終了時間。
データ関数	AVG
間隔のサンプル	1d

Industrial App Store コネクタ - Autoamte - ログイン

Power Automate に返されるヒストリカルデータは、JSON ファイル形式を使用して機器の値を説明します。データセットの例を以下に示します。

{
    "Edge Historian (LDT-INTELPLANT)": {
        "TIC001-HI": {
            "TagName": "TIC001-HI",
            "DisplayType": "TrailingEdge",
            "Values": [
                {
                    "IsNumeric": true,
                    "TagName": "TIC001-HI",
                    "UtcSampleTime": "2020-09-08T04:20:40Z",
                    "NumericValue": 13.89999,
                    "TextValue": "13.89999",
                    "Status": "Good",
                    "Unit": "degC",
                    "Notes": null,
                    "Error": null,
                    "HasError": false
                },
                {
                    "IsNumeric": true,
                    "TagName": "TIC001-HI",
                    "UtcSampleTime": "2020-09-09T04:20:40Z",
                    "NumericValue": 13.89999,
                    "TextValue": "13.89999",
                    "Status": "Good",
                    "Unit": "degC",
                    "Notes": null,
                    "Error": null,
                    "HasError": false
                },
                // -- remaining values removed for brevity --
            ]
        }
    }
}

データはデータソース名 (Edge Historian (LDT-INTELPLANT)) およびタグ名 (TIC001-HI) でインデックスが作成されます。各タグのエントリには、次のフィールドが含まれています。

TagName - テーブルの表示名です。
DisplayType - グラフでデータを視覚化するときに個々の値の間の線を引く方法を説明するヒントを提供します。
Values - タグ値の一覧。

Values コレクションの各エントリは、特定の時点でのタグの 1 つの値を説明しています。各値には複数のフィールドが定義されていますが、最も関心のあるフィールドを次に示します。

UtcSampleTime - ISO 8601 形式で指定された UTC タイムスタンプのサンプル。
NumericValue - 機器によって記録された数値。
Status - 値に関連付けられた品質の状態 (Good、Bad、または Uncertain)。機器の物理的な障害と診断されていない限り、通常、状態は Good です。
Unit - 値の単位。

これで、さらに処理するための履歴データが得られました。ここから、通知の発行、レポートのコンパイル、手順の開始などをすることができます。

既知の問題と制限事項

返されるデータセットをナビゲートしやすくするために、より優れたスキーマの定義に対応しています。

一般的なエラーと解決策

データソースへのアクセスが認証されていることを確認してください。 App Store Connect または Intelligent Plant を構成した人に連絡してください (support@intelligentplant.com)。

よくあるご質問

設定全体について詳しく説明しているこの記事を参照してください。詳細についてお尋ねになりたい場合、またご質問がありましたら、遠慮なく info@intelligentplant.com から Intelligent Plant までご連絡ください

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	100	60 秒

アクション

スナップショット値の読み取り	タグの現在の値を取得します。
タグを取得	データソースでタグ検索を実行します。
データソースを取得する	使用可能なデータソースの一覧を取得します。
プロット値の読み取り	タグ値の最適曲線を要求します。
生の値を読み取る	タグの生の値をリクエストします。
集計値の読み取り	タグの集計値をリクエストします。

スナップショット値の読み取り

操作 ID:: ias_getdata_snapshot_v2

タグの現在の値を取得します。

パラメーター

名前	キー	必須	型	説明
データソース名。	dsn	True	string	データクエリを実行するデータソース名。
クエリのタグ。	tag	True	string	クエリのタグ。
true の場合、キャッシュされたスナップショット値を使用しないことを指定します。	nocache		boolean	true の場合、キャッシュされたスナップショット値を使用しないことを指定します (例: スナップショットクエリは常にデータソースに対して実行されます)。
true の場合、タグ値のプロパティが結果に含められます。	includeProperties		boolean	true の場合、タグ値のプロパティが結果に含められます。

戻り値

名前	パス	型	説明
TagName	TagName	string	タグ名
UtcSampleTime	UtcSampleTime	string	タグ値のサンプル時刻 (UTC)
NumericValue	NumericValue	float	タグの数値
IsNumeric	IsNumeric	boolean	タグに数値が含まれるか?
TextValue	TextValue	string	タグのテキスト値
ステータス	Status	string	タグ値の状態
単位	Unit	string	タグ値の出荷単位です。
メモ	Notes	string	メモ
エラー	Error	string	タグ値のエラーの詳細
HasError	HasError	boolean	タグ値の HasError の状態

タグを取得

操作 ID:: ias_tagsearch

データソースでタグ検索を実行します。

パラメーター

名前	キー	必須	型	説明
データクエリを使用するデータソース名。	dsn	True	string	データソース名。
使用するタグ名フィルター。既定値は "*" です。	name	True	string	タグ名フィルター。
返される一致した結果のページ番号。	page	True	integer	返される一致した結果のページ番号。
結果のページサイズ。	pageSize	True	integer	結果のページサイズ。

戻り値

名前	パス	型	説明
		array of object
ID	Id	string	一意のタグ識別子
件名	Name	string	タグ名
内容	Description	string	タグの説明
UnitOfMeasure	UnitOfMeasure	string	タグ値の出荷単位
値	Properties.index.Value	integer	値
件名	Properties.index.Name	string	件名
カテゴリ	Properties.index.Category	string	カテゴリ
内容	Properties.index.Description	string	内容
DisplayIndex	Properties.index.DisplayIndex	integer	DisplayIndex
IsReadOnly	Properties.index.IsReadOnly	boolean	IsReadOnly
DigitalStates	DigitalStates	array of	DigitalStates
IsMetaTag	IsMetaTag	boolean	タグがドライバーによって作成されたメタタグであるかどうかを指定するフラグ。

データソースを取得する

操作 ID:: ias_getdsns

使用可能なデータソースの一覧を取得します。

戻り値

名前	パス	型	説明
		array of object
ホスト	Host	string	データソースのホスト
SupportedFeatures	SupportedFeatures	string	データソースがサポートしている機能
件名	Name.Name	string	データソースのコンポーネント名
名前空間	Name.Namespace	string	データソースの名前空間
QualifiedName	Name.QualifiedName	string	データソースの修飾名
表示名	Name.DisplayName	string	表示名
エイリアス	Name.Aliases	array of	エイリアス
TypeName	TypeName	string	データソースのコンポーネントの種類名
内容	Description	string	データソースコンポーネントの説明
RunningStatus	Status.RunningStatus	string	データソースの実行状態
IsHealthy	Status.HealthStatus.IsHealthy	boolean	IsHealthy
プロパティ	Status.HealthStatus.Properties	array of	プロパティ
IsInitialised	Status.IsInitialised	boolean	IsInitialised
IsDisabled	Status.IsDisabled	boolean	無効状態
DebugMode	Status.DebugMode	boolean	デバッグモード
UtcStartupTime	Status.UtcStartupTime	string	起動時間 (UTC)
UtcLastModified	Status.UtcLastModified	string	最終更新時間 (UTC)
稼働時間	Status.Uptime	string	データソースの稼働時間
メッセージ	Status.Messages	array of	メッセージ
設定	Settings	array of	データソースの設定
キープアライブのデータクエリ	Properties.Keep-Alive Data Queries	string	キープアライブのデータクエリ
リモートタイプ	Properties.Remote Type	string	リモートタイプ
AuthorizationRules	AuthorizationRules	array of	データソースの認証ルール

プロット値の読み取り

操作 ID:: ias_getdata_plot_v2

タグ値の最適曲線を要求します。

パラメーター

名前	キー	必須	型	説明
データソース名。	dsn	True	string	データクエリを実行するデータソース名。
クエリのタグ。	tag	True	string	クエリのタグ。
クエリの絶対または相対開始時間。	start	True	string	クエリの絶対または相対開始時間。
クエリの絶対または相対終了時間。	end	True	string	クエリの絶対または相対終了時間。
プロット間隔	intervals	True	integer	タグ値を表示するグラフのピクセル幅。
true の場合、タグ値のプロパティが結果に含められます。	includeProperties		boolean	true の場合、タグ値のプロパティが結果に含められます。

戻り値

Body: HistoricalDataQueryResponsev2

生の値を読み取る

操作 ID:: ias_getdata_raw_v2

タグの生の値をリクエストします。

パラメーター

名前	キー	必須	型	説明
データソース名。	dsn	True	string	データクエリを実行するデータソース名。
クエリのタグ。	tag	True	string	クエリのタグ。
クエリの絶対または相対開始時間。	start	True	string	クエリの絶対または相対開始時間。
クエリの絶対または相対終了時間。	end	True	string	クエリの絶対または相対終了時間。
タグごとに返すポイントの最大数。	points	True	integer	タグごとに返すポイントの最大数。

戻り値

Body: HistoricalDataQueryResponsev2

集計値の読み取り

操作 ID:: ias_getdata_processed_v2

タグの集計値をリクエストします。

パラメーター

名前	キー	必須	型	説明
データソース名。	dsn	True	string	データクエリを実行するデータソース名。
クエリのタグ。	tag	True	string	クエリのタグ。
クエリの絶対または相対開始時間。	start	True	string	クエリの絶対または相対開始時間。
クエリの絶対または相対終了時間。	end	True	string	クエリの絶対または相対終了時間。
データクエリを実行するときに使用するデータ関数/集計。	function	True	string	使用するデータ関数。
クエリのサンプル間隔。	step	True	string	クエリのサンプル間隔。
true の場合、タグ値のプロパティが結果に含められます。	includeProperties		boolean	true の場合、タグ値のプロパティが結果に含められます。

戻り値

Body: HistoricalDataQueryResponsev2

定義

HistoricalDataQueryResponsev2

名前	パス	型	説明
Values	Values	array of object	Values
TagName	Values.TagName	string	タグ名
UtcSampleTime	Values.UtcSampleTime	string	タグ値のサンプル時刻 (UTC)
NumericValue	Values.NumericValue	float	タグの数値
IsNumeric	Values.IsNumeric	boolean	IsNumeric の状態
TextValue	Values.TextValue	string	タグのテキスト値
ステータス	Values.Status	string	タグ値の状態
単位	Values.Unit	string	タグ値の出荷単位
メモ	Values.Notes	string	メモ
エラー	Values.Error	string	タグ値のエラーの詳細
HasError	Values.HasError	boolean	タグ値の HasError の状態

Industrial App Store

Industrial App Store Power Automate コネクタ

前提条件

資格情報の入手方法

コネクタの使用を開始する

既知の問題と制限事項

一般的なエラーと解決策

よくあるご質問

調整制限

アクション

スナップショット値の読み取り

パラメーター

戻り値

タグを取得

パラメーター

戻り値

データ ソースを取得する

戻り値

プロット値の読み取り

パラメーター

戻り値

生の値を読み取る

パラメーター

戻り値

集計値の読み取り

パラメーター

戻り値

定義

HistoricalDataQueryResponsev2

その他のリソース

データソースを取得する