Oracle Fixed Assets - Account Generator and WorkflOW

ORACLE APPLICATIONS

WHITE PAPER

Fixed Assets -- AccountGenerator and Workflow

Product Design and Architecture

Fixed Assets -- Account Generator and Workflow iiAccount_Generator_Paper Oracle/Client Confidential - For internal use only

Contributors

Name Position

Andrew Pettinella Senior Product AnalystEileen R. Wexler Product Analyst

Change Record

Date Author Version Change Reference

20 Sept 1998 A.Pettinella 1 Completed Document -- now using the template1 Dec 1998 A.Pettinella 1.1 Added Appendix C -- Case Study on customization13 Jan 1999 E. Wexler 1.2 Added detailed instructions. Moved Appendix C into body of paper,

example's section. Added further explanations & graphics.20 Jan 1999 E. Wexler 1.3 Added Examples D, E, and F. Created a Word 95 version to replace the

Word 97 version & increase ease of use.29 Jan 1999 A. Pettinella, E. Wexler 1.4 Added Appendix C -- logfile and scripts.

Fixed Assets -- Account Generator and Workflow iiiAccount_Generator_Paper Oracle/Client Confidential - For internal use only

Contents

Introduction .......................................................................................................................................................................... 1

Definitions ............................................................................................................................................................................ 3

Default Flexbuilder / Account Generator Setup .................................................................................................................. 4Generation of Accounting Code Combinations .................................................................................................................... 4

Account Generator Processes .............................................................................................................................................. 6The Generate Default Account Process................................................................................................................................ 7The Generate Category Level Process.................................................................................................................................. 8Example: Generating a Category Level Account.................................................................................................................. 9Function Control Properties............................................................................................................................................... 11

Upgrading from Release 10 Flexbuilder............................................................................................................................. 13

Account Generator Customization ..................................................................................................................................... 14Example A: Changing the value of a segment for all Book Level and Category Level accounts ......................................... 14Example B: Specifying a different value for a segment based on account type .................................................................. 16Example C: Specifying a different value for a segment based on book .............................................................................. 20Example D: Specifying a different value for a segment based on a descriptive flexfield ................................................... 24Example E: Specifying unqualified segments based on values from a custom table ........................................................... 28Example F: Inserting a new process: an alternate solution to Example E .......................................................................... 34

Account Generator Basics ................................................................................................................................................. 36How to open the Account Generator .................................................................................................................................. 36How 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

Fixed Assets -- Account Generator and Workflow Introduction 1Account_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

Introduction

Objective

This white paper assists the novice Workflow user in using Account Generator, which is new toRelease 11.0. We expect users to have knowledge of Oracle Assets, flexfield definitions, and aworking knowledge of Oracle Workflow. Account Generator builds the general ledger accountcombinations used to generate the general ledger journals by Oracle Assets. It allows you todesignate a specific source for each segment in the account for which Oracle Assets creates ajournal entry. The Account generator gives you the flexibility to create journal entries accordingto your requirements. You can specify to what detail to create journal entries, as well as thedetail level for each book and account type.

What is Account Generator?

The Account Generator in Oracle Assets utilizes Oracle Workflow. You can view and customizeAccount Generator processes through the Oracle Workflow Builder.

What is the Oracle Workflow Builder?

Oracle Workflow Builder lets you create, view, or modify a business process with simple dragand drop operations. Using the Workflow Builder, you can create and modify all workflowobjects, including activities, item types, and messages.

Has Account Generator replaced Flexbuilder?

In Release 10, several Oracle Applications products used Flexbuilder to derive account codecombinations for certain account transactions. In Release 11.0, Account Generator replacesFlexbuilder to provide implementation teams with even greater flexibility and a better userinterface.

What happens to Flexbuilder if you upgrade?

Account Generator replaces Flexbuilder and is automatically set up as part of the upgrade whenyou migrate from Release 10 to Release 11.

Fixed Assets -- Account Generator and Workflow IntroductionAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

2

White Paper Reviewers

Name Position Initial and Date

Trim Pershad Development ManagerUsha Thothatri Senior Product Manager

Fixed Assets -- Account Generator and Workflow DefinitionsAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

3

Definitions

Processes

A set of activities that need to be performed to accomplish a business goal. A process isrepresented 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 anapplication, or retrieve application information.

Fixed Assets -- Account Generator and Workflow Default Flexbuilder/Account Generator SetupAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

4

Default Flexbuilder/Account Generator Setup

Generation of Accounting Code Combinations

The table below defines where each segment derives its account detail. For instance, theCompany segment derives its value from the Distribution CCID, which is the accountingflexfield combination noted on the Assignments Screen. The depreciation account is derivedfrom the Distribution CCID entered in the Assignments form.

