データを組み立て

現在ご覧いただいているのは最新版の内容です(V2.2.1)。異なるバージョンを参照する場合は、画面右上のボタンから切り替えが可能です。

■ ご利用中のバージョンが分からない場合や、サポートが必要な場合はお気軽にサポート窓口までご連絡ください。

機能

入力データを文字列またはバイトストリームとして組み立てることができます。カスタム通信シーンに適しています。

使用シーン

複数のデータソースを特定ルールに従って結合またはパッケージ化する必要がある場合に適しています。特に、カスタム通信プロトコル、データ転送、または下流処理向けデータパッケージ化で使用されます。通常、データ取得、データ処理、および通信インターフェース間の中間組み立て処理として使用されます。また、データを解析データを送信 などのステップと組み合わせて使用できます。

基本概念

  • 文字列組み立て

    複数のテキストまたはデータポート内容を、特定の区切り文字を使用して1つの文字列に結合します。主にテキストプロトコルやメッセージ本文の組み立てに使用されます。

  • バイトストリーム組み立て

    入力データを指定したバイト順序に従って連続したバイナリストリームへパッケージ化します。通信や低レベルデータインタラクションで広く使用されます。

  • カスタム入力ポート

    組み立てステップ用のデータ入力インターフェースを指します。各ポートには、名前、データ型、位置などのプロパティを設定でき、データ組み立て順序や形式を柔軟に制御できます。

使用フロー

このステップの使用フローは以下の通りです。

  1. 組み立て要件に応じて 組み立て方法 を選択します(文字列組み立てまたはバイト組み立て)。

  2. 入力ポートを設定します。カスタム入力 の関連パラメータを使用して、組み立て対象データポートを追加し、各ポートの ポート名データ型 を指定します。

    • 文字列組み立て を選択した場合は、区切り文字などのテキストルールをさらに設定します。

    • バイト組み立て を選択した場合は、バイト順開始位置バイト長 などのデータストリーム組み立てルールを設定します。

  3. 設定完了後、ステップを実行し、組み立て後のデータを出力します。

入力説明

固定入力項目はありません。このステップでは、「カスタム入力」パラメータを使用して入力ポートを動的に追加します。ユーザーは実際の要件に応じて複数の入力データを設定できます。

パラメータ説明

パラメータ 説明

組み立て方法

データの組み立て方法を指定します。

オプション:

  • 文字列組み立て: 複数の入力ポートデータを、区切り文字で区切られた1つの文字列として組み立てます。テキストプロトコルに適しています。

  • バイト組み立て: 複数の入力ポートデータを1つのバイトストリームとして組み立てます。バイナリ通信プロトコルに適しています。

初期値:文字列組み立て

必要なデータ出力形式に応じて適切な組み立て方法を選択することを推奨します。例えば、通信プロトコルでバイナリパッケージ化が必要な場合は「バイト組み立て」を選択し、テキスト結合シーンでは「文字列組み立て」を選択してください。

文字列組み立て

パラメータ 説明

区切り文字

組み立てデータ内で複数の入力ポートデータを区切るために使用します。

オプション:

  • ,:カンマでテキストデータを区切ります。

  • ;:セミコロンでテキストデータを区切ります。

  • _:アンダースコアでテキストデータを区切ります。

  • スペース:スペースでテキストデータを区切ります。

初期値:カンマ(,)

実際の使用シーンに応じて適切な区切り文字を選択することを推奨します。

カスタム入力

新しい入力ポートを追加し、データ組み立てルールを設定できます。

組み立て対象の数や種類に応じてポートを追加し、後続処理や識別がしやすいよう適切に命名することを推奨します。

ポート名

カスタム入力ポート名を指定するために使用します。

実際の状況に応じて、可読性が高くデータ内容に関連する名称を設定することを推奨します。

データ型

入力ポートのデータ型を指定するために使用します。

オプション:

  • 文字列: 入力ポートが文字列型です。

  • 数値: 入力ポートが数値型です。

初期値:文字列

実際の入力データ型に応じて選択することを推奨します。特にテキスト組み立てシーンでは、文字列型を優先して選択してください。

バイト組み立て

パラメータ 説明

バイト順

複数バイトデータのバイトストリーム内での並び順を指定します。

オプション:

  • ABCD(ビッグエンディアン): 上位バイトを先頭に配置します。ビッグエンディアン通信プロトコルに適しています。

  • DCBA(リトルエンディアン): 下位バイトを先頭に配置します。リトルエンディアン通信プロトコルに適しています。

  • CDAB: カスタム順序です。特殊な通信シーンに適しています。

  • BADC: カスタム順序です。特殊な通信シーンに適しています。

初期値:ABCD(ビッグエンディアン)

下流通信機器またはソフトウェア要件に応じてバイト順を選択してください。不明な場合は、プロトコル仕様書を参照するか、テクニカルサポートまでお問い合わせください。

カスタム入力

新しい入力ポートを追加し、データ組み立てルールを設定できます。各入力ポートのデータは、設定ルールに従って組み立てられます。

バイト組み立て対象の数や内容に応じてポートを追加し、バイト構造の整合性を確保できるよう、ポートプロパティを慎重に設定することを推奨します。

ポート名

カスタム入力ポート名を指定するために使用します。

データ内容に応じたポート名を設定し、識別や後続解析処理を容易にすることを推奨します。

データ型

入力ポートのデータ型を指定するために使用します。

オプション:

  • Float32: 4バイト浮動小数点数。

  • Int16: 2バイト整数。

  • Int32: 4バイト整数。

  • Char8: 1バイト文字。

初期値:Char8

実際の要件に応じて適切なデータ型を選択してください。設定を誤ると、組み立て結果や後続のデコード解析結果にずれが発生する可能性があります。

開始位置

現在の入力ポートデータがバイトストリーム内で開始するバイト位置を指定するために使用します。開始位置バイト長 によって、組み立て時に占有されるバイト範囲が決定されます。

開始位置とバイト長が重複しないようにし、かつバイトストリーム全体を適切にカバーできるよう、事前にバイト構造を設計することを推奨します。

バイト長

在のデータフィールドがバイトストリーム内で占有するバイト数を指定するために使用します。

通常はデータ型に応じて自動設定される長さを使用することを推奨します。手動変更する場合は、データが範囲外になったり欠落したりしないよう注意してください。

出力説明

出力項目 説明

組み立て後のデータ

各入力ポートのデータを、指定した方式に従って組み立てた後に生成される出力データです。

トラブルシューティング

  • 各ステップで共通のエラーコードについては、エラーコード一覧 をご参照ください。

  • エラーコードとエラーメッセージが一致しない場合は、テクニカルサポートにお問い合わせください。

この情報は役に立ちましたか?

ご意見・ご要望がございましたら、以下よりお寄せください:

Mech-Mindは、お客様のプライバシーを重視しています

このサイトでは最高の体験を提供するために Cookie を使用しています。サイトの閲覧を続ける場合、Cookie の使用に同意したことになります。「拒否する」を選択すると、このサイトを訪れた際に追跡や記憶が行われないように単独の Cookie が使用されます。