Encode Component

この関数は、文字列のすべての特殊文字を、URLで使用できるようにエンコードされたテキスト文字列にエンコードします。

以前のステップで得られた値を返すURLを構築する場合は、この関数を使用してその値をエンコードできます。

エンコードする入力が複数ある場合は、Encode Query関数カードを使用してください。この関数は、オブジェクトを使用して単一のエンコードされたクエリ文字列を構築します。

入力

フィールド	定義	タイプ	Required (必須)
text（テキスト）	エンコードするテキスト文字列。	テキスト	TRUE

出力

フィールド	定義	タイプ
output（出力）	エンコードされたテキスト。	テキスト

区切り記号と特殊文字

APIリクエストを実行する際には、サーバーが特殊文字を正確に解釈するようにそれらの文字をエンコードすることが不可欠です。ただし、URLで使用される区切り記号はエンコードしないでください。

特殊文字には、スペース、句読点、非ASCII文字が含まれます。これらの文字を適切にエンコードしないと、URLに問題が生じる可能性があります。

区切り記号はURL構造の不可欠な部分であるため、エンコードしないでください。クエリ文字列の?区切り記号はURL内のリテラル文字です。この区切り記号を使用することで、Webサーバーはパスの終了位置とクエリ文字列の開始位置を認識できます。

「特殊文字と区切り記号」を参照してください。

例

入力がSherlock Holmes: Detectiveなら、エンコードされた出力はSherlock%20Holmes%3A%20Detectiveです。

次に、Format関数を使用して完全なURLを構築できます。エンコードされた出力をhttps://www.example.com/searchcustomers?name=に追加すると、https://www.example.com/searchcustomers?name=Sherlock%20Holmes%3A%20Detectiveという完全なURLが得られます。

関連項目

関数

Workflows要素

特殊文字と区切り記号