setParametersAsJSON(jsonString)

署名

public void setParametersAsJSON(String jsonString)

パラメータ

jsonString

型: String

設定する必要があるカスタムパラメータ (JSON 形式の文字列に逐次化される)。

戻り値

型: Void

使用方法

このメソッドを使用して、キャンバスアプリケーションの現在のカスタムパラメータを設定します。パラメータは JSON 文字列で指定する必要があります。System.JSON.serialize(objectToSerialize) メソッドを使用して、対応付けを JSON 文字列に逐次化できます。

カスタムパラメータを設定すると、現在の要求に設定されているカスタムパラメータが上書きされます。現在のカスタムパラメータを変更する必要がある場合、まず getParametersAsJSON() を使用して現在のカスタムパラメータのセットを取得し、必要に応じて、取得したパラメータセットを変更します。次に、変更したこのセットを setParametersAsJSON() へのコールで使用します。

指定された JSON 文字列が 32KB を超えると、System.CanvasException が発生します。

例

この例では、現在のカスタムパラメータを取得し、「TESTVALUE」の値で新しい newCustomParam パラメータを追加して、現在のカスタムパラメータを設定します。

1Canvas.EnvironmentContext env = renderContext.getEnvironmentContext();
2
3// Get current custom params
4Map<String, Object> previousParams = 
5    (Map<String, Object>) JSON.deserializeUntyped(env.getParametersAsJSON());
6
7// Add a new custom param
8previousParams.put('newCustomParam','TESTVALUE');
9
10// Now replace the parameters with the current parameters plus our new custom param
11env.setParametersAsJSON(JSON.serialize(previousParams));