Using Oracle ADI Templates for Journal Entries

Upload Journal Entry Using ADI

You can prepare and upload a journal entry from a Macro-Enabled Excel template into Oracle General Ledger using the “Application Desktop Integrator” or ADI. Note, currently ADI is only available using PC.

Advantages include:

  • Similar recurring journal entries can be reproduced efficiently
  • Journal entries with many lines are easily prepared
  • Excel copy and paste functionality
  • Validation of account combination prior to uploading entry

Creating the ADI Template

ADI Journal Entry Template Directions

  1. Log into the Oracle Applications.
  2. On homepage navigator click the journal entry responsibility (e.g. “RIT – GL – JOURNAL ENTRY ONLY”)
  3. In the “Journals” menu click on “Launch Journal Wizard”

Step 1

RIT Oracle Journal Wizard

  1. The “Document Parameters” screen will open, replacing your homepage
  2. Select ‘RIT Actuals Single’ from the “Layout” window.
  3. Set the “Content” field to “None”. Click the “Create Document” button

Step 3

  1. Select “Open” when prompted to either open or save “WebADI.xls

Step 3

  1. Click “Enable Editing” when a new blank spreadsheet opens with a “Protected View” warning

Step 4

  1. Click “Enable Content” when you receive a macros “Security Warning”

Step 5

  1. A “Download” window will open in Excel letting you know that your document is in the process of being created.

Step 7

  1. Click the “Close” button once the Journal Entry template has finished downloading into Excel. The message in the “Download” window will confirm that your document has created.

Strep 8

Populating the ADI Template

Excel Oracle ADI Journal Entry Template

  1. A blank Journal Entry template has been downloaded into Excel. Enter journal information in the white cells. Detailed descriptions of field content requirements are provided at end of this document. After data is entered, see instructions on uploading the entry to Oracle. All the tools and functions that are available in Excel can be used to enter data into the template. Reviewing the template from upper left to bottom right.Step 8
    • “Context” – this data is system generated. No action necessary.
    • “Header” – refer to Appendix I, pg 8, for more information on what to enter
      List of Values
      1. You must select the ‘Category’, ‘Source’, and ‘Accounting Date’ from the “List of Values”. The wrong format will cause the template to error when uploading.
      2. Double click on the cells designated with *List to access the Oracle “List of Values”.
    • “Body” – refer to to Appendix I, pg 8, for more information on what to enter
      Line Description
      • You must enter a description for each line. If left blank, this field will default to “Journal Import” after it has been uploaded into the general ledger. Accounting will not post journal entries with this default line description.
      Adding Rows to Journal Entry Template:
      1. Click on first blank white cell in “Body” of the entry. Using the Excel “Insert” function (right click and select “Insert”), add the desired number of additional rows.
      2. Note: Do not add lines from any of the shaded areas. These are macro-enabled cells and will cause formula errors throughout your journal entry.
      3. In addition to double clicking on the cell for List of Values, click in the desired cell, then click “ADD-INS” on tool bar -> “Oracle” menu on left side in the Add-In toolbar. Select “List of Values” from the drop down menu.Step 9
    Example: Select the field for “Accounting Date” for your Batch
    1. Double-click on the Accounting data cell. A “Search and Select” window will open displaying a list of values to select from. The current date will be in bold. Adjust dropdowns to obtain desired period. Click on the desired date and click “Select”.
    2. The date will populate in the appropriate field.Step 10
    Data Entry Complete in Excel Oracle ADI Journal Entry Template
    1. At this point make sure your entry is complete prior to performing the upload function. Review the following tips to ensure your entry is prepared:
      • Review the header for proper category, date, batch and journal names
      • Review each account line to be sure all lines are enabled
      • Review the line descriptions to make sure they represent the type of entry
      • Review the Footer of your entry to make sure total “Debits” = total “Credits”Step 11

Saving your template for reuse

  • From the toolbar select “File” “Save As” and save your template as a macro-enabled spreadsheet *.xlsm. Put it in a folder on a secured drive so it is protected and can be reused. Note: Save your template before you upload the entry.
  • See Appendix II page 18, on how to upload a saved template which was closed during Oracle session.

Additional Tips and Reminders

  • The RIT Chart of Accounts located on the Controller’s Website is another way to check valid segments and combinations.
  • If you do different “Categories” of journal entries on a regular basis (e.g. Adjustment, Chargebacks, Cash Entries, etc.) create a template for each category.
  • Follow the same process to name your Batch as you do directly in the application. The unique ID# will attach after the upload. Note: forgetting to change your Batch Number (151GPM0816-##), your batch will still successfully upload because each upload ID# is unique.
  • Save your files as macro-enabled templates *.XLMS
  • To avoid errors, review your account combinations before you upload your entry
  • The same restriction on object codes apply in ADI as they do directly in the application (e.g. if you cannot access object code 16200 in the application you will not be able to use it in ADI) Forward your entry and back-up to postmyje@rit.edu and Accounting Operations will upload it for you.
  • Only the Budget and Controller’s Offices can upload budget entries

