These commands search the model for a specific customer, node, or pipe and place a find flag on it once located — either by a general Search By value, or directly by Internal ID Number, Link ID Number, or Record Number. Only one find flag per feature type can be displayed at a time, so running a new Find command for a feature type replaces that type’s existing flag rather than adding a second one.
GDI Commands
Find A Customer
Finds and flags a customer feature based on a value you specify.
- Select the Find Customer item from the Customer branch of the GDI Command Tree.
- At the Customer Search Method – Search By prompt, select the data item to search by from the GDI Prompt List, then right-click.
- At the “To Find” prompt, type the value to search for and press Enter. GASWorkS searches the model for a customer whose selected data item matches that value.
- A find flag is placed at the matching customer feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDCUSTOMER or FINDCUST on the GDI Command Line.
Notes
- The Find Customer routine is case-sensitive, and a search value must match the entire text value unless the term “LIKE” is typed before it. For example, searching “Main” won’t match “MAIN,” and searching for an address of “Main St” requires the full string — typing “LIKE Main” instead would match either “Main St” or “Main Rd.”
- To search by an attribute value, an attribute database must be attached with the appropriate field assigned. The Attribute Value search uses a SQL-style Search String — for example, an attribute item named FACILITATE equal to 1998 is entered as
FACILITATE = 1998. See the Using SQL Statements topic in the Attribute Data section of the GASWorkS User’s Manual for more detail.
Find A Customer By Internal ID Number
Finds and flags a customer feature by its Internal ID Number.
- Select the Find Customer By Internal ID Number item from the GDI Command List.
- At the Internal ID Number Of Customer To Find prompt, type the ID number and press Enter.
- A find flag is placed at the matching customer feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDCUSTOMERID or FINDCID on the GDI Command Line.
Find A Customer By Link ID Number
Finds and flags a customer feature by its Link ID Number.
- Select the Find Customer By Link ID Number item from the GDI Command List.
- At the Link ID Number Of Customer To Find prompt, type the ID number and press Enter.
- A find flag is placed at the matching customer feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDCUSTOMERLINKID or FINDCLINK on the GDI Command Line.
Notes
- To search for a customer feature by an attribute value, an attribute database must be attached with the appropriate field assigned.
Find A Customer By Record Number
Finds and flags a customer feature by its Record Number.
- Select the Find Customer By Record Number item from the GDI Command List.
- At the Record Number Of Customer To Find prompt, type the record number and press Enter.
- A find flag is placed at the matching customer feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDCUSTOMERRECORD or FINDCREC on the GDI Command Line.
Find A Node
Finds and flags a node based on a value you specify.
- Select the Find Node item from the Edit Data branch of the GDI Command Tree.
- At the Node Search Method – Search By prompt, select the data item to search by from the GDI Prompt List, then right-click.
- At the “To Find” prompt, type the value to search for and press Enter. GASWorkS searches the model for a node whose selected data item matches that value.
- A find flag is placed at the matching node. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDNODE on the GDI Command Line.
Notes
- Type “LIKE” before the search value to allow partial matches, where a value of length “n” matches the first “n” characters of the field. Otherwise the value must match exactly — for example, if Search By is Address and you enter “LIKE 123 Main,” the routine flags a node with the address “123 Main St,” but searching only “123 Main” (without LIKE) would report no feature found.
Find A Node By Name
Finds and flags a node by its node Name.
- Select the Find Node By Name item from the GDI Command List.
- At the Name Of Node To Find prompt, type the node’s name and press Enter.
- A find flag is placed at the matching node. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDNODENAME or FINDNNAME on the GDI Command Line.
Notes
- Type “LIKE” before the search value to allow partial matches, where a value of length “n” matches the first “n” characters of the field. Otherwise the value must match exactly.
Find A Node By Record Number
Finds and flags a node by its Record Number.
- Select the Find Node By Record Number item from the GDI Command List.
- At the Record Number Of Node To Find prompt, type the record number and press Enter.
- A find flag is placed at the matching node. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDNODERECORD or FINDNREC on the GDI Command Line.
Find A Pipe
Finds and flags a pipe feature based on a value you specify.
- Select the Find Pipe item from the Edit Data branch of the GDI Command Tree.
- At the Pipe Search Method – Search By prompt, select the data item to search by from the GDI Prompt List, then right-click.
- At the “To Find” prompt, type the value to search for and press Enter. GASWorkS searches the model for a pipe whose selected data item matches that value.
- A find flag is placed at the matching pipe feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDPIPE on the GDI Command Line.
Notes
- The Find Pipe routine is case-sensitive, and a search value must match the entire text value unless the term “LIKE” is typed before it. For example, searching “Main” won’t match “MAIN,” and typing “LIKE Main” instead would match either “Main St” or “Main Rd.”
- To search by an attribute value, an attribute database must be attached with the appropriate field assigned. The Attribute Value search uses a SQL-style Search String — for example, an attribute item named FACILITATE equal to 1998 is entered as
FACILITATE = 1998. See the Using SQL Statements topic in the Attribute Data section of the GASWorkS User’s Manual for more detail.
Find A Pipe By Internal ID Number
Finds and flags a pipe feature by its Internal ID Number.
- Select the Find Pipe By Internal ID Number item from the GDI Command List.
- At the Internal ID Number Of Pipe To Find prompt, type the ID number and press Enter.
- A find flag is placed at the matching pipe feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDPIPEID or FINDPID on the GDI Command Line.
Find A Pipe By Link ID Number
Finds and flags a pipe feature by its Link ID Number.
- Select the Find Pipe By Link ID Number item from the GDI Command List.
- At the Link ID Number Of Pipe To Find prompt, type the ID number and press Enter.
- A find flag is placed at the matching pipe feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDPIPELINKID or FINDPLINK on the GDI Command Line.
Notes
- To search for a feature by an attribute value, an attribute database must be attached with the appropriate field assigned.
Find A Pipe By Record Number
Finds and flags a pipe feature by its Record Number.
- Select the Find Pipe By Record Number item from the GDI Command List.
- At the Record Number Of Pipe To Find prompt, type the record number and press Enter.
- A find flag is placed at the matching pipe feature. If no match is found, a message may be displayed — click OK to clear it.
Can also be run by typing FINDPIPERECORD or FINDPREC on the GDI Command Line.
Notes & Considerations
- For a find flag to display, the corresponding Display Symbols option must be turned on — Display Customer Symbols for customer finds, Display Node Symbols for node finds, and Display Pipe Symbols for pipe finds.
- Find flags remain displayed until cleared with one of the Clear Flag commands, or until another feature of the same type is flagged with a Find command. Only one find flag per feature type can be displayed at a time.
- If the Automatically Zoom On Find graphics option is selected, the GDI Window view centers on the flagged feature automatically. The option is on the Graphics data tab of the Options & Settings screen (Utilities menu).
- To clear a find flag once you’re done with it, use the corresponding Clear The [Feature] Find Flag or Clear A [Feature] Flag command.
See Also
- Adding Customers & Services
- Adding Pipes & Nodes
- Clearing Customer & Node Flags
- Clearing Pipe, DXF & System Flags
- Display & Visibility Settings
FAQ
-
Do I need exact text for searching?
The Find DXF Text and Find User Text routines are not case-sensitive, but the search string must match the entire text value — to find “Main St” you must search “Main St”. To match partial text, type the term LIKE before the search value. Only the first feature matching the criteria is flagged.
-
Can the view automatically jump to a found feature?Yes. If the Automatically Zoom On Find graphics option is selected, the GDI Window view is centered on the flagged feature. The option is on the Graphics data tab of the Options & Settings screen in the Utilities menu.
-
What does Go To An XY Coordinate Location do to my view?It positions the upper-left corner of the model image at the coordinate you specify — useful for jumping to a known location. Use the Zoom Previous command to return to the last view.