プリザンターでセクション(見出し)の制御をサーバスクリプトでおこなう方法

はじめに

今回はセクション(見出し)をサーバスクリプトでコントロールする方法を紹介します。

実装してみる

フィールド名の特定

マニュアルに記載のあるsiteSettings.Sectionsを使ってコントロールをおこないます。マニュアルに記載はないのですが、配列で指定する添字は0から始まります。フィールド自体のIDは使用されておらず編集画面の上から順に0,1,2･･･と連番になります。

使用出来るプロパティ

プロパティ	値型	説明
Id	int	セクションID
LableText	string	表示名
AllowExpand	bool	セクションを展開可能にするかどうか
Expand	bool	セクションを開く・閉じる
Hide	bool	セクションを非表示にする ※マニュアルに記載なし

マニュアルに記載のないHideが使えるというのがポイントです。

使用出来るメソッド

それぞれを一括で設定するUpdateもあります。こちらもマニュアルには記載がありません。

siteSettings.Sections[index].Update(
   id,
   labelText,
   allowExpand,
   expand,
   hide
)

idには必ず値をセットする必要がありますが、これは変更しない方が望ましい要素になります。また、変更する必要がない項目にはnullをセットします。これらをふまえた使用例は次の様になります。

siteSettings.Sections[0].Update( //インデックスを指定する
   siteSettings.Sections[0].Id, //Idは現状のものをそのままセットする
   '変更後フィールド名',
   null, //変更する必要のない項目はnullをセットする
   true,
   false
);

まとめ

今回はセクションの制御をおこなう方法を紹介しました。マニュアルに記載がないけど使えるプロパティ・メソッドがあるので、是非活用してみてください。