ACCOUNT STRUCTURE

Segment Name Default Segment Sources

Company Distribution CCID (Assignments screen)Cost Center Default CCID (Book Controls screen)Account Account Segment ValueProduct Default CCID (Book Controls screen)Sub-Account Default CCID (Book Controls screen)

Balancing Segment - 01

The Balancing segment is defaulted from the Assignments screen, as shown above.

Fixed Assets -- Account Generator and Workflow Default Flexbuilder/Account Generator SetupAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

5

The Cost Center is derived from the Default CCID in the Book Controls form, as are the twounqualified segments Product and Sub-Account.

Cost Center 000

Product 0000

Sub-Account 000

Fixed Assets -- Account Generator and Workflow Account Generator ProcessesAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

6

Account Generator Processes

The Account Generator is used to perform one of these five processes:

1. Generate Default Account2. Generate Asset Level Account3. Generate Book Level Account4. Generate Category Level Account5. Generate Account using Flexbuilder Rules

The main process is the Generate Default Account process noted above.

The Generate Default Account process incorporates three other processes:

1. Generate Asset Level Account2. Generate Book Level Account3. 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 bythe 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:

Table 1.1 Account Generator Processes and Generated Accounts

Asset Account Names Depreciation Expense

Book Account Names Cost of Removal ClearingCost of Removal Gain,Cost of Removal LossDeferred Depreciation ExpenseDeferred Depreciation ReserveDepreciation AdjustmentIntercompany Accounts PayableIntercompany Accounts ReceivableNet Book Value Retired GainNet Book Value Retired LossProceeds of Sale ClearingProceeds of Sale GainProceeds of Sale LossRevaluation Reserve Retired GainRevaluation Reserve Retired Loss

Book Classes BudgetCorporateTax

Category Account Names Asset ClearingAsset CostConstruction-in-Process ClearingConstruction-in-Process CostDepreciation ReserveRevaluation AmortizationRevaluation Reserve


7

The Generate Default Account Process

The Generate Default Account Process is among the most important processes. From Oracle Workflow Builder 2.0, enter theNavigator window. Navigate to FA Account Generator/ Processes/ Generate Default Account. The Generate Default Accountscreen will open as shown below.

The generate default account process above is a graphical representation of the Account Generator process. The first icon on theleft, 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 differenttypes 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 GeneratedAccounts. For example, the Cost Clearing Account is a Category Level Account. Therefore, it adopts the “Generate CategoryLevel Account” path. If you double click on the Generate Category Level Account icon, you will see the process involved ingenerating this type of account.


8

The Generate Category Level Account Process

Once you double click on the Generate Category Level Account icon, the Generate Category Level Account screen opens asshown below:

You may notice that your labels are marked with different names. For instance, the Balancing Segment from Distribution CCIDicon may be labeled “Copy Segment Value from Code Combination.” If you screen does not appear labeled as the aboveexample, you can change the icon labels as follows:

1. Right click in the white space of the Generate Category Level Account screen.2. A menu will appear. Choose “SHOW LABEL” and its submenu “COMMENT.”3. Your icon will now appear labeled as it does above.4. To change the icon labels again, right click in the white space of the screen.5. From the menu, choose “SHOW LABEL” and its submenu “DISPLAY NAME”6. 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 theDistribution 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 Accountsalternative 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 Accountcomes from the Asset Categories form, while the Proceeds of Sale Clearing Account comes from the Book Controlsform.

Unqualified Segments from Default CCID - This icon is where the other segments (not including the balancingsegment, cost center and account segments) derive their values.


9

Example: Generating a Category Level Account

Problem. We want to define the Asset Clearing Account using the Generate Category LevelAccount process. The Chart of Accounts has three segments: Company, Cost Center, andAccount. Company - Cost Center - Account

Building the Account. The Asset Clearing Account must be derived from values entered inthe Book Controls form as well as the Asset Categories form and the Assignments form. Wederive the three segment values:

1. Company segment. Balancing Segment from Distribution ID - Assignments form. 02

Asset Distribution 02-200-3000gives the Company segment

value 02.

2. Cost Center segment. Cost Center Segment from Default CCID - Book Defaults. 00

Book ControlsDefault

01-000-1000 givesthe Cost Center

segment value 000.


10

3. Account segment. Account value in Account Segment - Defined at category level. 2000

Category AssetClearing Account01-100-2000 gives

the Accountsegment value of

2000.

Thus, the Asset Clearing Account is defined as 02-000-2000.


11

Function Control Properties

Defining functions as icons and item types. If you double click on the “Cost Center from Default CCID” icon, the OracleWorkflow Navigator Control Properties screen will appear. There are two tabs on the Control Properties screen: ProcessActivity and Attribute Values.

Fig. 1.1

