データを組み立て
基本概念
-
文字列組み立て
複数のテキストまたはデータポート内容を、特定の区切り文字を使用して1つの文字列に結合します。主にテキストプロトコルやメッセージ本文の組み立てに使用されます。
-
バイトストリーム組み立て
入力データを指定したバイト順序に従って連続したバイナリストリームへパッケージ化します。通信や低レベルデータインタラクションで広く使用されます。
-
カスタム入力ポート
組み立てステップ用のデータ入力インターフェースを指します。各ポートには、名前、データ型、位置などのプロパティを設定でき、データ組み立て順序や形式を柔軟に制御できます。
使用フロー
このステップの使用フローは以下の通りです。
-
組み立て要件に応じて 組み立て方法 を選択します(文字列組み立てまたはバイト組み立て)。
-
入力ポートを設定します。カスタム入力 の関連パラメータを使用して、組み立て対象データポートを追加し、各ポートの ポート名 と データ型 を指定します。
-
文字列組み立て を選択した場合は、区切り文字などのテキストルールをさらに設定します。
-
バイト組み立て を選択した場合は、バイト順、開始位置、バイト長 などのデータストリーム組み立てルールを設定します。
-
-
設定完了後、ステップを実行し、組み立て後のデータを出力します。
パラメータ説明
| パラメータ | 説明 |
|---|---|
組み立て方法 |
データの組み立て方法を指定します。 オプション:
初期値:文字列組み立て 必要なデータ出力形式に応じて適切な組み立て方法を選択することを推奨します。例えば、通信プロトコルでバイナリパッケージ化が必要な場合は「バイト組み立て」を選択し、テキスト結合シーンでは「文字列組み立て」を選択してください。 |
文字列組み立て
| パラメータ | 説明 |
|---|---|
区切り文字 |
組み立てデータ内で複数の入力ポートデータを区切るために使用します。 オプション:
初期値:カンマ(,) 実際の使用シーンに応じて適切な区切り文字を選択することを推奨します。 |
カスタム入力 |
新しい入力ポートを追加し、データ組み立てルールを設定できます。 組み立て対象の数や種類に応じてポートを追加し、後続処理や識別がしやすいよう適切に命名することを推奨します。 |
ポート名 |
カスタム入力ポート名を指定するために使用します。 実際の状況に応じて、可読性が高くデータ内容に関連する名称を設定することを推奨します。 |
データ型 |
入力ポートのデータ型を指定するために使用します。 オプション:
初期値:文字列 実際の入力データ型に応じて選択することを推奨します。特にテキスト組み立てシーンでは、文字列型を優先して選択してください。 |
バイト組み立て
| パラメータ | 説明 |
|---|---|
バイト順 |
複数バイトデータのバイトストリーム内での並び順を指定します。 オプション:
初期値:ABCD(ビッグエンディアン) 下流通信機器またはソフトウェア要件に応じてバイト順を選択してください。不明な場合は、プロトコル仕様書を参照するか、テクニカルサポートまでお問い合わせください。 |
カスタム入力 |
新しい入力ポートを追加し、データ組み立てルールを設定できます。各入力ポートのデータは、設定ルールに従って組み立てられます。 バイト組み立て対象の数や内容に応じてポートを追加し、バイト構造の整合性を確保できるよう、ポートプロパティを慎重に設定することを推奨します。 |
ポート名 |
カスタム入力ポート名を指定するために使用します。 データ内容に応じたポート名を設定し、識別や後続解析処理を容易にすることを推奨します。 |
データ型 |
入力ポートのデータ型を指定するために使用します。 オプション:
初期値:Char8 実際の要件に応じて適切なデータ型を選択してください。設定を誤ると、組み立て結果や後続のデコード解析結果にずれが発生する可能性があります。 |
開始位置 |
現在の入力ポートデータがバイトストリーム内で開始するバイト位置を指定するために使用します。開始位置 と バイト長 によって、組み立て時に占有されるバイト範囲が決定されます。 開始位置とバイト長が重複しないようにし、かつバイトストリーム全体を適切にカバーできるよう、事前にバイト構造を設計することを推奨します。 |
バイト長 |
在のデータフィールドがバイトストリーム内で占有するバイト数を指定するために使用します。 通常はデータ型に応じて自動設定される長さを使用することを推奨します。手動変更する場合は、データが範囲外になったり欠落したりしないよう注意してください。 |
トラブルシューティング
|