Skip To Content

UDP ソケットからテキストを受信

UDP ソケットからテキストを受信入力コネクタを使用すると、区切りテキストとして書式設定されたイベント データを UDP ソケット接続で受信して適合させることができます。 属性値間の区切り文字は一般的にカンマ (,) であるため、このタイプのデータはカンマ区切り値と呼ばれることもあります。 ArcGIS GeoEvent Server では、印刷可能な ASCII 文字を区切り記号として使用し、データ属性値を区切ることができます。

ポート 5565 の UDP クライアントに送信された区切りテキスト

使用上の注意

UDP ソケットからテキストを受信入力コネクタを使用する際には、以下の点に注意してください。

  • この入力コネクタは、テキスト インバウンド アダプターと UDP インバウンド トランスポートをペアにします。
  • この入力コネクタは、サーバー コンピューターを表示できる任意の UDP クライアントから区切りテキストを受信し、指定した UDP ソケット ポートに接続するために使用します。
  • デフォルトでは、コネクタはポート [5000] に UDP ソケットを開きますが、使用可能なサーバー ポートであればどれでも使用できます。
  • 複数の [UDP ソケットからテキストを受信] 入力を構成できますが、それぞれの入力に対して一意のポートを指定する必要があります。
  • 複数の UDP クライアント アプリケーションを接続し、構成された単一の入力に同時にデータを送信できます。
  • [メッセージの区切り記号] パラメーターは必須です。 この記号は、イベント レコードの末尾を指定します。 一般的なレコード末尾区切り文字は、改行 (\n) です。
  • [属性の区切り記号] パラメーターは必須です。 この記号は属性値を区切ります。 一般的な属性区切り記号は、カンマ (,) です。
  • UDP データグラムは通常、コンパクトなメッセージであるため、クライアント アプリケーションはメッセージの間にメッセージ区切り記号を含めないことがあります。 [各メッセージに追加する文字] パラメーターを使用すると、受信したメッセージごとに暗黙的なメッセージ区切り記号を付加することができます。
  • [ソース IP をメッセージに追加] パラメーターを [はい] に設定すると、クライアント アプリケーションの IP アドレスとポートがデータグラム (メッセージ) に付加されます。 [ソース IP の接頭辞の文字] パラメーターに指定された文字が [属性の区切り記号] パラメーターに指定された文字と同じである場合、このコネクタは、付加された IP とポートを文字列の属性値と見なします。 各データグラムに付加されるデータに対応する属性フィールドが ジオイベント定義に含まれていることを確認します。
  • 受信した区切りデータ文字列の最初の属性を使用し、ジオイベント定義の名前を指定することがあります。 これは、さまざまな属性データ タイプを含むデータグラムや複数のデータ属性を含むデータグラムを受信することが想定されている場合に便利です。受信したデータ値を解釈するためにコネクタが使用するジオイベント定義は、そのデータ自体が指定します。 この機能を利用するには、[受信データにジオイベント定義が含まれる] パラメーターを使用します。 通常、特定のソケットで受信したすべてのデータ レコードのスキーマは同じになるため、このパラメーターを [いいえ] (デフォルト) に設定する必要があります。

パラメーター

UDP ソケットからテキストを受信入力コネクタのパラメーターを次に示します。

パラメーター説明

名前

GeoEvent Manager で参照用として使用される入力コネクタの記述名。

デフォルト空間参照

座標値が、想定されている WGS84 地理座標系システムの緯度と経度の値ではない属性フィールド値をもとにジオメトリを作成するか、受信したジオメトリ文字列に空間参照が含まれない場合に使用される空間参照の Well-Known ID (WKID)。 WKID または Well-Known Text (WKT) を含む属性フィールドの WKT 値または名前が指定されることもあります。

サーバー ポート

UDP ソケットを確立する際に使用するサーバー ポート。 UDP クライアントは、このポートを検出し、接続する必要があります。 デフォルト ポートは [5000] ですが、使用可能なサーバー ポートであればどれでも使用できます。

ソース ID をメッセージに追加

トランスポートが、UDP データグラムをデータグラム (メッセージ) に送信したコンピューターの IP アドレスを付加する必要があるかどうかを指定します。 [ソース IP の接頭辞の文字] パラメーターが [属性の区切り記号] と同じ文字である場合、アダプターは付加された IP とポートを追加の文字列の属性値として解釈します。 ジオイベント定義に、各データグラムに付加されるデータに対応する属性フィールドが含まれていることを確認します。

  • [はい] – 受信した各イベント レコードに、クライアントがメッセージの送信に使用する IP アドレスとポートが付加されます。
  • [いいえ] – 受信した各イベント レコードに、クライアントの IP アドレスとポートの値は付加されません。

