Class Person

Carrier object for Person. Services for the Person Carrier is available from the IPersonAgent.

Inheritance
Object
Person
Namespace: SuperOffice.CRM.Services
Assembly: SuperOffice.Services.dll
Syntax
public class Person : Carrier
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }

Constructors

Person()

Default constructor

Declaration
public Person()
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Properties

How many active ERP links are there for this person?

Declaration
public virtual int ActiveErpLinks { get; set; }
Property Value
Type Description
Int32

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }

ActiveInterests

Number of records in pintr table; select count(*) from pintr pi where pi.person_id = this.person_id == activeInterests is always true

Declaration
public virtual short ActiveInterests { get; set; }
Property Value
Type Description
Int16
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

AssociateId

Id of the item's owner (Associate id)

Declaration
public virtual int AssociateId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

AssociateName

Name of the person's owner

Declaration
public virtual string AssociateName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

CategoryName

The category list item name

Declaration
public virtual string CategoryName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactCountryId

The persons contact country id

Declaration
public virtual int ContactCountryId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactDepartment

The persons contact department

Declaration
public virtual string ContactDepartment { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactFax

Actual phone number as eneterd by the user

Declaration
public virtual string ContactFax { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactFullName

Company full name + department

Declaration
public virtual string ContactFullName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactId

Owning contact ID

Declaration
public virtual int ContactId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactName

The persons company name

Declaration
public virtual string ContactName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactOrgNr

The persons contact organization number

Declaration
public virtual string ContactOrgNr { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ContactPhone

Returns the direct phone that belong to the persons contact.

Declaration
public virtual string ContactPhone { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

CountryId

Country

Declaration
public virtual int CountryId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Description

Info text/description on person.

Declaration
public virtual string Description { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

DirectPhone

Returns the direct phone that belong to the contact person.

Declaration
public virtual string DirectPhone { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Email

First email on contact person.

Declaration
public virtual string Email { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

EmailName

E-mail description

Declaration
public virtual string EmailName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

FaxPhone

Returns the fax phone that belong to the contact person.

Declaration
public virtual string FaxPhone { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Firstname

First name

Declaration
public virtual string Firstname { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

FormalName

Get formal name for a person, as used in labels. (Full name + person title + academic title)

Declaration
public virtual string FormalName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

FullName

Get the persons full name (internal name used in clients for employees).

Declaration
public virtual string FullName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Kanafname

Kana first name, used in Japanese versions only

Declaration
public virtual string Kanafname { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Kanalname

Kana last name, used in Japanese versions only

Declaration
public virtual string Kanalname { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Lastname

Last name

Declaration
public virtual string Lastname { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

MiddleName

Middle name or 'van' etc.

Declaration
public virtual string MiddleName { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

MobilePhone

Returns the mobile phone that belong to the contact person.

Declaration
public virtual string MobilePhone { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Mrmrs

e.g. Mrs sex_title

Declaration
public virtual string Mrmrs { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

PersonId

Primary key

Declaration
public virtual int PersonId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

PersonNumber

Alphanumeric user field

Declaration
public virtual string PersonNumber { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Position

The position. This is a predefined SuperOffice value, different from Title

Declaration
public virtual string Position { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Post1

Postal address, used in Japanese versions only

Declaration
public virtual string Post1 { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Post2

Postal address, used in Japanese versions only

Declaration
public virtual string Post2 { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Post3

Postal address, used in Japanese versions only

Declaration
public virtual string Post3 { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Rank

Display sort sequence for default sort order

Declaration
public virtual short Rank { get; set; }
Property Value
Type Description
Int16
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Retired

1 = the user is retired and should have no rights, not appear in lists, etc.

Declaration
public virtual short Retired { get; set; }
Property Value
Type Description
Int16
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

SupportAssociateId

Our support contact for this person

Declaration
public virtual int SupportAssociateId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

SupportLanguageId

Support priority ID

Declaration
public virtual int SupportLanguageId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

TicketPriorityId

Ticket priority ID

Declaration
public virtual int TicketPriorityId { get; set; }
Property Value
Type Description
Int32
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Title

Title

Declaration
public virtual string Title { get; set; }
Property Value
Type Description
String
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

UsePersonAddress

If 1, use person's address for mailing instead of company address

Declaration
public virtual bool UsePersonAddress { get; set; }
Property Value
Type Description
Boolean
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

Methods

ToString()

Returns the carrier contents as a formatted string.

Declaration
public override string ToString()
Returns
Type Description
String

The carrier contents.
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

ToString(String)

Returns the carrier contents as a formatted string, useful for debugging. Each line in the output is prefixed with the input value.

Declaration
public string ToString(string prefix)
Parameters
Type Name Description
String prefix

The line prefix (typically used for indenting)
Returns
Type Description
String

The carrier contents.
Examples

Get Person 123 using the agent:

 using SuperOffice;
 using SuperOffice.CRM.Services;

 using (SoSession mySession = SoSession.Authenticate("user", "pass"))
 {
    var agent = new PersonAgent();
    var person = agent.GetPerson( 123 );
 }
See Also

See Also