Académique Documents
Professionnel Documents
Culture Documents
Contributors
Name Andrew Pettinella Eileen R. Wexler Senior Product Analyst Product Analyst
Position
Change Record
Date 20 Sept 1998 1 Dec 1998 13 Jan 1999 20 Jan 1999 29 Jan 1999 A.Pettinella A.Pettinella E. Wexler E. Wexler
Author
Change Reference Completed Document -- now using the template Added Appendix C -- Case Study on customization Added detailed instructions. Moved Appendix C into body of paper, example's section. Added further explanations & graphics. Added Examples D, E, and F. Created a Word 95 version to replace the Word 97 version & increase ease of use. Added Appendix C -- logfile and scripts.
A. Pettinella, E. Wexler
Contents
Introduction .......................................................................................................................................................................... 1 Definitions ............................................................................................................................................................................ 3 Default Flexbuilder / Account Generator Setup .................................................................................................................. 4 Generation of Accounting Code Combinations .................................................................................................................... 4 Account Generator Processes .............................................................................................................................................. 6 The Generate Default Account Process................................................................................................................................ 7 The Generate Category Level Process.................................................................................................................................. 8 Example: Generating a Category Level Account.................................................................................................................. 9 Function Control Properties............................................................................................................................................... 11 Upgrading from Release 10 Flexbuilder............................................................................................................................. 13 Account Generator Customization ..................................................................................................................................... 14 Example A: Changing the value of a segment for all Book Level and Category Level accounts ......................................... 14 Example B: Specifying a different value for a segment based on account type .................................................................. 16 Example C: Specifying a different value for a segment based on book .............................................................................. 20 Example D: Specifying a different value for a segment based on a descriptive flexfield ................................................... 24 Example E: Specifying unqualified segments based on values from a custom table ........................................................... 28 Example F: Inserting a new process: an alternate solution to Example E .......................................................................... 34 Account Generator Basics ................................................................................................................................................. 36 How to open the Account Generator .................................................................................................................................. 36 How to save a file in Account Generator............................................................................................................................ 36 Web Sites ............................................................................................................................................................................ 36 Appendices ......................................................................................................................................................................... 37 Appendix A: List of Processes and Generated Accounts ................................................................................................... 37 Appendix B : FA Account Generator - The Navigator menu in Oracle Work Flow Builder............................................... 38 Appendix C: Account Generator Test Script..................................................................................................................... 42
Introduction
Objective
This white paper assists the novice Workflow user in using Account Generator, which is new to Release 11.0. We expect users to have knowledge of Oracle Assets, flexfield definitions, and a working knowledge of Oracle Workflow. Account Generator builds the general ledger account combinations used to generate the general ledger journals by Oracle Assets. It allows you to designate a specific source for each segment in the account for which Oracle Assets creates a journal entry. The Account generator gives you the flexibility to create journal entries according to your requirements. You can specify to what detail to create journal entries, as well as the detail level for each book and account type.
Name Trim Pershad Usha Thothatri Development Manager Senior Product Manager
Position
Definitions
Processes A set of activities that need to be performed to accomplish a business goal. A process is represented by a workflow diagram. Process Definition A workflow process as defined in Oracle Workflow Builder. Process Activity A process modeled as an activity so that it can be referenced by other processes. Items A specific process, document, or transaction that is managed by a workflow process. Function A PL/SQL stored procedure that can define business rules, perform automated tasks within an application, or retrieve application information.
The table below defines where each segment derives its account detail. For instance, the Company segment derives its value from the Distribution CCID, which is the accounting flexfield combination noted on the Assignments Screen. The depreciation account is derived from the Distribution CCID entered in the Assignments form.
ACCOUNT STRUCTURE Segment Name Company Cost Center Account Product Sub-Account Default Segment Sources Distribution CCID (Assignments screen) Default CCID (Book Controls screen) Account Segment Value Default CCID (Book Controls screen) Default CCID (Book Controls screen)
Balancing Segment - 01
The Balancing segment is defaulted from the Assignments screen, as shown above.
Default Flexbuilder/Account Generator Setup Oracle/Client Confidential - For internal use only
The Cost Center is derived from the Default CCID in the Book Controls form, as are the two unqualified segments Product and Sub-Account.
Sub-Account 000
Product 0000
Default Flexbuilder/Account Generator Setup Oracle/Client Confidential - For internal use only
The main process is the Generate Default Account process noted above. The Generate Default Account process incorporates three other processes: 1. 2. 3. Generate Asset Level Account Generate Book Level Account Generate Category Level Account
The type of account you want to build determines which process you need to modify. If you want to modify an account driven by the category level (i.e., defined in the asset categories form), you must use the Generate Category Level Account process. The following table lists all Account Generator Processes and the names of the Accounts that each process generates:
Book Classes
The generate default account process above is a graphical representation of the Account Generator process. The first icon on the left, labeled Start Generating Code Combination, represents the start process. It leads to the Get Account Group icon, which determines the type of account being generated according to the nature of the account. You can see that three different types of accounts can be generated in this example: Book Level Accounts, Category Level Accounts, and Asset Level Accounts. To determine which process your account belongs to, refer to Appendix A -- Account Generator Processes and Generated Accounts. For example, the Cost Clearing Account is a Category Level Account. Therefore, it adopts the Generate Category Level Account path. If you double click on the Generate Category Level Account icon, you will see the process involved in generating this type of account.
Once you double click on the Generate Category Level Account icon, the Generate Category Level Account screen opens as shown below:
You may notice that your labels are marked with different names. For instance, the Balancing Segment from Distribution CCID icon may be labeled Copy Segment Value from Code Combination. If you screen does not appear labeled as the above example, you can change the icon labels as follows: 1. 2. 3. 4. 5. 6. Right click in the white space of the Generate Category Level Account screen. A menu will appear. Choose SHOW LABEL and its submenu COMMENT. Your icon will now appear labeled as it does above. To change the icon labels again, right click in the white space of the screen. From the menu, choose SHOW LABEL and its submenu DISPLAY NAME You will see the name of the icon appear as originally displayed.
For all default accounts that are Category Level Accounts, the following four functions appear as icons: Balancing Segment from Distribution CCID - This icon represents the balancing segment, which is derived from the Distribution CCID noted on the Assets Assignments form. Cost Center from Default CCID - The cost center is derived from the default ccid noted in the Natural Accounts alternative region of the Book Controls form. The Book Controls form is where the asset corporate book is defined. Account Value to Account Segment - This icon denotes the account mapping. For instance the Asset Clearing Account comes from the Asset Categories form, while the Proceeds of Sale Clearing Account comes from the Book Controls form. Unqualified Segments from Default CCID - This icon is where the other segments (not including the balancing segment, cost center and account segments) derive their values.
Problem. We want to define the Asset Clearing Account using the Generate Category Level
Account process. The Chart of Accounts has three segments: Company, Cost Center, and Account. Company - Cost Center - Account
Building the Account. The Asset Clearing Account must be derived from values entered in
the Book Controls form as well as the Asset Categories form and the Assignments form. We derive the three segment values: 1. Company segment. Balancing Segment from Distribution ID - Assignments form. 02
2.
Cost Center segment. Cost Center Segment from Default CCID - Book Defaults. 00
Book Controls Default 01-000-1000 gives the Cost Center segment value 000.
3.
Account segment. Account value in Account Segment - Defined at category level. 2000
Category Asset Clearing Account 01-100-2000 gives the Account segment value of 2000.
10
Process Activity.
This is where the process item is defined. One important aspect of the Process Activity tab is that the comment is defined here. The comment is the label that displays when you choose Show Label / Comment from the menu that appears when right clicking in the white space of the screen. You can change the comment in this screen to suit your needs. This will be reflected in the new process diagram.
Attribute Values.
Fig. 1.1 Each process item has a number of attributes that can be selected and altered from the Control Properties screen. From the pulldown menu labeled Select Attribute, you can choose which particular item you need to alter. As shown in Fig. 1.2, Code Combination ID is an example of a selectable attribute. Code Combination ID tells us from which account the segment value is being pulled. You can change the value to suit your needs: 1. Find the row that corresponds to Code Combination ID. 2. Locate the value, which is currently set to Distribution CCID (Fig 1.2) 3. Click on the Distribution CCID, and a second pull down menu will appear as in Fig 1.3 4. Select a new value for the Code Combination ID, such as Default CCID. 5. Press the button marked Apply
Fig. 1.2
11
The Segment attribute denotes which segment is being defined. In Fig. 1.2, we see the value is set to FA_COST_CTR. This means that the Cost Center segment is the one defined in this process. Other values for Segment include: Balancing Segment = GL_BALANCING Cost Center = FA_COST_CTR Account Segment = GL_ACCOUNT
Unqualified segments are those segments in addition to the mandatory Balancing Segment, Cost Center and Account Segments. Fig. 1.3
12
As part of the upgrade process, Autoinstall automatically creates an Account Generator process from your Flexbuilder configuration. This Account Generator process contains any customizations you had in Flexbuilder and is called Generate Account using Flexbuilder Rules. You can navigate to it from the Navigator form by selecting FA Account Generator/ Processes/Generate Account Using Flexbuilder Rules.
This process is provided for converting an existing Flexbuilder configuration only. You should not modify this process in any way, nor modify the PL/SQL functions. Oracle does not support modifications to this process. If you used Flexbuilder in Release 10 and now would like to add customizations to your Account Generator , you should do so by starting from the Default Account Generator process. If you used Flexbuilder in Release 10 but did not customize the default configuration, you do not need to use the Generate Account Using Flexbuilder rules process. The default Account Generator process gives you the same result as the default configuration in Flexbuilder.
Upgrading from Release 10 Flexbuilder Oracle/Client Confidential - For internal use only
13
Example A: Changing the value of a segment for all Book Level and Category Level Accounts
Problem. We want to change the Cost Center detail from the Default CCID to the Distribution
CCID for all Book Level Accounts and Category Level Accounts noted in Table 1.1.
Steps.
1. 2. Download the FA Account Generator file from the Database. From the Navigator window, navigate to FA Account Generator/Processes/Generate Default Account.
3.
Double click on Generate Default Account. We need to modify the following: Book Level Accounts Category Level Accounts
14
4.
Double click on the Generate Book Level Account process. The Generate Book Level Account screen will appear. In the Generate Book Level Account screen, double click on the Cost Center from CCID icon. The Control Properties screen will appear. Select the Attribute Values tab. Select the attribute Code Combination ID by clicking on the word Code Combinatio... and change the Value from Default CCID to Distribution CCID in the pull down menu that appears. This step is demonstrated below.
5.
6. 7.
8.
Return to the Generate Default Account screen and locate the Generate Category Level Account Process. The Generate Category Level Account screen will appear. In the Generate Category Level Account screen, double click on the Cost Center from CCID icon. The Control Properties screen will appear.
9.
10. Select the Attribute Values tab. 11. Change the value of the attribute Code Combination ID from Default CCID to Distribution CCID, as in Step 7. 12. To change the comment, click on the Process Activity tab in the Control Properties window. In the comment field, change the description to Cost Center from Distribution CCID.
15
Problem. We want to specify a different Cost Center segment value for the Asset Cost
Account, a specific type of Category Level Account. The Cost Center segment is derived from the default for the Asset Cost account, but we will derive the Cost Center segment from the Distribution CCID. Asset Level Accounts and Book Level Accounts will continue to have their Cost Center segment derived from the Default CCID as expected, and all other Category Level Accounts (other examples are listed in Table 1.1) will also continue to have their Cost Center segment derived from the Default CCID.
Solution. For the Category Level Account called Asset Cost, we will create a new process path
that designates a different value for the Cost Center segment to derive its value. All other accounts will use the default path to specify their Cost Center segment values.
Steps.
1. Download the FA Account Generator file from the Database.
2.
From the Navigator window, navigate to FA Account Generator / Processes / Generate Default Account.
16
3.
Double click on Generate Default Account to open the Generate Default Account screen. We need to modify the Cost Center segment of all of the Category Level Accounts. Double click on the Generate Category Level Account process. The Generate Category Level Account screen will appear.
4.
5.
Change the function labels from Name to Comment. Right click in the white space of the Generate Category Level Account screen, then choose Show Label/Comment from the menu (as shown below).
6.
Now, you will add two new functions to the Generate Category Level Account process. In the Navigator window, navigate to FA Account Generator/Standard Flexfield Workflow/Functions. Note that one function listed under this section is Copy Segment Value from Code Combination. In the Navigator window, click and hold down the mouse on the words Copy Segment Value from Code Combination and drag the mouse to the Generate Category Level Account screen. Release the mouse button, and you will see a new instance of this function. Create two instances.
7.
17
8.
Change the function labels from Comment to Name. Right click in the white space of the Generate Category Level Account screen, then choose Show Label/Display Name from the menu (as shown in Step 5). Reposition the two icons created in Step 7 so that one is directly above the Balancing Segment from Distribution CCID icon and the other is directly above the Cost Center from Default CCID icon.
9.
10. Double click on the icon now located directly above the Cost Center from Default CCID icon. When the Control Properties screen appears, select the Process Activity tab and enter the comment Make the Cost Account = Distribution CCID. 11. Double click on the icon now located directly above the Balancing Segment from Distribution CCID icon. When the Control Properties screen appears, select the Process Activity tab and enter the comment Balancing Segment from Distribution CCID. 12. Position the mouse on the Get Category Account Name function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Balancing Segment from Distribution CCID. You will see a new path line appear to connect the two icons as you drag your mouse across the screen. When you release, a menu will appear. Select Asset Cost from the menu, as shown below:
13. Create another path to connect the two new icons: Position the mouse on the new Balancing Segment from Distribution CCID icon and right click. As you continue to hold
Fixed Assets -- Account Generator and Workflow Account_Generator_Paper (v. 1.0 ) Account Generator Customization Oracle/Client Confidential - For internal use only 18
down the right mouse button, move the mouse to the Make the Cost Account = Distribution CCID icon. 14. Create another path to connect the Make the Cost Account = Distribution CCID icon and the Account Value to Account Segment icon as in Steps 12 and 13. 15. Modify the attribute values of the two new icons. Double clicking on an icon will open the Control Properties screen, from which you may choose the Attribute Values tab. The Attribute Values are listed in the tables below:
19
You will notice that there are two paths. If a code combination is being generated for the asset cost, it will follow the top path. All other accounts will be generated via the lower (default) path.
20
Problem. We want to set up our book such that the Cost Center segment is derived from the
Distribution CCID in the Corporate Book. However, the Cost Center segment is derived from the default CCID in the Budget Book or Tax Book.
Solution. Steps.
1. 2. 3. Download the FA Account Generator file from the Database. From the Navigator window, navigate to FA Account Generator/Lookup Types. Create a new Lookup Type. In the Navigator, place the cursor on the line labeled Lookup Types and select it. From the Edit menu, choose New/Lookup Type. When the Oracle Workflow Navigator Control Properties screen appears, enter: Internal Name = BOOK_TYPE_CODE Display Name = Books Description = Book Type Code Choose the OK button. a. b. c.
d.
21
4.
Create a Lookup CODE for each Asset Book. a. In the Navigator, place the cursor on the line labeled Lookup Types and select it. b. From the Edit menu, choose New/Lookup CODE. c. When the Oracle Workflow Navigator Control Properties screen appears, you will see that the Lookup Type is already of type Books. Enter the following and choose OK to save: Internal Name = CORP Display Name = US Corp Book Description = US Corp Book d. From the Edit menu, choose New/Lookup CODE again. e. When the Control Properties screen appears, you will see that the Lookup Type is already of type Books. Enter the following and choose OK to save: Internal Name = TAX Display Name = Federal Tax Book Description = Federal Tax Book Assign the Result Type, a predefined Lookup Type. Result Types list the possible results returned by this activity. (Note: Your workflow diagram may sometimes branch depending on the value returned by your completed activity.) Navigate to FA Account Generator / Functions/ Get Book Type Code and double click on Get Book Type Code. When the Control Properties screen appears, change Result Type by selecting Books from the pulldown menu. Note: If the Result Type is grayed out and you do not have access to change it, cancel out of the Control Properties screen, navigate to the menu bar and select Help/About Oracle Workflow Builder. Change your access level to an integer less than 100, then press OK. You may now change the Result Type as per the instructions. Navigate to FA Account Generator/Processes, then double click on Generate Default Account.
5.
6.
22
7.
We need to modify the Generate Book Level Account process and the Generate Category Level Account process. Double click on the Generate Book Level Account icon to address this process first. Change the function labels from Name to Comment. Right click in the white space of the Generate Book Level Account screen, then choose Show Label/Comment from the menu. Now, you will add two new functions to the Generate Book Level Account process. In the Navigator window, navigate to FA Account Generator/Standard Flexfield Workflow/Functions. Note that one function listed under this section is Copy Segment Value from Code Combination.
8.
9.
10. In the Navigator screen, click and hold down the mouse on the words Copy Segment Value from Code Combination and drag the mouse to the Generate Book Level Account screen. Release the mouse button, and you will see a new instance of this function. Place it above the Cost Center from Default CCID icon. 11. In the Navigator window, navigate to FA Account Generator/Functions. Note that one function listed under this section is Get Book Type Code. 12. In the Navigator window, click and hold down the mouse on the words Get Book Type Code and drag the mouse to the Generate Book Level Account screen. Release the mouse button, and you will see a new instance of this function. Place it above the Balancing Segment from Distribution CCID icon.
13. Double click on the Get Book Type Code icon. When the Control Properties screen appears, select the Process Activity tab and enter the comment Book Type Code. 14. Double click on the Copy Segment Value from Code Combination icon. When the Control Properties screen appears, select the Process Activity tab and enter the comment Cost Center from the Distribution CCID. 15. In the Control Properties screen of the Cost Center from the Distribution CCID icon, select the Attribute Values tab and enter the following values:
23
16. Position the mouse on the Cost Center from the Distribution CCID function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Account Segment from the Book Control. You will see a new path line appear to connect the two icons as you drag your mouse across the screen. 17. Position the mouse on the Book Type Code function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Cost Center from Default CCID. You will see a new path line appear to connect the two icons as you drag your mouse across the screen. When you release, a menu will appear. Select Default. This means that all other Book Type Codes will use this Default.
18. Position the mouse on the Book Type Code function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Cost Center from Distribution CCID. You will see a new path line appear to connect the two icons as you drag your mouse across the screen. When you release, a menu will appear. Select US Corporate Book. 19. Position the mouse on the Cost Center from Default CCID function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Account Segment from Book Control. You will see a new path line appear to connect the two icons as you drag your mouse across the screen. Once you reposition your icons, the end result should appear similar to the picture show below:
20. From the Navigator window, navigate to FA Account Generator/Processes/Generate Category Level Account to open the Generate Category Level Account screen. Repeat steps 8 through 19 for the Generate Category Level Accounts Process.
24
25
Problem. We want to build accounting flex combinations where the Asset Cost segment, a
Category Level Account, is dependent on the value stored in a descriptive flexfield. For instance, we may have three different types of Additions: New Additions, Late Additions, and Intercompany Additions. We want to store the type of addition in the descriptive flexfield, then have Account Generator create the corresponding accounting flex combinations based on the Addition type.
Solution. Since we are varying Asset Cost, we must be working with a Category Level
Account (see Table 1.1). We will create two attributes: Distribution ID and Account Value Segment. Then, Distribution ID will be passed into a customized PL/SQL function. The PL/SQL function takes the Distribution ID and determines the value of the account segment that is required to build the proper accounting flex combination based on the information in the descriptive flexfield. For instance, if the PL/SQL function identifies that an addition of type NEW is stored in the descriptive flexfield, it will return some value x. If a LATE addition is stored, then it will return some value y. This return value will be used to populate the Account Value Segment, which is the other attribute that we specified. The Account Value Segment can then be used to create the appropriate accounting flex combination.
Steps.
1. 2. Download the FA Account Generator file from the Database. From the Navigator window, navigate to FA Account Generator/ Processes/ Generate Category Level Account. Double click on the Generate Category Level Account process. The Generate Category Level Account screen will appear.
3.
4.
From the Navigator window, navigate to FA Account Generator/ Functions and highlight the word Functions. Create a new function. With Functions selected in the Navigator window, go to the Edit menu and choose New/ Function. The Control Properties screen should appear.
Account Generator Customization Oracle/Client Confidential - For internal use only 26
5.
6.
In the Control Properties screen, enter the following: Internal Name = GET_DESC_ACCT Display Name = Get Account Information Description = Get Account Information Function = <the name of the PL/SQL function> of type PL/SQL The PL/SQL function must be written such that it takes a parameter DISTRIBUTION_ID and returns the appropriate value for the account based on what information is located in the descriptive flexfield. Result Type = None Press OK to create the new function Get Account Information. From the Navigator window, notice that the new function Get Account Information is now listed under FA Account Generator/ Functions. Highlight the words Get Account Information. Add an attribute to the Get Account Information function. With Get Account Information selected in the Navigator window, go to the Edit menu and choose New/ Attribute. The Control Properties screen should appear. In the Control Properties screen, enter the following: Internal Name = DISTRIBUTION_ID Display Name = DISTRIBUTION_ID Description = Distribution ID Type = Number Default Values = Item Attribute, Distribution ID Press OK to create the new attribute Distribution ID for the Get Account Information function. DISTRIBUTION_ID will then be listed as an attribute in the Navigator window, as shown below:
7.
8.
9.
10. Add another attribute to the Get Account Information function. With Get Account Information selected in the Navigator window, go to the Edit menu and choose New / Attribute. The Control Properties screen should appear. 11. In the Control Properties screen, enter the following: Internal Name = ACCOUNT_VALUE_SEG Display Name = ACCOUNT_VALUE_SEG
27
Description = Account Value Segment Type = Text Press OK to create the new attribute Account Value Segment for the Get Account Information function. Account Value Segment will then be listed as an attribute in the Navigator window, 12. Now that the function is created and its attributes are defined, return to the Generate Category Level screen to construct the process. 13. Change the function labels from Name to Comment. Right click in the white space of the Generate Category Level Account screen, then choose Show Label/Comment from the menu (as shown below).
14. Now, you will add the new function to the Generate Category Level Account process. In the Navigator window, navigate to FA Account Generator/Functions to locate the Get Account Information function. 15. In the Navigator window, click and hold down the mouse on the words Get Account Information and drag the mouse to the Generate Category Level Account screen. Release the mouse button, and you will see a new instance of this function. Place the new icon directly above the path between the Copy Segment Value from Code Combination icon and the Assign Value to Segment icon, as shown below:
28
16. Highlight the path that connects the two function icons Copy Segment Value from Code Combination and Assign Value to Segment. Push the delete key to delete this path. You will insert the new Get Account Information function icon in between these two icons.
17. Position the mouse on the Copy Segment Value from Code Combination function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Get Account Information. You will see a new path line appear to connect the two icons as you drag your mouse across the screen. 18. Position the mouse on the Get Account Information function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Assign Value to Segment. You will see a new path line appear to connect the two icons as you drag your mouse across the screen. 19. When you have completed all of the steps, the end result should appear something like this:
29
Problem. We want to use the Account Generator to generate journal entries for two Book
Level Accounts: Intercompany Receivables Account and the Intercompany Payables Account. The Chart of Accounts specifies the following combination of segments: 1. 2. 3. 4. 5. 6. Operating Unit - Balancing Segment - derived from Distribution CCID/Assignments form Account - Natural Account - derived from the Book Controls form Sub-Account - Unqualified Minor - Unqualified Department - Cost Center - derived from the Distribution CCID/Assignments form Expansion - Unqualified
The Unqualified Segments are generally derived from the Default CCID/ Book Controls form. However, we want to create a custom table that contains the following columns and sample values: ACCOUNT TYPE Intercompany Receivables Intercompany Payables SEGMENT 3 456 786 SEGMENT 4 890 567
Thus, if the account type is Intercompany Receivables, the default combination generated by Account Generator is The required code combination generated would be as it draws values for Segments 3 and 4 from the above table. If the account type is Intercompany Payables, the default combination generated by Account Generator is The required code combination generated is as it draws values for Segments 3 and 4 from the above table.
01-7680-000-000-000-000. 01-7680-456-890-000-000,
01-7680-000-000-000-000. 01-7680-786-567-000-000,
Solution. Since we are creating a table to store the values of Segments 3 and 4, we will have to
(a) create a PL/SQL function to access these values and (b) make them available to populate the appropriate segments in Account Generator. Thus, we will create a new process path that branches from the Default path in order to create the appropriate code combinations.
Steps.
1. 2. Download the FA Account Generator file from the Database. From the Navigator window, navigate to FA Account Generator/ Processes/ Generate Book Level Account. The Generate Book Level Account screen will appear, as shown below:
30
3.
From the Navigator window, navigate to FA Account Generator/ Functions and highlight the word Functions. Create a new function. With Functions selected in the Navigator window, go to the Edit menu and choose New/ Function. The Control Properties screen should appear. In the Control Properties screen, enter the following: Internal Name = GET_ACCT_VALUE Display Name = Get Account Value Description = Get Account VALUE Function = <the name of the PL/SQL function> of type PL/SQL The PL/SQL function must be written such that it takes a parameter DISTRIBUTION_ID and returns the appropriate value for the account based on what information is located in the descriptive flexfield. A sample name might be FA_FLEX_PKG.GET_ACCT_INFO. Result Type = None Press OK to create the new function Get Account Value.
4.
5.
6.
From the Navigator window, notice that the new function Get Account Information is now listed under FA Account Generator/ Functions. Highlight the words Get Account Value.
7.
Add an attribute to the Get Account Value function. With Get Account Value selected in the Navigator window, go to the Edit menu and choose New/ Attribute. The Control Properties screen should appear.
8.
In the Control Properties screen, enter the following: Internal Name = DISTRIBUTION_ID Display Name = Distribution ID Description = Distribution ID Type = Number Default Values = Item Attribute, Distribution ID Press OK to create the new attribute Distribution ID for the Get Account Information function. DISTRIBUTION_ID will then be listed as an attribute in the Navigator window, as shown:
31
9.
Add another attribute to the Get Account Value function. With Get Account Value selected in the Navigator window, go to the Edit menu and choose New / Attribute. The Control Properties screen should appear.
10. In the Control Properties screen, enter the following: Internal Name = ACCT_SEGMENT_VALUE Display Name = Account Segment Value Description = Account Segment Value Type = Text Default Value = Item Attribute, Account Segment Value Press OK to create the new attribute Account Segment Value for the Get Account Value function. Account Segment Value will then be listed as an attribute in the Navigator window,
11. Now that the function is created and its attributes are defined, return to the Generate Book Level screen to construct the process. 12. Change the function labels from Name to Comment. Right click in the white space of the Generate Book Level Account screen, then choose Show Label/Comment from the menu (as shown below). 13. Change the function labels from Name to Display Name. Right click in the white space of the Generate Book Level Account screen, then choose Show Label/Display Name from the menu, as shown below:
32
14. Now, you will add the Get Book Account Name function to the Generate Book Level Account process. This function will identify to which Account Type a segment set belongs (e.g., Intercompany Receivables, Intercompany Payables, etc.) In the Navigator window, navigate to FA Account Generator / Functions to locate the Get Book Account Name function.
15. In the Navigator window, click and hold down the mouse on the words Get Book Account Name and drag the mouse to the Generate Book Level Account screen. Release the mouse button, and you will see a new instance of this function. Place the new icon directly above the path connecting the Assign Value to Segment function and the Copy Values from Code Combination function.
16. Highlight the path that connects the two function icons Copy Values from Code Combination and Assign Value to Segment. Push the delete key to delete this path. You will insert the new Get Book Account Name function icon in between these two icons.
17. Position the mouse on the Assign Value to Segment function icon and right click. As you continue to hold down the right mouse button, move the mouse to the new icon named Get Book Account Name. You will see a new path line appear to connect the two icons as you drag your mouse across.
33
18. Position the mouse on the Get Book Account Name function icon and right click. As you continue to hold down the right mouse button, move the mouse to the icon named Copy Values from Code Combination. You will see a new path line appear to connect the two icons as you drag your mouse across. When the menu appears, select Default as the path designation. 19. Now add a new path to populate segments 3 and 4 from the custom table. In the Navigator window, navigate to FA Account Generator/Functions. Note the new function listed under this section entitled Get Account Value that was created in step 5. 20. In the Navigator window, click and hold down the mouse on the words Get Account Value and drag the mouse to the Generate Book Level Account screen. Release the mouse button, and you will see a new instance of this function. Place it below the new Get Book Account Name icon added in step 15. Do this twice to create two instances of the Get Account Value function: one for segment 3 and one for segment 4. 21. Double click on the Get Book Type Code icon. When the Control Properties screen appears, select the Attribute Values tab. You should see the following values: Name Distribution ID Account Segment Value Value Type Item Attribute Item Attribute Value Distribution ID Account Segment Value Type Number Text
22. In the Navigator window, navigate to FA Account Generator/Standard Flexfield Workflow/Functions/Assign Value to Segment.
23. In the Navigator window, click and hold down the mouse on the words Assign Value to Segment and drag the mouse to the Generate Book Level Account screen. Release the mouse button, and you will see a new instance of this function. Do this twice to create two instances of the Assign Value to Segment function: one for segment 3 and one for segment 4. Arrange the icons as shown below, connecting the paths between each icon:
34
Note that the path between the Get Book Account Name function and the Get Account Value function should be designated Intercompany Account Receivables. Thus, we see that for Intercompany Account Receivables, the new path will be taken while all other accounts will take the Default path. 24. Double click on the first Assign Value to Segment icon. When the Control Properties screen appears, select the Process Activity tab and enter the comment Assign Value to Segment 3. 25. In the Control Properties screen of the Assign Value to Segment 3 icon, select the Attribute Values tab and enter the following values:
26. Double click on the second Assign Value to Segment icon. When the Control Properties screen appears, select the Process Activity tab and enter the comment Assign Value to Segment 4. 27. In the Control Properties screen of the Assign Value to Segment 3 icon, select the Attribute Values tab and enter the following values:
35
28. Setup a path for the Intercompany Accounts Payable path. Complete steps 19 through 27 to create a second new path above the Default workflow path. The end result should appear similar to this:
The Sub-Account Segment (3) and Minor Segment (4) are populated by one of these three paths.
36
Problem. We have a similar problem to the one stated in Example E. However, we want to
use the Account Generator to generate journal entries for *several* Book Level Accounts. In Example E, we only generated accounts for two account types (Intercompany Receivables and Intercompany Payables) and already the screen was becoming crowded and difficult to manage. As before, the Chart of Accounts specifies the following combination of segments: 1. 2. 3. 4. 5. 6. Operating Unit - Balancing Segment - derived from Distribution CCID/Assignments form Account - Natural Account - derived from the Book Controls form Sub-Account - Unqualified Minor - Unqualified Department - Cost Center - derived from the Distribution CCID/Assignments form Expansion - Unqualified
The Unqualified Segments are generally derived from the Default CCID/ Book Controls form. However, we want to create a custom table that contains the following columns and sample values for 12 of the 15 different Book Accounts: ACCOUNT TYPE Intercompany Receivables Intercompany Payables Cost of Removal Clearing SEGMENT 3 456 786 122 SEGMENT 4 890 567 143
Thus, if the account type is Intercompany Receivables, the default combination generated by Account Generator is The required code combination generated would be as it draws values for Segments 3 and 4 from the above table. If the account type is Intercompany Payables, the default combination generated by Account Generator is The required code combination generated is as it draws values for Segments 3 and 4 from the above table.
01-7680-000-000-000-000. 01-7680-456-890-000-000,
01-7680-000-000-000-000. 01-7680-786-567-000-000,
Solution. Since we are creating a table to store the values of Segments 3 and 4, we will have to
(a) create a PL/SQL function to access these values and (b) make them available to populate the appropriate segments in Account Generator. In Example E, we created two new process paths that branched from the Default path: one to handle Intercompany Receivables and one to handle Intercompany Payables. However, it would be impossible to fit 12 different paths onto one workflow screen, not to mention cluttered and confusing.
37
Instead, a possible solution would be to create a new Process for accessing the values in the custom table and creating the appropriate flexfield combinations. A sample workflow might look something like this:
38
3.
4.
1. 2. 3.
From the menu bar, choose File/Save As You have the option of saving to a file or saving the file to the database. If you are saving to a file: Click on File to highlight it. Browse to find the location you want the file to reside Enter a filename and press OK. If you are saving a file to the database Click on Database. Enter the following: User Password Connect Effective GWYUID FNDNAM ORACLE_SID or TWO_TASK You can leave this null.
4.
Web References
The Oracle Assets Homepage - http:// www-apps.us.oracle.com/fa/
39
40
Appendix A - Table of Account Generator Processes and Generated Accounts Appendix A - Account Generator Processes and Generated Accounts
Asset Account Names Book Account Names Depreciation Expense Cost of Removal Clearing Cost of Removal Gain, Cost of Removal Loss Deferred Depreciation Expense Deferred Depreciation Reserve Depreciation Adjustment Intercompany Accounts Payable Intercompany Accounts Receivable Net Book Value Retired Gain Net Book Value Retired Loss Proceeds of Sale Clearing Proceeds of Sale Gain Proceeds of Sale Loss Revaluation Reserve Retired Gain Revaluation Reserve Retired Loss Budget Corporate Tax Asset Clearing Asset Cost Construction-in-Process Clearing Construction-in-Process Cost Depreciation Reserve Revaluation Amortization Revaluation Reserve
Book Classes
Appendix A - Table of Account Generator Processes and Generated Accounts Oracle/Client Confidential - For internal use only
41
PROCESSES
FUNCTIONS
LOOKUP TYPES
LOOKUP TYPES
Account Names
Appendix B - FA Account Generator Menu: Quick Reference Oracle/Client Confidential - For internal use only
42
Proceeds of Sale Gain Proceeds of Sale Loss Revaluation Reserve Retired Gain Revaluation Reserve Retired Loss Book Classes Budget Corporate Tax Asset Clearing Asset Cost Construction-In-Process Clearing Construction-In-Process Cost Depreciation Reserve Revaluation Amortization Revaluation Reserve
Appendix B - FA Account Generator Menu: Quick Reference Oracle/Client Confidential - For internal use only
43
Introduction
This script assists in diagnosing problems in concurrent processes that fail due to account generation. This script is similar to the flexbuilder test screen that was used in Release 10 of the Application. The output from this script gives the user two pieces of information: the code combination that was attempted to be built and a reason why it is not able to build the code combination. Oracle Assets Release 11 is delivered with this SQL*PLUS test script. Its called faxagtst.sql. You can find it in the following directory Name: $FA_TOP/admin/sql/faxagtst.sql The latest script comes with the 11.03 Minipack. If you are not on 11.03, please contact World Wide Support for the latest version of the script.
Problem Explanation
When running depreciation, you may find that it completes with Error. Please review the Log File. If the problem relates to Account Generator, you will notice the following in the Log File:
Depreciation Program Exception Report ccid sent to fadoflx from fadosgl is: 19739 dist_ccid in fadoflx is: 19739 h_book_type_code = INSURANCE account_type = ASSET_COST_ACCT account = 1520 APP-48208: Dist CCid has the value of 19739. APP-48208: h_rtn_ccid has the value of -1. Concat segs = Error: function fafbgcc returned failure (called Getting account CCID Error: function fadoflx returned failure (called Error: function fadosgl returned failure (called Error: function faxinaj returned failure (called fazccb cache results
Required Parameters
Appendix C - Account Generator Test Script Oracle/Client Confidential - For internal use only
44
When you try to run the script, you will be prompted for the following information. This information is noted in the Log File.
Enter value for ASSET_COST_ACCT Enter value for Book INSURANCE Enter value for 19739 Enter value for 1520 Enter value for account_type: ASSET_COST_ACCT book: INSURANCE distribution_ccid: 19739 account_segment: 1520 account_ccid: 0
Please note if the log file does not mention an account_ccid, then please enter a 0 (ZERO). Do not leave it NULL.
Results of Script
The following is generated when you run the script. At the bottom of the script you will notice the following: The script will tell you if Dynamic inserts is set to YES. The script will note the code combination it is trying to build. The script will also give a reason why it is unable to build the combination.
VALIDATION_TYPE = GENERATE_CCID DYNAMIC_INSERTS_ALLOWED = TRUE INSERT IF NEW COMBINATION = FALSE FND_FLEX_SEGMENT1 IS 01 FND_FLEX_SEGMENT2 IS 740 FND_FLEX_SEGMENT3 IS 1520 FND_FLEX_SEGMENT4 IS 0000 FND_FLEX_SEGMENT5 IS 000 CONCATENATED SEGMENTS TO BE VALIDATED IS 01-740-1520-0000-000 VALIDATION FAILED START FND_FLEX_WORKFLOW_APIS.END_GENERATION PROCESS STATUS IS PROCESS RESULT IS SUCCESS CCID IS 0 CONCATENATED SEGMENTS IS CONCATENATED ID IS CONCATENATED DESCRIPTIONS IS VALIDATION_STATUS IS INVALID NEW COMBINATION IS FALSE ERROR MESSAGE IS FND FLEX-COMBINATION DISABLED Failed to Generate CCID Segments : PL/SQL procedure successfully completed.
Appendix C - Account Generator Test Script Oracle/Client Confidential - For internal use only
45