Queries

This page contains step-by-step guidance for the most common queries in the Queries menu and their function, but will not be an exhaustive list. This information is primarily intended for Agency staff who need detailed eLandings information for reporting purposes. 

The different types of queries and their use can be found below.

Accessing the Queries Menu

To access the Delinquent Fish Ticket reports, simply click on the Queries drop down menu and again, select Queries.

Delinquent Fish Ticket Queries

The Delinquent Fish Ticket reports show up in the main query list. These reports help identify landing reports that have been created and saved in the eLandings repository database, but the signed copy of the fish ticket has not been either submitted to the local office of ADFG or has yet to be processed by staff.  This is a pretty simple report as it searches for and returns all records without batching information – the Office code, Batch number and Sequence number.

When you select the delinquent report, a dialog box opens and requests that you set the number of days delinquent.  If you do not set the days delinquent, then all un-batched fish ticket reports will be returned.  Please also keep in mind that all un-batched fish ticket reports, for all fisheries are returned.

Please note in the illustration below, highlighted in yellow, the range of CFEC permits, from groundfish to salmon.

To display and save only those reports that is pertinent to your fisheries management team, simply select the Excel filter feature. 

Select Sort & Filter and then Filter.  When you make this selection a down arrow will appear on each on the columns.  Click on the CFEC Fishery column and a complete summary of all permit fisheries in the spreadsheet will display.  All values will be selected.  Simply unclick the Select All option at the beginning of the list and then scroll thru the list to locate the CFEC Fisheries that you wish to review. 

Once the filter is determined, only those records that pertain to your requirements are displayed.

Permit Queries

Their are several types of Permit Queries. These queries will help identify various permits that exist in eLandings and the users that posses them.

CFEC Permit Query

This query will allow you to see all CFEC Permits and the information associated with a particular Permit.

Select CFEC Permits from the menu and click 'Run'.

A popup will open to allow you to enter your desired search criteria.

Enter a START_DATE.

Enter an END_DATE.

After you've entered the date range click 'Execute' to run the query.

After the query runs it will either email or download a .csv file depending on whether or not 'Email Results' is checked.

The results.csv file will contain each permit broken out into it's component parts and the data associated with that permit. (ex. Revoked or not, Name, etc.)

Dual Permit Queries

Dual Permit Salmon Landing Reports show those landing reports that have more than one CFEC permit associated with them.

Select one of the Dual Permit Queries from the menu and click 'Run'.

Enter or select a START_DATE and END_DATE for your query.

Click 'Execute' to generate your results.

The data will be available as a results.csv file.

Federal Permit Query

The Federal Permit Query provides a list of all the valid Federal Processor Permits (FPP) and Federal Fisheries Permits (FFP) from a specified time frame. This query will combine both the FFPs and the FPPs into one .csv document.

The information included is:

• Federal Permit Number (either the FFP or FPP)
• Processor Name
• At Sea Processor (Yes/No)
• License Year
• Effective Date

To run the Federal Permit Query, navigate to Queries/Tools > Queries, then navigate to page 2 using the page numbers at the bottom of the screen. 

Find the Federal Permit query, and select the "Run" button associated with it. 

Enter the START_DATE and the END_DATE. Then select "Execute" to generate the report. The report will either download immediately if you have unchecked the Email Results box, or be sent to the email address on file with your User ID. 

The results will download in a .CSV file for you to search and sort as needed. 

Bristol Bay Queries

The Assurance Report was developed at the request of Bristol Bay processors to assist them in identifying fish tickets that documented incorrect information.  Information contained in the report include:

• Date fishing began
• Date of landing
• Time of landing
• Statarea of harvest
• Gear
• Landing report id
• Fish Ticket Number
• Fishery (as defined by district and gear)

The procedure used by processors is to generate the Bristol Bay Weekly Report and if discrepancies are identified, run the Data Assurance Report to identify the specific report(s) containing incorrect information.  The ticket(s) is corrected and the Bristol Bay Weekly Report generated from eLandings again.

Select the Bristol Bay Data Assurance Report from the menu and click 'Run'.

A popup will open and allow you to select your search criteria. Enter a START_DATE and END_DATE.

Enter the PROC_CODE (a processor or F-code) for the processor whose data you desire. 

The results will be downloaded (or emailed) as results.csv. Below you can see a TEST version of the report.

Landing Report Queries

Fisheries Mgmt Pgm (Fisheries Management Program)

