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 |