Process Activity.

This is where the process item is defined.

One important aspect of the Process Activitytab is that the comment is defined here. Thecomment is the label that displays when youchoose Show Label / Comment from themenu that appears when right clicking in thewhite space of the screen. You can changethe comment in this screen to suit your needs.This will be reflected in the new processdiagram.

Attribute Values.

Each process item has a number of attributesthat can be selected and altered from theControl Properties screen. From the pull-down menu labeled “Select Attribute,” you

Fig. 1.2

can choose which particular item you need toalter.

As shown in Fig. 1.2, Code Combination IDis an example of a selectable attribute. CodeCombination ID tells us from which accountthe segment value is being pulled. You canchange 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 inFig 1.3

4. Select a new value for the CodeCombination ID, such as Default CCID.

5. Press the button marked “Apply”


12

Fig. 1.3

The Segment attribute denotes which segmentis being defined. In Fig. 1.2, we see the valueis set to FA_COST_CTR. This means thatthe Cost Center segment is the one defined inthis process. Other values for Segmentinclude:

• Balancing Segment = GL_BALANCING• Cost Center = FA_COST_CTR• Account Segment = GL_ACCOUNT

Unqualified segments are those segments inaddition to the mandatory BalancingSegment, Cost Center and Account Segments.

Fixed Assets -- Account Generator and Workflow Upgrading from Release 10 FlexbuilderAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

13

Upgrading from Release 10 Flexbuilder

As part of the upgrade process, Autoinstall automatically creates an Account Generator process from your Flexbuilderconfiguration. This Account Generator process contains any customizations you had in Flexbuilder and is called “GenerateAccount 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 anyway, nor modify the PL/SQL functions. Oracle does not support modifications to this process. If you used Flexbuilder inRelease 10 and now would like to add customizations to your Account Generator , you should do so by starting from the DefaultAccount Generator process.

If you used Flexbuilder in Release 10 but did not customize the default configuration, you do not need to use the GenerateAccount Using Flexbuilder rules process. The default Account Generator process gives you the same result as the defaultconfiguration in Flexbuilder.

Fixed Assets -- Account Generator and Workflow Account Generator CustomizationAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

14

Account Generator Customization

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 DistributionCCID for all Book Level Accounts and Category Level Accounts noted in Table 1.1.

Steps.

1. Download the FA Account Generator file from the Database.

2. From the Navigator window, navigate to FA Account Generator/Processes/Generate DefaultAccount.

3. Double click on Generate Default Account. We need to modify the following:

• • Book Level Accounts

• • Category Level Accounts


15

4. Double click on the Generate Book Level Account process. The Generate Book LevelAccount screen will appear.

5. In the Generate Book Level Account screen, double click on the Cost Center from CCIDicon. The Control Properties screen will appear.

6. Select the Attribute Values tab.

7. Select the attribute Code Combination ID by clicking on the word “Code Combinatio...” andchange the Value from “Default CCID” to “Distribution CCID” in the pull down menu thatappears. This step is demonstrated below.

8. Return to the Generate Default Account screen and locate the Generate Category LevelAccount Process. The Generate Category Level Account screen will appear.

9. In the Generate Category Level Account screen, double click on the Cost Center from CCIDicon. The Control Properties screen will appear.

10. Select the Attribute Values tab.

11. Change the value of the attribute “Code Combination ID” from Default CCID to DistributionCCID, 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.


16

Example B: Specifying a different value for a segment based on account type

Problem. We want to specify a different Cost Center segment value for the Asset CostAccount, a specific type of Category Level Account. The Cost Center segment is derived fromthe default for the Asset Cost account, but we will derive the Cost Center segment from theDistribution CCID. Asset Level Accounts and Book Level Accounts will continue to have theirCost Center segment derived from the Default CCID as expected, and all other Category LevelAccounts (other examples are listed in Table 1.1) will also continue to have their Cost Centersegment derived from the Default CCID.

Solution. For the Category Level Account called Asset Cost, we will create a new process paththat designates a different value for the Cost Center segment to derive its value. All otheraccounts will use the default path to specify their Cost Center segment values.

Steps.


2. From the Navigator window, navigate to FA Account Generator / Processes / GenerateDefault Account.


17

3. Double click on Generate Default Account to open the Generate Default Account screen. Weneed to modify the Cost Center segment of all of the Category Level Accounts.

4. Double click on the Generate Category Level Account process. The Generate Category LevelAccount screen will appear.

5. Change the function labels from “Name” to “Comment. ” Right click in the white space ofthe Generate Category Level Account screen, then choose Show Label/Comment from themenu (as shown below).

6. Now, you will add two new functions to the Generate Category Level Account process. Inthe Navigator window, navigate to FA Account Generator/Standard FlexfieldWorkflow/Functions. Note that one function listed under this section is “Copy SegmentValue from Code Combination.”

