n8n/packages/nodes-base/nodes/HighLevel/description/TaskDescription.ts

480 lines
8.4 KiB
TypeScript
Raw Normal View History

feat(HighLevel Node): Add HighLevel node * HighLevel Node & Credentials with basic Get/GetAll contacts * moved contact description into subfolder * improving all HighLevel contact crud operations * Get All Contacts request filters and options * Get All Contacts request operation pagination * Get All Contacts pagination with rootProperty * fixing contact operations lint error node-param-options-type-unsorted-items * Get All Contact pagination using response total to terminate loop * Get All Contacts pagination using qs startAfterId and startAfter instead of nextPageUrl * cleanup ContactDescription.ts operations * added OpportunityDescription.ts Get All Operation * added PipelineDescription.ts Get All pipelines (pagination no supported) * GenericFunctions.ts created highLevelApiPagination method * removed returnAll from getAll pipelines because pagination not supported * minor improvement using IPostReceiveRootProperty Interface * added TaskDescription.ts GetAll operation * TaskDescription get operation * task delete operation * ContactDescription fixing duplicate additionalFields * OpportunityDescription.ts adding filters for get all operation * opportunity get and delete operation * opportunity create additional fields * task create with additionalFields * create opportunity added missing status * pagination resource mapping; create opportunity for contact email/phone/id * create task format field dueDate to suppressMilliseconds * opportunity's pipeline options with loadOptions * fixed task dueDate; task update operation * added contact dnd fields * added contact tags * add contact source parameter * using returnAll Tasks with undocumented limit property * add contact customField with loadOptions * task dueDate preSendAction throw required error * opportunity stageId using getPipelineStages method * improve update contacts operation; renaming identifier to contactId * contact tasks renamed contactIdentifier to contactId and identifier to taskId * delete unused postReceiveAction * getTaskPostReceiceAction to inject contactId into items * remove source field from update contact because not supported * renaming opportunities pipelineIdentifier to pipelineId * opportunity parameter reordering * opportunity update operation * opportunity renamed "Identifier" to "Opporituny ID" * create opportunity additional field tags * opportunity create/update additional fields * opportunity update contactIdentifier * deleted pipeline getAll resource; cleanup generic functions; * opportunity getAll option stageId use getPipelineStages * opportunity assignedTo options use loadOptionsMethod getUsers * added loadOptions description ''Choose from the list, or specify an ID [...]' * getAll Tasks removing output maxResults * highLevelApiRequest add IPollFunctions * add HighLevelTriggerNode * add highLevelOAuth2Api credentials * revert from v2 oauth2 back to apiKey v1 (incompatible client-oauth2) * delete run.sh (was commited by accidant) * removed HighLevelTrigger.node.ts (polling) until we support API V2 webhooks * task additionalFields in alphabetical order; task assignedTo using loadOptions getUsers * contact additionalFields/updateFields/filters in alphabetical order * opportunity additionalFields/fields in alphabetical order * :zap: linter fixes, formating * :zap: fixed deprecated auth * :zap: lock file and auth fix * :zap: linter fixes * :zap: requestWithAuthentication in highLevelApiRequest * :zap: timeZones autoload and naming fixes * contact property dnd - improved display name and description * contact property dnd - improved display name and description * contact create/update pre send action to validate email/phone * updated description for contact lookup email and phone parameters * opportunity monetary value - removed getAll filter (doesn't work) - added param description * opportunity getAll startDate and endDate to type dateTime and dateTimeToEpochPreSendAction * loadOption getTimezones() using /timezones and not moment.tz.names() * improved description for opportunity parameter assignedTo * added hint to opportunity param contactIdentifier "there can only be one..." * added contact phone description and placeholder * contact renamed operation "create" to "create or update" and added notice * update opportunity - prefetch fields title/status required by api * create/update task splitting up additionalFields to prep update changes * update task- prefetch fields title/dueDate required by api * linter fixes * :zap: improvements * :zap: updated autoloaded parameters names to follow convention * update opportunity added hint "You cannot update an opportunity's pipeline ID." Co-authored-by: Michael Kret <michael.k@radency.com>
2022-08-30 02:25:06 -07:00
import { INodeProperties } from 'n8n-workflow';
import {
dueDatePreSendAction,
taskPostReceiceAction,
taskUpdatePreSendAction,
} from '../GenericFunctions';
feat(HighLevel Node): Add HighLevel node * HighLevel Node & Credentials with basic Get/GetAll contacts * moved contact description into subfolder * improving all HighLevel contact crud operations * Get All Contacts request filters and options * Get All Contacts request operation pagination * Get All Contacts pagination with rootProperty * fixing contact operations lint error node-param-options-type-unsorted-items * Get All Contact pagination using response total to terminate loop * Get All Contacts pagination using qs startAfterId and startAfter instead of nextPageUrl * cleanup ContactDescription.ts operations * added OpportunityDescription.ts Get All Operation * added PipelineDescription.ts Get All pipelines (pagination no supported) * GenericFunctions.ts created highLevelApiPagination method * removed returnAll from getAll pipelines because pagination not supported * minor improvement using IPostReceiveRootProperty Interface * added TaskDescription.ts GetAll operation * TaskDescription get operation * task delete operation * ContactDescription fixing duplicate additionalFields * OpportunityDescription.ts adding filters for get all operation * opportunity get and delete operation * opportunity create additional fields * task create with additionalFields * create opportunity added missing status * pagination resource mapping; create opportunity for contact email/phone/id * create task format field dueDate to suppressMilliseconds * opportunity's pipeline options with loadOptions * fixed task dueDate; task update operation * added contact dnd fields * added contact tags * add contact source parameter * using returnAll Tasks with undocumented limit property * add contact customField with loadOptions * task dueDate preSendAction throw required error * opportunity stageId using getPipelineStages method * improve update contacts operation; renaming identifier to contactId * contact tasks renamed contactIdentifier to contactId and identifier to taskId * delete unused postReceiveAction * getTaskPostReceiceAction to inject contactId into items * remove source field from update contact because not supported * renaming opportunities pipelineIdentifier to pipelineId * opportunity parameter reordering * opportunity update operation * opportunity renamed "Identifier" to "Opporituny ID" * create opportunity additional field tags * opportunity create/update additional fields * opportunity update contactIdentifier * deleted pipeline getAll resource; cleanup generic functions; * opportunity getAll option stageId use getPipelineStages * opportunity assignedTo options use loadOptionsMethod getUsers * added loadOptions description ''Choose from the list, or specify an ID [...]' * getAll Tasks removing output maxResults * highLevelApiRequest add IPollFunctions * add HighLevelTriggerNode * add highLevelOAuth2Api credentials * revert from v2 oauth2 back to apiKey v1 (incompatible client-oauth2) * delete run.sh (was commited by accidant) * removed HighLevelTrigger.node.ts (polling) until we support API V2 webhooks * task additionalFields in alphabetical order; task assignedTo using loadOptions getUsers * contact additionalFields/updateFields/filters in alphabetical order * opportunity additionalFields/fields in alphabetical order * :zap: linter fixes, formating * :zap: fixed deprecated auth * :zap: lock file and auth fix * :zap: linter fixes * :zap: requestWithAuthentication in highLevelApiRequest * :zap: timeZones autoload and naming fixes * contact property dnd - improved display name and description * contact property dnd - improved display name and description * contact create/update pre send action to validate email/phone * updated description for contact lookup email and phone parameters * opportunity monetary value - removed getAll filter (doesn't work) - added param description * opportunity getAll startDate and endDate to type dateTime and dateTimeToEpochPreSendAction * loadOption getTimezones() using /timezones and not moment.tz.names() * improved description for opportunity parameter assignedTo * added hint to opportunity param contactIdentifier "there can only be one..." * added contact phone description and placeholder * contact renamed operation "create" to "create or update" and added notice * update opportunity - prefetch fields title/status required by api * create/update task splitting up additionalFields to prep update changes * update task- prefetch fields title/dueDate required by api * linter fixes * :zap: improvements * :zap: updated autoloaded parameters names to follow convention * update opportunity added hint "You cannot update an opportunity's pipeline ID." Co-authored-by: Michael Kret <michael.k@radency.com>
2022-08-30 02:25:06 -07:00
export const taskOperations: INodeProperties[] = [
{
displayName: 'Operation',
name: 'operation',
type: 'options',
noDataExpression: true,
displayOptions: {
show: {
resource: ['task'],
},
},
options: [
{
name: 'Create',
value: 'create',
routing: {
request: {
method: 'POST',
url: '=/contacts/{{$parameter.contactId}}/tasks',
},
output: {
postReceive: [taskPostReceiceAction],
},
},
action: 'Create a task',
},
{
name: 'Delete',
value: 'delete',
routing: {
request: {
method: 'DELETE',
url: '=/contacts/{{$parameter.contactId}}/tasks/{{$parameter.taskId}}',
},
output: {
postReceive: [
{
type: 'set',
properties: {
value: '={{ { "success": true } }}',
},
},
],
},
},
action: 'Delete a task',
},
{
name: 'Get',
value: 'get',
routing: {
request: {
method: 'GET',
url: '=/contacts/{{$parameter.contactId}}/tasks/{{$parameter.taskId}}',
},
output: {
postReceive: [taskPostReceiceAction],
},
},
action: 'Get a task',
},
{
name: 'Get Many',
feat(HighLevel Node): Add HighLevel node * HighLevel Node & Credentials with basic Get/GetAll contacts * moved contact description into subfolder * improving all HighLevel contact crud operations * Get All Contacts request filters and options * Get All Contacts request operation pagination * Get All Contacts pagination with rootProperty * fixing contact operations lint error node-param-options-type-unsorted-items * Get All Contact pagination using response total to terminate loop * Get All Contacts pagination using qs startAfterId and startAfter instead of nextPageUrl * cleanup ContactDescription.ts operations * added OpportunityDescription.ts Get All Operation * added PipelineDescription.ts Get All pipelines (pagination no supported) * GenericFunctions.ts created highLevelApiPagination method * removed returnAll from getAll pipelines because pagination not supported * minor improvement using IPostReceiveRootProperty Interface * added TaskDescription.ts GetAll operation * TaskDescription get operation * task delete operation * ContactDescription fixing duplicate additionalFields * OpportunityDescription.ts adding filters for get all operation * opportunity get and delete operation * opportunity create additional fields * task create with additionalFields * create opportunity added missing status * pagination resource mapping; create opportunity for contact email/phone/id * create task format field dueDate to suppressMilliseconds * opportunity's pipeline options with loadOptions * fixed task dueDate; task update operation * added contact dnd fields * added contact tags * add contact source parameter * using returnAll Tasks with undocumented limit property * add contact customField with loadOptions * task dueDate preSendAction throw required error * opportunity stageId using getPipelineStages method * improve update contacts operation; renaming identifier to contactId * contact tasks renamed contactIdentifier to contactId and identifier to taskId * delete unused postReceiveAction * getTaskPostReceiceAction to inject contactId into items * remove source field from update contact because not supported * renaming opportunities pipelineIdentifier to pipelineId * opportunity parameter reordering * opportunity update operation * opportunity renamed "Identifier" to "Opporituny ID" * create opportunity additional field tags * opportunity create/update additional fields * opportunity update contactIdentifier * deleted pipeline getAll resource; cleanup generic functions; * opportunity getAll option stageId use getPipelineStages * opportunity assignedTo options use loadOptionsMethod getUsers * added loadOptions description ''Choose from the list, or specify an ID [...]' * getAll Tasks removing output maxResults * highLevelApiRequest add IPollFunctions * add HighLevelTriggerNode * add highLevelOAuth2Api credentials * revert from v2 oauth2 back to apiKey v1 (incompatible client-oauth2) * delete run.sh (was commited by accidant) * removed HighLevelTrigger.node.ts (polling) until we support API V2 webhooks * task additionalFields in alphabetical order; task assignedTo using loadOptions getUsers * contact additionalFields/updateFields/filters in alphabetical order * opportunity additionalFields/fields in alphabetical order * :zap: linter fixes, formating * :zap: fixed deprecated auth * :zap: lock file and auth fix * :zap: linter fixes * :zap: requestWithAuthentication in highLevelApiRequest * :zap: timeZones autoload and naming fixes * contact property dnd - improved display name and description * contact property dnd - improved display name and description * contact create/update pre send action to validate email/phone * updated description for contact lookup email and phone parameters * opportunity monetary value - removed getAll filter (doesn't work) - added param description * opportunity getAll startDate and endDate to type dateTime and dateTimeToEpochPreSendAction * loadOption getTimezones() using /timezones and not moment.tz.names() * improved description for opportunity parameter assignedTo * added hint to opportunity param contactIdentifier "there can only be one..." * added contact phone description and placeholder * contact renamed operation "create" to "create or update" and added notice * update opportunity - prefetch fields title/status required by api * create/update task splitting up additionalFields to prep update changes * update task- prefetch fields title/dueDate required by api * linter fixes * :zap: improvements * :zap: updated autoloaded parameters names to follow convention * update opportunity added hint "You cannot update an opportunity's pipeline ID." Co-authored-by: Michael Kret <michael.k@radency.com>
2022-08-30 02:25:06 -07:00
value: 'getAll',
routing: {
request: {
method: 'GET',
url: '=/contacts/{{$parameter.contactId}}/tasks',
},
output: {
postReceive: [
{
type: 'rootProperty',
properties: {
property: 'tasks',
},
},
taskPostReceiceAction,
],
},
},
action: 'Get many tasks',
feat(HighLevel Node): Add HighLevel node * HighLevel Node & Credentials with basic Get/GetAll contacts * moved contact description into subfolder * improving all HighLevel contact crud operations * Get All Contacts request filters and options * Get All Contacts request operation pagination * Get All Contacts pagination with rootProperty * fixing contact operations lint error node-param-options-type-unsorted-items * Get All Contact pagination using response total to terminate loop * Get All Contacts pagination using qs startAfterId and startAfter instead of nextPageUrl * cleanup ContactDescription.ts operations * added OpportunityDescription.ts Get All Operation * added PipelineDescription.ts Get All pipelines (pagination no supported) * GenericFunctions.ts created highLevelApiPagination method * removed returnAll from getAll pipelines because pagination not supported * minor improvement using IPostReceiveRootProperty Interface * added TaskDescription.ts GetAll operation * TaskDescription get operation * task delete operation * ContactDescription fixing duplicate additionalFields * OpportunityDescription.ts adding filters for get all operation * opportunity get and delete operation * opportunity create additional fields * task create with additionalFields * create opportunity added missing status * pagination resource mapping; create opportunity for contact email/phone/id * create task format field dueDate to suppressMilliseconds * opportunity's pipeline options with loadOptions * fixed task dueDate; task update operation * added contact dnd fields * added contact tags * add contact source parameter * using returnAll Tasks with undocumented limit property * add contact customField with loadOptions * task dueDate preSendAction throw required error * opportunity stageId using getPipelineStages method * improve update contacts operation; renaming identifier to contactId * contact tasks renamed contactIdentifier to contactId and identifier to taskId * delete unused postReceiveAction * getTaskPostReceiceAction to inject contactId into items * remove source field from update contact because not supported * renaming opportunities pipelineIdentifier to pipelineId * opportunity parameter reordering * opportunity update operation * opportunity renamed "Identifier" to "Opporituny ID" * create opportunity additional field tags * opportunity create/update additional fields * opportunity update contactIdentifier * deleted pipeline getAll resource; cleanup generic functions; * opportunity getAll option stageId use getPipelineStages * opportunity assignedTo options use loadOptionsMethod getUsers * added loadOptions description ''Choose from the list, or specify an ID [...]' * getAll Tasks removing output maxResults * highLevelApiRequest add IPollFunctions * add HighLevelTriggerNode * add highLevelOAuth2Api credentials * revert from v2 oauth2 back to apiKey v1 (incompatible client-oauth2) * delete run.sh (was commited by accidant) * removed HighLevelTrigger.node.ts (polling) until we support API V2 webhooks * task additionalFields in alphabetical order; task assignedTo using loadOptions getUsers * contact additionalFields/updateFields/filters in alphabetical order * opportunity additionalFields/fields in alphabetical order * :zap: linter fixes, formating * :zap: fixed deprecated auth * :zap: lock file and auth fix * :zap: linter fixes * :zap: requestWithAuthentication in highLevelApiRequest * :zap: timeZones autoload and naming fixes * contact property dnd - improved display name and description * contact property dnd - improved display name and description * contact create/update pre send action to validate email/phone * updated description for contact lookup email and phone parameters * opportunity monetary value - removed getAll filter (doesn't work) - added param description * opportunity getAll startDate and endDate to type dateTime and dateTimeToEpochPreSendAction * loadOption getTimezones() using /timezones and not moment.tz.names() * improved description for opportunity parameter assignedTo * added hint to opportunity param contactIdentifier "there can only be one..." * added contact phone description and placeholder * contact renamed operation "create" to "create or update" and added notice * update opportunity - prefetch fields title/status required by api * create/update task splitting up additionalFields to prep update changes * update task- prefetch fields title/dueDate required by api * linter fixes * :zap: improvements * :zap: updated autoloaded parameters names to follow convention * update opportunity added hint "You cannot update an opportunity's pipeline ID." Co-authored-by: Michael Kret <michael.k@radency.com>
2022-08-30 02:25:06 -07:00
},
{
name: 'Update',
value: 'update',
routing: {
request: {
method: 'PUT',
url: '=/contacts/{{$parameter.contactId}}/tasks/{{$parameter.taskId}}',
},
send: {
preSend: [taskUpdatePreSendAction],
},
output: {
postReceive: [taskPostReceiceAction],
},
},
action: 'Update a task',
},
],
default: 'create',
},
];
const createProperties: INodeProperties[] = [
{
displayName: 'Contact ID',
name: 'contactId',
type: 'string',
displayOptions: {
show: {
resource: ['task'],
operation: ['create'],
},
},
default: '',
required: true,
description: 'Contact the task belongs to',
},
{
displayName: 'Title',
name: 'title',
type: 'string',
required: true,
default: '',
displayOptions: {
show: {
resource: ['task'],
operation: ['create'],
},
},
routing: {
send: {
type: 'body',
property: 'title',
},
},
},
{
displayName: 'Due Date',
name: 'dueDate',
type: 'dateTime',
required: true,
default: '',
displayOptions: {
show: {
resource: ['task'],
operation: ['create'],
},
},
routing: {
send: {
type: 'body',
property: 'dueDate',
preSend: [dueDatePreSendAction],
},
},
},
{
displayName: 'Additional Fields',
name: 'additionalFields',
type: 'collection',
placeholder: 'Add Field',
default: {},
displayOptions: {
show: {
resource: ['task'],
operation: ['create'],
},
},
options: [
{
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-wrong-for-dynamic-options
displayName: 'Assigned To',
name: 'assignedTo',
type: 'options',
default: '',
description:
'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>',
typeOptions: {
loadOptionsMethod: 'getUsers',
},
routing: {
send: {
type: 'body',
property: 'assignedTo',
},
},
},
{
displayName: 'Description',
name: 'description',
type: 'string',
default: '',
routing: {
send: {
type: 'body',
property: 'description',
},
},
},
{
displayName: 'Status',
name: 'status',
type: 'options',
options: [
{
name: 'Incompleted',
value: 'incompleted',
},
{
name: 'Completed',
value: 'completed',
},
],
default: 'incompleted',
routing: {
send: {
type: 'body',
property: 'status',
},
},
},
],
},
];
const deleteProperties: INodeProperties[] = [
{
displayName: 'Contact ID',
name: 'contactId',
type: 'string',
displayOptions: {
show: {
resource: ['task'],
operation: ['delete'],
},
},
default: '',
required: true,
description: 'Contact the task belongs to',
},
{
displayName: 'Task ID',
name: 'taskId',
type: 'string',
required: true,
displayOptions: {
show: {
resource: ['task'],
operation: ['delete'],
},
},
default: '',
},
];
const getProperties: INodeProperties[] = [
{
displayName: 'Contact ID',
name: 'contactId',
type: 'string',
displayOptions: {
show: {
resource: ['task'],
operation: ['get'],
},
},
default: '',
required: true,
description: 'Contact the task belongs to',
},
{
displayName: 'Task ID',
name: 'taskId',
type: 'string',
required: true,
displayOptions: {
show: {
resource: ['task'],
operation: ['get'],
},
},
default: '',
},
];
const getAllProperties: INodeProperties[] = [
{
displayName: 'Contact ID',
name: 'contactId',
type: 'string',
displayOptions: {
show: {
resource: ['task'],
operation: ['getAll'],
},
},
default: '',
required: true,
description: 'Contact the task belongs to',
},
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: ['task'],
operation: ['getAll'],
},
},
default: false,
description: 'Whether to return all results or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: ['task'],
operation: ['getAll'],
returnAll: [false],
},
},
typeOptions: {
minValue: 1,
maxValue: 100,
},
default: 20,
routing: {
send: {
type: 'query',
property: 'limit',
},
},
description: 'Max number of results to return',
},
];
const updateProperties: INodeProperties[] = [
{
displayName: 'Contact ID',
name: 'contactId',
type: 'string',
displayOptions: {
show: {
resource: ['task'],
operation: ['update'],
},
},
default: '',
required: true,
description: 'Contact the task belongs to',
},
{
displayName: 'Task ID',
name: 'taskId',
type: 'string',
displayOptions: {
show: {
resource: ['task'],
operation: ['update'],
},
},
default: '',
required: true,
},
{
displayName: 'Update Fields',
name: 'updateFields',
type: 'collection',
placeholder: 'Add Field',
default: {},
displayOptions: {
show: {
resource: ['task'],
operation: ['update'],
},
},
options: [
{
// eslint-disable-next-line n8n-nodes-base/node-param-display-name-wrong-for-dynamic-options
displayName: 'Assigned To',
name: 'assignedTo',
type: 'options',
default: '',
description:
'Choose from the list, or specify an ID using an <a href="https://docs.n8n.io/code-examples/expressions/">expression</a>',
typeOptions: {
loadOptionsMethod: 'getUsers',
},
routing: {
send: {
type: 'body',
property: 'assignedTo',
},
},
},
{
displayName: 'Description',
name: 'description',
type: 'string',
default: '',
routing: {
send: {
type: 'body',
property: 'description',
},
},
},
{
displayName: 'Due Date',
name: 'dueDate',
type: 'dateTime',
default: '',
routing: {
send: {
type: 'body',
property: 'dueDate',
preSend: [dueDatePreSendAction],
},
},
},
{
displayName: 'Status',
name: 'status',
type: 'options',
options: [
{
name: 'Incompleted',
value: 'incompleted',
},
{
name: 'Completed',
value: 'completed',
},
],
default: 'incompleted',
routing: {
send: {
type: 'body',
property: 'status',
},
},
},
{
displayName: 'Title',
name: 'title',
type: 'string',
default: '',
routing: {
send: {
type: 'body',
property: 'title',
},
},
},
],
},
];
export const taskFields: INodeProperties[] = [
...createProperties,
...updateProperties,
...deleteProperties,
...getProperties,
...getAllProperties,
];