Searching...
  1. Home
  2. Our Products
  3. GASWorkS
  4. GDI Commands
  5. Creating & Adding Features
  6. Adding Customers & Services

Adding Customers & Services

Contents

These commands add customer features and their service lines to a GASWorkS model. They cover simple customers, customers with automatic or manual supply-main assignment, customers with a chosen tap location, duplicate customers, multiple-customer entry, polyline-style services, branch customers that tap off another customer’s service, and unassigned customers with no supply main. Always check the default data values and dimensional units before adding new features — select the Options & Settings item in the Utilities menu to review the current values.

GDI Commands

Add A Customer

Adds a simple customer feature.

  1. Select the Add Customer item from the Customer branch of the GDI Command Tree.
  2. At the Select Customer Location prompt, left-click a point in the GDI Display. A customer symbol will be displayed at the selected location.
  3. At the Select Supply Main prompt, left-click a nearby pipe feature.
    Note: A message may be displayed if the selected pipe cannot have customers attached. Click the OK button to return to the prompt.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.
  4. A tap will be placed at the point on the supply main closest to the customer location. A service line will be drawn between the customer location and the tap location.

This command can be executed by selecting the Add Customer item from the GDI Command List or by typing ADDCUSTOMER or ADDCUST on the GDI Command Line and pressing Enter.

Notes

  • A trunk customer service runs from the customer location to a tap location on a supply main. To change the location of the service tap along the supply main after the customer is added, use the Move Service Tap command or grips.

Add A Customer & Automatically Assign The Main

Adds a simple customer feature and automatically assigns the customer to the main nearest to the selected customer location.

  1. Select the Add Customer – Auto Assign Main item from the GDI Command List.
  2. At the Select Customer Location prompt, left-click a point in the GDI Display.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.
  3. A customer symbol will be displayed at the selected location, the service line will be drawn from the customer location to the assigned supply main, and the tap will be placed at the intersection between the service and the main.

This command can be executed by typing ADDAUTOCUSTOMER or AUTOCUST on the GDI Command Line and pressing Enter.

Notes

  • When searching for the nearest main, only mains whose Facility Type is “Active” are considered. The “Active” setting can be found on the Facility Settings screen. To access the screen, select the Facility Settings item from the Edit menu.

Add A Branch Customer

Adds a branch-style customer feature. A branch customer can only be added to an existing non-branch customer feature.

  1. Select the Add Branch Customer item from the Customer branch of the GDI Command Tree.
  2. At the Select Branch Customer Location prompt, left-click a point in the GDI Display. A customer symbol will be displayed at the selected location.
  3. At the Select Customer To Branch From prompt, left-click an existing customer symbol. The selected customer will be highlighted.
    Note: A message may be displayed if the selected customer is already being used as a trunk service. Click the OK button to clear the message.
  4. At the Select New Tap Location prompt, left-click a location on the highlighted service line.
    Note: If the Prompt for Data During New Feature Entry environment settings option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.
  5. A service line will be drawn from the branch customer location to the selected tap location on the trunk service line.

This command can be executed by selecting the Add Branch Customer item from the GDI Command List or by typing ADDBRANCHCUST or ADDBRANCH on the GDI Command Line and pressing Enter.

Notes

  • A branch customer service taps off of a trunk service rather than a main. Branch customers are assigned to the supply main of their trunk customer. Each trunk customer can only have one branch customer.
  • Branch services run in a straight line from the branch customer symbol to the tap location on the trunk service line.
  • To create a branch and a trunk customer from two existing customers, use the Create Branch Customer Tap command.
  • To move a branch service tap to a different trunk service, use the Move Branch Service Tap command.

Add A Customer With A Tap Location

Adds a customer feature and allows the User to select a tap location on the main.

  1. Select the Add Customer – With Tap item from the GDI Command List.
  2. At the Select Customer Location prompt, left-click a point in the GDI Display. A customer symbol will be displayed at the selected location.
  3. At the Select Supply Main Tap Location prompt, left-click a nearby pipe feature.
    Note: A message may be displayed if the selected pipe cannot have customers attached. Click the OK button to return to the prompt.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.
  4. A service line will be drawn from the customer location to the selected tap location on the assigned supply main.