7. In the Navigator window, click and hold down the mouse on the words “Copy SegmentValue from Code Combination” and drag the mouse to the Generate Category Level Accountscreen. Release the mouse button, and you will see a new instance of this function. Createtwo instances.


18

8. Change the function labels from “Comment” to “Name.” Right click in the white space ofthe Generate Category Level Account screen, then choose Show Label/Display Name fromthe menu (as shown in Step 5).

9. Reposition the two icons created in Step 7 so that one is directly above the “BalancingSegment from Distribution CCID” icon and the other is directly above the “Cost Center fromDefault CCID” icon.

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 enterthe comment “Make the Cost Account = Distribution CCID.”

11. Double click on the icon now located directly above the “Balancing Segment fromDistribution CCID” icon. When the Control Properties screen appears, select the ProcessActivity 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. Asyou 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 toconnect the two icons as you drag your mouse across the screen. When you release, a menuwill appear. Select Asset Cost from the menu, as shown below:

Right click on the“Get CategoryAccount Name”function...

...to create a newProcess Path.

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


19

down the right mouse button, move the mouse to the “Make the Cost Account = DistributionCCID” icon.

14. Create another path to connect the “Make the Cost Account = Distribution CCID” icon andthe “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 theControl Properties screen, from which you may choose the Attribute Values tab. TheAttribute Values are listed in the tables below:


20

Balancing Segment from Distribution CCID function.Name Value Type Value Type

Code Combination Item Attribute Default CCID NumberSegment Identifier Constant Qualifier LookupSegment Constant GL_BALANCING TextReplace Existing Constant False Lookup

Make the Cost Account = Distribution CCID function.Name Value Type Value Type

Code Combination Item Attribute Distribution CCID NumberSegment Identifier Constant Qualifier LookupSegment Constant FA_COST_CTR TextReplace Existing Constant False Lookup

16. The process should look like this upon completion:

You will notice that there are two paths. If a code combination is being generated for the assetcost, it will follow the top path. All other accounts will be generated via the lower (default) path.


21

Example C: Specifying a different value for a segment based on book

Problem. We want to set up our book such that the Cost Center segment is derived from theDistribution CCID in the Corporate Book. However, the Cost Center segment is derived from thedefault CCID in the Budget Book or Tax Book.

Solution.

Steps.


2. From the Navigator window, navigate to FA Account Generator/Lookup Types.

3. Create a new Lookup Type.

a. In the Navigator, place the cursor on the line labeled “Lookup Types” and select it.b. From the Edit menu, choose New/Lookup Type.c. When the Oracle Workflow Navigator Control Properties screen appears, enter:

• Internal Name = BOOK_TYPE_CODE• Display Name = Books• Description = Book Type Code

d. Choose the OK button.


22

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 tosave:

• 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

