/
Qbyte Exchange for Surface

Qbyte Exchange for Surface

Search the Qbyte CS Land Wiki
 

This page has multiple incoming links - Please use your browser back button to return to the previous page. 

Qbyte Exchange Main Menu

Introduction

Qbyte Exchange is powerful functionality that allows Qbyte CS Land users to update the Qbyte CS Land database using provided Excel templates. Work with your System Administrator to complete the one-time Qbyte Exchange Setup before you can see the Qbyte Exchange menu option in Excel.

After you Login to Qbyte Exchange and have specified either Insert or Update from the Qbyte Exchange Main Menu for the Surface module, the template tabs and columns will be automatically loaded, and the Qbyte Exchange Module Menu will be shown on the right side of the spreadsheet where you will perform all the actions necessary to update the Qbyte CS Land database.

All processing options are explained on the Qbyte Exchange Module Menu page.


Mandatory tabs / columns are represented with an *

Surface Base *

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

 

File Status*

Code must exist in Validation Table.

Note: Generally, terminating/inactivating files should be done in the Qbyte CS Land application. IF the File Status is changed in Qbyte Exchange, remember to also update the Status Date.

Status Date*

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Lessor Type*

Code must exist in Validation Table.

Lease Number

 

Document Type*

Code must exist in Validation Table.

Document Date*

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Admin Company*

Code must exist in Validation Table...

Effective Date*

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Area*

Code must exist in Validation Table.

Division

Code must exist in Validation Table.

Lease Term

 

Term Period

 

Expiry Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Renewed Flag

Note: This column is not mandatory in the spreadsheet, however if it is not populated when inserting new records, the next time you are in the file in Qbyte CS Land you may be asked to choose Yes or No even though the default when manually entering new files is No.  When inserting new files, populate the column with 'N' in the spreadsheet to avoid the message in Qbyte CS Land.

Extension Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

How Acquired

 

Acquired Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Lease Operator

BA Code entered must exist in Business Associates.

Lease Payor

BA Code entered must exist in Business Associates.

Rental Status

If entered, Code must exist in Validation Table.

JVB Invoice

Note: This column is not included in the spreadsheet template.  When new records are inserted,  the JVB flag will default the correct value into the database based on the System Table (SURFJVB -  Billing Y/N) setting.

Rental Period

 

Total Rental

 

Gst Payable

Note: This column is not mandatory in the spreadsheet, however if it is not populated when inserting new records, the next time you are in the file in Qbyte CS Land you may get a message indicating the GST Payable flag is required and you cannot exit out of the Base tab until specified.  You can check then uncheck the flag to get past the message.  When inserting new files, populate the column with 'N' in the spreadsheet to show as not checked in Qbyte CS Land and avoid the message.

Rental Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Surrender Days

 

Acre hectare

 

Total Hectares

 

Total Acres

 

Reclaim Number

 

Application Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Reclamation Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Cost Centre

Cost Centre Code entered must exist in Cost Centres.

Prev Doc Number

 

Surface Lessors * 

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

 

Occurrence*

Do not populate this column. This is a system-generated value and it will be populated during Save.

Note: The  Occurrence (Occ) Number can be renumbered at any time in the Qbyte CS Land application (if required) to change the display order of the rows.

Lessor*

BA Code entered must exist in Business Associates.

Lessor Amount*

 

Depository

BA Code entered must exist in Business Associates.

Lessor Interest*

 

Withhold Tax

 

Bank Account

 

Surface Areas 

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

When inserting new records, the File Number specified must already exist.

Area*

When inserting new Areas, the Area code must exist in the Area Validation Table. The applicable Province code will default automatically in the database when the Area code is saved.  No te:   After the initial Insert > Save, If still in Insert mode and the Area is changed, then a Save is performed, a second Area record will be added, leaving also the initial Area record. If any of the Areas are no longer required, they must be deleted in the application.

Updating Areas in Update mode is currently not allowed and will display an error when attempting a Validate or Save.

Surface Land Description * 

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

 

Land Description*

 

Surface Land Use * 

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

 

Land Use Type*

Code must exist in Validation Table.

Land Use*

 

Surface Registration

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

When inserting new Registration, the File Number specified must already exist.

Occurrence

When inserting new Registration, do not populate this column. This is a system-generated value and it will be populated during Save.

When updating existing Registration, this column can be used to change the occurrence order.

Note: The  Occurrence (Occ) Number can be renumbered at any time in the Qbyte CS Land application (if required) to change the display order of the rows.

Document Type*

Code must exist in Registration Types Validation Table.

Document Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Document Number*

