|
|
|
|
The set of fields used in customer or reseller accounts registration forms in Parallels Business Automation - Standard graphical interface is composed with a glance to a typical and widely used scope of data required for personal authorization. These fields allow entering not only an account owner personal data, but also some specific attributes like VAT number. In some cases it is needed to add more attributes to account registration forms.
The API described below allows adding custom attributes to accounts, which results in appearance of new fields in accounts' registration forms. In Parallels Business Automation - Standard, such an additional attributes are called extended attributes. Extended attributes can be added not only to accounts, but also to documents and some other Parallels Business Automation - Standard objects, but this requires a special API. In this document we describe extended attributes usage in accounts, because this kind of customization is mostly in demand among our customers.
Each extended attribute presents a specific data of a particular type (integer, boolean, string) and particular access permissions to this data (read/write, read-only, no access). The type of data defines the type of input field in account registration form (input field, checkbox, etc.).
The API provided allows specifying the type of account (or a particular account) a custom field is to be added, set access permissions for this field (visible or not, editable or read-only).
The set of Accounting plug-ins shipped with Parallels Business Automation - Standard is the example of extended attributes usage. In this case, extended attributes allow adding to accounts profile the data required for Parallels Business Automation - Standard billing to match a country-specific accounting.
The type of object an extended attribute is assigned to (provider account, reseller account, customer account) must be passed on an extended attribute registration.
If needed, you can create a placeholder for a custom extended attribute.