import { IExecuteFunctions } from 'n8n-core';
import {
deepCopy,
IDataObject,
INodeExecutionData,
INodeType,
INodeTypeDescription,
} from 'n8n-workflow';
import { get, set, unset } from 'lodash';
interface IRenameKey {
currentKey: string;
newKey: string;
}
export class RenameKeys implements INodeType {
description: INodeTypeDescription = {
displayName: 'Rename Keys',
name: 'renameKeys',
icon: 'fa:edit',
group: ['transform'],
version: 1,
description: 'Renames keys',
defaults: {
name: 'Rename Keys',
color: '#772244',
},
inputs: ['main'],
outputs: ['main'],
properties: [
{
displayName: 'Keys',
name: 'keys',
placeholder: 'Add new key',
description: 'Adds a key which should be renamed',
type: 'fixedCollection',
typeOptions: {
multipleValues: true,
sortable: true,
},
default: {},
options: [
{
displayName: 'Key',
name: 'key',
values: [
{
displayName: 'Current Key Name',
name: 'currentKey',
type: 'string',
default: '',
placeholder: 'currentKey',
description:
'The current name of the key. It is also possible to define deep keys by using dot-notation like for example: "level1.level2.currentKey".',
},
{
displayName: 'New Key Name',
name: 'newKey',
type: 'string',
default: '',
placeholder: 'newKey',
description:
'The name the key should be renamed to. It is also possible to define deep keys by using dot-notation like for example: "level1.level2.newKey".',
},
],
},
],
},
{
displayName: 'Additional Options',
name: 'additionalOptions',
type: 'collection',
default: {},
placeholder: 'Add Option',
options: [
{
displayName: 'Regex',
name: 'regexReplacement',
placeholder: 'Add new regular expression',
description: 'Adds a regular expressiond',
type: 'fixedCollection',
typeOptions: {
multipleValues: true,
sortable: true,
},
default: {},
options: [
{
displayName: 'Replacement',
name: 'replacements',
values: [
{
displayName:
'Be aware that by using regular expression previously renamed keys can be affected',
name: 'regExNotice',
type: 'notice',
default: '',
},
{
displayName: 'Regular Expression',
name: 'searchRegex',
type: 'string',
default: '',
placeholder: 'e.g. [N-n]ame',
description: 'Regex to match the key name',
hint: 'Learn more and test RegEx here',
},
{
displayName: 'Replace With',
name: 'replaceRegex',
type: 'string',
default: '',
placeholder: 'replacedName',
description:
"The name the key/s should be renamed to. It's possible to use regex captures e.g. $1, $2, ...",
},
{
displayName: 'Options',
name: 'options',
type: 'collection',
default: {},
placeholder: 'Add Regex Option',
options: [
{
displayName: 'Case Insensitive',
name: 'caseInsensitive',
type: 'boolean',
description: 'Whether to use case insensitive match',
default: false,
},
{
displayName: 'Max Depth',
name: 'depth',
type: 'number',
default: -1,
description: 'Maximum depth to replace keys',
hint: 'Specify number for depth level (-1 for unlimited, 0 for top level only)',
},
],
},
],
},
],
},
],
},
],
};
async execute(this: IExecuteFunctions): Promise {
const items = this.getInputData();
const returnData: INodeExecutionData[] = [];
let item: INodeExecutionData;
let newItem: INodeExecutionData;
let renameKeys: IRenameKey[];
let value: any;
const renameKey = (key: IRenameKey) => {
if (key.currentKey === '' || key.newKey === '' || key.currentKey === key.newKey) {
// Ignore all which do not have all the values set or if the new key is equal to the current key
return;
}
value = get(item.json, key.currentKey);
if (value === undefined) {
return;
}
set(newItem.json, key.newKey, value);
unset(newItem.json, key.currentKey);
};
const regexReplaceKey = (replacement: IDataObject) => {
const { searchRegex, replaceRegex, options } = replacement;
const { depth, caseInsensitive } = options as IDataObject;
const flags = (caseInsensitive as boolean) ? 'i' : undefined;
const regex = new RegExp(searchRegex as string, flags);
const renameObjectKeys = (obj: IDataObject, objDepth: number) => {
for (const key in obj) {
if (Array.isArray(obj)) {
// Don't rename array object references
if (objDepth !== 0) {
renameObjectKeys(obj[key] as IDataObject, objDepth - 1);
}
} else if (obj.hasOwnProperty(key)) {
if (typeof obj[key] === 'object' && objDepth !== 0) {
renameObjectKeys(obj[key] as IDataObject, objDepth - 1);
}
if (key.match(regex)) {
const newKey = key.replace(regex, replaceRegex as string);
if (newKey !== key) {
obj[newKey] = obj[key];
delete obj[key];
}
}
}
}
return obj;
};
newItem.json = renameObjectKeys(newItem.json, depth as number);
};
for (let itemIndex = 0; itemIndex < items.length; itemIndex++) {
renameKeys = this.getNodeParameter('keys.key', itemIndex, []) as IRenameKey[];
const regexReplacements = this.getNodeParameter(
'additionalOptions.regexReplacement.replacements',
itemIndex,
[],
) as IDataObject[];
item = items[itemIndex];
// Copy the whole JSON data as data on any level can be renamed
newItem = {
json: deepCopy(item.json),
pairedItem: {
item: itemIndex,
},
};
if (item.binary !== undefined) {
// Reference binary data if any exists. We can reference it
// as this nodes does not change it
newItem.binary = item.binary;
}
renameKeys.forEach(renameKey);
regexReplacements.forEach(regexReplaceKey);
returnData.push(newItem);
}
return [returnData];
}
}