Workiva サポートセンター

チェーン内のコマンド入力として使いやすくするために、変数やコマンド出力に変換を適用できます。コマンド入力に対して、そのデータや変換出力をさらに変換するなど、複数の変換を適用できます。

変換

注： JSON出力を他のコマンドのプロパティとして使用する場合、完全なJSON文字列ではなく、出力から特定の要素を選択することができます。完全な文字列ではなく要素を選択した場合は、JSONから値を取得する変換を適用してデータタイプを変換します。

テキストをJSONとして解析する

テキスト変数または出力をJSONに変換するには、[テキストを解析]をJSON変換として適用します。

1. チェーン内で、変換する入力を含むコマンドのノードを選択し、[編集]作成をクリックします。
2. [コマンドプロパティ]で、変換する変数または出力をクリックします。
3. [テキストをJSONとして解析]を選択し、[追加]追加をクリックします。

   注： JSONからも要素を取得するには、JSONから値を取得を選択し、追加追加 をクリックして、追加の変換を適用します。

4. [承認]をクリックします。

文字列の大文字化を更新する

テキスト文字列変数または出力をすべて大文字または小文字に変換するには、大文字または小文字の変換を適用します。

To title-case a text string variable or output or convert its characters to all uppercase or lower-case:-->

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
<!--
2. Select whether to convert the string to Uppercase or Lowercase, and click Add&nbsp;&nbsp;add.
-->
3. 適用する変換を選択します。
   • 文字列の各単語の最初の文字を大文字にするには、[タイトル化]を選択します。
   • 文字列の文字をすべて大文字に変換するには、[大文字]または[キャピタライズ]を選択します。
   • 文字列の文字をすべて小文字に変換するには、[小文字]を選択します。

   注： 文字列を変換するには、適用する追加変換を選択し、追加追加 をクリックします。

4. [承認]をクリックします。

文字列の末尾または先頭のスペースを追加または削除する

テキスト文字列の変数または出力の先頭または末尾にスペースを追加または削除するには、パッドまたはトリム変換を適用します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. 適用する変換を選択し、[ 追加 ] をクリックします。
   • 文字列の開始点にスペースを追加するには、[左パッド]を選択し、文字列の全長を入力します。
   • 文字列の最後尾にスペースを追加するには、[右パッド]を選択し、文字列の全長を入力します。
   • 文字列の開始点からスペースを削除するには、[接頭辞のトリム]を選択します。
   • 文字列の最後尾のスペースを削除するには、[接尾辞のトリム]を選択します。
   • 文字列の開始点と最後尾の両方からスペースを削除するには、[トリム]を選択します。

   注： 文字列出力を変換するには、適用する追加変換を選択し、追加追加 をクリックする。

3. [承認]を選択します。

文字列を分割する

区切り文字の値に基づいてテキスト文字列の変数または出力を分割するには、[分割]変換を適用します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. [分割]を選択し、[追加]addをクリックします。
3. [区切り文字]には、文字列を分割するテキスト値を入力します。

   注： 文字列出力を変換するには、適用する追加変換を選択し、追加追加 をクリックする。

4. [承認]を選択します。

文字列の値を置換する

テキスト変数または出力内の値を別の値に置換するには、[置換]変換を適用します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. [置換]を選択し、[追加]addをクリックします。
3. [検索]で、置換する値の条件を文字列に入力し、一致する正確なテキストまたは正規表現として入力します。
4. [置換]に、[検索]テキストを置き換える値で条件に一致するものを入力します。
5. [一致タイプ]で、完全一致と正規表現（RegEx）のどちらで[検索]条件を検索するかを選択します。

   注： 文字列出力を変換するには、適用する追加変換を選択し、追加追加 をクリックする。

6. [承認]をクリックします。

数の加算、減算、乗算、除算、四捨五入

数値に数学演算を施すには、加算 、減算 、乗算 、除算 、四捨五入 変換を適用します。

ヒント： 数値文字列値に対して数学演算を行うには、まず数値のパース 変換を適用します。

