AgileApps Support Wiki Pre Release

Understanding Object Relationships

From AgileApps Support Wiki
Revision as of 22:28, 14 July 2011 by imported>Aeric (→‎Relating Objects Using Lookups)

Designer > Data > Object > {object} > Relationships

Objects and their relationships are fundamental concepts of the platform. They are the difference between a flat, two-dimensional spreadsheet and a deep, multi-dimensional process model--one that integrates data management policies and user access rights, in addition to its many other benefits.

Object relationships are shown in the Relationships tab for an object, and are further illustrated in the Sample Order Processing System.

Relating Objects Using Lookups

An object relationship is established when one object has a Lookup to another object:

Lookupexample.png


In this example, the Orders object has a Lookup field that references Customers. To create it, it was only necessary to:

  1. Add a field of type "Lookup"
  2. Specify the target object (Customers)


With that relationship established, the platform knows what to do when you create or modify an Order. When creating a new order, for example, clicking the lookup icon ([[File:Lookupicon.gif) gives you a list of Customers you can use to make a selection:

RelatedCustomerSelection.jpg

Notepad.png

Note: You can also add a new customer on the spot using the [New Record] button in that window. That button, too, is generated for you, as a result of adding the Lookup field.


When Orders are displayed, information that identifies the Customer is included:

RelatedToCustomer.jpg


In each case, you can customize the layout to choose which fields from the Customer record to display, and how they are arranged.

Types of Relationships (Relationship Cardinality)

The cardinality of relationship is determined by the number of possible objects at each end of the relationship.

The possible relationships are:

  • Many to One
  • One to Many
  • One to One
  • Many to Many (using an intermediate Junction Object)

Many to One (N:1)

A Lookup field present in an object defines a Many to One relationship. For example, the Orders object has a Lookup to Customers:

Lookupexample.png

So there can be multiple source records (Orders) that point to the same target record (a Customer). So the Lookup defines a Many Orders to One Customer relationship.

Notepad.png

Note: The arrow goes from the multiple-record side to the single-record side. It comes from the Object that has the Lookup, and goes to the object the Lookup is pointing to.

Other Examples of Many to One Relationships
  • Many employees work for a single company
  • Many birds belong to a single flock

One to Many (1:N)

By definition, the "Many Orders to One Customer" relationship also has an inverse relationship: One Customer to Many Orders. The platform handles that relationship in the Related Information of a record. When viewing a Customer record, that section shows all related Orders.

File:Customer orders.jpg

In addition to open Orders, that section shows the history of all Orders for that customer - a time line of your organization's interactions with this Customer, all in one place. Plus, the Related Information Section includes the ability to add Notes and Attachments, Send Email, Add Appointments and Tasks, or Log Activities.

Other Examples of One to Many Relationships
  • A person can own many cars
  • A car is assembled from many parts

One to One (1:1)

A One to One relationship is considered a special case of a One to Many relationship (1:N). You create a 1:N relationship, and then use the application's business logic to put a lid on the number of source objects, whether that lid is set at one, ten, or a thousand.

Most often, a One to One relationship is best modeled by adding fields directly to the record. But it sometimes happens that there are many fields that are used only rarely. In that case, you can put the seldom-used field in a secondary object, and create a Lookup to it. That makes the information easy to access when you need it, but it doesn't take up time or space (for example, when transmitting record data over the internet).

Many to Many (N:M)

In the Sample Order Processing System an Order can have multiple Tags, and any given Tag can apply to multiple Orders. In that system:

  • The tag "Rush" could apply to Order #1 and Order #15. (Many Orders to One Tag)
  • Order #1 could tagged as a "Linux" system, while also being a "Rush" order. (Many Tags to One Order)

That arrangement is a Many Tags to Many Orders relationship.

Examples of Many to Many Relationships
  • Musicians collaborate to produce songs (and songs can be produced by multiple artists)
  • Employees request reimbursement for expenses (and expenses are allocated to employees in a budget)
  • Customers place orders for products (and products are purchased by customers)
  • Carpools contain different riders (and riders can belong to multiple carpool groups)

Working with a Many to Many Relationship

Once a Many to Many relationship has been established, each object contains a Multi Value Lookup field that lets you make multiple selections from the related object. Here, an Order contains a multi value lookup for Tags:

File:Multi Value Lookup-75percent.jpg

Using the Wizard to Create a Many to Many Relationship

This process establishes a relationship between Tags and Orders:

  1. Open the Wizard:
    • Designer > Data > Objects > [New Object]
    • Create Using Wizard
  2. Create the objects you need.
    (This step is optional. If the objects already exist, you can skip this step and move forward to establishing the relationships.)
    • Click [Add an Object]
    • Object Name: - for example, Tags
    • [Define Fields]
    • Field Label: -- for example: Tag Name
  3. Establish Relationships
    • Click [Add a Relationship]
    • Between: Orders and: Tags
    • Relationship Type: Many to Many
      An Orders_Tags object is created behind the scenes, and a many-to-many relationship is established.

Notepad.png

Note: Programmers who work with APIs will need to know about the Junction Objects that underly Many to Many relationships. Everyone else just needs to know that when they see a strange "Orders_Tags" object in their list of objects, that's just the Junction Object that establishes the Many to Many relationship.

Managing Relationships

The Relationships tab for any given object shows the other objects it is related to. That information is shown in a grid.

Lock-tiny.gif

Users that have the Customize Objects permission can manage Relationship Information 
Considerations

Relationships and Composite Objects

Relationship definitions allow for Composite Object operations, where records in related objects can be modified at the same time as the original object, along with objects related to them, and so on--all in a single transaction-safe operation.

Learn more: Working with Composite Objects