Na2009 enus devii_03
Upcoming SlideShare
Loading in...5
×

Like this? Share it with your network

Share
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
No Downloads

Views

Total Views
1,363
On Slideshare
1,363
From Embeds
0
Number of Embeds
0

Actions

Shares
Downloads
22
Comments
0
Likes
1

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide

Transcript

  • 1. Chapter 3: RegistrationsCHAPTER 3: REGISTRATIONSObjectives The objectives are: • Import and export objects as text files. • Support multilanguage functionality. • Use main and subpages (document pages). • Use virtual tables. • Use temporary tables. • Review the various types of tables • Review of C/AL functions • Create additional tables and user interfaces (pages) to maintain registrations • Test the results of the LabsIntroduction Now that the master tables and pages are in place, the next step is to implement functionality to allow users to perform transactions with the master data. As with the tasks in the previous chapter, this requires frequent referral to planning documentation, including the Analysis, Design, and Implementation phases. Before starting the Analysis phase, however, there are some concepts and features that are necessary during the Implementation phase. They are as follows: • Working with objects as text files • Multi-language support • Document pages • Table types • Useful C/AL functions By the end of this chapter, the tables and pages that are necessary for registering participants in seminars will be in place. Microsoft Official Training Materials for Microsoft Dynamics ® 3-1 Your use of this content is subject to your current services agreement
  • 2. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009Prerequisite Information Before getting into the subject of registration, there is some information that must be reviewed. Working with Objects as Text Files Analyzing and modifying objects can sometimes be much easier when the objects are in text file format. Any object in the Object Designer can be exported as text and imported back into Microsoft Dynamics® NAV as an un- compiled object. To export one or more objects as a text file, follow these steps: a. Select the object or objects in the Object Designer. b. Click file, and then click export in the menu bar. c. In the Export Objects dialog window, select Text Format as the Save as type, and then enter a file name. d. Click OK. One text file is created containing the text representations for the object or objects. The resulting text file contains all the details of the object. The first line for every object in the file begins with the word OBJECT, the object type, number, and name. The text for the rest of the object follows. For example: OBJECT Table 123456703 Instructor { OBJECT-PROPERTIES { Date=09/26/08; Time=[ 6:41:44 AM]; Modified=Yes; Version List=CSD; } PROPERTIES { DataCaptionFields=Code,Name; } FIELDS { { 1 ; ;Code ;Code10 ;CaptionML=ENU=Code; NotBlank=Yes } { 2 ; ;Name ;Text50 ;CaptionML=ENU=Name } { 3 ; ;Internal/External ;Option ;CaptionML=ENU=Internal/External;3-2 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 3. Chapter 3: Registrations OptionString=Internal,External } { 4 ; ;Resource No. ;Code20 ;TableRelation=Resource.No. WHERE (Type=CONST(Person)); OnValidate=BEGIN IF Resource.GET("Resource No.") AND (Name = ) THEN Name := Resource.Name; END; CaptionML=ENU=Resource No. } { 5 ; ;Contact No. ;Code20 ;TableRelation=Contact.No.; OnValidate=BEGIN IF Contact.GET("Contact No.") AND (Name = ) THEN Name := Contact.Name; END; CaptionML=ENU=Contact No. } } KEYS { { ;Code ;Clustered=Yes } } FIELDGROUPS { } CODE { VAR Resource@1000000000 (mailto:Resource@1000000000) : Record 156; Contact@1000000001 (mailto:Contact@1000000001) : Record 5050; BEGIN { CSD - MM/DD/YYYY - D.E. Veloper Chapter 2 Lab 3 - Created table } END. } } Microsoft Official Training Materials for Microsoft Dynamics ® 3-3Your use of this content is subject to your current services agreement
  • 4. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 OBJECT-PROPERTIES Section This section contains the objects date, time, and version properties. PROPERTIES Section This section includes the table objects OnInsert, OnModify, OnDelete and OnRename triggers, and general table properties. Triggers are only included in the text file when they contain C/AL code. Properties are only included when the value is set to something other than the default value. Properties that have default values and triggers without any C/AL code do not show up in an objects text file. SUB-OBJECTS Section This section lists the sub-objects. For tables, these consist of FIELDS and KEYS. This section contains the sub-object properties that do not contain default values and the triggers that contain code. CODE Section This section contains the global variables and functions for the object. Once the text files are changed and saved, import the text file back into Microsoft Dynamics NAV. 1. Open the Object Designer. 2. Click File, and then click Import. 3. Select the appropriate file in the Import Objects dialog window and click Open. The object or objects are imported. The objects must be compiled before they can be used. The Import Worksheet The Import Worksheet cannot be used when importing a text file, which means the following: • No warning is received about overwriting existing tables. • There is no opportunity to skip the import of some objects. • There is no opportunity to merge objects. Multilanguage Functionality in Text Messages When creating messages for the user, ensure that the text and the object names in the messages are enabled for multilanguage functionality. Error and text messages must be entered as text constants so that they can be easily translated. The C/AL Globals and C/AL Locals forms in the C/AL Designers have a Text Constants tab with a (normally) hidden column, ConstValueML. This column displays all the languages for a text constant. Text constants replace the use of hard-coded, language-dependent text strings.3-4 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 5. Chapter 3: Registrations Once it is assigned as a text constant, the message can be used in code as in the following example: ERROR(Text001); //where Text001 is defined as Text Constant in the global or local variables The following example uses the FIELDCAPTION function within an error message. The Text Constant 025 value is "Please enter "Yes" in %1 and/or %2 and/or %3". ERROR(Text025,FIELDCAPTION(Receive), FIELDCAPTION(Invoice), FIELDCAPTION(Ship)); When the code is run, the error message translates into: Please enter "Yes" in Receive and/or Invoice and/or Ship. When referring to fields in a message, the code must refer to the caption rather than the name of the field. By using the FIELDCAPTION function, the current caption of a field is returned as a string. The field property CaptionML must be populated to enable this functionality. The TABLECAPTION function can be used to return the table name. The following code returns the caption of the Document Type field: SalesLine.FIELDCAPTION("Document Type"); Document Pages A Document page (also commonly referred to as a Header/Line page) is a combination of a card page and a list page. It is used to display records from two tables with a one-to-many relationship, all on one page. The Card part of this type of page acts as a master page for the main table, and the subpage part lists the related records from the second table. For example, the Sales Invoice page (Page 43) is used to create, view, or modify sales invoice documents. Just like any other Card page, it displays fields from the Header table grouped in a number of FastTabs. In addition to the FastTabs that group fields of the main records, the page also has a special type of FastTab that displays the subpage, which displays the records that are related to the main record. The main page is associated with the header table, Sales Header (Table 36). The subpage (Page 47) is associated with the line table, Sales Line (Table 37). The two pages are linked together by the Document Type and Document Number fields, which are the fields that define the relationship between the Sales Header table and the Sales Line table. In the page designer, a subpage control is defined with a Type of Part. The ID of the subpage and the link to the main page is defined in the properties. In the properties of the subpages Part element, the "PagePartID" property is set to the "Sales Invoice Subform" (Page 47). To link the subpage records to the current Sales Header record, the SubFormLink property is set. Microsoft Official Training Materials for Microsoft Dynamics ® 3-5Your use of this content is subject to your current services agreement
  • 6. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 The Sales Invoice subpage indicates that the page is associated to the line table, Sales Line (Table 37). The page itself is a tabular page with a Repeater element that contains certain fields from the table. The key fields from the Sales Line (Document Type, Document No., and Line No.) are NOT displayed. Since this is a worksheet type page, it adheres to the following standards: • The key fields from the Sales Line (Document Type, Document No., and Line No.) are NOT displayed. The values of the Document Type and Document No. fields are automatically populated by the link between the main page and the subpage. • AutoSplitKey property is set to Yes. This property causes the Line No. field to be automatically populated by the system. Standard Microsoft Dynamics NAV naming conventions for these forms and tables are: Type Naming Convention Example Document Name of Transaction or Sales Header (Table 36) Table Document + Header (Header) Document Name of Transaction or Sales Line (Table 37) Table (Line) Document + Line Document Name of Document Represented Sales Invoice (Page 43) Page Document Name of Document Represented Sales Invoice Subform Subpage + "Subform" (Form 47) To follow Microsoft Dynamics NAV standards, the Seminar Registration window in this chapter is similar to the existing Sales Invoice window. For more information about design standards, refer to the Microsoft Dynamics NAV 2009 Developer and IT Pro Help, on the Microsoft Download Center: http://go.microsoft.com/fwlink?linkid=126282.Types of Tables Up until now, regular database tables were used to implement the Seminar module. The upcoming exercises make use of other types of tables. Virtual Tables A virtual table contains information provided by the system and is presented in C/SIDE as table objects, so that handling this information is done the same way that physical tables are handled. C/SIDE provides access to a number of virtual tables. They work in much the same way as regular database tables, but the information in them cannot be changed – they contain read-only information. Virtual tables are not stored in the database as normal tables are, but are computed by the system at run time.3-6 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 7. Chapter 3: Registrations Because a virtual table can be treated the same as an ordinary table, the same methods can access their information. For example, use filters to get subsets or ranges of integers or dates. Here is a list of virtual tables that are available in Microsoft Dynamics NAV 2009: • Date • Integer • File • Drive • Monitor • Session • Database File • Table Information • Field • Server • Windows Object • Windows Group Member • SID – Account ID • User SID • Several others Because the virtual tables are not stored in the database, they cannot be viewed directly from the Object Designer. The content of a virtual table can be viewed in a tabular page and accessed by C/AL code. The virtual tables have the highest numbers in the table list (they are listed in the 2000000000+ object range when designing an object that can be based on a table, such as pages, reports, dataports, and more). Refer to the Microsoft Dynamics NAV 2009 Developer and IT Pro Help for additional information on a number of the virtual tables. The Date virtual table is used for the Seminar Registration process. The Date virtual table provides easy access to days, weeks, months, quarters, and years. This table has three fields as follows: • Period Type: Days, weeks, months, quarters, or years • Period Start: The date of the first day in the period • Period End: The date of the last day in the period Microsoft Official Training Materials for Microsoft Dynamics ® 3-7Your use of this content is subject to your current services agreement
  • 8. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 Temporary Tables A temporary table is a memory-based table; a record type variable that exists only in the computers memory. Temporary tables are not physical tables in the database, but are always based on physical tables. Unlike virtual tables, they are not read-only. A temporary table can do almost anything that a normal database table can, but the information in the table is lost when the table is closed. The write transaction principle that applies to normal database tables does not apply to temporary tables. Refer to the Microsoft Dynamics NAV 2009 Developer and IT Pro Help for more information on the transaction principle. The advantage of using a temporary table is that all interaction with a temporary table takes place on the client or on the server tier. This reduces the load both on the network and on the server. To perform many operations on data in a specific table in the database, it can be beneficial to load the information into a temporary table for processing. Because all operations are local to the server tier, this speeds up the process. Creating a temporary table is similar to creating a record variable; use the following steps: 1. In either the C/AL Globals or C/AL Locals variable window, define a variable with the data type Record. Select a table in the Subtype field. 2. Open the Properties window for the variable, and set the Temporary property to Yes. A record type variable is by default linked to a physical table in the database. By setting a record variables Temporary property to Yes, the record variable becomes a temporary table. System Tables System Tables are stored in the database just like regular tables, but they are different because they are created automatically by the system. System table data can be read, written, modified, and deleted. The eight system tables in C/SIDE are primarily used to manage security and permissions. Refer to the Microsoft Dynamics NAV 2009 Developer and IT Pro Help for detailed information on each one of the System Tables.Additional Functions In the C/SIDE Introduction Course, the following functions were introduced. These functions are used later in this chapter. Refer to the Microsoft Dynamics NAV 2009 Developer and IT Pro Help for more information. • CALCDATE • DATE2DMY3-8 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 9. Chapter 3: Registrations • DATE2DWY • ROUND • RUNMODAL • CONFIRM • MESSAGE • ERROR • TESTFIELD • WORKDATE • VALIDATE • FORMAT • COUNT Page Functions Page functions are called through the CurrPage variable. This variable is a reference to the instance of the current page. The table contains several of the most useful page functions available. Refer to the online Microsoft Dynamics NAV 2009 Developer and IT Pro Help http://go.microsoft.com/fwlink?linkid=126282 for a complete list.Function DescriptionCurrPage.UPDATE Use this function to save the current record and then update the controls in the page. If the SaveRecord parameter is set to TRUE, this function saves the record before the system updates the page.CurrPage.SETSELECTION Use this function to have the system note the records the userFILTER has selected on the page, mark those records in the table specified, and set the filter to "marked only".CurrPage.CLOSE Use this function to close the current page.CurrPage.EDITABLE Use this function to return the current setting of the Editable property and to change the setting of the property. Most, but not all properties can also be changed from within code. This property is especially useful for using the same page for viewing and editing, but only allow some users to edit the records. Control Functions Microsoft Dynamics NAV also has a number of properties at the page and control level which can be modified at run time. Examples of these are the Visible and Editable properties. If the Visible property is True, then the page or control (depending on which level of property is being considered) can be seen. If it is False, the page or control, as appropriate, cannot be seen. The Editable property operates in a similar manner. Microsoft Official Training Materials for Microsoft Dynamics ® 3-9 Your use of this content is subject to your current services agreement
  • 10. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 Refer to the Microsoft Dynamics NAV 2009 Developer and IT Pro Help for more information on control functions. If the information in the Help files is not specific on which functions can be changed at run time, review of standard NAV 2009 code or even some experimentation may be required. Properties such as Editable and Visible can be changed at runtime in a page. See Customer Card (or Vendor Card) for the Contact Control Editable property settings as an example.Registrations Now that the master data is complete, make it possible for users to apply the master data to daily transactions related to registrations. Solution Analysis The functional requirements define the role of registrations in the following way: "If a customer wants to register one or more participants for a seminar, enter the relevant information into a registration page." Therefore, the main process related to registrations is managing seminar registrations. There is an additional optional requirement to manage seminar planning. This use case and related exercise is covered in the Additional Exercises section. Based on the results of the diagnosis, the analysis and implementation phases of this chapter are the following use case: • Managing Seminar Registration The clients functional requirements describe the process of seminar registration in the following way: "A customer can register one or more participants for a seminar. Each registration is assigned a job number. It must be possible to assign additional expenses to an instance of a seminar, such as catering expenses or equipment rentals. The registration information must include how the seminar is to be invoiced (for example, whether to include expenses or catering)." "Additional comments for each seminar can be entered to allow for things like necessary equipment or other particular requirements."3-10 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 11. Chapter 3: Registrations Therefore, registering a participant in a seminar must accomplish or allow the following items: • A place is reserved for the participant in the seminar • Invoicing information is gathered and stored • The appropriate facilities are reserved • The seminar and participant information can be tracked with a job number • Additional expenses can be invoiced as well The next step is to define the process of creating a new seminar. Once the details of a seminar are established, a seminar manager can create an instance of the seminar with this information: • An instructor • An available and properly equipped room • Any charges or additional comments Once the seminar is created, a customer training manager can add participants to the seminar. The following illustration shows this scenario. FIGURE 3.1 THE SEMINAR MANAGEMENT FLOWCHART Microsoft Official Training Materials for Microsoft Dynamics ® 3-11Your use of this content is subject to your current services agreement
  • 12. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 Solution Design The analysis of the seminar registration management process shows there are two main processes: • The creation of seminar instances o Define seminar registration details o Assign additional comments o Assign seminar charges • The registration of participants The following illustration shows the relationship between the system tables and the pages used to control these. Here, the prerequisite tables are shown to the left, the main processing tables are in the middle and the subprocess tables are to the right. FIGURE 3.2 SEMINAR REGISTRATION RELATIONSHIPS GUI Design The pages for the seminar registration and the navigation between them reflect the relationships shown in the previous diagram. Start by defining the simplest pages first so they can be integrated with the more complex pages at the end of the GUI design.3-12 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 13. Chapter 3: Registrations The Seminar Comment List page displays the comments for a seminar as shown in the following illustration. FIGURE 3.3 SEMINAR COMMENT LIST PAGE (123456707) The Seminar Comment Sheet page, as shown in the following illustration, enables the entry of comments for a seminar. FIGURE 3.4 SEMINAR COMMENT SHEET PAGE (123456706) Microsoft Official Training Materials for Microsoft Dynamics ® 3-13Your use of this content is subject to your current services agreement
  • 14. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 The Seminar Charges page, as shown in the following illustration, enables the entry of charges for a seminar. FIGURE 3.5 THE SEMINAR CHARGES PAGE (123456724)3-14 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 15. Chapter 3: Registrations Since the seminar registration and participant registration are so closely linked, it is best to handle them in one window with header and lines as shown in the following illustration. This Document page actually consists of two pages, a header page, and a subpage that contains the lines. FIGURE 3.6 THE SEMINAR REGISTRATION PAGE (MAIN 123456710, SUBPAGE 123456711) Microsoft Official Training Materials for Microsoft Dynamics ® 3-15Your use of this content is subject to your current services agreement
  • 16. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 FIGURE 3.7 THE SEMINAR REGISTRATION PAGE, WITH THE SEMINAR ROOM FASTTAB AND THE INVOICING FASTTAB EXPANDED3-16 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 17. Chapter 3: Registrations The Seminar Registration List page, as shown in the following illustration, displays the seminar registrations. FIGURE 3.8 THE SEMINAR REGISTRATION LIST PAGE IN THE ROLETAILORED CLIENT (123456713) Table Design The following tables are required for registrations: Table Description Table 123456710 Holds the information for one instance of a Seminar, Seminar which is referred to as a registration. Registration Header Table 123456711 Holds the information for one participant in a seminar Seminar registration. Registration Line Table 123456704 Holds comments for the seminar registrations. Seminar Comment Line Table 123456712 Holds charges related to the seminar registration. These Seminar Charge are in addition to the individual participant charges of the Seminar Registration Line table. Microsoft Official Training Materials for Microsoft Dynamics ® 3-17Your use of this content is subject to your current services agreement
  • 18. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009Lab 3.1 - Creating the Tables and Pages for SeminarRegistration In Chapter 2 labs, the master tables for the Seminar module were created. Now the variety of transaction tables and associated pages must also be created. Scenario The Seminar module design calls for the entry and processing of Seminar Registrations (in header/detail format), Comments about Seminars, and Seminar Charges. Tables and pages for each of these must be created. The header/detail data structure requires the use of a Document page type. Create these tables and their supporting pages. Challenge Yourself! Using the table definitions in the preceding Table Design and the GUI page designs as guides, create the following: 1. Tables a. Seminar Registration Header b. Seminar Registration Line c. Seminar Comment Line d. Seminar Charge 2. Pages a. Seminar Comment List b. Seminar Comment Sheet c. Seminar Charges Page d. Seminar Registration Page e. Seminar Registration Subpage f. Seminar Registration List Step by Step The first task is to create the Seminar Comment Line table, which contains comments about the seminar registration, if any. The fastest way to create this table is by exporting an existing table as a text file (described at the beginning of this chapter), making the appropriate changes to the text file and importing it back into Microsoft Dynamics NAV.3-18 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 19. Chapter 3: Registrations 1. Create table 123456704 Seminar Comment Line by exporting the standard table Sales Comment Line, modifying it, and importing it back into Microsoft Dynamics NAV. o To do this, first export the Sales Comment Line table (44) as a text file using the steps given earlier in the chapter. Give the text file the name "Table 123456704 - seminar comment Line.txt" to match the number and name that the new table will have. o Open the file in Notepad. Change the object number to 123456704. o Change the object name and the CaptionML value in the PROPERTIES section to "Seminar Comment Line." o Replace all instances of the word "Sales" with "Seminar." These instances include instances of the word "Sales" in variable names and C/AL code. o Replace the OptionString and OptionCaptionML values for the Document Type field to "Seminar Registration, Posted Seminar Registration" as shown in the table design. o Set the LookupFormID and DrillDownFormID properties to form 123456707. o Save the text file, import it into Microsoft Dynamics NAV, and compile it. Note that at this point the table object can be compiled, even though page 123456707 is not yet created. o Write a proper reference in the documentation trigger of the table and change the value of the Version List to "CSD." The completed table has the following fields: No. Field Type Length Comment Name 1 Document Option Options: Seminar Registration, Type Posted Seminar Registration. 2 No. Code 20 3 Line No. Integer 4 Date Date 5 Code Code 10 6 Comment Text 80 NOTE: The key for the table is Document Type, No., Document Line No., and Line No. This is also imported with the table. The next step is to create the Seminar Comment List and Seminar Comment Sheet pages. These pages are used to enter and display any comments about the registration. Microsoft Official Training Materials for Microsoft Dynamics ® 3-19Your use of this content is subject to your current services agreement
  • 20. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 2. Create the Seminar Comment List page (123456707) with the fields No., Date, and Comment as shown in the GUI design. Define the Code field on the page with its Visible property set to FALSE. Set the property to specify that this page cannot be edited, set the DataCaptionFields to the No. field, and set the LinksAllowed property to No. The Comment List page (number 125) can be used as an example for the Seminar comment List page. 3. Create the Seminar Comment Sheet form (123456706) with the Date, Comment, and Code fields. The Code field Visible property is set to FALSE. o Set the properties to automatically split the key, allow multiple new lines, and to specify that the program does not insert the record until the user has left the record. (The AutoSplitKey, MultipleNewLines, and DelayedInsert properties.) o In the appropriate page trigger, run the function SetUpNewLine whenever the user enters a new record. This function is imported with the Seminar Comment Line table. The next step is to create the Seminar Registration Header table, which contains information about specific offerings of the seminar. 4. Create table 123456710 Seminar Registration Header with the following fields: No. Field Name Type Length Comment 1 No. Code 20 2 Starting Date Date 3 Seminar Code 20 Relation to the Seminar table. No. 4 Seminar Text 50 Name 5 Instructor Code 10 Relation to Instructor table. Code 6 Instructor Text 50 FlowField; The CalcFormula Name looks up the Name field on the Instructor table and cannot be edited. 7 Status Options Options: Planning, Registration, Closed, Canceled. 8 Duration Decimal Decimal Places 0:1 9 Maximum Integer Participants3-20 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 21. Chapter 3: Registrations No. Field Name Type Length Comment 10 Minimum Integer Participants 11 Seminar Code 10 Relation to Seminar Room table. Room Code 12 Seminar Text 30 Room Name 13 Seminar Text 30 Room Address 14 Seminar Text 30 Room Address2 15 Seminar Code 20 Relation to Post Code table. Room Post There is to be no validation or Code testing of the table relation. 16 Seminar Text 30 Room City 17 Seminar Text 30 Put in comment column "Set Room ExtendedDataType property" Phone No. 18 Seminar Decimal AutoFormatType=1 Price 19 Gen. Prod. Code 10 Relation to Gen. Product Posting Posting Group table. Group 20 VAT Prod. Code 10 Relation to VAT Product Posting Posting Group table. Group 21 Comment Boolean FlowField; The CalcFormula checks whether lines exist on the Seminar Comment Line table for the current Seminar Registration Header. Cannot be edited. 22 Posting Date Date 23 Document Date Date 24 Job No. Code 20 Relation to Job table. 25 Reason Code 10 Relation to Reason Code table. Code Microsoft Official Training Materials for Microsoft Dynamics ® 3-21Your use of this content is subject to your current services agreement
  • 22. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 No. Field Name Type Length Comment 26 No. Series Code 10 Relation to No. Series table. Cannot be edited. 27 Posting No. Code 10 Relation to No. Series table. Series 28 Posting No. Code 20 The primary key for this table is the No. field, with a secondary key of Room Code. The sum index field for the secondary key is Duration. Ensure that the table and all fields have their Caption and CaptionML properties set. The next step is to create the Seminar Line Table. 5. Create the Seminar Registration Line table (123456711) with the following fields: No. Field Name Type Length Comment 1 Seminar Code 20 Relation to Seminar Registration Registration Header table. No. 2 Line No. Integer 3 Bill-to Code 20 Relation to Customer table. Customer No. 4 Participant Code 20 Relation to Contact table. Contact No. 5 Participant Text 50 Flowfield; Lookup the value Name based on the Participant Contact No. Cannot be edited. 6 Register Date Date Cannot be edited. 7 To Invoice Boolean Initial value is Yes. 8 Participated Boolean 9 Confirmation Date Cannot be edited. Date 10 Seminar Decimal AutoFormatType = 2 Price 11 Line Decimal Decimal places 0:5; The Discount % minimum value is 0 and the maximum is 100. 12 Line Decimal AutoFormatType = 1 Discount Amount3-22 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 23. Chapter 3: Registrations No. Field Name Type Length Comment 13 Amount Decimal AutoFormatType = 1 14 Registered Boolean Cannot be edited. The primary key is Seminar Registration No., Line No. The next step is to create the Seminar Charge table, which contains information for invoicing. 6. Create table 123456712 Seminar Charge with the following fields: No. Field Name Type Length Comment 1 Seminar Code 20 Relation to table 123456710 Registration Seminar Registration Header. No. Must not be blank. 2 Line No. Integer 3 Job No. Code 20 Relation to table 167 Job 4 Type Option Options: Resource, G/L Account 5 No. Code 20 If Type=Resource, relation to table 156 Resource If Type=G/L Account, relation to table 15 G/L Account. 6 Description Text 50 7 Quantity Decimal Decimal Places 0:5 8 Unit Price Decimal AutoFormatType = 2 Minimum value of 0. 9 Total Price Decimal Cannot be edited. AutoFormatType=1 10 To Invoice Boolean Initial value is Yes. 11 Bill-to Code 20 Relation to Customer table. Customer No. 12 Unit of Code 10 If Type=Resource, relation to Measure the Code field of table 205 Code Resource Unit of Measure table, where the Resource No. = No. Otherwise, relation to table 204 Unit of Measure. Microsoft Official Training Materials for Microsoft Dynamics ® 3-23Your use of this content is subject to your current services agreement
  • 24. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 No. Field Name Type Length Comment 13 Gen. Prod. Code 10 Relation to table 251 Gen. Posting Product Posting Group. Group 14 VAT Prod. Code 10 Relation to table 324 VAT Posting Product Posting Group. Group 15 Qty. per Decimal Unit of Measure 16 Registered Boolean Cannot be edited. The primary key is Seminar Registration No., Line No. and a secondary key of Job No. The next step is to create the Seminar Charges form, which allows for the input and display of invoice information. 7. Create the Seminar Charges form (123456724) with the following fields: Type, No., Description, Bill-to Customer No., To Invoice, Unit of Measure Code, Quantity, Unit Price, and Total Price. Set the property to automatically split the key. The next steps are to create the Seminar Registration page and subpages. 8. Create the page 123456711 Seminar Registration Subpage. The fields to include on the subpage are: Bill-to Customer No., Participant Contact No., Participant Name, Participated, Register Date, Confirmation Date, To Invoice, Registered, Seminar Price, Line Discount %, Line Discount Amount, and Amount. o Set the Caption on the page to Lines. o Set the properties for the Line Discount % and Line Discount Amount fields so that they are blank if the value is 0. o Set the page property to specify that the program automatically creates a key for a newly inserted record. 9. Create the Seminar Registration main page (123456710) as shown in the GUI design. Include the three FastTabs: General, Seminar Room and Invoicing, and the subpage FastTab. o The Lines subpage FastTab is always the second FastTab on Document (Header/Line) pages. It is defined as an element with type Part, with the same indentation as the other FastTabs, and it is entered right above the Seminar Room FastTab. Give the subpage element the name SeminarRegistrationLines.3-24 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 25. Chapter 3: Registrations o The Subpage ID is entered into the PagePartID property of the element. Set the property to link the subpage to its table where the Seminar Registration No. field equals the No. field in the header. o Set the Drilldown property of the Instructor Name to No. o Add menu button and menu items as follows: Type/Subtype Option Comment Actioncontainer / RelatedInformation Action Group &Seminar Opens the Seminar Comment Sheet Registration form (123456706). The link runs whenever there is an update. Action Co&mments Opens the Seminar Comment Sheet page (123456706) Action Charges Opens the Seminar Charges page (123456724) for the corresponding Seminar Registration No. The link runs whenever there is an update. 10. Create the Seminar Registration List page (123456713) with the following fields: No., Starting Date, Seminar Code, Seminar Name, Status, Duration, Maximum Participants, and Room Code. o Set the property to specify this page cannot be edited. o Set the CardFormID property to the Seminar Registration page. o Add the same Related Information selections to the Seminar Registration List page that were added to the Seminar Registration page. Microsoft Official Training Materials for Microsoft Dynamics ® 3-25Your use of this content is subject to your current services agreement
  • 26. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009Lab 3.2 - Adding Code to the Seminar Charge Table The business rules for the data in the Seminar Charge table require creating C/AL code to initialize and/or validate data in a number of fields. Scenario Process the entry of Seminar Charges data for a seminar. Challenge Yourself! Handle the entry of Seminar Charges for both Resources and G/L Account entries. Initialize and Validate fields as new records are entered. Step by Step In the Seminar Charge table, enter code to perform the following tasks: 1. When a record is inserted into the table, the program gets the corresponding Seminar Registration Header record and sets the Job No. field to that of the Seminar Registration Header. 2. When a user deletes a record, the program checks that the Registered field is false. Users cannot delete registered seminars. HINT: Use the TESTFIELD function to test the Registered value. 3. When a user enters or changes a value in the Job No. field, the program checks that the corresponding record in the Job table is not blocked and that the status of the job is Order. 4. When a user enters or changes a value in the Type field, the program sets the Description to blank. 5. When a user enters or changes a value in the No. field, the program checks the following: o If the Type is Resource: - Tests that the corresponding Resource is not blocked. - Tests that the Gen. Prod. Posting Group field is filled on the Resource record. - Sets the Description field of the Seminar Charge table to the Name from the Resource. - Sets the Gen. Prod. Posting Group, the VAT Prod. Posting Group, the Unit of Measure Code, and the Unit Price to the corresponding values in the Resource record. o If the Type is G/L Account: - Gets the corresponding G/L Account record and runs the CheckGLAcc function. - Tests that Direct Posting is TRUE for the G/L Account.3-26 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 27. Chapter 3: Registrations - Sets the Description field of the Charge table to the Name of the G/L Account. - Sets the Gen. Prod. Posting Group and VAT Prod. Posting Group to the corresponding values in the G/L Account record. Solution: The code in the No. - OnValidate trigger is as follows: CASE Type OF Type::Resource: BEGIN Resource.GET("No."); Resource.TESTFIELD(Blocked,FALSE); Resource.TESTFIELD("Gen. Prod. Posting Group"); Description := Resource.Name; "Gen. Prod. Posting Group" := Resource."Gen. Prod. Posting Group"; "VAT Prod. Posting Group" := Resource."VAT Prod. Posting Group"; "Unit of Measure Code" := Resource."Base Unit of Measure"; "Unit Price" := Resource."Unit Price"; END; Type::"G/L Account": BEGIN GLAccount.GET("No."); GLAccount.CheckGLAcc(); GLAccount.TESTFIELD("Direct Posting",TRUE); Description := GLAccount.Name; "Gen. Prod. Posting Group" := GLAccount."Gen. Bus. Posting Group"; "VAT Prod. Posting Group" := GLAccount."VAT Bus. Posting Group"; END; END; 6. When a user enters or changes the value in the Quantity field, the program calculates the Total Price field by multiplying the Unit Price by the Quantity. The same thing is done when the user enters or changes the Unit Price. HINT: Use the ROUND function to ensure the correct number of decimal places. 7. When a user enters or changes a value in the Unit of Measure Code field, the program does the following: o If the Type is Resource: - Gets the corresponding Resource record. - If the Unit of Measure Code is blank, the program sets it to the Base Unit of Measure Code from the Resource record. Microsoft Official Training Materials for Microsoft Dynamics ® 3-27Your use of this content is subject to your current services agreement
  • 28. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 - Finds the corresponding record in the Resource Unit of Measure table and sets the Qty. per Unit of Measure field to the corresponding value in the Resource Unit of Measure table. - Calculates the Unit Price according to the Unit Price from the Resource record. o If the Type is G/L Account: - Sets the Qty. per Unit of Measure to 1. - If the current field is the Unit of Measure Code field, the program validates the Quantity. Use CurrFieldNo to check the current field. Do this in case OnValidate is triggered by some other field or code besides Unit of Measure Code. Solution: The code in the Unit of Measure Code - OnValidate trigger is as follows: CASE Type OF Type::Resource: BEGIN Resource.GET("No."); IF "Unit of Measure Code" = THEN BEGIN "Unit of Measure Code" := Resource."Base Unit of Measure"; END; ResourceUofM.GET("No.","Unit of Measure Code"); "Qty. per Unit of Measure" := ResourceUofM."Qty. per Unit of Measure"; "Unit Price" := ROUND(Resource."Unit Price" * "Qty. per Unit of Measure"); END; Type::"G/L Account": BEGIN "Qty. per Unit of Measure" := 1; END; END; IF CurrFieldNo = FIELDNO("Unit of Measure Code") THEN BEGIN VALIDATE(Quantity); END;3-28 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 29. Chapter 3: RegistrationsLab 3.3 - Adding Code to the Seminar Registration HeaderTable and Page The business rules for the data in the Seminar Registration Header table require creating C/AL code to initialize and/or validate data in a number of fields. Scenario The fields in a Header that must be validated include the unique key field that identifies the document according to a set of standard NAV rules. Other C/AL code must be created to make sure required data is present according to standard NAV business rules for this type of document data. Referential integrity code must also be created so that when Header records are changed or deleted, associated Detail (child) records are kept consistent with their parent records (or deleted when appropriate). Challenge Yourself! Add code to make record addition, new record numbering, and record deletion follow Microsoft Dynamics NAV standards. Add code to support field validation and default value initialization in the same style as in other Microsoft Dynamcis NAV documents. Step by Step 1. Create a new function called AssistEdit with a return type of Boolean that: o Takes a parameter called OldSeminarRegHeader which is a record variable of the Seminar Registration Header table. o Checks for a Seminar Nos. series in the Seminar Setup table. o If found, uses the SelectSeries function in the NoSeriesManagement codeunit to check the series number. o If SelectSeries returns TRUE, the program uses the SetSeries function in the NoSeriesManagement codeunit to set the No. field, and the program then exits TRUE. HINT: The AssistEdit function created for the Seminar table is similar. 2. Create a new function called InitRecord which: o Sets the Posting Date to the work date if the Posting Date is blank (= 0D) o Sets the Document Date to the work date. o Gets the Seminar Setup record and runs the SetDefaultSeries function of the NoSeriesManagement codeunit to set the Posting No. Series value. Microsoft Official Training Materials for Microsoft Dynamics ® 3-29 Your use of this content is subject to your current services agreement
  • 30. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 Solution: IF "Posting Date" = 0D THEN "Posting Date" := WORKDATE; "Document Date" := WORKDATE; SeminarSetup.GET; NoSeriesMgt.SetDefaultSeries( "Posting No. Series", SeminarSetup."Posted Seminar Reg. Nos."); 3. When a new record is inserted, if the program finds that the No. field is blank, it gets the Seminar Registration Nos. series from the Seminar Setup table and tests it. It then fills the No. field by using the InitSeries function of the NoSeriesManagement codeunit. The program then runs the new InitRecord function. Solution: Enter the following code in the OnInsert trigger: IF "No." = THEN BEGIN SeminarSetup.GET; SeminarSetup.TESTFIELD("Seminar Registration Nos."); NoSeriesMgt.InitSeries( SeminarSetup."Seminar Registration Nos.", xRec."No. Series",0D,"No.","No. Series"); END; InitRecord; 4. When the user deletes a record, the program tests that the Status is Canceled and shows an error if the Status is not Canceled. The program also shows an error if the header has registered Seminar Registration Lines or if there are associated Seminar Charge lines. The program then deletes corresponding records in the Seminar Comment Line table. TESTFIELD(Status,Status::Canceled); SeminarRegLine.RESET; SeminarRegLine.SETRANGE("Seminar Registration No.","No."); SeminarRegLine.SETRANGE(Registered,TRUE); IF SeminarRegLine.FIND(-) THEN ERROR( Text001, SeminarRegLine.TABLECAPTION, SeminarRegLine.FIELDCAPTION(Registered), TRUE); SeminarRegLine.SETRANGE(Registered); SeminarRegLine.DELETEALL(TRUE); SeminarCharge.RESET; SeminarCharge.SETRANGE("Seminar Registration No.","No."); IF NOT SeminarCharge.ISEMPTY THEN ERROR( Text006, SeminarCharge.TABLECAPTION);3-30 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 31. Chapter 3: Registrations SeminarCommentLine.RESET; SeminarCommentLine.SETRANGE( "Document Type", SeminarCommentLine."Document Type"::"Seminar Registration"); SeminarCommentLine.SETRANGE("No.","No."); SeminarCommentLine.DELETEALL; 5. When a user attempts to rename a record, the program shows an error stating that a Seminar Registration Header cannot be renamed. HINT: Use a text constant and the TABLECAPTION function. 6. If the user changes No. to a new value from what it was previously, the program tests whether the number series (from the Seminar Registration Nos. field in the Seminar Setup) is allowed to be changed manually by using the TestManual function from the NoSeriesManagement codeunit. It then sets the No. Series field to blank. IF "No." <> xRec."No." THEN BEGIN SeminarSetup.GET; NoSeriesMgt.TestManual(SeminarSetup."Seminar Registration Nos."); "No. Series" := ; END; 7. When the user changes a value in the Starting Date from what it was previously, the program tests that the Status is Planning. 8. When the user changes a value in the Seminar No. from what it was previously, the program performs the following tasks: o Shows an error if there are any corresponding registered Seminar Registration Line records. o Gets the Seminar record and tests the following: - That the Blocked field is false. - That the Gen. Prod. Posting Group field is not blank. - That the VAT Prod. Posting Group field is not blank. o Fills in the following fields with values from the Seminar record: Seminar Name, Duration, Seminar Price, Gen. Prod. Posting Group, VAT Prod. Posting Group, Minimum Participants, Maximum Participants. The program validates and fills in the Job No. field. IF "Seminar No." <> xRec."Seminar No." THEN BEGIN SeminarRegLine.RESET; SeminarRegLine.SETRANGE("Seminar Registration No.","No."); SeminarRegLine.SETRANGE(Registered,TRUE); Microsoft Official Training Materials for Microsoft Dynamics ® 3-31Your use of this content is subject to your current services agreement
  • 32. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 IF NOT SeminarRegLine.ISEMPTY THEN ERROR( Text002, FIELDCAPTION("Seminar No."), SeminarRegLine.TABLECAPTION, SeminarRegLine.FIELDCAPTION(Registered), TRUE); Seminar.GET("Seminar No."); Seminar.TESTFIELD(Blocked,FALSE); Seminar.TESTFIELD("Gen. Prod. Posting Group"); Seminar.TESTFIELD("VAT Prod. Posting Group"); "Seminar Name" := Seminar.Name; Duration := Seminar."Seminar Duration"; "Seminar Price" := Seminar."Seminar Price"; "Gen. Prod. Posting Group" := Seminar."Gen. Prod. Posting Group"; "VAT Prod. Posting Group" := Seminar."VAT Prod. Posting Group"; "Minimum Participants" := Seminar."Minimum Participants"; "Maximum Participants" := Seminar."Maximum Participants"; VALIDATE("Job No.",Seminar."Job No."); END; 9. When the user enters or changes a value in the Instructor Code, the program calculates the value of the Instructor Name field. 10. When the user enters or changes a value in the Seminar Room Code, if the Seminar Room Code is blank, the program clears the values of the Room Name, Room Address, Room Address2, Room Post Code, Room City and Room Phone No. fields. Otherwise, the program gets the Seminar Room record and fills in those fields with the corresponding Seminar Room values. 11. When the user enters or changes a value in the Seminar Room Code, if the Maximum Participants in the corresponding Seminar Room record is less than the Maximum Participants in the Seminar Registration Header, the program asks the user whether to change the Maximum Participants in the Seminar Registration Header to the number of Maximum Participants from the Seminar Room record. If the user answers yes, the program changes the Maximum Participants value in the Seminar Registration Header. IF "Seminar Room Code" = THEN BEGIN "Seminar Room Name" := ; "Seminar Room Address" := ; "Seminar Room Address 2" := ; "Seminar Room Post Code" := ; "Seminar Room City" := ; "Seminar Room Phone No." := ; END ELSE BEGIN SeminarRoom.GET("Seminar Room Code"); "Seminar Room Name" := SeminarRoom.Name; "Seminar Room Address" := SeminarRoom.Address; "Seminar Room Address 2" := SeminarRoom."Address 2";3-32 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 33. Chapter 3: Registrations "Seminar Room Post Code" := SeminarRoom."Post Code"; "Seminar Room City" := SeminarRoom.City; "Seminar Room Phone No." := SeminarRoom."Phone No."; IF (CurrFieldNo <> 0) THEN BEGIN IF (SeminarRoom."Maximum Participants" <> 0) AND (SeminarRoom."Maximum Participants" < "Maximum Participants") THEN BEGIN IF CONFIRM(Text004,TRUE, "Maximum Participants", SeminarRoom."Maximum Participants", FIELDCAPTION("Maximum Participants"), "Maximum Participants", SeminarRoom."Maximum Participants") THEN "Maximum Participants" := SeminarRoom."Maximum Participants"; END; END; END; HINT: Use a CONFIRM message. 12. When the user enters or changes a value in the Room Post Code, the program runs the ValidatePostCode function from the Post Code table. 13. When the user performs a lookup on the Room Post Code field, the program runs the LookUpPostCode function from the Post Code table. 14. When the user enters or changes a value in the Room City field, the program runs the ValidateCity function from the Post Code table. 15. When the user performs a lookup on the Room City field, the program runs the LookUpCity function from the Post Code table. 16. When the user changes the Seminar Price to a new value from what it was before and the Status is not Canceled, the program searches for corresponding, unregistered Seminar Registration Lines. If any are found, the program asks the user whether to change the Seminar Price in the unregistered Seminar Registration Lines. If the user answers yes, the program validates and modifies the lines with the new Seminar Price. IF ("Seminar Price" <> xRec."Seminar Price") AND (Status <> Status::Canceled) THEN BEGIN SeminarRegLine.RESET; SeminarRegLine.SETRANGE("Seminar Registration No.","No."); SeminarRegLine.SETRANGE(Registered,FALSE); IF SeminarRegLine.FINDSET(FALSE,FALSE) THEN IF CONFIRM(Text005,FALSE, FIELDCAPTION("Seminar Price"), Microsoft Official Training Materials for Microsoft Dynamics ® 3-33Your use of this content is subject to your current services agreement
  • 34. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 SeminarRegLine.TABLECAPTION) THEN BEGIN REPEAT SeminarRegLine.VALIDATE("Seminar Price","Seminar Price"); SeminarRegLine.MODIFY; UNTIL SeminarRegLine.NEXT = 0; MODIFY; END; END; 17. When the user changes the Job No. to a new value from what it was before, if the program finds any Seminar Charge records with the old Job No., it asks whether to change the Job No. on the Seminar Charge lines. If the user answers yes, then the program modifies Seminar Charge lines with the new Job No. Otherwise, if the user answers no, the program changes the Job No. back to the old Job No. IF "Job No." <> xRec."Job No." THEN BEGIN SeminarCharge.RESET; SeminarCharge.SETCURRENTKEY("Job no."); SeminarCharge.SETRANGE("Job no.",xRec."Job No."); IF SeminarCharge.FINDSET(TRUE,TRUE) THEN BEGIN IF CONFIRM(Text007,TRUE, FIELDCAPTION("Job No."), SeminarCharge.TABLECAPTION) THEN BEGIN SeminarCharge.MODIFYALL("Job no.","Job No."); MODIFY; END ELSE BEGIN "Job No." := xRec."Job No."; END; END; END; HINT: Use the CONFIRM message function and use the MODIFYALL function to change the Seminar Charge lines. 18. When validating the Posting No. Series field, if the Posting No. Series is not blank, the program tests that there are values in the Seminar Registration Nos. and Posted Sem. Registration Nos. fields on the Seminar Setup table. It then runs the TestSeries function from the NoSeriesManagement codeunit. Regardless of whether the Posting No. Series field is blank, the program tests that the Posting No. field is blank.3-34 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 35. Chapter 3: Registrations Solution: Enter the following code in the Posting No. Series - OnValidate trigger: IF "Posting No. Series" <> THEN BEGIN SeminarSetup.GET; SeminarSetup.TESTFIELD("Seminar Registration Nos."); SeminarSetup.TESTFIELD("Posted Seminar Reg. Nos."); NoSeriesMgt.TestSeries(SeminarSetup."Posted Seminar Reg. Nos.", "Posting No. Series"); END; TESTFIELD("Posting No.",); 19. When the user performs a lookup on the Posting No. Series field, the program tests that there are values in the Seminar Registration Nos. and Posted Sem. Registration Nos. fields on the Seminar Setup table. If the LookupSeries function of the NoSeriesManagement codeunit is true, the program validates the Posting No. Series field. Solution: Enter the following code in the Posting No. Series - OnLookup trigger: WITH SeminarRegHeader DO BEGIN SeminarRegHeader := Rec; SeminarSetup.GET; SeminarSetup.TESTFIELD("Seminar Registration Nos."); SeminarSetup.TESTFIELD("Posted Seminar Reg. Nos."); IF NoSeriesMgt.LookupSeries(SeminarSetup."Posted Seminar Reg. Nos.", "Posting No. Series") THEN BEGIN VALIDATE("Posting No. Series"); END; Rec := SeminarRegHeader; END; 20. In the Seminar Registration page, when the user clicks the AssistEdit on the No. field, the program runs the AssistEdit function for xRec, and if it returns true, updates the current page. HINT: Use the UPDATE function of the CurrPage object to update the current page. Microsoft Official Training Materials for Microsoft Dynamics ® 3-35Your use of this content is subject to your current services agreement
  • 36. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009Lab 3.4 - Adding Code for Seminar Registration Lines As with the Seminar Registration Header record table, the Seminar Registration Line table must also have C/AL code included to enforce the business rules that will logically support the module design. Scenario Create validation code in the Seminar Registration Line table so that each record in this table is initialized to relate properly to its parent Seminar Registration Header record. Within this table, create code to also do calculations and validation lookups as necessary to ensure that all fields are properly completed. Challenge Yourself! As was done for the Seminar Registration Header, add code to the Seminar Registration Line table to handle field validation, initialization and consistency checking, Step by Step In the Seminar Registration Line table, enter code to perform the following tasks: 1. Create a new function called GetSeminarRegHeader that retrieves the corresponding Seminar Registration Header record and stores it in a global variable. IF SeminarRegHeader."No." <> "Seminar Registration No." THEN BEGIN SeminarRegHeader.GET("Seminar Registration No."); END; 2. Create a new function, CalculateAmount, to calculate the Amount field as the Seminar Price reduced by the Line Discount %. Use the ROUND function. Amount := ROUND(("Seminar Price" / 100) * (100 - "Line Discount %")); 3. Create a new function called UpdateAmount to calculate the Amount field to equal the Seminar Price minus the Line Discount Amount. Use the ROUND function with the Amount Rounding Precision field on the G/L Setup table as the precision parameter. GLSetup.GET; Amount := ROUND("Seminar Price" - "Line Discount Amount", GLSetup."Amount Rounding Precision");3-36 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 37. Chapter 3: Registrations 4. When the user inserts a new line, the program retrieves the corresponding Seminar Registration Header record, sets the Register Date to the current work date, and sets both the Seminar Price and the Amount to the Seminar Price from the Seminar Registration Header. 5. When the user deletes a record, the program tests that the line is not registered. 6. When the user changes the value in the Bill-to Customer No. field from what it was previously, the program shows an error if the line is registered. 7. When the user performs a lookup on the Participant Contact No., show the Contact List filtered for the Bill-to Customer Number. o To do so, the program filters the Contact Business Relation table to the appropriate customer using the Bill-to Customer No. o It then filters the Contact table to only those records where the Company No. is the same as that of the Contact Business Relation record. o The program runs the Contact List form (using the RUNMODAL function) using the filtered Contact record, and if the user selects a contact and clicks OK, the program assigns the Contact No. field of the Contact record to the Participant Contact No. Solution: Insert the following code in the Participant Contact No. - OnLookup trigger: ContactBusinessRelation.RESET; ContactBusinessRelation.SETRANGE("Link to Table", ContactBusinessRelation."Link to Table"::Customer); ContactBusinessRelation.SETRANGE("No.","Bill-to Customer No."); IF ContactBusinessRelation.FINDFIRST THEN BEGIN Contact.SETRANGE("Company No.",ContactBusinessRelation."Contact No."); IF FORM.RUNMODAL(FORM::"Contact List",Contact) = ACTION::LookupOK THEN BEGIN "Participant Contact No." := Contact."No."; END; END; CALCFIELDS("Participant Name"); 8. When the user enters or changes a value in the Seminar Price, the program validates the Line Discount %. Microsoft Official Training Materials for Microsoft Dynamics ® 3-37Your use of this content is subject to your current services agreement
  • 38. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 9. When the user enters or changes a value in the Line Discount %, the program calculates the Line Discount Amount (rounded by using the Amount Rounding Precision from the G/L Setup table) and then updates the Amount field using the new UpdateAmount function. IF "Seminar Price" = 0 THEN BEGIN "Line Discount Amount" := 0; END ELSE BEGIN GLSetup.GET; "Line Discount Amount" := ROUND("Line Discount %" * "Seminar Price" * 0.01, GLSetup."Amount Rounding Precision"); END; UpdateAmount; 10. When the user enters or changes a value in the Line Discount Amount, if the Seminar Price is not 0, the program calculates the Line Discount % using the Line Discount Amount and the Seminar Price. If the Seminar Price is 0, the program sets the Line Discount % to 0. The program runs the UpdateAmount function. IF "Seminar Price" = 0 THEN BEGIN "Line Discount %" := 0; END ELSE BEGIN GLSetup.GET; "Line Discount %" := ROUND("Line Discount Amount" / "Seminar Price" * 100, GLSetup."Amount Rounding Precision"); END; UpdateAmount; 11. When the user enters or changes a value in the Amount field, the program checks that the Bill-to Customer and Seminar Price fields are not empty. It rounds the Amount value with the Amount Rounding Precision field from the G/L Setup table as the precision parameter. It calculates the Line Discount Amount and the Line Discount %.3-38 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 39. Chapter 3: Registrations Solution: Insert the following code in the Amount - OnValidate trigger: TESTFIELD("Bill-to Customer No."); TESTFIELD("Seminar Price"); GLSetup.GET; Amount := ROUND(Amount,GLSetup."Amount Rounding Precision"); "Line Discount Amount" :="Seminar Price" - Amount; IF "Seminar Price" = 0 THEN BEGIN "Line Discount %" := 0; END ELSE BEGIN "Line Discount %" := ROUND("Line Discount Amount" / "Seminar Price" * 100, GLSetup."Amount Rounding Precision"); END; Microsoft Official Training Materials for Microsoft Dynamics ® 3-39Your use of this content is subject to your current services agreement
  • 40. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009Lab 3.5 - Set Up a Seminar Management Department Page To make testing easier, access to all the pages that are developed in the labs can be added to a department page. This enables access directly from the RoleTailored client, instead of having to run the pages from the Run command prompt. A department page can be created by adding a menu for the department to a MenuSuite object. Scenario While pages and reports can be run directly by the developer on a test basis, the creation of actions defined in a menu from which to invoke the new objects makes testing more complete and similar to what the target user will experience. Since the creation of menu functionality is necessary to put the new module, the basis for that production menu will be created now for use in testing. Step by Step 1. In the Object Designer, go to the MenuSuite area. Click the New button and select Partner. Clicking the OK button opens the MenuSuite in design mode. 2. Right-click in the menu area and select Create Menu. Enter Seminar Management as the Name, and enter the number 1 as the Bitmap value. Clicking the OK button creates a new Menu for the Seminar Management Department. 3. Create two Items, one for Planning and one for Setup. Items can be created by right-clicking the empty Seminar Management Department Menu and selecting Create Item. 4. Expand the Planning Item and add Items for Instructors (Page 123456705), Seminars (Page 123456701), Seminar Rooms (Page 123456745), and Seminar Registrations (Page 123456713). For each selection, enter the list pages as the objects. For instance, the Instructors selection has its Object Type set to Page, the Object ID to Instructors, and the Caption to Instructors. FIGURE 3.9 INSTRUCTORS SELECTION3-40 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 41. Chapter 3: Registrations 5. Expand the Setup Item and add an Item for Seminar Setup. 6. Save the Menusuite. Next time that the Role Tailored client is opened, there will be a department for Seminar Management. The Seminar Management Department in the RoleTailored client: FIGURE 3.10 SEMINAR MANAGEMENT DEPARTMENT IN ROLETAILORED CLIENT Microsoft Official Training Materials for Microsoft Dynamics ® 3-41Your use of this content is subject to your current services agreement
  • 42. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009Testing Seminar Registrations Use the following test script to check the Seminar Registrations functionality. It is assumed that at least one Seminar Room, one Instructor, and one Seminar are set up from the test script in the last chapter. 1. In the RoleTailored client, browse to the Seminar Management Department and select Seminar Registrations from the Planning menu. Click the New button, which opens the Seminar Registration page with a new empty record. 2. Tab off the No. field. The next number in the number series set up in the last chapter is automatically filled into the No. field. Note that when a new record is started, the Posting Date and Document Date values are set to the work date. 3. Select a Seminar No. and see that the Seminar Name is populated. 4. Select an Instructor Code and see that the Instructor Name is populated. 5. Expand the Seminar Room FastTab, select a Seminar Room Code and see that the other fields are populated. 6. Expand the Invoicing tab, and enter a Price and a Job No. The values do not matter for now, but the Job No. becomes important in subsequent chapters when registrations are posted. 7. In the Lines FastTab, use the lookup to select a Bill-to Customer. Then use the Participant Contact No. lookup. The values in the Contact List must be filtered to only show Contact related to the Bill-to Customer. Select a Contact and click OK. The Participant Name field is populated automatically. 8. Tab through the rest of the fields on the line. Note that the Seminar Price is defaulted from the Invoicing FastTab. Enter a value in the Line Discount % and notice the Line Discount Amounts and Amount fields calculate accordingly. 9. Select the Charges menu item from the Related Information menu and enter a new charge. See that the line item values are populated appropriately based on the Resource or G/L Account selected. That concludes the testing for this use case. If there are areas that did not function as expected, make the necessary changes.Summary This chapter described how to create the tables and pages that are necessary to register participants in seminars, along with how to create code to improve usability and data validation. The next step is to take the transaction information and create a posting routine that can certify participants and create ledger entries for completed courses. It will also be possible to post invoices to customers.3-42 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 43. Chapter 3: RegistrationsTest Your Knowledge 1. What method is used to retrieve a fields caption? How about a tables caption? 2. Why is it necessary to be cautious when importing objects as text files? 3. How do card and list pages relate to a table, and how do they relate to each other? Microsoft Official Training Materials for Microsoft Dynamics ® 3-43 Your use of this content is subject to your current services agreement
  • 44. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 4. Is it possible to write to a virtual table? 5. When are virtual tables computed by the system? 6. What does the AutoSplitKey property do?3-44 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 45. Chapter 3: Registrations 7. What function is used to force the calculation of a FlowField? Microsoft Official Training Materials for Microsoft Dynamics ® 3-45Your use of this content is subject to your current services agreement
  • 46. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009Quick Interaction: Lessons Learned Take a moment and write down three key points you have learned from this chapter 1. 2. 3.3-46 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement
  • 47. Chapter 3: RegistrationsSolutions Test Your Knowledge 1. What method is used to retrieve a fields caption? How about a tables caption? MODEL ANSWER: The FIELDCAPTION method is used to retrieve a fields caption. The TABLECAPTION method is used to retrieve a tables caption. 2. Why is it necessary to be cautious when importing objects as text files? MODEL ANSWER: It is important to be careful when importing objects as text files for two reasons: 1. They are in an uncompiled state, so it is not possible to use the object immediately. A developer needs to compile the object before it can be used. 2. When importing objects as text files, there is no confirmation, nor is the import worksheet available. 3. How do card and list pages relate to a table, and how do they relate to each other? MODEL ANSWER: A card page displays a single record. A list page displays a list of records for that table. A card page is tied to a list page so that selection of a specific record on the list can cause the associated card to be displayed showing that record in full detail. 4. Is it possible to write to a virtual table? MODEL ANSWER: Virtual tables are used to present static system information in a structure that works the same as regular tables. It is not possible to write to a virtual table. 5. When are virtual tables computed by the system? MODEL ANSWER: Virtual tables are computed by the system when they are opened. For instance, the virtual table Integer is populated when an instance of the virtual table is used in an object. Microsoft Official Training Materials for Microsoft Dynamics ® 3-47 Your use of this content is subject to your current services agreement
  • 48. C/SIDE Solution Development in Microsoft Dynamics® NAV 2009 6. What does the AutoSplitKey property do? MODEL ANSWER: The AutoSplitKey property is a form and/or page property that automatically calculates the value of the last field of the primary key when a record is inserted from the form/page, provided that this field has the data type Integer. 7. What function is used to force the calculation of a FlowField? MODEL ANSWER: The CALCFIELDS method is used to calculate a FlowField in C/AL code.3-48 Microsoft Official Training Materials for Microsoft Dynamics ® Your use of this content is subject to your current services agreement