Versions Compared

Old Version 1

changes.mady.by.user Fiona Sargeant

Saved on

compared with

New Version 2

changes.mady.by.user Fiona Sargeant

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Relationship diagrams underpin the ability to create views that combine data from different streams

This page is for data modellers or application designers. It explains the properties for relations.

Overview

You can create views by including attributes from different streams and you do this using:

relationship diagrams: this tells PhixFlow which streams are linked via a key attribute -which is the unique identifier for the stream (UID).

relations: this is another way to link streams.

Panel
borderColor#7da054
titleColorwhite
titleBGColor#7da054
borderStylesolid
titleSections on this page

Table of Contents
indent12px
stylenone

Relationship Diagrams and Relational Views

Relationship diagrams are important because they tell PhixFlow how data in different tables is connected. Once you have defined these relationships, you can create data views that combine attributes from different fields.

Need example. 

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

In the repository for your application, right-click on  Insert excerpt_relationship_diagram_relationship_diagramnopaneltrue.Click  Insert excerpt_add_addnopaneltrue.
  • In the pop-up, enter its name.
  • 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.
    • TipWhen you make any changes to the diagram, remember to  Insert excerpt_save_savenopaneltrue.

    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_diagramnopaneltrue icon.

    Create a New Stream

    Drag the  Insert excerpt_streams_add_streams_addnopaneltrue icon from the toolbar into the diagram.In the pop-up, enter its name, for example "Customer" and click Insert excerpt_dialog_finish_dialog_finishnopaneltrue. PhixFlow opens a new Stream properties tab.
  • PhixFlow adds a box to represent the data stream, and opens the properties tab for it.
    • To add attributes to the streameither, in the properties tab on the right, In the Attributes section, click  Insert excerpt_add_addnopaneltrue.
  • or right-click the stream and select Add New Stream Attribute.
  • PhixFlow opens a Stream Attributes properties tab where you can specify details for the attribute, such as its name, data type and length. 
  • 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 Image Removed 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.

    Tip

    You can change which attributes are the Primary Key or a Foreign Key  using the tick boxes in the the Stream Attributes properties.

    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.

    relationship diagram, for each table (stream) and relationship, PhixFlow creates items in the repository; see the diagram below.

    There are additional properties that you can optionally configure for the streams, stream attributes and relationships. In a diagram, you can double-click on a table name, attribute or relationship to open its properties. Alternatively, you can find the item in the repository.

    The relationship properties are described on this page. 

    See also:



    Panel
    borderColor#7da054
    titleColorwhite
    titleBGColor#7da054
    borderStylesolid
    titleSections on this page

    Table of Contents
    indent12px
    stylenone


    Image Added


    Draft image - needs better example and the repo needs to reflect the streams and relationships in the diagram

    Properties

    Insert excerpt
    _standard_settings
    _standard_settings
    nopaneltrue

    Basic Settings

    FieldDescription
    NameEnter the name
    for the entity-relationship diagram. When yo press Return or save a new properties tab, PhixFlow opens an empty diagram in the workspace on the left.
    Toolbar  Anchortoolbartoolbar

    Image Removed

    Insert excerpt_zoom_out_zoom_outnopaneltrueZoom out to see more of the diagram, with smaller text. Insert excerpt_zoom_in_zoom_innopaneltrueZoom in to see a smaller area of the diagram, with larger text. Insert excerpt_align_grid_align_gridnopaneltrue

    Organise selected objects in a grid.

    Insert excerpt_align_left_align_leftnopaneltrue

    Align all selected objects left.

    Insert excerpt_align_right_align_rightnopaneltrue

    Align all selected objects right.

    Insert excerpt_align_top_align_topnopaneltrue

    Align all selected objects to top.

    Insert excerpt_align_bottom_align_bottomnopaneltrue

    Align all selected objects to bottom.

    Insert excerpt_stream_add_stream_addnopaneltrueEither drag into the diagram to add a stream
    or click to open the list of streams in the repository and drag a stream in from the repository list. Insert excerpt_save_savenopaneltrueSave the relationship diagram. Insert excerpt_refresh_refreshnopaneltrueRefresh the diagram, for example to show changes to an attributes Primary Key or Foreign Key properties. Insert excerpt_help_helpnopaneltrueOpens this help page for relationship diagrams.
    .
    Stream AThe name of the source stream for the relationship.
    Stream Attribute AThe source attribute.
    Stream BThe name of the destination stream for the relationship.
    Stream Attribute BThe destination attribute.


    Suggestion for Dev: Properties should list the ERDs the relationship is on its on so you can open it easily