Free-format up to 20 characters.

Withdrawal Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

District

Code must exist in District Validation Table.

Register Number

Free-format up to 20 characters.

Comments

Free-format up to 1910 characters.

Surface Name Xref

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

When inserting new Name Xref records, the File Number specified must already exist.  The File Number cannot be updated.

Name Type*

When inserting, the Code  must  exist in the Name Xref Validation Table.  The Name Type cannot be updated.

Name Cross Reference*

When inserting, the BA Code  entered  must  exist in Business Associates.  

When updating, the Name Cross Reference cannot be updated - a validation error will be given.  If required, change the Name Cross Reference BA Code in the Qbyte CS Land application.

Comments

Free-format up to 40 characters.  The Comment can be updated if required on existing rows.

Surface Remarks

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

 

Occurrence

Do not populate this column when inserting new data. This is a system-generated value and it will be populated during Save.

Note: The  Occurrence (Occ) Number can be renumbered at any time in the Qbyte CS Land application (if required) to change the display order of the rows.

Delete

This value is applicable on the spreadsheet only and is not stored in the table. 

When inserting a new Remarks record, enter a value of "N".  If blank, "N" is assumed.

When updating, retrieve existing data via Get Data, the Delete value will default to "N".  Change the value to "Y" to indicate that you wish to delete the specific row.  If blank, "N" is assumed. 

  • Validate will display a 'Conflict' error along with message 'Row will be deleted - are you sure?'.  Simply change the Delete column back to "N", if you change your mind.  

  • Upon Save, the Remarks with a delete flag of "Y" are deleted from the database and the remaining remarks occurrence number will be renumbered.  However, the just deleted row will still appear temporarily on the spreadsheet with status = 'Deleted' as a visual indication that the row has been deleted and the occurrence renumber will not be apparent.  A subsequent Get Data will omit the deleted rows and display the reordered remarks occurrence. 

Remark Type*

Code must exist in Validation Table.

Remark Date

Value must be in a yyyy-MM-dd format.  Cell format must be Text.

Remark*

Free-format up to 1910 characters.

Surface W.I.

This tab is only used if your company has chosen to store WI information on Surface files.  If the data is populated on this tab in Qbyte Exchange but the WI tab is not available in the Qbyte CS Land application, a 'No updates are allowed' error will be given.

The ability to add DOI information in Qbyte Exchange is different than what is done in Qbyte CS Land.  Currently, the intent of using this tab would be a means for inserting a single DOI Type (i.e. Rent) onto the Surface. 

Using this WII tab, you can:

  • Insert only - Inserting new WI, if the exact DOI Type already exists on the Well within the Qbyte Exchange Spreadsheet, Qbyte Exchange will expire the existing DOI Type and insert a “new” DOI.

  • Up to 10 Partners and Percentages can be specified.  If more then 10 are required, they must be entered via the Qbyte CS Land application.  The total of all Partner Percentages entered must equal 100%.

  • Linking of DOI's must be done in the Qbyte CS Land application.

Note: Mandatory columns are represented with *

COLUMN

HINTS & TIPS

File Number*

When inserting a new Surface DOI, the Surface File Number specified must already exist.

DOI Type*

Code must exist in the DOI Types Validation Table. 

Note:  if the exact DOI Type already exists, the existing DOI Type will be expired and a “new” DOI inserted.

Effective Date*

The value must be in a yyyy-MM-dd format. Cell format must be Text.

  • Cannot be a “future date”.

  • If inserting a new DOI of the same DOI Type of an existing DOI, then the Effective Date must be greater than the Effective Date of the existing DOI.

Comments

Free-format up to 60 characters.

DOI ID

When inserting new Term, do not populate this column. This is a system-generated value and it will be populated during Save.

When updating existing Terms, do not change this column.

Partner BA ID 1*

BA Code entered must exist in Business Associates and must be active.

  • Up to 10 Partners and Percentages can be specified.  If more then 10 are required, they must be entered via the Qbyte CS Land application. 

  • The total of all Partner Percentages entered must equal 100%.

Partner Percentage 1*

 

Partner BA ID 2*

 

Partner Percentage 2*

 

Partner BA ID 3*

 

Partner Percentage 3*

 

Partner BA ID 4*

 

Partner Percentage 4*

 

Partner BA ID 5*

 

Partner Percentage 5*

 

Partner BA ID 6*

 

Partner Percentage 6*

 

Partner BA ID 7*

 

Partner Percentage 7*

 

Partner BA ID 8*

 

Partner Percentage 8*

 

Partner BA ID 9*

 

