Directions for the Well Allocation Deck Upload spreadsheet OGSQL gives users the ability to import Well Allocation Deck information from a text file. The Well Allocation Deck Upload has 3 tabs that must be populated. The Well Allocation Deck, Deck Version and Deck Version Detail Interest tabs must be populated before the Check Data macro can be run. This spreadsheet is designed to assist with the preparation and creation of the necessary text files for the Import Data from ASCII File module. Steps to follow: If necessary, reset the spreadsheet: Click Reset Click Reset again On the Well allocation Deck tab, populate columns B through G with the appropriate data. On the Deck Version tab, populate columns B through Z with the appropriate data. On the Deck Version Interest tab, populate columns B through J with the appropriate data (field definitions will be shown at the end of the directions): Click the Check Data button: The data entered will be checked for errors. If a large number of rows have been entered, this may take some time. Please be patient.
If errors are discovered in the data, a notification that lists the row number and the error detected will be displayed. If there are a large number of errors, they may not all appear in the message: o Errors will be marked on the spreadsheet in red: o Hover over the cell with the mouse and a comment with more detailed information on the error will be shown: Correct any errors and click the Check Data button again. Check all three tabs for errors. Repeat as necessary until all errors have been corrected. When no errors are detected, a dialog box displays to save the text file. Click the button next to the file name and navigate to the location of the directory to save the file:
The required name of the file will automatically appear in the File name field. When the Save In shows the desired folder, click Save. Click OK on the Are you ready to save your data to text? message box appears. The next dialog box displays to save the text file. Click the button next to the file name and navigate to the location of the directory to save the file.
The required name of the file will automatically appear in the File name field. When the Save In shows the desired folder, click Save. Click OK on the Are you ready to save your data to text? message box appears. The next dialog box displays to save the text file. Click the button next to the file name and navigate to the location of the directory to save the file.
The required name of the file will automatically appear in the File name field. When the Save In shows the desired folder, click Save. Click OK on the Are you ready to save your data to text? message box appears. Back up the SQL database. Log into OGSql Navigate to Process Exceptional Processing Import Data from ASCII File.
Select Well Allocation Deck, Well Allocation Deck Version and Well Allocation Deck Version Detail Interest. Verify the path and file name of the upload file. Verify Advanced Selection settings The advanced selection option allows the user to select a specific directory that will apply to all files selected. There are also several other options that the user may choose from.
o Rename Files after Import If multiple files are being uploaded at one time, this option will rename each file when the upload is complete. This is helpful in auditing that all uploads are completed. o Validate Selected File Names This option will validate that the file name selected is what the program is requiring. o Overwrite Duplicate Records If the file contains a key field that is already in the database, the data in the database will be overwritten by the data in the file. Otherwise, an error on import will be received on duplicate records. o Report Overwritten Duplicate Records when the upload is complete, a report of all records overwritten will be outputted. o Recognize OMIT_ME Normally, a column of data is considered omitted on an import line if there is nothing there, not even a blank, after its preceding comma and before its trailing comma (if any). If the user has difficulty making a.csv file, then instead they can put OMIT_ME in that positions and check this box, and that data cell will be treated as omitted. Omitting something has a different result than putting in a blank or zero. If the user omits something on a brand new record being imported (not a re-write), then the default value for that column is used instead. If they omit something on a rewrite import, then that data item is left untouched when the rewrite is done. This is different than when a blank/zero is included: that will always change the contents of the resulting record to blank/zero. o Prorate Expense Deck Interests If an Expense deck participant s interest changes and causes the total to be higher or lower than the original, this option would prorate the rest of the participant s interest so that the original total interest would remain the same. o Prorate Revenue Deck Interests If a Revenue deck participant s interest changes and causes the total to be higher or lower than the original, this option would prorate the rest of the participant s interest so that the original total interest would remain the same. o View Generic Import Formats When enabled, the user will be able to view all imports whether they are applicable to the database or not. Use of imports that do not apply to the database before the options required are enabled will cause an error on import. Click OK Click Import Review the OGSQL report that is generated for any errors.
Field Definitions All fields are optional unless noted as required. On the spreadsheet, required fields are designated with blue text. There are 3 tabs in this worksheet that must be populated. Well Allocation Deck There will be one record for each well-allocation deck. Company Code Enter the Company code for which the Deck applies. This company code must exist in Company Maintenance prior to the upload. Required. Deck Type Enter the Deck type. Allowed values are BATTERY, DISPOSAL WELL, FIELD, OPERATING GROUP, TANK and FIELD. Required Deck Code Enter the deck code of the Deck Type up to 12 characters. Required Product Code Enter the Product code found up to 3 characters. This product code must exist in Product Code Maintenance at the time of the upload. Required Purpose Enter the purpose of the Deck. Allowed values are SALES (Sales only), PROD (Production only), DISP (Disposal only), OTHER (other disposal only) or INVEN (inventory only). Required Name Enter a description of the deck up to 30 characters Deck Version There will be one of these records for each dated edition of an allocation deck. Company Code Enter the Company Code for this Deck. The code entered must be valid in Company Maintenance at the time of the upload. Required Deck Type Enter the Deck Type. Allowed values are BATTERY, DISPOSAL WELL, FIELD, OPERATING GROUP, TANK and FIELD. Required Deck Code Enter the deck code of the Deck Type up to 12 characters. Required Product Code Enter the Product code found up to 3 characters. This product code must exist in Product Code Maintenance at the time of the upload. Required Purpose Enter the purpose of the Deck. Allowed values are SALES (Sales only), PROD (Production only), DISP (Disposal only), OTHER (other disposal only) or INVEN (inventory only). Required Version Date Enter the Date this version becomes effective. Required Total Token Enter the Total token value. This is a 15 digit number of which 6 digits can be to the right of the decimal. Use For Net Volume Enter a Y or N to indicated if this is to be used for net volume share (if not,
Use For Net Value Enter a Y or N to indicated if this is to be used for net value share (if not, Use For Gross 88ths Tax 1 Enter a Y or N to indicated if this is to be used for gross 8/8ths Use For Net Tax 1 Enter a Y or N to indicated if this is to be used for net tax share (if not, Use For Gross 88ths Tax 2 Enter a Y or N to indicated if this is to be used for gross 8/8ths Use For Net Tax 2 Enter a Y or N to indicated if this is to be used for net tax share (if not, Use For Gross 88ths Tax 3 Enter a Y or N to indicated if this is to be used for gross 8/8ths Use For Net Tax 3 Enter a Y or N to indicated if this is to be used for net tax share (if not, Use For Gross 88ths Tax 4 Enter a Y or N to indicated if this is to be used for gross 8/8ths Use For Net Tax 4 Enter a Y or N to indicated if this is to be used for net tax share (if not, Use For Gross 88ths Tax 5 Enter a Y or N to indicated if this is to be used for gross 8/8ths Use For Net Tax 5 Enter a Y or N to indicated if this is to be used for net tax share (if not, Use For Gross 88ths Tax 6 Enter a Y or N to indicated if this is to be used for gross 8/8ths Use For Net Tax 6 Enter a Y or N to indicated if this is to be used for net tax share (if not, Use For Net Other Deductions 1 Enter a Y or N to indicated if this is to be used for net other deduction share (if not, Use For Net Other Deductions 2 Enter a Y or N to indicated if this is to be used for net other deduction share (if not, Use For Net Expense Enter a Y or N to indicated if this is to be used for net expense share (if not, calculate share using expense-deck) Active Enter a Y or N to indicated if this is deck active for distribution Deck Version Interest There will be one of these records for each well that is part of an allocation deck version. Company Code Enter the Company Code for this Deck. The code entered must be valid in Company Maintenance at the time of the upload. Required
Deck Type Enter the Deck Type. Allowed values are BATTERY, DISPOSAL WELL, FIELD, OPERATING GROUP, TANK and FIELD. Required Deck Code Enter the deck code of the Deck Type up to 12 characters. Required Product Code Enter the Product code found up to 3 characters. This product code must exist in Product Code Maintenance at the time of the upload. Required if production module is active in the system Purpose Enter the purpose of the Deck. Allowed values are SALES (Sales only), PROD (Production only), DISP (Disposal only), OTHER (other disposal only) or INVEN (inventory only). Required if production modules is active in the system Version Date Enter the Date this version becomes effective. Required Well Code Enter the Well Code up to 10 characters. Required Decimal Interest Enter the Well s share of the allocation. This is a 15 digit number of which 10 digits may be to the right of the decimal Token Share Enter the Well's share of total token. This is a 15 digit number of which 6 digits may be to the right of the decimal Note: The Total Tokens are a tool that is used to calculate the decimal interest. So the user can either skip the tokens and just enter a decimal or the user can enter tokens, with no decimal and let the program calculate the decimal interest based on the tokens entered. Both are not typically used as the tokens have no purpose if you already know the decimal interest.