Class NSProjectAgent

Collection of all services that work with Project data.

Examples

NSProjectAgent agent;
agent.callMethod(arg1, arg2);

Constructors

NSProjectAgent()

Collection of all services that work with Project data.

Declaration

NSProjectAgent

Examples

NSProjectAgent agent;
agent.callMethod(arg1, arg2);

Methods

AddProjectMembers(Integer,NSProjectMember[])

Adds multiple project members to a project

Declaration

Void AddProjectMembers(Integer projectEntityId, NSProjectMember[] projectMembers)

Parameters

Type Name Description
Integer projectEntityId
NSProjectMember[] projectMembers

Returns

Type Description
Void

CreateDefaultProjectEntity()

Sets default values into a new NSProjectEntity.

Declaration

NSProjectEntity CreateDefaultProjectEntity()

Examples

NSProjectAgent agent;
NSProjectEntity thing = agent.CreateDefaultProjectEntity();
thing = agent.SaveProjectEntity(thing);

Returns

Type Description
NSProjectEntity

CreateDefaultProjectEventEntity()

Sets default values into a new NSProjectEventEntity.

Declaration

NSProjectEventEntity CreateDefaultProjectEventEntity()

Examples

NSProjectAgent agent;
NSProjectEventEntity thing = agent.CreateDefaultProjectEventEntity();
thing = agent.SaveProjectEventEntity(thing);

Returns

Type Description
NSProjectEventEntity

CreateDefaultProjectMember()

Sets default values into a new NSProjectMember.

Declaration

NSProjectMember CreateDefaultProjectMember()

Examples

NSProjectAgent agent;
NSProjectMember thing = agent.CreateDefaultProjectMember();
thing = agent.SaveProjectMember(thing);

Returns

Type Description
NSProjectMember

CreateNewEntry()

Creates a new project based on external duplicate

Declaration

Integer CreateNewEntry(NSDuplicateEntry duplicate)

Examples

NSProjectAgent agent;
NSDuplicateEntry duplicate;
Integer res = agent.CreateNewEntry(duplicate);

Returns

Type Description
Integer

DeleteProjectEntity(Integer)

Deletes the NSProjectEntity

Declaration

DeleteProjectEntity(Integer projectEntity)

Examples

NSProjectAgent agent;
agent.DeleteProjectEntity(123);

Parameters

Type Name Description
Integer projectEntity

Returns

Type Description
Void

DeleteProjectEventEntity(Integer)

Deletes the NSProjectEventEntity

Declaration

DeleteProjectEventEntity(Integer projectEventEntity)

Examples

NSProjectAgent agent;
agent.DeleteProjectEventEntity(123);

Parameters

Type Name Description
Integer projectEventEntity

Returns

Type Description
Void

DeleteProjectEventEntityFromProjectId(Integer)

Deletes a project event based on a project ID. Does not delete the project, but does delete the published and ExternalEvent and AudienceVisibility records.

Declaration

Void DeleteProjectEventEntityFromProjectId(Integer projectId)

Examples

NSProjectAgent agent;
Integer projectId;
agent.DeleteProjectEventEntityFromProjectId(projectId);

Parameters

Type Name Description
Integer projectId

Returns

Type Description
Void

DeleteProjectMember(Integer)

Deletes the NSProjectMember

Declaration

DeleteProjectMember(Integer projectMember)

Examples

NSProjectAgent agent;
agent.DeleteProjectMember(123);

Parameters

Type Name Description
Integer projectMember

Returns

Type Description
Void

DeleteProjectMemberByIds(Integer[])

Deletes project-member rows.

Declaration

Void DeleteProjectMemberByIds(Integer[] projectMemberIds)

Parameters

Type Name Description
Integer[] projectMemberIds

Returns

Type Description
Void

DeleteProjectMembers(Integer,Integer[])

Deletes the given project members from a project

Declaration

Void DeleteProjectMembers(Integer projectEntityId, Integer[] memberIds)

Parameters

Type Name Description
Integer projectEntityId
Integer[] memberIds

Returns

Type Description
Void

GetDuplicateRules()

Retrieve all available duplicate rules for project

Declaration

NSDuplicateRule[] GetDuplicateRules()

Examples

NSProjectAgent agent;
NSDuplicateRule[] res = agent.GetDuplicateRules();

Returns

Type Description
NSDuplicateRule[]

GetDuplicates(String)

Gets duplicates(exact or similar in the database) based on the name

Declaration

NSDuplicateEntry[] GetDuplicates(String name)

Examples

NSProjectAgent agent;
String name;
NSDuplicateEntry[] res = agent.GetDuplicates(name);