• 加算または減算の変換の場合、数値をどれだけ増減させるかを入力します。
• 乗算または除算の変換の場合、数値をどれだけ掛けたり割ったりするかを入力します。
• 丸め変換の場合、数値を丸める小数の桁数を入力します。

日付またはタイムスタンプを文字列として解析する

日付またはタイムスタンプの変数または出力を特定の形式とタイムゾーンに変換するには、[日付/時刻の解析]変換を適用します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. [日付/時刻の解析]を選択し、[追加]addをクリックします。
3. 国際標準化機構（ISO）の標準を使用するか、日付またはタイムスタンプ付きのカスタム形式を使用するかを選択します。
4. strftime 形式および .、,、: 、または/などの区切り文字を使用して、日付または時刻の値を書式設定する方法を入力します。たとえば、01-30-2020 の場合は%m-%d-%Y、21:08 の場合は%H:%M。
5. 日付またはタイムスタンプのタイムゾーンを変更するには、入力値と出力値のタイムゾーンを選択します。

   注： 文字列出力を変換するには、適用する追加変換を選択し、追加追加 をクリックする。

6. [承認]をクリックします。

日付またはタイムスタンプを加算または減算する

日付またはタイムスタンプの変数または出力に間隔値を加算または減算するには、[日付と時刻の追加/減算]変換を適用します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. 日付と時刻の追加/減算] を選択し、[追加][追加] をクリックします。
3. 国際標準化機構（ISO）の標準を使用するか、カスタム形式を使用するかを選択します。
4. [演算]で、タイムスタンプを[加算]するか[減算]するかを選択します。
5. タイムスタンプに加算または減算する増分（例：1日）を入力します。

   注： タイムスタンプの書式を変更するには、[日付/時刻の解析]を選択し、追加追加 をクリックして追加の変換を適用します。

6. [承認]をクリックします。

リスト内のアイテムを並べ替える

リストの変数または出力の項目を昇順または降順で並べ替えるには、[リストの並べ替え]変換を適用します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. [リストの並べ替え]を選択し、[追加]addをクリックします。
3. リストを昇順と降順のどちらで並べ替えるかを選択します。

   注： リストから文字列要素を選ぶには、「リストから選ぶ」を選択し、「追加」「追加」 をクリックして、追加の変換を適用します。

4. [承認]をクリックします。

リストから要素を選択する

リストの変数または出力から個々の要素を抽出するには、[リストから選択]変換を適用します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. [リストから選択]を選択し、[追加]addをクリックします。
3. [値]には、選択する要素のインデックス番号を入力します。（最初の要素の場合は 0、最後の要素の場合は -1 など。）

   注: 文字列要素を変換するには、適用する追加変換を選択し、追加追加 をクリックします。

4. [承認]をクリックします。

JSONから値を取得する

JSON変数または出力から個々の要素を文字列、リスト、またはJSONに変換するには、JSONから値を取得 変換を適用します。変換を使用する場合、JSON内のリスト内の要素はゼロベースのインデックスを使用し、最初の値のインデックスは0です。

注： 変換で解析する要素のインデックスと名前を決定するには、監視flight_takeoff をクリックし、コマンドのJSON出力を表示します。

1. チェーンで、変換する入力を持つコマンドを選択し、[コマンドプロパティ]で変換する変数または出力をクリックします。
2. [JSONから値を取得]を選択し、[追加]addをクリックします。 
   
3. 要素をテキスト文字列タイトル、リストリスト、JSONコードのどれで出力するかを選択します。
4. [値]に、次のように入力します。
   • JSONに複数のオブジェクトが含まれている場合、抽出元のオブジェクトの0から始まるインデックス。たとえば、2番目のオブジェクトの場合は1を入力します。

     注： JSONに複数のオブジェクトが含まれている場合のみ、インデックスを入力してください。

   • idなど、選択する要素の名前。

   注： 日付文字列の書式やリストのソートなど、変換からの出力を変換するには、適用する追加の変換を選択し、追加追加 をクリックします。

5. [承認]をクリックします。