For assistance contact Accounting acctg@rit.edu , ext. 5-2237

Appendix I

Detailed Descriptions of Data Fields in Excel Oracle ADI Journal Entry Template

The Header

  • The Header section of the template includes the fields listed below. These are the same fields that are in the Journal Entry form in the Oracle Applications. Those in bold italics are required:
    • Source – Journal sources identify the origin of journal entries. The default source for a journal entry created using the Journal Wizard and uploaded from Excel is “Spreadsheet”. There are other sources available for you to choose from in the List of Values. This appendix example uses the source “Spreadsheet”.
    • Category - Journal categories help differentiate journal entries by purpose or type, such as accrual, payments or receipts. The default category is “Adjustment”.
    • Accounting Date – The Accounting date is entered in normal date format, (mm/dd/yyyy). Enter the date within the period you want the journal entry to be posted. For example, if you want the journal entry posted in August, and today’s date is August 16th , enter an Accounting Date for today. *If you are doing a journal entry during the first two days of a month that is to be posted for the prior month, make sure you change the calendar back to the prior month and select the last day of that month as your Accounting Date. Failure to do so will result in your entry posting in the new month.
    • Batch Name – The Batch Name follows the RIT batch naming convention, first 3 numbers of a user’s dept. number, followed by his/her initials, the month, day and the number of the batch for the day, (i.e.: 151GPM0816-01). After the journal entry is uploaded into the general ledger, the source, balance type and request id are added to the batch name, (i.e.: 151GPM0816-01 Spreadsheet A Spreadsheet A 9262888 17256059). *If you are doing a journal entry during the first two days of a month that is to be posted for the prior month, make sure you name your batch as of the last day of the month. For example on September 2nd you prepare a journal entry for August, your batch name is 151GPM0831-01
    • Batch Description – Information about the batch’s purpose should be entered in this field. If left blank, this field will default to “Journal Import”, the source, and the request id number, (i.e.: Journal Import Spreadsheet A 9262888 17256059). Note: You must enter a description that will allow you and Accounting to easily find the information after it has posted to the ledger.
    • Journal Name – More descriptive information can be entered in this field about the journal entry. If left blank, this field will default to the category and currency, (i.e.: Adjustment USD).
    • Journal Description – More descriptive information can be entered in this field about the journal entry. If left blank, this field will default to “Journal Import” and the request id number, (i.e.: A 9262888 17256059).

The Body

  • The body of the Journal Entry template includes the columns listed below. Those in bold italics are required.
    • Upload Flag – The upload flag is used to mark the journal entry lines that are to be uploaded into the general ledger. The Journal Wizard will ignore any rows entered after 3 blank rows, even if they are flagged to be uploaded. Normally the upload flag will automatically fill in upon entering an account number into the template. You can manually enter an upload flag by clicking in the upload flag column and typing any character on your keyboard.
    • Entity, Department, Object, Expense Category, Project and Program – These are the 6 segments that make up RIT’s 24 digit account combination. Each segment has its own column and has to be entered separately. To use the List of Values to select the segment values, double click on any of the segments’ cells and the “Enter Flexfield” window will open.
  1. Click on the magnifying lens to the right of a segment’s field in the “Enter Flexfield” window to access the segment’s List of Values. The “Search and Select” screen will display for the segment.Step 12
  2. To see an entire list of all the values for a segment, enter the wildcard character into the “Search Criteria” field and click on the “Go” button. The entire list of values will display in groups of 10.Step 13
    1. To see the next group of 10 values click on the “Next 10” button in the lower right hand corner of the window. You can also click on the drop down list of groups of 10 to scan through the list.Step 14
  3. If you know the first couple characters of the segment value, you can see a reduced list of values by using the wildcard character. For example; you know the Mechanical Engineering department number you want to enter starts with “632”. Enter “632%” in the “Search Criteria” field and click on the “Go” button. A reduced list of values starting with department number “63200” will display for you to choose from.Step 15
  4. Once you find the value you want to enter click on the select circle to the left of the value you want to enter into the field and click on the “Select” button.Step 16
  5. The segment field will fill in on “Enter Flexfields” window. If you know some of the segment values, such as Project, but not all, you can enter those you do know and then click on the “Combinations” button. For example; enter “90310” in the “OBJECT” field, and “00000” in the “PROJECT” field. Click on the “Combinations” button to see which accounts currently exist.Step 17
  6. An “Accounting Flexfield” window will display a list of 24 digit account combinations to choose from. Select the account you want to enter, click on the “Select” button, and the values are entered into the fields on the “Enter Flexfield” window.Step 18
  7. Click on the “Select” button and an information window will tell you if the account number is valid.Step 19Step 20
  8. Click on the “Select” button again and the account number will fill in on the journal entry template in the Excel spreadsheet. At the same time the upload flag will fill in automatically. Press the tab key repeatedly to move your cursor to the “Debit” field.

    Note: When you enter accounts using the Accounting Flexfield screen, the account combination is validated at the time you click on the “Select” button. This doesn’t happen if you manually type or paste the account numbers into the journal entry template. In that case the accounts will be validated during the upload process.