Parameters

Type Name Description
String name

Returns

Type Description
NSDuplicateEntry[]

GetMyMemberProjects()

Returns projects where an user is project member.

Declaration

NSProject[] GetMyMemberProjects()

Examples

NSProjectAgent agent;
NSProject[] res = agent.GetMyMemberProjects();

Returns

Type Description
NSProject[]

GetMyProjectEvents()

Gets all project events that belongs to the currently logged-on user.

Declaration

NSProjectEvent[] GetMyProjectEvents()

Examples

NSProjectAgent agent;
NSProjectEvent[] res = agent.GetMyProjectEvents();

Returns

Type Description
NSProjectEvent[] The list of events is filtered by the Audience Visibility restrictions set when the project event is created.

GetMyProjects(Bool)

Returns projects belonging to an associate. If memberProjects is false only the projects where the associate is project responsible is returned, otherwise both the projects where the associate is project responsible and project member is returned.

Declaration

NSProject[] GetMyProjects(Bool includeMemberProjects)

Examples

NSProjectAgent agent;
Bool includeMemberProjects;
NSProject[] res = agent.GetMyProjects(includeMemberProjects);

Parameters

Type Name Description
Bool includeMemberProjects

Returns

Type Description
NSProject[]

GetMyPublishedProjects()

Gets published projects from the logged in user.

Declaration

NSProject[] GetMyPublishedProjects()

Examples

NSProjectAgent agent;
NSProject[] res = agent.GetMyPublishedProjects();

Returns

Type Description
NSProject[]

GetNextMilestone(Integer)

Declaration

NSAppointment GetNextMilestone(Integer projectId)

Examples

NSProjectAgent agent;
Integer projectId;
NSAppointment res = agent.GetNextMilestone(projectId);

Parameters

Type Name Description
Integer projectId Next upcoming milestone appointment.

Returns

Type Description
NSAppointment

GetNextProjectStatus(Integer)

Declaration

Integer GetNextProjectStatus(Integer projectId)

Parameters

Type Name Description
Integer projectId

Returns

Type Description
Integer

GetProject(Integer)

Gets an NSProject object.

Declaration

NSProject GetProject(Integer projectId)

Examples

NSProjectAgent agent;
NSProject thing = agent.GetProject(123);

Parameters

Type Name Description
Integer projectId

Returns

Type Description
NSProject

GetProjectEntity(Integer)

Gets an NSProjectEntity object.

Declaration

NSProjectEntity GetProjectEntity(Integer projectEntityId)

Examples

NSProjectAgent agent;
NSProjectEntity thing = agent.GetProjectEntity(123);

Parameters

Type Name Description
Integer projectEntityId

Returns

Type Description
NSProjectEntity

GetProjectEvent(Integer)

Gets an NSProjectEvent object.

Declaration

NSProjectEvent GetProjectEvent(Integer projectEventId)

Examples

NSProjectAgent agent;
NSProjectEvent thing = agent.GetProjectEvent(123);

Parameters

Type Name Description
Integer projectEventId

Returns

Type Description
NSProjectEvent

GetProjectEventEntity(Integer)

Gets an NSProjectEventEntity object.

Declaration

NSProjectEventEntity GetProjectEventEntity(Integer projectEventEntityId)

Examples

NSProjectAgent agent;
NSProjectEventEntity thing = agent.GetProjectEventEntity(123);

Parameters

Type Name Description
Integer projectEventEntityId

Returns

Type Description
NSProjectEventEntity

GetProjectEventEntityFromProjectId(Integer)

Gets an NSProjectEventEntity based on a projectId.

Declaration

NSProjectEventEntity GetProjectEventEntityFromProjectId(Integer projectId)

Examples

NSProjectAgent agent;
Integer projectId;
NSProjectEventEntity res = agent.GetProjectEventEntityFromProjectId(projectId);

Parameters

Type Name Description
Integer projectId

Returns

Type Description
NSProjectEventEntity

GetProjectEventList(Integer[])

Gets an array of NSProjectEvent objects.

Declaration

NSProjectEvent[] GetProjectEventList(Integer[]  projectEventIds)

Examples

Integer[] ids;
NSProjectAgent agent;
NSProjectEvent[] res = agent.GetProjectEventList(ids);

Parameters

Type Name Description
Integer[] projectEventIds

Returns

Type Description
NSProjectEvent[]

GetProjectEventOnPerson(Integer,Integer)

Gets an NSProjectEvent object from a project and a person.

Declaration

NSProjectEvent GetProjectEventOnPerson(Integer projectId, Integer personId)

Parameters

