controls コレクションを使用して、列に関連付けられている制御にアクセスします。
列に関連付けられているコントロールに対してアクションを実行する場合は、そのコントロールがページに複数回表示される可能性があることを考慮してください。 一般に、列の各コントロールに対して同じアクションを実行する必要があります。 列コントロール コレクションをループ処理し、各コントロールに対してアクションを実行できます。
たとえば、 name 列にバインドされている各コントロールに通知を追加するには、次のコードを使用します。
const notification = {
messages: ['Sample Notification on Name Controls'],
notificationLevel: 'RECOMMENDATION',
uniqueId: 'my_unique_id'
};
formContext.getAttribute("name").controls.forEach(control =>
control.addNotification(notification)
);
各列はページに複数回表示できるため、コントロール コレクションは、その列を表すすべてのコントロールにアクセスできます。 ページ上の 1 つのコントロールだけが列を表す場合、このコレクションの長さは 1 です。
control getName メソッドを使用する場合、最初のコントロールの名前は列の名前と一致します。 その列のコントロールの 2 番目のインスタンスが <columnName>1。 パターン <columnName>+N は、特定の列のフォームに追加されたコントロールごとに続行されます。
フォームがヘッダーに業務プロセス フロー コントロールを表示すると、業務プロセス フローに表示される各列のコントロールが追加されます。 これらのコントロールには、次のような一意の名前があります: header_process_<column name>。