This command can be executed by typing ADDCUSTOMERTAP or ADDTAP on the GDI Command Line and pressing Enter.

Notes

  • The tap location can be adjusted after the customer is added — use the Move Service Tap command or grips to change the location of the service tap along the supply main.

Add A Duplicate Customer

Adds a new customer feature by duplicating an existing customer feature at the same location as the “base” customer.

  1. Select the Add Customer – Duplicate item from the GDI Command List.
  2. At the Select Customer To Duplicate prompt, left-click a customer feature. The selected customer will be highlighted.
  3. At the Number Of Customers To Duplicate prompt, type a value on the GDI Prompt Line and press Enter. This sets the number of duplicate customers to be created.
  4. A message will be displayed asking whether to duplicate the LINK ID Number – respond appropriately.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button. The Customer Data will be displayed for the number of customers duplicated.

This command can be executed by typing ADDDUPLICATECUSTOMER or ADDDUP on the GDI Command Line and pressing Enter.

Notes

  • All values associated with the “base” customer are duplicated, except for the Record Number, Internal ID Number, and Link ID Number.
  • Duplicate customers are assigned the next available customer Internal ID Number. For example, if the model’s highest existing customer Internal ID Number is 12, and three duplicate customers are added. In this case, the Internal ID Number for the duplicate customers will be 13, 14, and 15, respectively.
  • Duplicate customers are placed at the same location as the “base” customer. Left-clicking on that customer location will display the Multiple Customers Found screen. Each customer is listed by either the Record/ID Number or Link ID Number. From this screen, select a number from the list to access an individual customer’s data.

Add Multiple Customers

Adds multiple customer features.

  1. Select the Add Multiple Customers item from the GDI Command List.
  2. At the Select Customer Location prompt, left-click a point in the GDI Display. A customer symbol will be displayed at the selected location.
  3. At the Select Supply Main prompt, left-click a nearby pipe feature.
    Note: A message may be displayed if the selected pipe cannot have customers attached. Click the OK button to return to the prompt.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.
  4. A service line will be drawn from the customer location to the assigned supply main, and the tap will be placed at the intersection between the service and the main.
  5. The Select Customer Location prompt will remain displayed. Repeat the steps above to add more customer features. When finished, right-click the mouse.

This command can be executed by typing ADDMULTICUST on the GDI Command Line and pressing Enter.

Add Multiple Customers & Automatically Assign The Main

Adds multiple customer features and automatically assigns the supply main.

  1. Select the Add Multi Auto-Main item from the Customer branch of the GDI Command Tree.
  2. At the Select Customer Location prompt, left-click a point in the GDI Display. A customer symbol will be displayed at the selected location.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.
    Note: There will be no prompt to select a supply main. GASWorkS will automatically assign the customer to the nearest pipe segment.
  3. A service line will be drawn from the customer location to the closest supply main, and the tap will be placed at the intersection between the service and the main.
  4. The Select Customer Location prompt will remain displayed. Repeat the process until all desired customers have been added. When finished, right-click the mouse.

This command can be executed by selecting the Add Multiple Customers – Auto Assign Main item from the GDI Command List or by typing ADDMULTIAUTO on the GDI Command Line and pressing Enter.

Notes

  • When searching for the nearest main, only mains whose Facility Type is “Active” are considered. The “Active” setting can be found on the Facility Settings screen. To access the screen, select the Facility Settings item from the Edit menu.

Add A Polyline Service Customer

Adds a customer feature with a polyline style service line.

  1. Select the Add Polyline Customer item from the Customer branch of the GDI Command Tree.
  2. At the Main Tap Location prompt, type a coordinate pair on the GDI Prompt Line and press Enter. The tap location will be placed on the pipe nearest the selected point.
    Note: A message may be displayed if the selected pipe cannot have customers attached. Click the OK button to return to the prompt.
  3. At the Next Vertex prompt, left-click the desired vertex location in the GDI Display. A line segment will be drawn from the tap location to the selected vertex location.
  4. The Next Vertex prompt will remain displayed. Use one of the methods described above to continue adding segments. When finished, right-click the mouse to end the polyline at the last entered location.
    Note: To undo the last entered line segment, type “U” on the GDI Prompt Line.
  5. The last added vertex will become the customer location.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.