The Fisheries Mgmt Pgm report allows a user to search for landings reports using a CFEC Fishery, a Federal Management Program, and a specified date range as parameters. The report returns the fish ticket number, landing report ID, vessel ADF&G as well as landing and catch data for each landing that matches the search criteria.

To retrieve this report, navigate to Queries/Tools > Queries, then choose page 2 from the page numbers at the bottom of the screen. 

Find the Fisheries Mgmt Pgm query, and click "Run." 

Fill out the following information: CFEC Fishery, the management program, and the start date and stop d ate. 

The parameters might be something like this:

Click "Execute." The results will begin to download (or be emailed) in a .cvs file immediately. 

Clicking on the download will open the file in excel. From here you can search and filter the data as needed. 

Landings Reports with Unlicensed Proc Codes

The query "Landing Reports with Unlicensed Proc Codes" is a query that provides Agency Users with a list of Landing Reports that have an unlicensed Proc Code associated with them. 

To run the query entitled "Landing Reports with Unlicensed Proc Codes" in Agency Web, go to Queries/Tools>Queries, then using the page numbers at the bottom of the screen, navigate to page 3 where you will see the query "Landing Reports with Unlicensed Proc Codes", to begin the query process, click "Run." 

A new dialog box will open on the window titled "Execute Query." This query requires no parameters, so to get the results, you merely need to click "Execute."

If you left the "Email Results" box checked, the "Execute Query" dialog box will close and a green banner will be open on the top of your Agency Web screen. This green banner confirms that you have successfully initiated the query and that the results will be emailed to you shortly. It should look something like this screen shot:

Once the email arrives you can download the .csv file from the email. 

Missing IFQ Reports

The Missing IFQ Reports query is used to find Landing Reports that failed to submit their IFQ report with their Landing Report. 

To run the "Missing IFQ Reports" query, use Agency Web to navigate to Queries/Tools > Queries.

Using the page numbers at the bottom of the screen, navigate to page 3 . Find the report entitled "Missing IFQ Reports" and click "Run." 

A new dialog box entitled "Execute Query" will open. You can use the calendar date picker to set your date range for the START_DATE and STOP_DATE.

When you have entered your dates, you can click "Execute" to begin the download.

If you are using Google Chrome, the download will begin at the bottom left of the screen. To open the .csv file, merely click on the download, and the file will open as soon as the download is complete. 

Misused Stat Area Worksheet

To execute the Misused Stat Area Worksheet, navigate to Queries/Tools > Queries, and then to page three of the queries. Find the query entitled "Misused Stat Area Worksheet" and click "Run."

A new dialog box will open entitled "Execute Query." Type in the date range you wish to search for using the START_DATE and END_DATE, then click "Execute"

The results will download is a .csv file which can be opened in Microsoft Excel for viewing and sorting.

Species and Federal Area

The Species and Federal Area Query provides a .csv file of landing reports matching a set of Federal Area and Species parameters. 

To run the Species and Federal Area Query, use Agency Web to navigate to Queries/Tools > Queries. Navigate through the Queries list to find the "Species and Federal Area" query, then click "Run." 

A new dialog box will open, entitled "Execute Query." Use the fields in the dialog box to create your search parameters. Choose a START_DATE and a STOP_Date, a species code, and up to six federal areas you wish to search for. 

Once you have entered your parameters, click "Execute." The download will either start automatically, or the results file will be sent to your email. Once the download is complete, you can open the .csv file in Excel to view and sort the results of your query. 

Information included will be the Report ID, Report Type, vessel ADF&G, vessel name, Proc Code, Proc Code owner, custom processor, landing date, port of landing, gear type, CFEC permit, management program, management program code, fish ticket, stat area, federal stat area, species, species condition code, disposition of fish, and the weight. Each fish ticket may have multiple lines of results. 

Mothership Tendered Landing Reports

To search for Mothership Tendered Landing reports, use Agency Web to navigate to the Queries/Tools>Queries, then using the page number at the bottom right of the screen, find the query entitled "Mothership Tendered Landing Reports" and click "Run."

The only required search parameters for this query is the year. Enter the four digit year you wish to search, then click "Execute."

The results will either start to download automatically, or be sent to the email associated with your User ID. 

If you have chosen to have the file download immediately, you can open the results by clicking on the download in the bottom left of the screen. 

The results.csv file will open in excel for you to view the data retrieved. 

Report Detail By...

There are multiple queries that begin with "Report Detail by..." They are:

• Report Detail by CFEC Fishery
• Report Detail by CFEC Fishery and Management Program
• Report Detail by Management Program
• Report Detail by Port and CFEC Fishery
• Report Detail by Port and Management Program

These queries are the main group of "Landing Report Queries." Their function is to search through and narrow results for landing reports matching a parameter set. Each query is has slightly different parameters in order to help users narrow their results effectively. These reports return a .csv file which contains all the information on the landing reports that match the search criteria. 

The Report Details By... reports can be found with the other queries on pages 4 and 5.

All five of the "Report Detail by..." reports are narrowed by a selected date range, then depending on your needs, you can choose one of the five reports to further narrow the search. Because they all have the same functionality and provide the same informational details, only one example is provided. However, this one example should give you an understanding of how to run these five reports effectively. 

To run the Report Details by CFEC Fishery and Management Program, first click the "Run" button.

Enter the CFEC Fishery, the Fishery Management Program, and the start and stop date.  

Enter your parameters, then click "Execute."

The Report Detail by CFEC Fishery and Management Program report will download as a .csv file, or be sent to the email address associated with your User ID. The information returned includes Management Program, Program ID, CFEC Permit number, ADF&G, date of landing, port of landing, Proc Code, Fish Ticket Number, gear code, species code, species condition code, landed weight, round weight, ice and slime, disposition code, harvest code, ADF&G Office code, Sequence ticket number, landing report number, report type and trip number. There will be a line for each species reported on each fish ticket. 

Operations Queries

Buying Station Operation Statuses Query

The Buying Station Operation Statuses Query is used to search for Buying Stations registered in eLandings that have a different status then the parent operation they are registered under.

To run this query navigate to Queries/Tools > Queries, then select the Buying Station Operation Statuses "Run" button. 

This report requires no parameters, to run the report, click "Execute"

The report will either be emailed to the address you have on file, or downloaded automatically as a .CSV file which can be opened in excel. 

The file will contain a list that looks similar to the example above. The statuses of the Buying Station and parent operation will be listed next to the names for easy reference.

This list can be filtered or sorted at the user's convenience to extract the necessary data. 

Closed/Archived Operations with Reports

The "Closed/Archived Operations with Reports" query lists all the closed or archived operations and the number of reports that they have in the system. This is a useful tool for eLandings staff and eLandings developers to reference the number of reports a closed or archived operation has, and as a reference to make sure that no closed or archives operations with reports get deleted. The query contains the following information:

• Operation ID
• Operation Name
• Status of Operation
• Operation Type
• Number of Reports

To access this query, navigate to Queries/Tools > Closed/Archived Operations with Reports

Select the "Run" button for the "Closed/Archived Operations with Reports"

This search has built in parameters, so to run the report, just clicks "Execute"

A .csv file will either be sent to the email on file, or automatically start downloading. The default list is sorted by status, and then by name. As you can see in the screen shot below, many archived or closed operations have no reports associated with them, some have a few, and others have many. 

To sort the list to see the operations with archived reports, choose the "Data" tab in excel, and then click "Sort." A new window will open and allow you to choose how you want to organize the data. In this case, we will sort by number of reports, and then change the order of the results to largest to smallest. Click "OK" to make the change. 

Immediately the list will sort by number of reports, and allow the user to see the closed or archived operations with the most number of reports. 

Operations for a User

The query "Operations for a User" lists all the operations an eLandings user is authorized on. To run this report navigate to Queries/Tools > Queries, and then using the page numbers at the bottom of the screen, find the "Operations for a User" query, and click the "Run" button. 

You will need to know the User ID that you wish to search for. Enter the User ID in the Value box, then click "Execute"

The .CSV file will download and can be opened in an excel spread sheet. The query will provide a list of all the operation names that the selected user is authorized on, as well as the operation ID, authorization type, and the status of the operation.

Operation Proc Code License Year

The Operation Proc Code License Year provides Agency Web users with a .CSV sheet of all the Processor Codes and the year the license became active. This is a canned query and the output cannot be tailored.

To run this query go to Queries/Tools > Queries, page 3.

Click the "Run" button for the Operation Proc Code License Year Query.

A new small dialog box will open entitled "Execute Query." By checking or unchecking the "Email Results" box you can choose whether you want the results emailed to the email address associated with your eLandings User ID, or if you want the results to download automatically. In the screen shot below, because the box is unchecked, the download will begin automatically. Click "Execute" to initiate query.

