注意：PI_UFL インターフェイスは、PI Batch File インターフェイスに代わるものです。PI Batch File インターフェイスは、Microsoft 本書では、以下のトピックについて説明します。 設計の概要 インストールと運用の詳細 設定ファイルの仕様 サポートされているコマンドラインパラメーター 注意： Files 詳細については、を参照してください。 参考マニュアル OSIsoft PI Windows Server 2 32 64
なし なし 必要なベンダーハードウェア なし あり デバイスポイントタイプ 該当なし *シリアルベースのインターフェイス あり *それぞれの詳細については、以下を参照してください。 PI_UFL Exception Report（入力値変化テスト） 起動パラメーター： /lb /lbs /rbo Location5 PI PI タイムスタンプのソース ヒストリリカバリ SDK SDK
動作原理 基本的な原理については、の章で簡単に説明しています。この章では、さらに詳しく説明します。 インターフェイスの起動 PI_UFL 以下に/ps PointSource /ps /tm
起動における設定のチェックが完了すると、インターフェイスは続いてデータ処理を行います。 データ処理 PI_UFL PI_UFL 注意：PI_UFL InstrumentTag /f=hh:mm:ss
インストールチェックリスト このチェックリストでは、管理者向けにインターフェイスのインストール時に役立つ情報を提供します。 データ収集ステップ PI インターフェイスノード上でインターフェイスを実行している場合は、PI PI ICU（Interface Configuration インターフェイスのインストールキットを実行します。このキットを実行すると、PI PI PI Server（/Host=host:port） スキャンクラス（/F=##:##:##,offset） 設定ファイル（/cf=<filespec>） API ICU Trust SMT
インターフェイスディレクトリ [PIPC] [PIPC] Files インターフェイスのインストール先ディレクトリ インターフェイスインストールキットは、以下の場所にインターフェイスを自動的にインストールします。 インターフェイスのインストール手順 PI_UFL インターフェイスのセットアッププログラムは、Microsoft Windows UFL_#.#.#.#_.exe PI_UFL インターフェイスのサービスは、手動でも作成できますが、PI Interface Configuration PIHOME
インターフェイスのサービスを手動でインストールする方法 PI_UFL.exe /help Bufservが実装されているPI InterfaceノードまたはPI 手動サービス PI_UFL.exe /install /depend "tcpip bufserv" 自動サービス PI_UFL.exe /install /auto /depend "tcpip bufserv" PI_UFL.exe /serviceid X /install /auto /depend "tcpip,bufserv" Bufservが実装されていないPI InterfaceノードまたはPI 手動サービス PI_UFL.exe /install /depend tcpip 自動サービス PI_UFL.exe /install /auto -depend tcpip PI_UFL.exe /serviceid X /install /auto /depend tcpip
デジタルステート デジタルステートの詳細については、PI デジタルステートセット システムデジタルステートセット PI_UFL Server n System
タグ属性 タグ（Tag） PI 改行やタブなど、制御文字は無効です。 次の文字は無効です。 * ’ ? ; { } [ ] | ` ' " 文字数 PI PI PI 最大文字数 1.6.0.2以降 3.4.370.x以降 1023 1.6.0.2以降 3.4.370.x未満 255 1.6.0.2未満 3.4.370.x以降 255 1.6.0.2未満 3.4.370.x未満 255 API API タグ設定
文字数 PI PI PI Server 最大文字数 1.6.0.2以降 3.4.370.x以降 1023 1.6.0.2以降 3.4.370.x未満 1.6.0.2未満 3.4.370.x以降 32 1.6.0.2未満 3.4.370.x未満 32 文字数 PI PI PI Server 最大文字数 1.6.0.2以降 3.4.370.x以降 1023 1.6.0.2以降 3.4.370.x未満 80 1.6.0.2未満 3.4.370.x以降 80 1.6.0.2未満 3.4.370.x未満 80 パフォーマンスタグ（PERFORMANCE_POINT） float16、float32、float64、int16、int32 上記の値には、 Scan API API API API
Shutdown Shutdown Snapshot 注意： PI Shutdown Shutdown Availability PI 出力タグ PI_UFL インターフェイスは、出力タグをサポートしていません。 15 PIBufss Bufserv
/f=HH:MM:SS /f=SS 必須 1分のスキャンクラスの例：/f=00:01:00 注意：PI_UFL /host=host:port 必須 /hostパラメーターは、PI ServerノードのIPアドレスまたはPI 例： PI Interfaceノード上で動作しているインターフェイスで、PI /host=marvin /host=marvin:5450 /host=206.79.198.30 /host=206.79.198.30:5450 /imt オプション IMT（Ignore Missing /lb オプション LB（LaBoratory）。イベントをPI /lbs オプション LBS（LaBoratory Snapshot）。イベントをPI /perf=# デフォルト値：8時間 オプション /ps=x オプション 使用しているPI APIがバージョン1.6.x未満またはPI Serverノード
/rbo オプション RBO（Read Before /runonce オプション /tm=xxx* または /tm="xxx xxx*" オプション TM（Tag Mask）。 -対象のタグに対してのみ、書き込み操作を限定する場合 タグマスクはPIタグの検索ルールに準拠しており、 ワイルドカード文字として*または?を使用できます。 /utc オプション UTC（Universal Time Coordinated）。 /wd=# オプション WD（Write Delay）。PI /ws=# オプション WS（Write Size）。PI このパラメーターは、PI
IFM IFM（Input File 以下は、サポートされている構文の例を示しています。 IFM = ' または IFM = ' または IFM = 注意：このキーワードは必須です。 Naming Convention）です。 IFS（Input File インターフェイスは、以下の条件に基づいて並べ替えられたデータファイルを読み取ることができます。 作成日（Creation date。デフォルト） IFS=C 変更日（Modification date） IFS=M ファイル名（File Name） IFS=N IFS = N NEWLINE NEWLINE = "event end>" ' または NEWLINE = "STOP" OR "END" OR "EndOfLine"
StopBits = 0 エラーの種類は多岐にわたるので、発生する頻度が高い主なエラーを紹介します。 2 – The system cannot find the file 指定したシリアルポートが存在しない可能性があります。 5 – Access denied（アクセスが拒否されました） – 87 – The parameter is incorrect（パラメーターが正しくありません） – いずれか のポートパラメーターが適切に指定されていません。 [PLUG-IN] – POP3 Socket Layer）通信（POP3S）はサポートされていません。 ATTACHMENT_PREFIX ' 実際の電子メールの行は、以下の行で始まります。 ' [Message Attachment] : ' 4ufl ' … Attachment_Prefix = [Message Attachment]: MAIL_ATTACHMENT
FORWARD_TO Forward_To = FORWARD_AS_UFLSTREAM Forward_As_UflStream = FROM_PREFIX ' 実際の電子メールの行は、以下の行で始まります。 ' [Message From]: ' … From_Prefix = [Message From]: Mail_Attachment = True MAIL_FROM SMTP_PORT SMTP_SERVER true
SMTP_Port = 25 SMTP_Server = mail.osisoft.com SUBJECT_PREFIX ' 実際の電子メールの行は、以下の行で始まります。 ' [Message Subject]: 4ufl ' … Subject_Prefix = [Message Subject]:
[PLUG-IN] – BatchFL ADJUST ADJUST = 60 ALIAS ALIAS = E DATETIME_FORMAT DATETIME_MONTH_FORMAT 詳細については、の項を参照してください。 DATETIME_FORMAT = dd-MMM-yyyy hh:mm:ss DATETIME_MONTH_FORMAT = Jan,Feb,Mar,Apr,May,Jun.Jul,Aug,Sep,Oct,Nov,Dec Tag
LOCALE = "German – Germany" '長い形式 または LOCALE = "de-de" '短い形式 または LOCALE = 1031 'LCID – United MAXLOG MAXLOG = 10 MAXLOGSIZE MAXLOGSIZE = 10 正常に処理されなかった行を格納するファイルの絶対パスを定義します。 MSGINERROR = 20 DateTime
' MSG(1)フィルタの条件を満たすのは、以下の値です。 ' State.City.A.*、State.City.B.*、State.City.C.* ' MSG(2)フィルタの場合は、以下の値です。 ' Plant.Area.Operation.X.*、Plant.Area.Operation.Y.*、 ' Plant.Area.Operation.Z.* [MSG(1)] ' この例では、行がフィルタ条件を満たすのは、 ' 角括弧で囲まれた文字が検出されない場合です。 MSG(1).Filter = C1=="State.City.[!DEF].*" [MSG(2)] MSG(2).Filter = C1=="Plant.Area.Operation.[!OPQ]*" フィールドへのデータ抽出 Field(n).Value = データ抽出 シンプルな割り当て方法によって、メッセージの各部分は個別のフィールドに割り当てることができます。 Field(n) = Cx – Cy Field(n) = Cx – Cy("Mask") Field(n) = Cx – ("Mask") Field(n) = Cx("Mask") – ("Mask") フィールドパターンの評価では、大文字と小文字が区別されます。 y x
ENDIF ENDIF 数学関数 演算子 意味 データタイプオペランド ABS 絶対値 Number ABS(x Number) ACOS, ASIN,ATAN, ATAN2, COS,COSH, SIN,SINH,TAN,TANH 三角関数 戻り値はラジアン単位 Number ACOS(x Number) … Number ATAN2(x Number, y Number) CEILING 最も近い整数に切り上げ Number CEILING(x Number) EXP 指数値 Number EXP(x Number) FLOOR 所定の数式以下で最も大きい整数 Number FLOOR(x Number) LOG,LOG10 対数値 Number LOG(x Number) PI 3.14 Number PI() ROUND 四捨五入 Number ROUND(x Number) 文字列関数 演算子 意味 データタイプオペランド CONCAT 2つの文字列を連結 String CONCAT(x String, y String) INSTR 指定された部分文字列の 特定の出現位置を返却 Int INSTR(x String, substring String, start Int, occurrence Int) LOWER すべての文字を小文字に変換 String LOWER (x String) LEFT 左端からカウント分の文字を返却 String LEFT(x String, n Int) LEN Int LEN (x String) LTRIM 先頭の空白を切り捨て String LTRIM (x String) REPLACE String REPLACE (x String, findWhat String, replaceWith String) RIGHT 右端からカウント分の文字を返却 String RIGHT(x String, n Int) RTRIM 末尾の空白を切り捨て String RTRIM (x String) SPACE String SPACE (n Int) SUBSTR String SUBSTR(x String, start Int, len Int) TRIM 先頭および末尾の空白を切り捨て String TRIM (x String) UPPER すべての文字を大文字に変換 String UPPER (x String)
バッファリング アプリケーション PI TrustのApplication Nameフィールド PI Buffer PIBufss.exe PI Buffer Server APIBE（PI APIが4文字のプロセス名を使用している場合） APIBUF（PI APIが8文字のプロセス名を使用している場合） > [Buffering]を選択します。 [Choose Buffer Type] Name
インターフェイスの診断の設定 スキャンクラスパフォーマンスタグ 注意：PI_UFL 値をスキャンクラスパフォーマンスタグに書き込むには、インターフェイスを再起動する必要があります。 パフォーマンスカウンタータグ サービスまたは対話モードで動作しているときに、PI_UFL インターフェイスが動作していた時間 インターフェイスがタグリストに追加したタグの数 現在更新中のタグの数 Class Performance Monitor Monitor Interface」を参照してください。 パフォーマンスカウンター
(_Total)専用のパフォーマンスカウンター 「デバイスの実接続数」 (.Device_Actual_Connections) 「デバイスの想定接続数」 (.Device_Expected_Connections) 「デバイスステータス」 (.Device_Status) 「インターフェイス動作時間（秒）」 (.up_time) 「ログファイルメッセージ数」 (.log_file_msg_count) (PI_Status) 50
「30（分）更新のなかったタグ」 (.Points_Stale_30min) 「60（分）更新のなかったタグ」 (.Points_Stale_60min) 「240（分）更新のなかったタグ」 (.Points_Stale_240min) (Scan Class x)専用のパフォーマンスカウンター 「デバイススキャン時間（ミリ秒）」 (.Device_Scan_Time) Class 1)」を含むタグ（たとえば、 「sy.perf.etamp390.E1 (Scan Class 1).device_scan Class 1、同様に「(Scan Class Class 「スキャン時間（ミリ秒）」 (.scan_time) Class 1)」を含むタグ（たとえば、 「sy.perf.etamp390.E1(Scan Class Class 1、同様に「(Scan Class Class
PI_UFL 古いパラメーター名 新しいパラメーター名 場所/備考 新しい起動パラメーター /am BATファイル バージョン3.0.3以降 /cf=xxx.yyy 変更なし /db deb=n /des 変更なし 新しい起動パラメーター /disablecounters BATファイル バージョン3.0.3以降 新しい起動パラメーター /ec BATファイル。 バージョン3.0.3以降 /err err 変更なし /host=host 変更なし /id サポート対象から除外 Message
[Unregister BatchFL Interface (Recommended)]チェックボックスがオフの場合 このチェックボックスをオフにした場合、BatchFL この場合の結果は、以下のとおりです。 BatchFL 両方が同じデータソースファイルを要求して競合し、 BatchFL BatchFL BatchFL インターフェイスのインスタンスが時系列外データに依存している場合、PI_UFL
記号 記号 ASCII 記号 ASCII 記号 0 NUL 32 (space) @ 96 ` 1 SOH 33 ! 65 A 97 a 2 STX 34 “ 66 B 98 b 3 ETX 35 # 67 C 99 c 4 EOT 36 $ 68 D 100 d 5 ENQ 37 % 69 E 101 e 6 ACK 38 & 70 F 102 f 7 BEL 39 ‘ 71 103 g 8 BS 40 ( 72 H 104 h 9 TAB ) 73 I 105 i 10 LF 42 * 74 J 106 j 11 VT 43 + 75 K 107 k 12 FF 44 , 76 L 108 l 13 CR 45 - 77 M 109 m 14 SO 46 . 78 N 110 n 15 SI 47 / 79 O 111 o DLE 48 0 80 P 112 p 17 DC1 49 1 81 Q 113 q 18 DC2 2 82 R 114 r 19 DC3 3 83 S 115 s 20 DC4 52 4 84 T 116 t 21 NAK 53 5 85 U 117 u 22 SYN 54 6 86 V 118 v 23 ETB 55 7 87 W 119 w 24 CAN 56 8 88 X 120 EM 57 9 89 Y 121 y 26 SUB 58 : 90 Z 122 z 27 ESC 59 ; 91 [ 123 { FS 60 < 92 124 | 29 GS 61 = 93 ] 125 } RS 62 > 94 ^ 126 ~ 31 US 63 ? 95 _ 127
改訂履歴 日付 執筆者 コメント 2006年12月 MFreitag PI_UFLバージョン3.0マニュアルドラフト 2007年3月 MFreitag PI_UFLバージョン3.0.0.29用マニュアルのレビュー 2007年3月16日 Janelle 2007年3月30日 MFreitag 2007年6月7日 バージョン3.0.0.31 2007年6月27日 MFreitag 2007年7月17日 MFreitag 2007年7月30日 MKelly 2007年9月5日 MFreitag サポートされているOSのリストを更新 2008年3月 MFreitag バージョン3.0.1.13 – 2008年7月 MFreitag POP3プラグイン 2008年7月23日 Janelle 2008年7月 MFreitag 2008年7月31日 Janelle 2009年5月20日 MFreitag 2009年6月15日 MKelly 2009年6月18日 MKelly 2009年6月19日 MFreitag 目次を再作成 2009年6月19日 MKelly バージョン3.0.3.16、リビジョンD：PI Tag