This commit is contained in:
2022-01-27 18:49:03 +00:00
parent 8b388181e5
commit 56e5fd87a0
3 changed files with 44 additions and 49 deletions

View File

@@ -148,4 +148,4 @@ In addition some notifications can be filtered by tag as required.
### User settings tab
This section is a duplicate of the [User settings](home-user-settings.md) form available to users when they log in. This tab is provided for and Administrator to edit or set up Users in advance.
This section is a duplicate of the [User settings](home-user-settings.md) form available to all logged in users. This tab is provided for and Administrator to edit or set up Users in advance.

View File

@@ -2,10 +2,7 @@
The Customer contacts [form](ay-start-form-overview.md) is used to create and edit Customer contacts in AyaNova.
Customer contacts are used for two purposes
- for reference purposes as a Contact of the Customer each with their own contact information
- as an optional Customer User account that allows the customer contact to login to AyaNova and use the [Customer access](adm-global-settings.md#customer-access-settings) self-service features
Customer contacts are people associated with a Customer or Head office that might need to be contacted by AyaNova users and / or are allowed to log in to AyaNova's [Customer access](adm-global-settings.md#customer-access-settings) self-service features.
## Authorization Roles required
@@ -29,68 +26,62 @@ Read only access
Customer contacts are accessed in the following ways:
- From the `Customers` navigation pane `Customer contacts` item
- By clicking on the [open record icon](ay-start-form-autocomplete.md#opening-selected-record) any Tax code selection list on any other form where Customer contacts can be selected such as the Work order, Quote and Preventive Maintenance forms
- From any [data table](ay-start-form-data-tables.md) column showing Customer contacts such as the [Work order list](svc-workorders.md)
- Contacts for a single Customer are listed in the [Contacts tab](customers.md#Contacts-tab) of the Customer edit form
- All Customer Contacts are listed in the `Customers` navigation pane `Customer contacts` [data table](ay-start-form-data-tables.md) form
## How Customer contacts work
### Adding new Contacts
### Selecting
Customer contacts are selected on [Purchase orders](inv-purchase-orders.md), [Work orders](svc-workorders.md), [Quotes](svc-quotes.md) and [Preventive Maintenance](svc-pms.md) orders to indicate and calculate taxes for both purchase and sales events.
### Locked when used
Tax code Percentages and Tax on Tax fields are **locked** to prevent editing once they are used on another object in order to protect the historical record. Other fields remain editable as they would not affect past record tax calculations.
After an edit and save that affects any of the calculation affecting fields the AyaNova server will check if any objects are using this Tax code and if any are found will prevent the change and report back all object types involved. Options are to remove or switch the Tax code from the existing in-use objects to be able to edit those fields or simply make a new Tax code.
### Retiring
When a tax rate changes a new tax code must be made to replace the previously used tax code with the now outdated rate in order to preserve historical data. The old rate must be "retired" to prevent it from being used in future.
When a tax code is retired it should be set to inactive by un-checking it's Active checkbox and a new active tax code created to take it's place. Setting to inactive prevents it from being selected on new records but still shows it on historical records.
Due to the need to replace customer contacts from time to time and the requirement that Names be unique we recommend customer contacts be named uniquely by appending the year they go into effect or some other system that makes sense for your needs.
### Automatic default
Customer contacts can be set to default automatically (you can still change the default when necessary) in [Global Settings](adm-global-settings.md#default-parts-purchase-tax).
A default tax code can not be deleted unless it is removed as a default first.
### Not required
Customer contacts are optional and not required to be used if they are not appropriate for your situation.
New customer contacts are added through the [Customer form](customers.md) or [Head office form](head-offices.md).
## Customer contacts data table
The Customer contacts [data table](ay-start-form-data-tables.md) lists all the Customer contacts available and provides all data table [common menu options](ay-start-form-data-tables.md#common-menu-options).
## Tax code edit form
## Customer contact edit form
The Tax code edit form contains all the [standard edit form](ay-start-edit-forms.md) functionality and contains the following fields:
### Contact tab
The Customer contact edit form contains all the [standard edit form](ay-start-edit-forms.md) functionality and contains the following fields:
#### Organization
The first field is a read only field showing the Contact's [Customer](customers.md) or [Head office](head-offices.md) account and also provides a link to open that record.
#### Name
This is the name of the rate as it's displayed in forms and reports. A rate name must be unique from all other Customer contacts entered. Remember this is the Name that Customers will see on reports if provided to them.
This is the only required field. Enter the User name here, we recommend `Firstname Lastname` format however as long as it's unique you can enter anything you wish here to identify Users in all areas of the AyaNova user interface.
0000000000000000000000000000000000000000000000000000000000000000000
#### Authorization roles
# CUSTOMER-CONTACT Placeholder
There are only two roles available, the full `Customer` role and the more restricted `Customer - restricted` role.
This works in conjunction with the [Customer access](adm-global-settings.md#customer-access-settings) self-service feature controls to restrict access.
[UNDER CONSTRUCTION]
#### New login name / New password
#b4beta (this is new and should be doccd)
Set or reset the User's login name and password here. Note that the User can also change their own login credentials in their User settings so it's often the case that a temporary set of credentials is set here by the administrator and then the User themselves will use this to login and immediately change their login and password.
This form is used to manage Customer type Users known as "Contacts" in AyaNova.
If this value is changed while a User is actively logged in, it doesn't take effect until the _next_ time they login.
## LOGIN NAME
If you do not provide or set up a login and password this Contact will not have access to log in to AyaNova.
We recommend using the users Email address as their login name
#### Last login
## User Settings
This read only field shows the most recent date and time this Contact logged in.
This section is a duplicate of the [User settings](home-user-settings.md) form and is available to the Contact user to manage their own settings only if enabled under [Global settings](adm-global-settings.md).
#### Active
Note that Tags are not visible to Contact type users anywhere in AyaNova as that is considered private information to be used only by regular AyaNova Users ("Inside" Users - staff) so the Tags section of a Customer Contact form is available only when opened by a inside staff type (non Customer) User with sufficent rights.
The active field controls whether a Contact user is enabled in AyaNova. Inactive Contacts can not log in.
##### Revoking access / locking out Contacts
Only active Contacts can login. If a Contact user is set to inactive their authentication token is immediately revoked and even if they are currently logged in they will be logged out the moment they attempt any operation in AyaNova that needs to connect with the server or when the web application attempts to connect behind the scenes to check for notifications as it periodically does.
This means the moment a Contact user is deactivated and saved they are effectively locked out of AyaNova.
#### Notes / Tags / Wiki / Attached files
Contact users will not see or have access to these features, they are provided for AyaNova administration purposes.
### User settings tab
This section is a duplicate of the [User settings](home-user-settings.md) form available to all logged in users. This tab is provided for and Administrator to edit or set up Contact users in advance.

View File

@@ -8,6 +8,10 @@
The Customer edit form contains all the [standard edit form](ay-start-edit-forms.md) functionality and contains the following fields:
### Contacts tab
(there is a link to here from cust-contacts)
#### Name