Partner Percentage 9*

 

Partner BA ID 10*

 

Partner Percentage 10*

 

Surface Obligations

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

When inserting new Obligation records, the File Number specified must already exist.  

When updating an existing Obligation, the File Number cannot be changed.

Occurrence*

When inserting a new row do not populate this column, this is a system-generated value and it will be populated during Save.

Note: The  Occurrence (Occ) Number can be renumbered at any time in the Qbyte CS Land application (if required) to change the display order of the rows.

Delete

This value is applicable on the spreadsheet only and is not stored in the table. 

When inserting a new record, enter a value of "N".  If blank, "N" is assumed.

When updating, retrieve existing data via Get Data, the Delete value will default to "N".  Change the value to "Y" to indicate that you wish to delete the specific row.  If blank, "N" is assumed. 

  • Validate will display a 'Conflict' error along with message 'Row will be deleted - are you sure?'.  Simply change the Delete column back to "N", if you change your mind.  

  • Upon Save, the rows with a delete flag of "Y" are deleted from the database and the remaining rows occurrence number will be renumbered.  However, the just deleted row will still appear temporarily on the spreadsheet with status = 'Deleted' as a visual indication that the row has been deleted and the occurrence renumber will not be apparent.  A subsequent Get Data will omit the deleted rows and display the reordered rows occurrence. 

Obligation Type*

Code must exist in Validation Table  Obligation Surface.

Date*

Date must be in a yyyy-MM-dd format.  Cell format must be Text.

Frequency*

Value must be O, A, SA, Q, M, 2Y, 3Y, 4Y, 5Y, 10, 20, 21 or 25.

Company*

Value must be Y or N.

Satisfied*

Value must be Y or N.

Comp Date

Date must be in a yyyy-MM-dd format.  Cell format must be Text.

Party Resp*

Code must exist in Validation Table  Obligation Responsibility.

Description*

Free-format up to 1910 characters.

Surface Client Defined

The ability to Insert and update data on mass within Qbyte Exchange for the Client Defined tab is different than how that data is entered into Qbyte CS Land. 

  • Tab label will be generic 'Client Defined' not the unique label defined in the Qbyte CS Land configuration. 

  • Specific fields (label and its value) must be entered into its own row within the spreadsheet.  If a specific field is not needed, it does not need to be added in the spreadsheet.  In Qbyte CS Land all defined Client Defined Fields are shown n the window regardless if a value has been populated or not.

  • Get data from P2 will bring only the fields (rows) with values populated into the spreadsheet.  

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

When inserting a new Client Defined record, the File Number specified must already exist.  Any one File Number may have multiple rows in the spreadsheet if there are more than 1 applicable Client Defined Labels/Values.  

When updating an existing Client Defined record, the File Number cannot be changed.

Label*

When inserting a new Client Defined record, the Label must be entered exactly as it appears in the Qbyte CS Land window (or as defined in Admin > Client Defined Fields update screen). 

When updating an existing Client Defined record, the Label cannot be changed.

Value*

The Value is required when inserting new rows and can also be updated after the initial save.  The cell is always defined as Text in the Qbyte Exchange spreadsheet regardless of Value entered. 

Values entered are validated accordingly per the field setup in Qbyte CS Land:

  • Dates can be entered with or without a format.   For example, if a date format of 'yyyy-mm-dd' has been defined, the date must be entered as '2022-12-13'. If a date format was not defined, the date can be entered as '2022-12-13', and Qbyte Exchange will format the date to the default date format of 'Dec 13, 2022' - just like it is in the application.

  • Validation codes entered must exist in the applicable validation code table.

  • String values entered must not exceed 1910 alpha/numeric characters.  Alt + Enter can be used to break the text string to a new line.

  • Percentage can be entered with or without a format.  

  • Number can be entered with or without a format.  For number fields setup with masks:

    •  

      • The 0 (zero) character will allow a leading zero to be entered in Qbyte CS Land and all leading zeroes will be visible when the field is imported to Qbyte Exchange.  For example, with mask 000-000-00000, entered as 00-000-0001 in Qbyte CS Land, will display as 000-000-0001 in Qbyte Exchange.

      • The # character will allow a leading zero to be entered in Qbyte CS Land only if there is a non-numeric character like a dash (-) in the mask.  Leading zeroes are not displayed when the field is imported to Qbyte Exchange.  For example, with mask ###-###-####, entered 000-000-0001 in Qbyte CS Land will display as '- -1' in Qbyte Exchange.