Once you have received and opened the results in excel, you can view all the active Proc Codes, the Operation ID, Operation Name, Operations Type, Status of the Operation, the Liscense Year, the Registered Buyer's Number and the Registered Crab Receiver's number associated with the Proc Code. Line 1 in the .cvs file (outlined in red below) provides you with the column titles. 

SeaLandings Queries

There are three SeaLandings Queries available in the Agency Web. These three queries are used to help eLandings staff provide user support to seaLandings users. 

Sealandings Emaillf History

Sealandings Emaillf History provide programmers and eLandings support staff with a detailed log of file transmissions being sent in to the sealandings server. To get this information, sign into the Agency Web interface, then navigate to Queries/Tools > Queries. Use the page numbers to navigate through the queries to find the Sealandings Emaillf History Query. Click the "Run" button. 

No parameters are required, so clicking "Execute" will start the query download. 

A .CVS document will begin downloading. The document will have details about the IERS Monitor Date, the user ID, and the webservice method. 

SeaLandings Emaillf User

The SeaLandings Emaillf User provides important information about seaLandings users to eLandings staff. This information is primarily used to assist seaLandings support staff with troubleshooting. 

To run the Sealandings Emaillf User Query, use the eLandings Agency website to navigate to Queries/Tools > Queries, then use the page numbers at the bottom of the screen to navigate the to Sealandings Emaillf User Query. Click "Run" to start.

A new dialog box will open, entitled "Execute Query." No parameters are needed to run this query. To begin the download, click "Execute."

Leaving the "Email Results" box checked will result in the query .csv file to be sent to the email address associated with your user name. If the box remains checked, once you click "Execute" the Execute Query dialog box will close and a green informational banner will appear at the top of your screen providing information on the success of the query request, and a time frame within which the results will be emailed. 

When the results are processed you will receive an email with a .csv attachment.  

Open the email and download the attachment

When you open the query file it will provide you with UserIDs, Schema version, the last date the user logged into sealandings, and the number of calls to the server for all active sealandings user IDs. 

Sealandings User Version

The Sealandings User Version query provides details about the operating system and software versions that seaLandings users are operating with. This query takes the SeaLandings Emaillf User query and expands on it, providing more details for troubleshooting or sending receipts. 

To run this query, go to Queries/Tools > Queries. Use the page numbers at the bottom of the screen to search through queries and find the query entitled "Sealandings User Version," click the "Run" button on the same line. 

No information is needed to give this search parameters, it will return information on every registered sealandings user.

To execute the query and start the download, click "Execute." The .CSV file will automatically begin downloading.

The information provided in the report includes the User ID, the operating system that the sealandings program is installed on, the java version, the release build they are operating, the schema version, last date of use, and number of calls to the server. 

To search or narrow the results, click on the Data tab, then hit "Filter." Next, click the down arrows on the column header to open options for filter the results. You can use the search bar, or sort the columns. 

Trip Number Queries

Logbook Queries

Flow Scale Tests Query

The Flow Scale Test Query provides a summary of all the flowscale tests recorded in a single vessel's logbook. To retrieve this information, use the Agency Web to navigate to Queries/Tools > Queries. Use the page numbers at the bottom of the browser screen to navigate through the queries until you find the Flow Scale Tests Query.

Click the "Run" button associated with the Flow Scale Query.

Enter the date range you wish to search for using the START_DATE and END_DATE, then enter target vessel's ADF&G. Click "Execute" to generate the report

The .CSV file will download and can be opened in an excel spreadsheet. The query will contain all the entered flow scale tests entered by the selected vessel within the date parameters set. Addition information will include Logbook ID, the entry sequence of the flow scale test, time of test, platform weight, flow scale test weight, the percentage error and any comments entered. 

Production Report Summary

The Production Report Summary is used to see a detailed summary of all production reports for an at sea or shoreside operation. The report provides a spreadsheet with each line on all production reports based on the date parameters. 

To run the Production Report Summary Query, navigate to Queries/Tools > Queries; then, using the page numbers at the bottom of the browser screen, navigate through the pages until you find the Production Report Summary Query. To start the query, click "Run." 

Enter the federal permit number you wish to search (either the FFP or the FPP) and the date parameters, using the START_DATE and STOP_DATE. Click Execute to run the query. 

A detailed .CSV document will download. Users can sort and filter for species, disposition code, or management program as needed to narrow the detailed information. 

Other Queries

Voided Landing Reports

This query will let you see all the year's voided landing reports. 

Select the query from the list and click 'Run'.

Enter the Year and click 'Execute'.

The results will be a .csv file.