This command can be executed by selecting the Add Polyline Service Customer item from the GDI Command List or by typing ADDPOLYSERVICE or ADDPOLYS on the GDI Command Line and pressing Enter.

Notes

  • To display the Vertex Data in the Data Panel, left-click on the desired vertex.
  • To add a service line vertex to a polyline service customer, use the Add Service Line Vertex command.
  • To change the location of a service line vertex and redraw the adjacent service line segments, use the Move Service Line Vertex command or grips.
  • To remove a service line vertex from a polyline service customer, use the Delete Service Line Vertex command.

Add An Unassigned Customer

Adds a customer feature that does not require a supply main assignment.

  1. Select the Add Customer – Unassigned item from the GDI Command List.
  2. At the Select Customer Location prompt, left-click a point in the GDI Display.
    Note: If the Prompt For Data During New Feature Entry environment option is selected, the Customer Data will be displayed in the Data Panel. Right-click the mouse to accept the default data values. If changes are made, click the Apply Data Values button.
  3. A customer symbol will be placed in the selected location.

This command can be executed by typing ADDUNASSIGNED or ADDUNCUST on the GDI Command Line and pressing Enter.

Notes

  • When the model is opened, a message may be displayed if unassigned customers exist in the model. An alternative to using an unassigned customer is to assign the customer to an adjacent main or pipe and then set the Per Unit Load value equal to zero (0) or set the Load Status to “off.”
  • To locate unassigned customers, use the Flag Customers – Unassigned command.
  • To connect one unassigned customer to a supply main, use the Reassign Customer Supply Main command. To connect all unassigned customers, use the Assign Customer Service Lines command.

Notes & Considerations

  • To change the Customer Data, use the Edit Customer Data command or left-click the desired customer feature to display the data in the Data Panel.
  • To change a customer’s location, use the Move Customer command or grips.
  • To change a customer’s supply main, use the Reassign Customer Supply Main command.
  • To remove a customer feature from the model, use the Delete Customer command.
  • To graphically select the From Node or To Node to which the customer’s load should be applied, select the Select Supply Node option from the Actions section of the Data Panel.
  • If the Allow Undo Of Data/Graphic Changes environment option is selected, click the Undo icon to restore the last data or graphic change. To access the option, select the Options & Settings item from the Utilities menu, then select the Environment data tab.

See Also

  • Adding Pipes & Nodes
  • Creating Taps, Tables & Legends
  • Customer Loads, Supply Mains & Maintenance
  • Deleting Model Features
  • Editing Customer, Node & Pipe Data
  • Example: Fittings, Panels & Palettes
  • Example: GDI Coordinates, Commands & Grips
  • Example: Selecting, Moving & Viewing Features
  • Flagging Customers, Nodes & Pipes
  • GDI Utilities: Undo, Redo, Cancel & Housekeeping
  • Moving Customers, Nodes & Pipes

FAQ

  • The pipe I clicked won’t accept a customer — why?
    A message is displayed when the selected pipe cannot have customers attached (for example, because of its type or settings). Click the OK command button to return to the prompt and select a different pipe.
  • How do I change a customer’s data or supply main after adding it?
    Left-click the customer to display its data in the Data Panel or use the Edit Customer Data command. Use Move Customer (or grips) to relocate it, Move Service Tap to slide the tap along the main, and Reassign Customer Supply Main to connect it to a different main.
  • How does automatic assignment decide which main to use?
    The auto-assign commands connect the object to the nearest main, but only mains whose Facility Type is “Active” are considered. The Active setting can be viewed on the Facility Settings screen — select the Facility Settings item from the Edit menu.
  • Can a main or service line follow a bent route instead of a straight line?

    Yes. Use the Add Polyline Service command to place a tap location and then a series of vertices; the last vertex entered becomes the customer location. Type “U” on the GDI Prompt Line to undo the last segment while drawing. You can later add, move, or delete line vertices with the corresponding commands.

  • What is the difference between a trunk and a branch customer?
    A trunk customer’s service runs from the customer location to a tap on a supply main. A branch customer taps off of a trunk customer’s service line rather than a main, and is assigned to the supply main of its trunk customer. Each trunk customer can only have one branch customer.

No related posts.

Updated on September 24, 2026

Was this article helpful?

Yes No

Related Articles