Type Name Description
Integer projectId
Integer personId

Returns

Type Description
NSProjectEvent

GetProjectEventsOnPerson(Integer)

Gets all project events that belongs to the person specified.

Declaration

NSProjectEvent[] GetProjectEventsOnPerson(Integer personId)

Examples

NSProjectAgent agent;
Integer personId;
NSProjectEvent[] res = agent.GetProjectEventsOnPerson(personId);

Parameters

Type Name Description
Integer personId

Returns

Type Description
NSProjectEvent[] The list of events are filtered by the Audience Visibility restrictions set when the project event is created.

GetProjectImage(Integer)

Returns the project image that is displayed in the CRM application.

Declaration

NSImage GetProjectImage(Integer projectId)

Examples

NSProjectAgent agent;
Integer projectId;
NSImage res = agent.GetProjectImage(projectId);

Parameters

Type Name Description
Integer projectId

Returns

Type Description
NSImage

GetProjectList(Integer[])

Gets an array of Project objects.

Declaration

NSProject[] GetProjectList(Integer[] projectIds)

Examples

Integer[] ids;
NSProjectAgent agent;
NSProject[] res = agent.GetProjectList(ids);

Parameters

Type Name Description
Integer[] projectIds

Returns

Type Description
NSProject[]

GetProjectMember(Integer)

Gets an NSProjectMember object.

Declaration

NSProjectMember GetProjectMember(Integer projectMemberId)

Examples

NSProjectAgent agent;
NSProjectMember thing = agent.GetProjectMember(123);

Parameters

Type Name Description
Integer projectMemberId

Returns

Type Description
NSProjectMember

GetProjectMembers(Integer)

Returns an array of project members

Declaration

NSProjectMember[] GetProjectMembers(Integer projectId)

Examples

NSProjectAgent agent;
Integer projectId;
NSProjectMember[] res = agent.GetProjectMembers(projectId);

Parameters

Type Name Description
Integer projectId

Returns

Type Description
NSProjectMember[]

GetProjectMembersById(Integer[])

Returns an array of project members.

Declaration

NSProjectMember[] GetProjectMembersById(Integer[] projectMemberIds)

Examples

NSProjectAgent agent;
Integer rojectMemberIds;
NSProjectMember[] res = agent.GetProjectMembersById(projectMemberIds);

Parameters

Type Name Description
Integer[] projectMemberIds

Returns

Type Description
NSProjectMember[]

GetProjectsFromContact(Integer)

Returns all projects where the given contact has project members.

Declaration

NSProject[] GetProjectsFromContact(Integer contactId)

Examples

NSProjectAgent agent;
Integer contactId;
NSProject[] res = agent.GetProjectsFromContact(contactId);

Parameters

Type Name Description
Integer contactId

Returns

Type Description
NSProject[]

GetProjectsFromPerson(Integer)

Returns all projects where the person is project member.

Declaration

NSProject[] GetProjectsFromPerson(Integer personId)

Examples

NSProjectAgent agent;
Integer personId;
NSProject[] res = agent.GetProjectsFromPerson(personId);

Parameters

Type Name Description
Integer personId

Returns

Type Description
NSProject[]

GetPublishedProject(Integer)

Gets published project by project ID.

Declaration

NSProject GetPublishedProject(Integer projectId)

Examples

NSProjectAgent agent;
Integer projectId;
NSProject res = agent.GetPublishedProject(projectId);

Parameters

Type Name Description
Integer projectId

Returns

Type Description
NSProject

GetPublishedProjects(Integer[])

Gets published projects by project IDs.

Declaration

NSProject[] GetPublishedProjects(Integer[] projectIds)

Examples

NSProjectAgent agent;
Integer[] projectIds;
NSProject[] res = agent.GetPublishedProjects(projectIds);

Parameters

Type Name Description
Integer[] projectIds

Returns

Type Description
NSProject[]

GetPublishedProjectsOnPersonId(Integer)

Gets published projects where person is a member

Declaration

NSProject[] GetPublishedProjectsOnPersonId(Integer personId)

Examples

NSProjectAgent agent;
Integer personId;
NSProject[] res = agent.GetPublishedProjectsOnPersonId(personId);

Parameters

Type Name Description
Integer personId

Returns

Type Description
NSProject[]

HasGuide(Integer)

Declaration

Bool HasGuide(Integer projectId)

Examples

NSProjectAgent agent;
Integer projectId;
Bool res = agent.HasGuide(projectId);

Parameters

Type Name Description
Integer projectId

Returns

Type Description
Bool Does this project have a guide associated with its project type?

HasGuideActivities(Integer)