ソース IP の接頭辞の文字

(条件)

トランスポートが各 UDP データグラムに付加した IP アドレスとポート番号を分離するために使用する、単一の文字リテラル。 通常、メッセージの主要属性値の属性の区切り記号と同じ文字が使用されるため、IP アドレスとポートは新しい属性として付加されます。ただし、IP アドレスとポート値を、別の区切り記号を使用して最後の文字列値に結合できます。

このパラメーターは、[ソース IP をメッセージに追加][はい] に設定されている場合は表示され、[ソース IP をメッセージ定義に追加][いいえ] に設定されている場合は非表示になります。

各メッセージに追加する文字

メッセージの未加工バイト配列がアダプターに送信される前に、トランスポートが各 UDP データグラムに付加するリテラル文字。 UDP データグラムは、通常はコンパクトなメッセージであり、クライアント アプリケーションはメッセージの間に区切り記号を含めないことがあります。 ただし、アダプターでイベント データ レコードの末尾を示すにはメッセージの区切り記号が必要であるため、ブロードキャストしている UDP クライアントにメッセージの区切り記号が含まれていない場合は、このパラメーターで定義する必要があります。

バッファー サイズ (バイト)

ブロードキャストしている UDP クライアント アプリケーションから取得する未加工バイトを保持するために、トランスポートが割り当てるバッファー サイズを指定します。 デフォルト値は [2048] バイトです。 バッファーは、IP ヘッダー、UDP ヘッダー、属性データ値、データとして受信するジオメトリの文字列表現、および受信したメッセージに付加されるデータに対応できるだけの大きさである必要があります。

メッセージの区切り記号

イベント データ レコードの末尾を表す文字リテラル。 区切り文字を指定するには、Unicode 値が使用されることがあります。 文字は引用符で囲んではなりません。 一般的なレコード末尾区切り文字は、改行 (\n) です。

属性の区切り記号

メッセージ内で属性値を区切るために使われるリテラル記号。 区切り文字を指定するには、Unicode 値が使用されることがあります。 文字は引用符で囲んではなりません。 一般的な属性区切り記号はカンマです。

受信データにジオイベント定義が含まれる

区切られたテキスト行の最初の属性値を、ジオイベント定義の名前として使用するかどうかを指定します。 詳細については、上の「使用上の注意」をご参照ください。

  • [はい] – 各イベント レコードの属性フィールドが、ジオイベント定義 (既存または新規) の名前になります。
  • [いいえ] – すべてのイベント レコードは共通のスキーマを持つため、1 つのジオイベント定義を共有します。 各イベント レコードの最初の属性フィールドは、ジオイベント定義の名前ではなく、センサー データです。

認識されていないイベント定義の作成

(条件)

指定した名前のジオイベント定義が存在しない場合に、新しいジオイベント定義を作成する必要があるかどうかを指定します。 区切りテキスト ファイルに異なるタイプのセンサーからのイベント レコードが含まれる場合、最初の属性値を使用してイベントのタイプを指定します。この属性値がジオイベント定義名として使用されます。

  • [はい] – 指定した名前のイベント定義が存在しない場合に、新しいジオイベント定義が作成されます。
  • [いいえ] – 新しいジオイベント定義は作成されません。 対応するジオイベント定義のないインバウンド イベント データは適合されず、処理されません。