Debit, Credit

There can only be an amount in one of these columns per row. If there are amounts in the debit and the credit column on the same row, an error will display after you attempt to upload it into the general ledger.

Step 21

Note: To widen the width of the “Line Description” column to the correct width, select the column, from the toolbar select “Home”, click on the “Format” menu, click on “AutoFit Column Width”

Uploading Your Entry into the General Ledger

  • Once all the journal entry lines have been entered into the template, it can be uploaded into the general ledger.
  • If you closed the ADI template before uploading to Oracle, see Appendix II, pg. 18, for instructions on how to upload in future. Otherwise see instructions below.
    • Click on the “Oracle” menu in the Excel Menu toolbar at the top of the page. Click on “Upload” from the drop down menu.Step 22
    • A “Journals Upload” window opens showing the following parameters, which automatically default to the correct settings:Step 23
    • Click on the “Upload” button. A “Journals Upload” window displays showing the progress of the upload process.Step 24
    • If any of the data has been entered incorrectly, (the account combinations don’t exist or are disabled in the general ledger), a message will display in the “Journals Upload” window stating that the upload process has completed with errors. It should list out how many rows were invalid, if any of the information in the header section is invalid, and that no rows were uploaded.Step 25Step 26
    • Click the “Close” button and return to the journal entry template in Excel. In the message section you will see a sad face and an error message next to the invalid combinations. Go to the Chart of Accounts on the Controller’s Office Website and search for your combination under a different FEC value. If none exists, contact Accounting Operations acctg@rit.edu (ext. 5-2237) for assistance.
    • Once the upload process completes successfully the “Journals Upload” window will display a message listing out how many rows were successfully uploaded and provide a Journal Import Request ID number. The Journal Import process will start automatically and can be monitored using this request id number.Step 27
    • Click on the “Close” button to close the “Journals Upload” window.

Messages

This section is filled in by the Journal Wizard after an upload attempt has been made. If an account combination is invalid or the journal entry is out of balance a sad face and an error message will display. If the upload process was successful, a happy face will display next to each account combination.

Sad Face with Error Message

Error message

Happy Face – Success!

Success Message

Checking your Uploaded Entry in the General Ledger

  • Click “Journals” ->“Enter” from your journal entry responsibility (e.g. RIT-GL JOUNRAL ENTRY ONLY).
  • The “Find Journals” window opens
  • In the “Batch” field enter only a portion of your batch name and the “%” wildcard
  • In the “Period” field enter the proper accounting period
  • Click on “Find”Step 30
  • Your entry will appear in the “Enter Journals” window. Note your batch name will include the Upload ID# for that batch. You will need to use the “%” wildcard every time you upload an entry in ADI. You will not need to memorize the upload ID #Step 31

Appendix II

SSO & MFA WEBADI login to reuse ADI templates

The SSO & MFS WebADI login allows the user to reuse existing ADI templates in Excel within a 4-hour timeout session. When the session times out the user can log in again and continue to use the same template.

  1. Close all Excel spreadsheets.
  2. Go to https://mybiz.rit.eduStep 32
  3. Click on the “Click here for WebADI” button.
  4. Login using your RIT Computer Account user-id and password, (email account)Step 33
  5. If you haven’t yet, enroll in the DUO Application on your phone.
  6. Choose an authentication method.Step 34
  7. Depending on which authentication mode you selected, perform the following action:
    1. Duo Push: Accept the “Push” on your phone
    2. Call Me: Answer the phone call and follow instructions to login.
    3. Passcode: Click on the green key on your phone and enter number into the field next to “Log in” in the RIT Login screen.
    Step 35
  8. A Viewer screen will open. Leave “Excel 2007” in the “Viewer” field and click the “Next” button.Step 37
  9. Leave “None” in the “Content” field and click the “Next” button.Step 37
  10. Click the “Create Document” button.Step 38
  11. An Information screen will open and a popup screen will open. You will be prompted to open or save the document. Click the “Open” button.Step 39
  12. Excel will open a workbook on your screen. Enable Editing.Step 40
  13. Enable Content.Step 41
  14. Click "Close"Click Close
  15. A blue template will open in ExcelStep 43
  16. Open an existing ADI Template.Step 44
  17. Select a responsibility by clicking on the “ADD-INS” tab and selecting “Switch Responsibility” from the Oracle drop down list.Step 45
  18. Update, upload, and save the ADI template as you normally would in Excel using the Oracle Add-In.
  19. Do not close the Excel authentication session until you have finished uploading all of ADI templates. Once closed a new session will have to be opened by logging in again.