import type { IDataObject, IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription, } from 'n8n-workflow'; import { NodeOperationError } from 'n8n-workflow'; import { SIGNL4ApiRequest } from './GenericFunctions'; export class Signl4 implements INodeType { description: INodeTypeDescription = { displayName: 'SIGNL4', name: 'signl4', // eslint-disable-next-line n8n-nodes-base/node-class-description-icon-not-svg icon: 'file:signl4.png', group: ['transform'], version: 1, subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}', description: 'Consume SIGNL4 API', defaults: { name: 'SIGNL4', }, inputs: ['main'], outputs: ['main'], credentials: [ { name: 'signl4Api', required: true, }, ], properties: [ { displayName: 'Resource', name: 'resource', type: 'options', noDataExpression: true, options: [ { name: 'Alert', value: 'alert', }, ], default: 'alert', }, { displayName: 'Operation', name: 'operation', type: 'options', noDataExpression: true, displayOptions: { show: { resource: ['alert'], }, }, options: [ { name: 'Send', value: 'send', description: 'Send an alert', action: 'Send an alert', }, { name: 'Resolve', value: 'resolve', description: 'Resolve an alert', action: 'Resolve an alert', }, ], default: 'send', }, { displayName: 'Message', name: 'message', type: 'string', default: '', displayOptions: { show: { operation: ['send'], resource: ['alert'], }, }, description: 'A more detailed description for the alert', }, { displayName: 'Additional Fields', name: 'additionalFields', type: 'collection', placeholder: 'Add Field', displayOptions: { show: { operation: ['send'], resource: ['alert'], }, }, default: {}, options: [ { displayName: 'Alerting Scenario', name: 'alertingScenario', type: 'options', options: [ { name: 'Single ACK', value: 'single_ack', description: 'In case only one person needs to confirm this Signl', }, { name: 'Multi ACK', value: 'multi_ack', description: 'In case this alert must be confirmed by the number of people who are on duty at the time this Singl is raised', }, ], default: 'single_ack', }, { displayName: 'Attachments', name: 'attachmentsUi', placeholder: 'Add Attachments', type: 'fixedCollection', typeOptions: { multipleValues: false, }, options: [ { name: 'attachmentsBinary', displayName: 'Attachments Binary', values: [ { displayName: 'Property Name', name: 'property', type: 'string', placeholder: 'data', default: '', description: 'Name of the binary properties which contain data which should be added as attachment', }, ], }, ], default: {}, }, { displayName: 'External ID', name: 'externalId', type: 'string', default: '', description: 'If the event originates from a record in a 3rd party system, use this parameter to pass the unique ID of that record. That ID will be communicated in outbound webhook notifications from SIGNL4, which is great for correlation/synchronization of that record with the alert. If you resolve / close an alert you must use the same External ID as in the original alert.', }, { displayName: 'Filtering', name: 'filtering', type: 'boolean', default: false, description: 'Whether to apply event filtering for this event, or not. If set to true, the event will only trigger a notification to the team, if it contains at least one keyword from one of your services and system categories (i.e. it is whitelisted)', }, { displayName: 'Location', name: 'locationFieldsUi', type: 'fixedCollection', placeholder: 'Add Location', default: {}, description: "Transmit location information ('latitude, longitude') with your event and display a map in the mobile app", options: [ { name: 'locationFieldsValues', displayName: 'Location', values: [ { displayName: 'Latitude', name: 'latitude', type: 'string', required: true, description: 'The location latitude', default: '', }, { displayName: 'Longitude', name: 'longitude', type: 'string', required: true, description: 'The location longitude', default: '', }, ], }, ], }, { displayName: 'Service', name: 'service', type: 'string', default: '', description: 'Assigns the alert to the service/system category with the specified name', }, { displayName: 'Title', name: 'title', type: 'string', default: '', description: 'The title or subject of this alert', }, ], }, { displayName: 'External ID', name: 'externalId', type: 'string', default: '', displayOptions: { show: { operation: ['resolve'], resource: ['alert'], }, }, description: 'If the event originates from a record in a 3rd party system, use this parameter to pass the unique ID of that record. That ID will be communicated in outbound webhook notifications from SIGNL4, which is great for correlation/synchronization of that record with the alert. If you resolve / close an alert you must use the same External ID as in the original alert.', }, ], }; async execute(this: IExecuteFunctions): Promise { const items = this.getInputData(); const returnData: IDataObject[] = []; const length = items.length; let responseData; const resource = this.getNodeParameter('resource', 0); const operation = this.getNodeParameter('operation', 0); for (let i = 0; i < length; i++) { try { if (resource === 'alert') { //https://connect.signl4.com/webhook/docs/index.html // Send alert if (operation === 'send') { const message = this.getNodeParameter('message', i) as string; const additionalFields = this.getNodeParameter('additionalFields', i); const data: IDataObject = { message, }; if (additionalFields.title) { data.title = additionalFields.title as string; } if (additionalFields.service) { data.service = additionalFields.service as string; } if (additionalFields.locationFieldsUi) { const locationUi = (additionalFields.locationFieldsUi as IDataObject) .locationFieldsValues as IDataObject; if (locationUi) { data['X-S4-Location'] = `${locationUi.latitude},${locationUi.longitude}`; } } if (additionalFields.alertingScenario) { data['X-S4-AlertingScenario'] = additionalFields.alertingScenario as string; } if (additionalFields.filtering) { data['X-S4-Filtering'] = (additionalFields.filtering as boolean).toString(); } if (additionalFields.externalId) { data['X-S4-ExternalID'] = additionalFields.externalId as string; } data['X-S4-Status'] = 'new'; data['X-S4-SourceSystem'] = 'n8n'; // Attachments const attachments = additionalFields.attachmentsUi as IDataObject; if (attachments?.attachmentsBinary) { const propertyName = (attachments.attachmentsBinary as IDataObject) .property as string; const binaryData = this.helpers.assertBinaryData(i, propertyName); if (binaryData) { const supportedFileExtension = ['png', 'jpg', 'jpeg', 'bmp', 'gif', 'mp3', 'wav']; if (!supportedFileExtension.includes(binaryData.fileExtension as string)) { throw new NodeOperationError( this.getNode(), `Invalid extension, just ${supportedFileExtension.join(',')} are supported}`, { itemIndex: i }, ); } const binaryDataBuffer = await this.helpers.getBinaryDataBuffer(i, propertyName); data.attachment = { value: binaryDataBuffer, options: { filename: binaryData.fileName, contentType: binaryData.mimeType, }, }; } } responseData = await SIGNL4ApiRequest.call( this, 'POST', '', {}, { formData: data, }, ); } // Resolve alert if (operation === 'resolve') { const data: IDataObject = {}; data['X-S4-ExternalID'] = this.getNodeParameter('externalId', i) as string; data['X-S4-Status'] = 'resolved'; data['X-S4-SourceSystem'] = 'n8n'; responseData = await SIGNL4ApiRequest.call( this, 'POST', '', {}, { formData: data, }, ); } } if (Array.isArray(responseData)) { returnData.push.apply(returnData, responseData as IDataObject[]); } else if (responseData !== undefined) { returnData.push(responseData as IDataObject); } } catch (error) { if (this.continueOnFail(error)) { returnData.push({ error: error.message }); continue; } throw error; } } return [this.helpers.returnJsonArray(returnData)]; } }