Create a Contact entity through an entity

Creating a contact through an entity can be done in two different ways:

If you create an entity called A and assign it to an entity called B, when saving B - entity A will be saved through NestedPersistent
you can create an entity that is a property of another entity. Then when saving the main entity, the entity created as the property of it will be saved as well.

Both these would give the same results.

Example 1

using SuperOffice.CRM.Entities;
using SuperOffice.CRM.Rows;
using SuperOffice;
using(SoSession mySession = SoSession.Authenticate("sam", "sam"))
{
  //Create a Contact Entity
  Contact newContact = Contact.CreateNew();

  //Setting the Defaults for the Contact
  newContact.SetDefaults();

  //Assigning values for the individual properties of the Contact Entity
  //Assigning basic properties to a Contact
  newContact.Name = "EuroCenter";
  newContact.OrgNr = "1234523";
  newContact.Number1 = "7412885";

  //Adding a Row type property to a Contact Entity
  newContact.Country = new CountryRow.IdxCountryId(40);

  //Creating Email Rows
  EmailRow eMail1 = EmailRow.CreateNew();
  eMail1.EmailAddress = "Matt1@Fox.com";
  eMail1.Description = "Mathews first email";

  EmailRow eMail2 = EmailRow.CreateNew();
  eMail2.EmailAddress = "Matt2@Fox.com";
  eMail2.Description = "Mathews second email";

  //Adding the created Row types to the Properties of Rows type to the Contact Entity
  newContact.Emails.Add(eMail1);
  newContact.Emails.Add(eMail2);

  //Assigning values to Properties of Entity Collection Types.
  Sale newSale1 = Sale.GetFromIdxSaleId(10);
  Sale newSale2 = Sale.GetFromIdxSaleId(20);
  newContact.Sales.Add(newSale1);
  newContact.Sales.Add(newSale2);

  //Retrieving an Instance of another Entity
  Person newPerson = new Person.IdxPersonId(20);

  //Assign the Created Contact to the other Entity
  newPerson.Contact = newContact;

  //Saving the Updated Entity
  newPerson.Save();
}

In the example above, we create a new contact as explained in this example. The difference is that we do not save the created contact. Instead, we assign it to another entity such as the Person entity and then save the Person:

newPerson.Contact = newContact;
newPerson.Save();

Example 2

Below is the example of creating a Contact entity, which is a property of another entity, such as Person.

using SuperOffice.CRM.Entities;
using SuperOffice.CRM.Rows;
using SuperOffice;
using(SoSession mySession = SoSession.Authenticate("sam", "sam"))
{
  //Create an Instance of another Entity
  Person newPerson = Person.CreateNew();
  newPerson.SetDefaults();

  //Assigning values for the individual properties of the ContactEntity of the Person Property
  //Assigning basic properties to a Contact Entity
  newPerson.Contact.Name = "EuroCenter";
  newPerson.Contact.OrgNr = "1234523";
  newPerson.Contact.Number1 = "7412885";

  //Creating Email Rows
  EmailRow eMail1 = EmailRow.CreateNew();
  eMail1.EmailAddress = "Anna1@Nicole.com";
  eMail1.Description = "Anna first email";

  EmailRow eMail2 = EmailRow.CreateNew();
  eMail2.EmailAddress = "Anna2@Nicole.com";
  eMail2.Description = "Anna second email";

  //Adding the created Row types to the Properties of Rows type to the Contact Entity Property of the Person Entity
  newPerson.Contact.Emails.Add(eMail1);
  newPerson.Contact.Emails.Add(eMail2);

  //Assigning values to Properties of Entity Collection Types.
  Sale newSale1 = Sale.GetFromIdxSaleId(10);
  Sale newSale2 = Sale.GetFromIdxSaleId(20);
  newPerson.Contact.Sales.Add(newSale1);
  newPerson.Contact.Sales.Add(newSale2);

  //Saving the Updated Entity
  newPerson.Save();
}

The difference between example 1 and example 2 is that here the properties of the Contact entity are accessed through the instance of the Person entity as shown below. However, the statements may vary a little depending on the data type.

using SuperOffice.CRM.Entities;
using SuperOffice.CRM.Rows;
using SuperOffice;
using(SoSession mySession = SoSession.Authenticate("sam", "sam"))
{
  //Create an Instance of another Entity
  Person newPerson = Person.CreateNew();
  newPerson.SetDefaults();

  //Assigning values for the individual properties of the ContactEntity of the Person Property
  //Assigning basic properties to a Contact Entity
  newPerson.Contact.Name = "EuroCenter";
  newPerson.Contact.OrgNr = "1234523";
  newPerson.Contact.Number1 = "7412885";

  //Creating Email Rows
  EmailRow eMail1 = EmailRow.CreateNew();
  eMail1.EmailAddress = "Anna1@Nicole.com";
  eMail1.Description = "Anna first email";

  EmailRow eMail2 = EmailRow.CreateNew();
  eMail2.EmailAddress = "Anna2@Nicole.com";
  eMail2.Description = "Anna second email";

  //Adding the created Row types to the Properties of Rows type to the Contact Entity Property of the Person Entity
  newPerson.Contact.Emails.Add(eMail1);
  newPerson.Contact.Emails.Add(eMail2);

  //Assigning values to Properties of Entity Collection Types.
  Sale newSale1 = Sale.GetFromIdxSaleId(10);
  Sale newSale2 = Sale.GetFromIdxSaleId(20);
  newPerson.Contact.Sales.Add(newSale1);
  newPerson.Contact.Sales.Add(newSale2);

  //Saving the Updated Entity
  newPerson.Save();
}

When saving the Person entity with the use of the Save method the new Contact is also saved NestedPersistent).

When using the above type of code, the main entity (such as the Person entity above) should also be created. When retrieving a person, it may already have a contact assigned to it. So therefore when adding values to the properties of the Contact in such an entity, what we would actually be doing is updating the existing Contact information.

​Example 1

​Example 2

Example 1

Example 2