このパラメーターは、[受信データにジオイベント定義が含まれる][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

ジオイベント定義の作成

(条件)

インバウンド イベント データに新しいジオイベント定義を使用するか、既存のジオイベント定義を使用するかを指定します。 GeoEvent Server がインバウンド データ属性フィールドおよびデータ タイプを理解するには、ジオイベント定義が必要です。

  • [はい] – 最初に受信したイベント レコードのスキーマに基づき、新しいジオイベント定義が作成されます。
  • [いいえ] – 新しいジオイベント定義は作成されません。 インバウンド イベント データのスキーマに一致する、既存のジオイベント定義が選択されます。

このパラメーターは、[受信データにジオイベント定義が含まれる][いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。

ジオイベント定義名 (新規)

(条件)

新しいジオイベント定義に与えられる名前。 指定した名前を持つジオイベント定義がすでに存在する場合、既存のジオイベント定義が使用されます。 最初に受信したデータ レコードを使用し、後続のデータ レコードで予期されるスキーマを決定します。新しいジオイベント定義は、最初のデータ レコードのスキーマに基づいて作成されます。

このパラメーターは、[ジオイベント定義の作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

ジオイベント定義名 (既存)

(条件)

受信したデータを適合して、GeoEvent Service によって処理されるイベント データを作成する際に使用する、既存のジオイベント定義の名前。

このパラメーターは、[ジオイベント定義の作成][いいえ] に設定されている場合に表示され、[はい] に設定されている場合は非表示になります。

フィールドからジオメトリを作成

入力コネクタが、属性として受信した座標値を使用してポイント ジオメトリを作成するかどうかを指定します。 デフォルトは [いいえ] です。

  • [はい] – 指定したイベント属性の値を使用し、ポイント ジオメトリを作成します。
  • [いいえ] – ポイント ジオメトリは作成されません。 属性フィールドには、ジオメトリとして解釈される値が含まれているか、イベント レコードが非空間である (ジオメトリがない) と想定されます。

X ジオメトリ フィールド

(条件)

ポイント位置の X 座標部 (水平や経度など) を含むインバウンド イベント データの属性フィールド。

このパラメーターは、[フィールドからジオメトリを作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

Y ジオメトリ フィールド

(条件)

ポイント位置の Y 座標部 (垂直や緯度など) を含むインバウンド イベント データの属性フィールド。

このパラメーターは、[フィールドからジオメトリを作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

Z ジオメトリ フィールド

(条件)

ポイント位置の Z 座標部 (深さや高度など) を含むインバウンド イベント データのフィールド名。 空白のままにすると、Z 値が省略されて、2D ポイント ジオメトリが作成されます。

このパラメーターは、[フィールドからジオメトリを作成][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。

推定される日付形式

日付時間値として予期される文字列表現を一致させ、それを Java Date 値に変換するために使用されるパターン。 パターンの形式は、Java SimpleDateFormat クラス変換に従います。

GeoEvent Server では、日付/時間値を ISO 8601 標準で表すことを推奨していますが、日付値として一般的に認識されている日付/時間値の文字列表現のいくつかは、[推定される日付形式] パターンを指定しなくても Java Date 値に変換することができます。 これらには以下のものが含まれます。

  • "2019-12-31T23:59:59" – ISO 8601 標準形式
  • 1577836799000 – Java Date (紀元からの時間を示す Long 型整数、UTC)
  • "Tue Dec 31 23:59:59 -0000 2019" – 一般的な Web サービス文字列形式
  • "12/31/2019 11:59:59 PM" – 米国で使用される一般的な形式 (12 時間形式)
  • "12/31/2019 23:59:59" – 米国で使用される一般的な形式 (24 時間形式)

受信した日付/時間の値が、上記の 5 つ以外の形式で表される場合は、GeoEvent Server が日付/時間値を適合する方法を把握できるよう、推定される日付形式パターンを指定する必要があります。

数値形式の言語

データ値から数値を書式設定する際、ロケール依存型の動作に使用されるロケール識別子 (ID)。 デフォルトは、GeoEvent Server がインストールされているコンピューターのロケールです。 詳細については、「Java Supported Locales」をご参照ください。

マルチキャスト モード

内部ネットワークから対象受信者のグループにルーティングされるメッセージを受信するため、入力コネクタがマルチキャスト グループに参加する必要があるかどうかを指定します。 デフォルトは [いいえ] です。

  • [はい] – 入力コネクタは、特定のグループ アドレスにルーティングされたマルチキャスト パケットを受信します。
  • [いいえ] – 入力コネクタは、ユニキャスト (ポイントツーポイントなど) レシーバーとしてのみ動作します。 メッセージは、GeoEvent Server を実行するサーバー コンピューター上で UDP ソケットを確立するよう指定されたサーバー ポートにブロードキャストする必要があります。

マルチキャスト グループ

(条件)

マルチキャスト モード時に入力コネクタが参加するグループ アドレスを入力します。 入力コネクタは、このグループ アドレスに送信されたパケットを受信します。 IP アドレス範囲 239.x.x.x は、単一のローカル エリア ネットワーク内での組織固有の管理用として、RFC 2365 で予約されています。

このパラメーターは、[マルチキャスト モード][はい] に設定されている場合に表示され、[いいえ] に設定されている場合は非表示になります。


このトピックの内容
  1. 使用上の注意
  2. パラメーター