This commit is contained in:
2022-02-03 18:05:38 +00:00
parent 11aacedb0d
commit a55761788a
5 changed files with 45 additions and 3 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.5 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.4 KiB

View File

@@ -48,15 +48,57 @@ We want the Customer "XYZ Accounting" so we'll click into the Customers [autocom
![Work order walkthrough 3](img/svc-work-order-walk3.png)
You'll notice in the image that there are some Tags ("black, green") also showing with the customer name, this is because we've customize the Customer [autocomplete list template](adm-global-autocomplete-templates.md) to also use Tags for searching and selection.
Since there is only one customer with XYZ in it's name, only one search result came back and is displayed in the list below the autocomplete control. If there were multiple matches, up to 100 of them at a time would be displayed in the results list.
We're using a desktop computer with a keyboard and don't want to take our hands off the keyboard to select with a mouse so we'll press the down arrow to highlight the result "XYZ Accounting..." and press enter to select it:
(There are many ways to search and use the autocomplete list control to speed up entry, all documented in the [autocomplete list](ay-start-form-autocomplete) help page)
You'll notice in the image that there are some Tags ("black, green") also showing with the customer name, this is because we've customize the Customer [autocomplete list template](adm-global-autocomplete-templates.md) to also use Tags for searching and selection. You can change this to include multiple fields as required from the [Customer](customers.md) object.
We're using a desktop computer with a keyboard here and don't want to take our hands off the keyboard to select with a mouse so we'll press the down arrow to highlight the result "XYZ Accounting..." and press enter to select it:
![Work order walkthrough 4](img/svc-work-order-walk4.png)
The Customer is now selected as required by the form validation rules and it no longer displays a red validation error message.
We'll save the work order now as it's valid and
This is a good time to save the Work order to the server.
Currently, you can see it hasn't been saved yet as it does not have a work order serial number displayed and the URL bar shows it's internal record id is zero meaning it has no server provided ID number yet and only exists here in the browser.
![Work order walkthrough 5](img/svc-work-order-walk5.png)
It's good practice to save forms early and often as you work in them because until they are saved, the changes only exist in your browser if something should go wrong at your end with your browser or connection to the network changes made since the last save could be lost.
Let's click on save now:
![Work order walkthrough 6](img/svc-work-order-walk6.png)
This action submits the form to the AyaNova server where it will validate the work order to check for any errors or broken business rules. If errors are found it will not save the record but instead return a list of one or more validation errors to the User to correct the problems. If no errors are found it will update the object in the database.
In this case there are no errors and so a new work order record is created in the database and the server returns a copy of the work order back to the browser. The reason it returns a copy of the work order is because it has itself made some changes to the work order.
AyaNova has assigned this new work order and internal ID number of 104 which you can see in the URL bar which has changed from record 0 to record 104:
![Work order walkthrough 7](img/svc-work-order-walk7.png)
Also you can see in the image that this browser tab now shows the work order serial number assigned which is also 104. This is the page title in the browser and makes it easier to see what record is open in a operating system task bar.
This URL in the web browser is a complete link to this exact work order record in AyaNova so, like any page in AyaNova you can bookmark in your browser this record if desired or send the url link to another User to open this same record (provided they have the rights to do so).
In addition to the record id in the URL, the work order serial number 104 is now displayed in the work order form [app bar](ay-start-form-overview.md#app-bar):
![Work order walkthrough 8](img/svc-work-order-walk8.png)
The work order serial number and it's record id are actually two completely seperate things. The record Id will not necessarily be the same as the work order serial number, it's just worked out that way as the work order serial number [automatic starting seed number](adm-global-seeds.md) has not been changed so record 1 was also serial number 1 etc.
When we selected this Customer it had a [Contract](svc-contracts.md) and the Server automatically applied the Customer's Contract to this work order:
## How to use collections