Note:  If a Client Defined field was setup in Qbyte CS Land as being mandatory, then in Qbyte Exchange a value must be provided for that field if that Label exists in the spreadsheet.  However, if there is not a row for the Label in the spreadsheet, there is not validation to indicate it is missing.

Surface Related Files

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

When inserting new records, the File Number specified must already exist.

Note : this field cannot be updated after Insert > Save completed. If relationship is no longer required, it must be deleted in the application. When using 'get data' to retrieve existing data, you may want to sort by File Number to ensure all rows for each File Number appear grouped together.

Related Subsystem*

When inserting new records, enter the module for which the related files is part of.

Acceptable codes:  C (any Contract category), M (Mineral), S (any Surface category), W (Well).  Qbyte Exchange has the same Related Files exceptions as Qbyte CS Land.

Note : this field cannot be updated after Insert > Save completed.

Related File Number*

When inserting new records, enter the file number for which you are relating to the file number specified in column A.

Note : this field cannot be updated after Insert > Save completed.

Related File Sub

When inserting new records, enter a sub, if applicable to relate files at the sub level.

Note : this field cannot be updated after Insert > Save completed.

Relationship

If entered, the code must exist in Relationship Validation Table.

Comment

Free-format up to 120 characters.

Surface Rent Hist Manual

The ability to Insert, update and delete data on mass within Qbyte Exchange for the Rent Hist Manual tab is different than how that data is entered into Qbyte CS Land. 

  • File Number, Rental Date, Lessor, Depository, and Cheque Number are key fields and can not be updated in Qbyte Exchange after initial insert.

COLUMN

HINTS & TIPS

COLUMN

HINTS & TIPS

File Number*

When inserting new records, the File Number specified must already exist.  

When updating an existing record, the File Number cannot be updated.

Rental Date*

When inserting new records, Date must be in a yyyy-MM-dd format.  Cell format must be Text.

When updating an existing record, the Rental Date cannot be updated.

Lessor*

When inserting new records, BA Code entered must exist in Business Associates.

When updating an existing record, the Lessor cannot be updated.

Depository*

When inserting new records, BA Code entered must exist in Business Associates.

When updating an existing record, the Depository cannot be updated.

Cheque Date*

When inserting new records, Date must be in a yyyy-MM-dd format.  Cell format must be Text.

When updating an existing records, the Cheque Date can be updated on the existing record.

Cheque Number*

When inserting new records, Free format up to 16 characters.

When updating an existing records, the Cheque Number cannot be updated.

Cheque Amount

Minimum = 0.01 and maximum = 9,999,999.99

WH Tax

Withholding Tax amount minimum = 0 and maximum = 9,999,999.99  Note: If left blank, it will be saved as 0.

Rental Amount

Minimum = 0 and maximum = 9,999,999.99  Note: If left blank, it will be saved as 0.

Comment

Free-format up to 100 characters. 

Delete

This value is applicable on the spreadsheet only and is not stored in the table. 

When inserting a new Rent Hist Manual record, enter a value of "N".  If blank, "N" is assumed.

When updating, retrieve existing data via Get Data, the Delete value will default to "N".  Change the value to "Y" to indicate that you wish to delete the specific row.  If blank, "N" is assumed. 

  • Validate will display a 'Conflict' error along with message 'Row will be deleted - are you sure?'.  Simply change the Delete column back to "N", if you change your mind.  

  • Upon Save, the Rent Hist Manual records with a delete flag of "Y" are deleted from the database.  However, the just deleted records will still appear temporarily on the spreadsheet with status = 'Deleted' as a visual indication that the records have been deleted.  A subsequent Get Data will omit the deleted rows and display the remaining Rent Hist Manual records. 

Surface Lease Rent Hist Comments

Just like the Rent Hist Comments tab in Qbyte CS Land, only the Comments can be updated. All of the data columns are populated by the Rental process and cannot be inserted or updated in Qbyte Exchange. They are shown in the spreadsheet for reference to ensure the Comment is updated on the correct row.

COLUMN

HINTS & TIPS

Owner Company*

Cannot be updated.

Select Date*

Cannot be updated.

Rental Run Code

Cannot be updated.

File Number*

Cannot be updated.

Lessor*

Cannot be updated.

Depository*

Cannot be updated.

Cheque Date*

Cannot be updated.

Cheque Number*

Cannot be updated.

Cheque Amount

Cannot be updated.

WH Tax

Cannot be updated.

GST

Cannot be updated.

Rental Amount

Cannot be updated.

Comment

Free format up to 100 characters. 

 






Copyright© 2024 IFS AB. Copying prohibited. All rights reserved.