One Day Tutorial *
April 2005 *
Metech Pty Ltd 24 Moreau Mews *
Applecross *
Western Australia 6153 *
*
Tel:+61 8 9316 6600 *
Fax:+61 8 9316 6699 *
Support:
[email protected] *
Email:
[email protected] *
acQuire Version 3.9.0 *
29 April 2005 *
Licence Agreement The use of the software described in this manual is subject to a licence agreement with Acquire Software Pty Ltd. The software may only be used or copied in accordance with the terms and conditions of that agreement. *
Disclaimer Acquire Software Pty Ltd will not accept any liability arising from the use of the software or any other software product mentioned in this manual; nor for any technical or editorial errors or omissions made in this manual. *
The mention of any other computer software product within this manual does not imply any endorsement of such product by Acquire Software Pty Ltd. *
Copyright Notice Acquire Software Pty Ltd is the owner of the software and of all icons and logos within the software, together with all soft and hardcopy documentation. This manual contains information protected by copyright. No part of this manual may be photocopied or reproduced in any form without prior written consent from Acquire Software Pty Ltd. *
Copyright 1999 - 2003 Acquire Software Pty Ltd *
The following are trademarks or registered trademarks of their respective companies or organisations: Crystal Reports, MS NT, Windows95, Windows 98, MS Excel, ORACLE, MS Access and MS SQL Server. *
*
Contents
Introduction Before You Start the Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Who should do the Tutorials? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 You need to . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Conventions used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Some new words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Extra Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Features and look . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Tutorial flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Tutorial 1 Import Drilling Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 The story so far . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 The steps are . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Start here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Tutorial 2 Create Sample Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 The story so far . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 The steps are . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Start here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Tutorial 3 Importing Assays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 The story so far . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 The steps are . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Start here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Tutorial 4 Exporting Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 The story so far . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 The steps are... . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Start here . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Appendix Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . III Covered in the Appendix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . III Installing the Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . III Start SQL Server (MSDE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IV Create an ODBC link to 1Day . . . . . . . . . . . . . . . . . . . . . . . . . . . . IV
Introduction
Before You Start the Tutorial - 3
Before You Start the Tutorial Who should do the Tutorials? The Tutorials are aimed at new users of acQuire who want to *
_
Enter data into acQuire.
_
Undertake everyday tasks of viewing, entering, creating and exporting data.
You need to 1. Have acQuire installed on your machine. 2. Install the Tutorial from the acQuire CD or from the acQuire web site.
Make sure that you select Tutorial.
3. Start SQLServer service using SQL Server Service Manager if it has not been started. Go to the Start button on your desktop and select Programs. You will have either a MSDE or a Microsoft SQL Server program entry. Select either and navigate to the Service Manager. (Usually the SQL Server Service Manager is installed and started when you install acQuire.)
SQL Server Service Manager. Click Start/Continue to start SQL Server.
acQuire Tutorial
Introduction
4 - Before You Start the Tutorial 4. Make sure that the acQuire security key is plugged into a parallel or USB port on your machine. 5. Start acQuire. Go to the acQuire icon on your desktop to start acQuire or go to Start, Programs and select acQuire. 6. In acQuire, go to File, Recent Workspace on the main menu and select \Tutorials\One Day.qwsp. 7. In acQuire, the SQL Server Login dialog box will open. Your response will be Login ID:
sa
Password:
8. Click OK. You will have entered the One Day workspace and will be ready to work!
Your first view of the One Day workspace. On your left is a shortcut tree with a set of objects - A through to F. The first shortcut, A. Import Drilling is open and on view in the object work area to the right.
Conventions used The following explains some of the terms that you will come across: *
Introduction
One Day
The Tutorial workspace (see definition below). This is the name of the set of folders and acQuire objects that access the 1Day database. Both the workspace and the database are included in the acQuire Tutorial installation.
1Day
The Tutorial database. This database has a set of acQuire tables with data. This database is the basis of the Tutorial.
acQuire Tutorial
Before You Start the Tutorial - 5 Right-click
Click the right mouse button.
Double-click
Click the left mouse button quickly twice - usually to open an object in the workspace.
Dialog
A page/sheet that acQuire opens when you open an object or select an option from a menu. On the page/sheet you enter data or select an option.
File, Save Workspace Directions to a function in acQuire. For example, this direction takes you to File on the main menu and then to Save Workspace under File. Other directions will be written similarly - menu items separated by a comma.
Some new words MSDE
One of the relational database management systems (RDBMS). It is more or less the same as SQL Server although it has some limitations on the number of users and on its database size.
acQuire Data Model
A group of tables that resides in the database. Each table has one or more fields. This is where your data will be stored. The acQuire Data Model is also referred to as the ADM. You will find a copy of the acQuire Data Model.pdf in \bin.
Table
A database consists of a collection of tables which are, in turn, probably related/linked to one another. Each table holds data about a particular topic. Each item of data in a table is somehow related in theme. Each table consists of one or more fields.
Record
A row or line of data in a form.
Field
Each cell of data in a record is a field. Each field has a field name. For example, in acQuire there is a table called HoleLocation. One of the field names is HoleID. This field is a collection of unique hole identifiers. Some fields in some tables are nominated as essential or primary key fields. Primary key fields must have unique data. Another term for a field is a column - a field or column of data.
Filter
acQuire Tutorial
A filter can be applied to subset the data that you work with - in a form, export and more. Forms with a large amount of data can take a long time to open so it is best to apply a filter that is saved with the form.
Introduction
6 - Before You Start the Tutorial Workspace
An acQuire users work area. A collection of objects in folders that allow you to view your data and to work with it. You can get to a workspace area by clicking onto the Workspace bar. A workspace can be saved (the layout, forms, imports etc) to a workspace name. Workspaces have many of the features of Explorer - you can create, delete and rename folders, forms and imports (use the menu available when you right-click in your workspace). There is no need to go outside acQuire to do your ‘housekeeping’.
One Day workspace
Main menu The workspace tree is a filing system for Icon toolbar your acQuire objects. It consists Shortcut bar of a set of folders. Workspace bar Each folder can Workspace name have any number and type of acQuire object. The shortcut in the Data Entry object Exploration shortcut bar link to objects in the workspace tree, SQL object to acQuire tools or Folder to external files. Form object Import object
Workspace filter
Database bar
Introduction
Object
An item in a folder in your workspace. Object types are many and varied - each performs a different function. acQuire objects are constructed by the users on site. The following summarises the object types.
Briefcase
This object copies data from one acQuire database to another acQuire database. This means that the second database can be ‘up and running’ with all, or a subset of the data of the original, very efficiently. This is a good way to ensure that company codes and reference material are retained throughout the company.
acQuire Tutorial
Before You Start the Tutorial - 7 Data entry
Data entry is one of the acQuire that resides in you workspace or on a PDA (personal digital assistant). A data entry object is designed to create data that has some regularity about it. The data can be inserted or updated into the database. A data entry object differs from an import object which inserts or update data into the database from a source file.Briefcase
Form
A view of the data in the acQuire database. A form may be made up of a single table or a number of tables of data in the database.
Export
An object in your workspace to export Collar, Survey, Assay and Geology data to a text file or software client specific file format. Export, for example, to MineSight, Gemcom, Micromine and Datamine files.
Import
An object that is constructed by the user to import data into the database.
LogReporter
An object to produce a graphic log of drillhole data. The log can incorporate validation codes displayed as patterns, analytical results displayed as bar plots and core photographs.
QAQC
An object in the workspace tree. This object is used to statistically summaries and graphically chart the analytical results that you have in the database.
Report
An object in the workspace tree. This object presents a customised report of data. The acQuire manager on site designs and defines the sheets that make up the report. It can consist of one to many sheets.
Script
This object can consist of a number of sheets. Each sheet can have a queries to access the database and return a result - a set of database records that meet the query criteria or to construct a view, for example.
Workspace filter
A filter can be applied to our workspace. The filter is based upon the fields in Collar. For example, the filter may be ProjectCode = Merlot. All forms that are opened when that workspace filter is applied will have only the data that is defined by ProjectCode = Merlot. The Workspace filters name should give you some indication of its function (they are defined and named by the user). They can be applied when required.
acQuire Tutorial
Introduction
8 - Before You Start the Tutorial Hole navigator
Once a workspace filter has been applied, it is possible to apply a hole filter. All forms that are opened will only have information about the selected HoleID. Automatic requery can be set (Tools, Options, Workspace Settings) so that forms that are open will automatically refresh as the hole filter is changed.
Extra Information Extra information for your interest is presented as follows *
information that could be of interest will be presented like this - a green line at the top h Extra and bottom.
Features and look The following will give you some idea of what acQuire looks like and some of the terminology used in the Tutorial. *
Shortcut bar
Record
Field
Form
Import
Workspace bar Database bar
Tutorial flow The Tutorials must be completed in the following order: 1. Import Drilling Information. You have received the latest diamond drilling data from site and you want to enter it into acQuire. 2. Create Sample Numbers. You want to create some sample numbers or names for the diamond holes, in readiness for the analytical results.
Introduction
acQuire Tutorial
Before You Start the Tutorial - 9 3. Importing Assays. The analytical results have arrived and you want to enter them into acQuire. 4. Exporting Results. You want to export all the geochemical data that you have in your database into a spreadsheet.
acQuire Tutorial
Introduction
10 - Before You Start the Tutorial
*
Introduction
acQuire Tutorial
Tutorial 1
*
Import Drilling Information - 13
Import Drilling Information The story so far Imagine that you receive some drillhole data from site (it is collar and survey information). It has been downloaded to a file that is in CSV format (comma delimited) and you want to load it into your database. *
The steps are 1. Select the import object for the CSV files. 2. Use the import object or template to insert the source file into the Collar and Survey areas of the 1Day database.
3. View and check the results.
Lesson Time: 20 minutes.
Start here Start
1. To import the files, click on A. Import Drilling in the Exploration shortcut tree. The import object (pictured below) will appear in the work area to the right.
The import object consists of a Control Sheet (the white tab on the lower surface of the object) and two other sheets Johnson Rig and Johnson Survey.
Select A. Import Drilling shortcut
Preview of the execution
acQuire Tutorial
Browse to locate the source file
Execute to Insert or Update the source file into the database
Tutorial 1
14 - Import Drilling Information 2. Browse to find the two source files Tsdcol.csv
The collar file.
Tsdsur.csv
The survey file.
You will find them in: \Tutorials\Data Browse
3. Every drillhole that is entered into an acQuire database MUST be assigned to a project. The term project is referred to as ProjectCode within acQuire. From the drop-down list select the Project Code Merlot.
4. Next select the Survey Instrument. Although survey data can be loaded into an acQuire database without a defined survey instrument, the object has been designed in such a way that it MUST be entered. From the drop-down list select the Survey Instrument EastSS.
5. Click the Preview button. This will action the import but not pass the data to the database. You will be able to preview what data will be loaded from the source file to which fields in the database.
The Destination row shows the field names in the database. The field names that are red MUST have data entered into them. The Preview section shows the data in the source file. An import object takes the data in the source file and enters it into the database or updates the data that is already there. En route, from the source to the database, an expression can be applied to the data to change or to check it.
6. Now all you need to do is to execute the function. Go to the Control Sheet. Click on Execute.
Tutorial 1
acQuire Tutorial
Import Drilling Information - 15 7. The Import - Execution dialog will open. Because there can be many sheets in an import object, it is possible to have numerous source files importing data to numerous tables within the database on a single execution. Each sheet can be set to execute as an insert, update, merge or as a check for these types. It is a good idea to do a check before you import to see if you have defined the import object correctly or the source data is correct.
Execute dialog. Note that both sheets are ticked as Active. Each sheet will be imported as Type = Insert. 8. Click Execute Now to insert the data as defined. 9. When it is finished you will get a message that ‘Data Import Ran Successfully’. It is a good idea to read the import report. You will find a summary (and any errors listed if they occurred) of the importing process. Each sheet is summarised in the report. You will find that: Johnson rig
3 records processed. No errors found.
Johnson Survey
8 records processed. No errors found.
You have just imported into the database Collar and Survey data for the following drillholes TSD009, TSD011 and TSD012
10. Click Close to exit the dialog. 11. Go to File, Close on the main menu to exit the object. You will be asked if you want to save the changes to Collar - Run Mode?. Respond with No.
12. You must check that the import functioned the way that it reported. First check that the Collar data was imported (the Johnson rig sheet in the import object). Make sure that you are still in the Exploration bar. Click on B. Check the Collars shortcut in the Exploration tree. The form Drilling will open.
acQuire Tutorial
Tutorial 1
16 - Import Drilling Information 13. Drilling is a view of some of the Collar data in the One Day database. To find the drillholes that you have just imported you will need to:
• Make one of the cells in HOLEID active. • Go to Edit, Find on the main menu. • Type in TSD009 (type in upper case as the database is case sensitive). • Click Find Next. • The record with a HOLEID=TSD009 will be highlighted.
Click on B. Check the Collars. Go to Edit, Find on the main menu to find a record. The records below this will be TSD011 and TSD012. Thus the drillholes were successfully imported into the database.
14. Click Cancel to exit the Find dialog. 15. You can see that all the records in this form have a PROJECTCODE = Merlot. This means that the form has been filtered on PROJECTCODE = Merlot. To see this filter:
• Activate the filter icon on the icon menu. • The acQuire filter will open at the bottom of the form. • To close the filter, re-click on the filter icon.
Tutorial 1
acQuire Tutorial
Import Drilling Information - 17 16. Close the Drillhole form by going to File, Close on the main menu. Because you have not made any changes to the object you will not be asked if you want to save it.
17. Now check that the survey data was loaded. Click on the the object in the Exploration tree C. Check the Surveys.
18. The process to find the new data in this form is the same as previously mentioned • Make a cell in HOLEID active. • Go to Edit, Find on the main menu. • Type in TSD009. • Click Find Next. • The first cell for HOLEID=TSD009 will be displayed. Alternatively you could go to the bottom of the form by clicking on the last record icon on the main menu and view the new surveys at the bottom of the form.
19. Click Cancel to exit the Find dialog. You will find records for TSD011 and TSD012 below that for TSD009. way to sort data in a form is to make one of the cells in the column that you want to h Asort,quickactive (click on a cell). Then highlight the column by clicking on the field name (Dip, for example). Double click very quickly while it is still highlighted and the data will be sorted alternatively in ascending and descending order on the selected field. Please remember that this type of sort cannot be saved with the form.
20. Close the Survey form by clicking on X on the upper right of the object. you have an acQuireManager security key attached to your machine you can inspect the h Ifimport object more fully to see how it was constructed and works. Open the object again by clicking on A. Import drilling in the Exploration tree. Click on the Johnson rig tab to make the sheet active. Right-click on the sheet and select Toggle Design/Run Mode. This will display some of the design features of the sheet. You will be able to see more rows - the: Column Name
Defined if referenced in an Expression.
Expression
Second row which defines the expression that will be applied to the data in the source file before it is imported.
Destination
Field names in the database that will receive the data.
The Expression, an Excel-type query, can range in complexity. On the Johnson rig sheet, ProjectCode is passed from the Control Sheet to Johnson rig via the statement {ctrl::Project Code:}. The Destination EAST is imported from the source file via the Expression {src::East}+50. It is possible to construct very complex expressions. For example, you could test if one of the columns in the source file is “NULL”. If it is, you may not enter any other data from that row. This expression might be:
acQuire Tutorial
Tutorial 1
18 - Import Drilling Information =IF({src::East},"NULL","SKIPROW") Another Expression could concatenate the HoleID and the From to generate a series of unique sample numbers and so on. You may like to see some more information about the functions that can be used in expressions. Go to Help, acQuire Help on the main menu. Select the Index tab and type in ‘expressions’. Select ‘functions’ from the list of topic options. Exit Help. To see how the source file is defined right-click again and select Import Definition. The Import Definition dialog consists of a number of tabs - Source file properties, Sheet properties, Data section and Header section. Source file properties Defines whether one source file will be used for all the sheets in the object or not. Also defines the Data format (comma, tab, space delimited, Micromine and so on) of the source file and its location. Browse to find the source file. In this example the source file is passed to the sheet from the Control Sheet via the statement {ctrl::Collar File}. Sheet properties
Defines the execution type and other properties.
Data section
Defines the row on which the field names occur and the row on which the data starts. The field names of the source file are also defined.
The actual source file must be defined in the Source File Properties tab. On the Data Section tab you define the location of the data section and the field names in the source file. To achieve this, complete the Data starts on line and Field names on line. Click Auto fill and the field names will be displayed in the Name list. Header section
Defines the location of information in the source file header that is to be imported. This is useful when importing analytical results and accessing data in the header of the laboratory source files. In this example this section is not used.
Click OK to exit the dialog. Close the object. Do not save it when you close. You have investigated the way that the source file is defined and now it is time to return to the object in Run Mode.
Tutorial 1
acQuire Tutorial
Import Drilling Information - 19 Right-click and select Toggle Design/Run Mode.
Summary Tutorial 1 has been completed. The following information has been added to the database: *
Collar
TSD009, TSD011, TSD012
Survey
Eight new records for TSD009, TSD011 and TSD012
You are now ready to create some sample numbers for these new holes (Tutorial 2) and to import the results when they arrive from the laboratory (Tutorial 3). *
acQuire Tutorial
Tutorial 1
20 - Import Drilling Information
*
Tutorial 1
acQuire Tutorial
Tutorial 2
Create Sample Numbers - 23
Create Sample Numbers The story so far You have entered collar information for some drillholes and surveys into the 1Day database and you want to enter sample numbers and intervals for these holes in readiness for the assay results that will arrive later. *
The steps are 1. Create the sample numbers for drillholes that were imported in Tutorial 1. 2. Review the results.
Lesson Time: 20 minutes.
Start here You must be in the Exploration tree.
1. Click on D(i). Create Sample Tool. This will open at the Specify Holes dialog. This dialog is part of one of the Tools provided by acQuire - Create Samples.
2. Select the Existing Holes tab. 3. On the left under Select Collar form definition, select One Day, All Collar. 4. Apply a filter so that you can efficiently select the appropriate drillholes. Select the filter HoleID LIKE TSD% from the drop-down list.
Applying a filter subsets your data. The only wildcard that you can use in a filter or other parts of acQuire is %. This character is used to take the place of one to many characters.
*
acQuire Tutorial
Tutorial 2
24 - Create Sample Numbers 5. Click Select Holes and you will find only those drillholes in the database that have a HOLEID that starts with TSD will be displayed in the lower grid.
6. Click Next> to move onto the next dialog box - Order Holes. 7. In the List of Holes, highlight TSD009. Click on the > button in the centre. The drillhole TSD009 will move to the List of Selected Holes. This is one way to move drillholes to the List of Selected Holes.
8. Another way is to double-click quickly on TSD011 in the List of Holes. This drillhole will move to the List of Selected Holes.
9. Now move TSD012 from the List of Holes to the List of Selected Holes by double-clicking on it.
You have selected the three new drillholes that you have just imported into the database: TSD009, TSD011 and TSD012.
10. Click Next> to move onto the next dialog box - Create Samples. 11. You will fill-in the following information for your new sample numbers, checks or field duplicates and standard:
Tutorial 2
Options
Selection Information
Starting SampleID:
R30702
The first sample number.
Sample Increment:
1
Sample numbers will be incremented by 1.
Start Interval at Depth:
0
Sample numbers will start at Depth=0.
Interval Length:
2
Each interval will be 2m down hole.
Min Interval Length:
1.5
At least 1.5m must exist at the bottom of the hole before a new sample number can be generated for it.
Sample Priority:
1
A company defined system of prioritising sample results.
Sample Type:
2m
Select from the predefined sample types.
acQuire Tutorial
Create Sample Numbers - 25
DN2000
Select from the drop-down list of despatch numbers in the database.
Company Standards:
a
Tick if you want to define sample numbers to Standards. These will be saved into the Check Assay area of the database.
Frequency:
20
Every 20th sample number will be a Standard.
Restart for Each Hole:
a
Restart the counting for each new drillhole.
No of Standards:
1
Standard ID:
RF60
Despatch Number:
Field Duplicates:
a
Tick if you want to define sample numbers to Field Duplicates. These will be saved into the Check Assay area of the database.
Frequency:
10
Every 10th sample number will be a Standard.
12. Click Next>. You will progress to the Preview Samples dialog. 13. View the data that will be generated, as per our instructions, for Samples, Duplicates and Standards under each of the tabs. It has not been committed to the database at this stage.
acQuire Tutorial
Tutorial 2
26 - Create Sample Numbers In this exercise, the Create Samples tool has created entries to the _
Assay (Sample table)
_
CheckAssay (CheckSample table)
_
Despatch (DespatchSend table) region of your acQuire Data Model.
It is a good idea to view the Data Model to understand what has been achieved. Listed are the samples that have been created for TSD009. Click Commit if you are happy that the information is correct. Click
