More About Relationships

The name for the relationship should reflect its direction. For example:

• either company → employs → people
• or people→ work for → company
• but not company → work for→ people

PhixFlow imposes no restrictions on the names for relationships, but it must be unique in the repository. (Todo - May change)

One to One Relationships

In a PhixFlow relationship diagram, it is not possible to create a one-to-one relationship. 

Many-to-Many Relationships

You can show a many-to-many relationship by using an intermediate stream. This stream has attributes that are foreign keys from the two streams you want to connect, with a one-to-many relationship into the foreign keys. For example

• A customer buys many products
• And a product can be bought by many customers
• The intermediate stream is a Customer Purchase Record, which has both the CustomerID and ProductID as foreign keys.

Example

In a relationship diagram, a stream and its attributes are displayed as a box. You can expand or collapse the  box using the icon in the top left. PhixFlow shows all the attributes when the stream is expanded, and only the primary and foreign keys when it is collapsed.

The following diagram shows some relationships between streams that represent a company, its employees and departments, the products it makes and the customers who buy them.

(Todo - update with a final version)

The company "contains" many departments. An employee "works in" a department, and a department can have many team members. In this company, the department "makes" several products, which "ship to" many customers.

Relationship diagrams are useful because you can design relational views that use data from multiple streams. For example, you might want a view that shows the employee details by department. This will display data from the Employee stream and the Department stream. The relationship diagram shows these are connected by the DepartmentID attribute.

Relationship Diagrams and Relational Views

TODO - Add how ERDs and Relational vies interact.

Relationship diagrams underpin the ability to create views that combine data from different streams. 

When you create a GUI screen for an application,an area can contain information from a stream, displayed as a Stream View. This can be a grid (table), a graph or a chart. PhixFlow can show data from different streams, where the streams have a connection in a relationship diagram. 

Drawing Relationship Diagrams

Create a Relationship Diagram

1. In the repository for your application, right-click on 

   Insert excerpt
   _relationship_diagram _relationship_diagram nopanel true

   .
2. Click 

   Insert excerpt
   _add _add nopanel true

   .
3. In the pop-up, enter its name.
4. PhixFlow opens a properties tab on the right, and a new relationship diagram on the left. The relationship diagram has a toolbar at the top; see the Toolbar section below for details.

Open a Relationship Diagram

To open an existing relationship diagram:

• either, in the repository, right-click on its name and select Display.
• or, in the properties toolbar, click the .

  Insert excerpt
  _relationship_diagram _relationship_diagram nopanel true

   icon.

Create a New Stream

1. Drag the 

   Insert excerpt
   _streams_add _streams_add nopanel true

    icon from the toolbar into the diagram.
2. In the pop-up, enter its name, for example "Customer" and click

   Insert excerpt
   _dialog_finish _dialog_finish nopanel true

   . PhixFlow opens a new Stream properties tab.
3. PhixFlow adds a box to represent the data stream, and opens the properties tab for it.
4. To add attributes to the stream
   • either, in the properties tab on the right, In the Attributes section, click 

     Insert excerpt
     _add _add nopanel true

     .
   • or right-click the stream and select Add New Stream Attribute.
5. PhixFlow opens a Stream Attributes properties tab where you can specify details for the attribute, such as its name, data type and length. 
6. If this is the unique identifier, tick Primary Key. Remember to include ID or UID in the name.

Add an Existing Stream

1. In the repository, open the list of streams.
2. Drag a stream from the repository into the diagram. PhixFlow adds the stream with a list of all of its attributes.
3. If the stream has many attributes, click  to collapse the stream so that it only shows the primary and foreign keys.

Connect Attributes

To connect attributes in different streams, click-drag from one attribute to another. PhixFlow shows the currently selected destination in bold. Release the click to connect to the selected destination.

PhixFlow can only connect primary and foreign keys. If you connect standard attributes, PhixFlow automatically sets them to be foreign keys.

PhixFlow automatically sets the type of relationship according to the keys:

• one to one: from primary key to primary key
• one to many: from primary key to foreign key
• many to one: from foreign key to primary key
• many to many: from foreign key to foreign key

Other affected pages: repository, toolbars

• .

Properties

Basic Settings

Toolbar 

Anchor
toolbar toolbar

TODO Same as Model Window Toolbar Icons

Image Removed

Image RemovedImage RemovedImage RemovedDrag

Insert excerpt _zoom_out _zoom_out nopanel true	Zoom out to see more of the diagram, with smaller text.
Insert excerpt _zoom_in _zoom_in nopanel true	Zoom in to see a smaller area of the diagram, with larger text.
Insert excerpt _align_grid _align_grid nopanel true	Organise selected objects in a grid.
Insert excerpt _align_left _align_left nopanel true	Align all selected objects left.
Insert excerpt _align_right _align_right nopanel true	Align all selected objects right.
Image Removed Insert excerpt _align_top _align_top nopanel true	Align all selected objects to top.
Insert excerpt _align_bottom _align_bottom nopanel true	Align all selected objects to bottom.
Image Removed	Distribute all selected objects horizontally. Changed ICON TODO
Image Removed	Distribute all selected objects vertically. Changed ICON TODO
Insert excerpt _stream_add _stream_add nopanel true	Either drag into the diagram to add a stream, or click to open the list of streams in the repository	Save TODO	Refresh TODO	Help TODOand drag a stream in from the repository list.
Insert excerpt _save _save nopanel true	Save the relationship diagram.
Insert excerpt _refresh _refresh nopanel true	Refresh the diagram, for example to show changes to an attributes Primary Key or Foreign Key properties.
Insert excerpt _help _help nopanel true	Opens this help page for relationship diagrams.