5. Assign the Result Type, a predefined Lookup Type. Result Types list the possible resultsreturned by this activity. (Note: Your workflow diagram may sometimes branch dependingon 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 theControl Properties screen appears, change Result Type by selecting Books from the pull-down 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 selectHelp/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.

6. Navigate to FA Account Generator/Processes, then double click on “Generate DefaultAccount.”


23

7. We need to modify the Generate Book Level Account process and the Generate CategoryLevel Account process. Double click on the Generate Book Level Account icon to addressthis process first.

8. Change the function labels from “Name” to “Comment.” Right click in the white space ofthe Generate Book Level Account screen, then choose Show Label/Comment from the menu.

9. Now, you will add two new functions to the Generate Book Level Account process. In theNavigator window, navigate to FA Account Generator/Standard FlexfieldWorkflow/Functions. Note that one function listed under this section is “Copy SegmentValue from Code Combination.”

10. In the Navigator screen, click and hold down the mouse on the words “Copy Segment Valuefrom 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 abovethe “Cost Center from Default CCID” icon.

11. In the Navigator window, navigate to FA Account Generator/Functions. Note that onefunction 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 TypeCode” and drag the mouse to the Generate Book Level Account screen. Release the mousebutton, and you will see a new instance of this function. Place it above the “BalancingSegment from Distribution CCID” icon.

13. Double click on the “Get Book Type Code” icon. When the Control Properties screenappears, 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 ControlProperties screen appears, select the Process Activity tab and enter the comment “CostCenter from the Distribution CCID.”

15. In the Control Properties screen of the “Cost Center from the Distribution CCID” icon, selectthe Attribute Values tab and enter the following values:

Name Value Type Value TypeCode Combination Item Attribute Distribution CCID NumberSegment Identifier Constant Qualifier LookupSegment Constant FA_COST_CTR TextReplace Existing Constant False Lookup


24

16. Position the mouse on the “Cost Center from the Distribution CCID” function icon and rightclick. As you continue to hold down the right mouse button, move the mouse to the newicon named “Account Segment from the Book Control.” You will see a new path line appearto 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 continueto hold down the right mouse button, move the mouse to the new icon named “Cost Centerfrom Default CCID.” You will see a new path line appear to connect the two icons as youdrag 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 continueto hold down the right mouse button, move the mouse to the new icon named “Cost Centerfrom Distribution CCID.” You will see a new path line appear to connect the two icons asyou drag your mouse across the screen. When you release, a menu will appear. Select USCorporate 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 iconnamed “Account Segment from Book Control.” You will see a new path line appear toconnect the two icons as you drag your mouse across the screen. Once you reposition youricons, the end result should appear similar to the picture show below:

20. From the Navigator window, navigate to FA Account Generator/Processes/GenerateCategory Level Account to open the Generate Category Level Account screen. Repeat steps8 through 19 for the Generate Category Level Accounts Process.


25


26

Example D: Specifying a different value for a segment based on a descriptive flexfield

Problem. We want to build accounting flex combinations where the Asset Cost segment, aCategory 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, andIntercompany Additions. We want to store the type of addition in the descriptive flexfield, thenhave Account Generator create the corresponding accounting flex combinations based on theAddition type.

Solution. Since we are varying Asset Cost, we must be working with a Category LevelAccount (see Table 1.1). We will create two attributes: Distribution ID and Account ValueSegment. 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 segmentthat is required to build the proper accounting flex combination based on the information in thedescriptive flexfield. For instance, if the PL/SQL function identifies that an addition of typeNEW is stored in the descriptive flexfield, it will return some value x. If a LATE addition isstored, then it will return some value y.

This return value will be used to populate the Account Value Segment, which is the otherattribute that we specified. The Account Value Segment can then be used to create theappropriate accounting flex combination.

Steps.


2. From the Navigator window, navigate to FA Account Generator/ Processes/ GenerateCategory Level Account.

3. Double click on the Generate Category Level Account process. The Generate Category LevelAccount screen will appear.

4. From the Navigator window, navigate to FA Account Generator/ Functions and highlight theword “Functions.”

5. Create a new function. With Functions selected in the Navigator window, go to the Editmenu and choose New/ Function. The Control Properties screen should appear.


27

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 parameterDISTRIBUTION_ID and returns the appropriate value for the account based on what information is locatedin the descriptive flexfield.• Result Type = None• Press OK to create the new function “Get Account Information.”

7. From the Navigator window, notice that the new function “Get Account Information” is nowlisted under FA Account Generator/ Functions. Highlight the words “Get AccountInformation.”

8. 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. TheControl Properties screen should appear.

9. 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 Navigatorwindow, as shown below:

10. Add another attribute to the Get Account Information function. With “Get AccountInformation” 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


28

• 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 theNavigator window,

12. Now that the function is created and its attributes are defined, return to the GenerateCategory Level screen to construct the process.

13. Change the function labels from “Name” to “Comment. ” Right click in the white space ofthe Generate Category Level Account screen, then choose Show Label/Comment from themenu (as shown below).

14. Now, you will add the new function to the Generate Category Level Account process. In theNavigator window, navigate to FA Account Generator/Functions to locate the “Get AccountInformation” function.

15. In the Navigator window, click and hold down the mouse on the words “Get AccountInformation” and drag the mouse to the Generate Category Level Account screen. Releasethe mouse button, and you will see a new instance of this function. Place the new icondirectly above the path between the “Copy Segment Value from Code Combination” icon andthe “Assign Value to Segment” icon, as shown below:


29

16. Highlight the path that connects the two function icons “Copy Segment Value from CodeCombination” and “Assign Value to Segment.” Push the delete key to delete this path. Youwill 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 andright click. As you continue to hold down the right mouse button, move the mouse to thenew icon named “Get Account Information.” You will see a new path line appear to connectthe 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 youcontinue 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 asyou drag your mouse across the screen.

19. When you have completed all of the steps, the end result should appear something like this:


30

Example E: Specifying unqualified segments based on values from a custom table

Problem. We want to use the Account Generator to generate journal entries for two BookLevel Accounts: Intercompany Receivables Account and the Intercompany Payables Account.The Chart of Accounts specifies the following combination of segments:

1. Operating Unit - Balancing Segment - derived from Distribution CCID/Assignments form2. Account - Natural Account - derived from the Book Controls form3. Sub-Account - Unqualified4. Minor - Unqualified5. Department - Cost Center - derived from the Distribution CCID/Assignments form6. 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 samplevalues:

ACCOUNT TYPE SEGMENT 3 SEGMENT 4Intercompany Receivables 456 890Intercompany Payables 786 567

Thus, if the account type is Intercompany Receivables,the default combination generated by Account Generator is 01-7680-000-000-000-000.

The required code combination generated would be 01-7680-456-890-000-000,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 01-7680-000-000-000-000.

The required code combination generated is 01-7680-786-567-000-000,as it draws values for Segments 3 and 4 from the above table.

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 theappropriate segments in Account Generator. Thus, we will create a new process path thatbranches from the Default path in order to create the appropriate code combinations.

Steps.


2. From the Navigator window, navigate to FA Account Generator/ Processes/ Generate BookLevel Account. The Generate Book Level Account screen will appear, as shown below:


31

3. From the Navigator window, navigate to FA Account Generator/ Functions and highlight theword “Functions.”

4. Create a new function. With Functions selected in the Navigator window, go to the Editmenu and choose New/ Function. The Control Properties screen should appear.

5. 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 parameterDISTRIBUTION_ID and returns the appropriate value for the account based on what information is locatedin the descriptive flexfield. A sample name might beFA_FLEX_PKG.GET_ACCT_INFO.• Result Type = None• Press OK to create the new function “Get Account Value.”

6. From the Navigator window, notice that the new function “Get Account Information” is nowlisted 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 inthe Navigator window, go to the Edit menu and choose New/ Attribute. The ControlProperties 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 Navigatorwindow, as shown:


32

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. TheControl 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 theNavigator window,

11. Now that the function is created and its attributes are defined, return to the Generate BookLevel screen to construct the process.

12. Change the function labels from “Name” to “Comment. ” Right click in the white space ofthe 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 spaceof the Generate Book Level Account screen, then choose Show Label/Display Name from themenu, as shown below:


33

14. Now, you will add the “Get Book Account Name” function to the Generate Book LevelAccount 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 AccountName” and drag the mouse to the Generate Book Level Account screen. Release the mousebutton, and you will see a new instance of this function. Place the new icon directly abovethe path connecting the “Assign Value to Segment” function and the “Copy Values fromCode Combination” function.

16. Highlight the path that connects the two function icons “Copy Values from CodeCombination” and “Assign Value to Segment.” Push the delete key to delete this path. Youwill 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 youcontinue to hold down the right mouse button, move the mouse to the new icon named “GetBook Account Name.” You will see a new path line appear to connect the two icons as youdrag your mouse across.


34

18. Position the mouse on the “Get Book Account Name” function icon and right click. As youcontinue to hold down the right mouse button, move the mouse to the icon named “CopyValues from Code Combination.” You will see a new path line appear to connect the twoicons as you drag your mouse across. When the menu appears, select Default as the pathdesignation.

19. Now add a new path to populate segments 3 and 4 from the custom table. In the Navigatorwindow, navigate to FA Account Generator/Functions. Note the new function listed underthis 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 AccountName” icon added in step 15. Do this twice to create two instances of the “Get AccountValue” function: one for segment 3 and one for segment 4.

21. Double click on the “Get Book Type Code” icon. When the Control Properties screenappears, select the Attribute Values tab. You should see the following values:

Name Value Type Value TypeDistribution ID Item Attribute Distribution ID NumberAccount Segment Value Item Attribute Account Segment Value Text

22. In the Navigator window, navigate to FA Account Generator/Standard FlexfieldWorkflow/Functions/Assign Value to Segment.

23. In the Navigator window, click and hold down the mouse on the words “Assign Value toSegment” and drag the mouse to the Generate Book Level Account screen. Release themouse button, and you will see a new instance of this function. Do this twice to create twoinstances of the “Assign Value to Segment” function: one for segment 3 and one for segment4. Arrange the icons as shown below, connecting the paths between each icon:


35

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 forIntercompany Account Receivables, the new path will be taken while all other accounts will takethe Default path.

24. Double click on the first “Assign Value to Segment” icon. When the Control Propertiesscreen appears, select the Process Activity tab and enter the comment “Assign Value toSegment 3.”

25. In the Control Properties screen of the “Assign Value to Segment 3” icon, select theAttribute Values tab and enter the following values:

Name Value Type Value TypeSegment Identifier Constant Name LookupSegment Constant Sub-Account

(segment 3’s name)Text

Value Item Attribute Account Segment Value TextReplace Existing Value Constant False Lookup

26. Double click on the second “Assign Value to Segment” icon. When the Control Propertiesscreen appears, select the Process Activity tab and enter the comment “Assign Value toSegment 4.”

27. In the Control Properties screen of the “Assign Value to Segment 3” icon, select theAttribute Values tab and enter the following values:

Name Value Type Value TypeSegment Identifier Constant Name LookupSegment Constant Minor

(segment 4’s name)Text

Value Item Attribute Account Segment Value TextReplace Existing Value Constant False Lookup


36

28. Setup a path for the Intercompany Accounts Payable path. Complete steps 19 through 27 tocreate a second new path above the Default workflow path. The end result should appearsimilar to this:

The BalancingSegment (1) ispopulated here.

The AccountSegment (2) ispopulated here.

The Cost CenterSegment (5) ispopulated here.

The Sub-AccountSegment (3) andMinor Segment (4)are populated by oneof these three paths.


37

Example F: Inserting a new process - an alternate solution to Example E

Problem. We have a similar problem to the one stated in Example E. However, we want touse the Account Generator to generate journal entries for *several* Book Level Accounts. InExample E, we only generated accounts for two account types (Intercompany Receivables andIntercompany 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. Operating Unit - Balancing Segment - derived from Distribution CCID/Assignments form2. Account - Natural Account - derived from the Book Controls form3. Sub-Account - Unqualified4. Minor - Unqualified5. Department - Cost Center - derived from the Distribution CCID/Assignments form6. 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 samplevalues for 12 of the 15 different Book Accounts:

ACCOUNT TYPE SEGMENT 3 SEGMENT 4Intercompany Receivables 456 890Intercompany Payables 786 567Cost of Removal Clearing 122 143… … …

Thus, if the account type is Intercompany Receivables,the default combination generated by Account Generator is 01-7680-000-000-000-000.

The required code combination generated would be 01-7680-456-890-000-000,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 01-7680-000-000-000-000.

The required code combination generated is 01-7680-786-567-000-000,as it draws values for Segments 3 and 4 from the above table.

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 theappropriate segments in Account Generator. In Example E, we created two new process pathsthat branched from the Default path: one to handle Intercompany Receivables and one to handleIntercompany Payables. However, it would be impossible to fit 12 different paths onto oneworkflow screen, not to mention cluttered and confusing.


38

Instead, a possible solution would be to create a new Process for accessing the values in thecustom table and creating the appropriate flexfield combinations. A sample workflow might looksomething like this:

Fixed Assets -- Account Generator and Workflow Account Generator BasicsAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

39

Account Generator Basics

Starting the Account Generator

1. From the menu bar, choose File/Open

2. You have the option of opening from a file you previously saved or downloading the filefrom the database.

3. If you are downloading from a file:• Click on File to highlight it.• Browse to find the file previously saved.

4. If you are downloading from the database

• Click on Database• Enter the following:

User GWYUIDPassword FNDNAMConnect ORACLE_SID or TWO_TASKEffective You can leave this null.

Saving a File in Account Generator

1. From the menu bar, choose File/Save As

2. You have the option of saving to a file or saving the file to the database.

3. 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.

4. If you are saving a file to the database• Click on Database.• Enter the following:

User GWYUIDPassword FNDNAMConnect ORACLE_SID or TWO_TASKEffective You can leave this null.

Web References

• The Oracle Assets Homepage - http:// www-apps.us.oracle.com/fa/

Fixed Assets -- Account Generator and Workflow Account Generator BasicsAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

40

• The Oracle WorkFlow Homepage - http://www-apps.us.oracle.com/atg/wf/index.html

Fixed Assets -- Account Generator and Workflow Appendix A - Table of Account Generator Processes and Generated AccountsAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

41

Appendix A - Table of Account Generator Processes and Generated Accounts

Appendix A - Account Generator Processes and Generated Accounts


Book Account Names Cost of Removal ClearingCost of Removal Gain,Cost of Removal LossDeferred Depreciation ExpenseDeferred Depreciation ReserveDepreciation AdjustmentIntercompany Accounts PayableIntercompany Accounts ReceivableNet Book Value Retired GainNet Book Value Retired LossProceeds of Sale ClearingProceeds of Sale GainProceeds of Sale LossRevaluation Reserve Retired GainRevaluation Reserve Retired Loss


Category Account Names Asset ClearingAsset CostConstruction-in-Process ClearingConstruction-in-Process CostDepreciation ReserveRevaluation AmortizationRevaluation Reserve

Fixed Assets -- Account Generator and Workflow Appendix B - FA Account Generator Menu: Quick ReferenceAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

42

Appendix B - FA Account Generator Menu: Quick ReferenceAPPENDIX B - FA ACCOUNT GENERATOR MENU: QUICK REFERENCE

ATTRIBUTES Account CCIDAccount NameAccount ValueAccount SegmentBookDefault CCIDCost Center ValueDistribution CCIDDistribution IDGenerated CCIDBalancing SegmentFlexfield StructureError Message

PROCESSES Generate Account using Flexbuilder RulesGenerate Asset Level AccountGenerate Book Level AccountGenerate Category Level AccountGenerate Default Account

FUNCTIONS Flexbuilder UpgradeGet Account GroupGet Account NameGet Asset Account NameGet Book Account NameGet Book ClassGet Book Type CodeGet Category AccountPost Cost Center

LOOKUP TYPES Account Group Asset Level AccountBook Level AccountCategory Level Account

LOOKUP TYPES Account Names Asset ClearingAsset CostConstruction-in-Process ClearingConstruction-in-Process CostCost of Removal ClearingCost of Removal GainCost of Removal LossDeferred Depreciation ExpenseDeferred Depreciation ReserveDepreciation AdjustmentDepreciation ExpenseDepreciation ExpenseIntercompany Accounts PayableIntercompany Accounts ReceivableNet Book Value Retired GainNet Book Value Retired LossProceeds of Sale ClearingProceeds of Sale GainProceeds of Sale LossRevaluation AmortizationRevaluation ReserveRevaluation Reserve Retired GainRevaluation Reserve Retired Loss


Book Account Names Cost of Removal ClearingCost of Removal GainCost of Removal LossDeferred Depreciation Reserve

Depreciation AdjustmentIntercompany Accounts PayableIntercompany Accounts ReceivableNet Book Value Retired GainNet Book Value Retired LossProceeds of Sale Clearing

Fixed Assets -- Account Generator and Workflow Appendix B - FA Account Generator Menu: Quick ReferenceAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

43

Proceeds of Sale GainProceeds of Sale LossRevaluation Reserve Retired GainRevaluation Reserve Retired Loss


Category Account Names Asset ClearingAsset CostConstruction-In-Process ClearingConstruction-In-Process CostDepreciation ReserveRevaluation AmortizationRevaluation Reserve

Fixed Assets -- Account Generator and Workflow Appendix C - Account Generator Test ScriptAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

44

Appendix C - Account Generator Test Script

Introduction

This script assists in diagnosing problems in concurrent processes that fail due to accountgeneration. This script is similar to the flexbuilder test screen that was used in Release 10 of theApplication. The output from this script gives the user two pieces of information: the codecombination that was attempted to be built and a reason why it is not able to build the codecombination.

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 WorldWide Support for the latest version of the script.

Problem Explanation

When running depreciation, you may find that it completes with Error. Please review the LogFile. If the problem relates to Account Generator, you will notice the following in the Log File:

Depreciation Program Exception Reportccid sent to fadoflx from fadosgl is: 19739dist_ccid in fadoflx is: 19739h_book_type_code = INSURANCEaccount_type = ASSET_COST_ACCTaccount = 1520APP-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 from fadoflx)Getting account CCIDError: function fadoflx returned failure (called from fadosgl)Error: function fadosgl returned failure (called from faxinaj)Error: function faxinaj returned failure (called from fadcje)fazccb cache results

Required Parameters

Fixed Assets -- Account Generator and Workflow Appendix C - Account Generator Test ScriptAccount_Generator_Paper (v. 1.0 ) Oracle/Client Confidential - For internal use only

45

When you try to run the script, you will be prompted for the following information. Thisinformation is noted in the Log File.

Enter value for account_type: ASSET_COST_ACCTASSET_COST_ACCTEnter value for book: INSURANCEBook INSURANCEEnter value for distribution_ccid: 1973919739Enter value for account_segment: 15201520Enter value for account_ccid: 0

Please note if the log file does not mention an account_ccid, then please enter a 0 (ZERO). Donot leave it NULL.

Results of Script

The following is generated when you run the script. At the bottom of the script you will noticethe 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_CCIDDYNAMIC_INSERTS_ALLOWED = TRUEINSERT IF NEW COMBINATION = FALSEFND_FLEX_SEGMENT1 IS 01FND_FLEX_SEGMENT2 IS 740FND_FLEX_SEGMENT3 IS 1520FND_FLEX_SEGMENT4 IS 0000FND_FLEX_SEGMENT5 IS 000CONCATENATED SEGMENTS TO BE VALIDATED IS 01-740-1520-0000-000VALIDATION FAILEDSTART FND_FLEX_WORKFLOW_APIS.END_GENERATIONPROCESS STATUS ISPROCESS RESULT IS SUCCESSCCID IS 0CONCATENATED SEGMENTS ISCONCATENATED ID ISCONCATENATED DESCRIPTIONS ISVALIDATION_STATUS IS INVALIDNEW COMBINATION IS FALSEERROR MESSAGE IS FNDFLEX-COMBINATION DISABLEDFailed to Generate CCIDSegments :PL/SQL procedure successfully completed.

If you have any problems, please contact World Wide Support.

Oracle Fixed Assets - Account Generator and WorkflOW

Documents

Transcript of Oracle Fixed Assets - Account Generator and WorkflOW