Declaration

Bool HasGuideActivities(Integer projectId)

Parameters

Type Name Description
Integer projectId

Returns

Type Description
Bool

IsNumberValid(Integer,String)

Checks if the number is unique or required.

Declaration

Bool IsNumberValid(Integer contactId, String number)

Examples

NSProjectAgent agent;
Integer contactId;
String number;
Bool res = agent.IsNumberValid(contactId, number);

Parameters

Type Name Description
Integer contactId
String number

Returns

Type Description
Bool

Merge(Integer,Integer,Bool)

Merges two projects into one, removing the source project in the process

Declaration

Void Merge(Integer sourceProjectId, Integer destinationProjectId, Bool replaceEmptyFieldsOnDestination)

Parameters

Type Name Description
Integer sourceProjectId
Integer destinationProjectId
Bool replaceEmptyFieldsOnDestination

Returns

Type Description
Void

OfferAutoNextStatusOnApppointmentCompleted(Integer)

Declaration

Bool OfferAutoNextStatusOnApppointmentCompleted(Integer appointmentId)

Parameters

Type Name Description
Integer appointmentId

Returns

Type Description
Bool

SaveProjectEntity(NSProjectEntity)

Updates the existing NSProjectEntity or creates a new NSProjectEntity if the ID parameter is 0.

Declaration

NSProjectEntity SaveProjectEntity(NSProjectEntity projectEntity)

Examples

NSProject  agent;
NSProjectEntity thing = agent.CreateDefaultProjectEntity();
thing = agent.SaveProjectEntity(thing);

Parameters

Type Name Description
NSProjectEntity projectEntity The entity to save.

Returns

Type Description
NSProjectEntity New or updated NSProjectEntity.

SaveProjectEventEntity(NSProjectEventEntity)

Updates the existing NSProjectEventEntity or creates a new NSProjectEventEntity if the ID parameter is 0.

Returns.

Declaration

NSProjectEventEntity SaveProjectEventEntity(NSProjectEventEntity entity)

Examples

NSProject agent;
NSProjectEventEntity thing = agent.CreateDefaultProjectEventEntity();
thing = agent.SaveProjectEventEntity(thing);

Parameters

Type Name Description
NSProjectEventEntity entity The entity to save.

Returns

Type Description
NSProjectEventEntity The new or updated NSProjectEventEntity.

SaveProjectMember(NSProjectMember)

Updates the existing NSProjectMember or creates a new NSProjectMember if the id parameter is 0

Declaration

NSProjectMember SaveProjectMember(NSProjectMember projectMember)

Examples

NSProject  agent;
NSProjectMember thing = agent.CreateDefaultProjectMember();
thing = agent.SaveProjectMember(thing);

Parameters

Type Name Description
NSProjectMember projectMember The NSProjectMember to save.

Returns

Type Description
NSProjectMember

SaveProjectMembersFunctionAndComment(Integer[],Integer,String)

Saves role and comment on an array of project members represented by IDs.

Declaration

Void SaveProjectMembersFunctionAndComment(Integer[] projectMemberIds, Integer roleId, String comment)

Parameters

Type Name Description
Integer[] projectMemberIds
Integer roleId
String comment

Returns

Type Description
Void

SetDuplicateRulesStatus(NSDuplicateRule[])

Sets which duplicate rules should be active or not

Declaration

Void SetDuplicateRulesStatus(NSDuplicateRule[] rules)

Parameters

Type Name Description
NSDuplicateRule[] rules

Returns

Type Description
Void

SetProjectImage(Integer,NSImage)

Stores the project image that is displayed in the CRM application.

Declaration

Void SetProjectImage(Integer projectId, NSImage image)

Parameters

Type Name Description
Integer projectId
NSImage image

Returns

Type Description
Void

UpdateProjectMember(NSProjectMember)

Updates an NSProjectMember row.

Declaration

NSProjectMember UpdateProjectMember(NSProjectMember projectMember)

Examples

NSProjectAgent agent;
NSProjectMember projectMember;
NSProjectMember res = agent.UpdateProjectMember(projectMember);

Parameters

Type Name Description
NSProjectMember projectMember

Returns

Type Description
NSProjectMember

ValidateProjectEntity(NSProjectEntity)

Checks that entity is ready for saving, return error messages by field.

Declaration

Map ValidateProjectEntity(NSProjectEntity projectEntity)

Examples

NSProjectAgent agent;
NSProjectEntity projectEntity;
Map res = agent.ValidateProjectEntity(NSProjectEntity);

Parameters

Type Name Description
NSProjectEntity projectEntity

Returns

Type Description
Map