mcdev 8.0.2 → 8.2.0

package/lib/metadataTypes/Folder.js

@@ -81,7 +81,7 @@ class Folder extends MetadataType {
         };
         for (const id of sortPairs) {
             if (!idMap[id]) {
-                Util.logger.debug(`Error: id ${id} not found in idMap-obj but in sortPairs-array.`);
+                Util.logger.debug(`id ${id} not found in idMap-obj but in sortPairs-array.`);
             } else if (
                 idMap[id].ParentFolder &&
                 Number.isSafeInteger(idMap[id].ParentFolder.ID) &&
@@ -714,7 +714,7 @@ class Folder extends MetadataType {
             ),
             options
         );
-        return response.Results;
+        return response.Results ?? [];
     }
 
     /**

package/lib/metadataTypes/Journey.js

@@ -2554,9 +2554,12 @@ class Journey extends MetadataType {
                     break;
                 }
                 default: {
-                    throw new Error(
-                        `${this.definition.type} type ${journey.definitionType} not supported yet by validate method`
+                    Util.logger.info(
+                        Util.getGrayMsg(
+                            ` ☇ skipping ${this.definition.type} ${key}: type ${journey.definitionType} not supported yet by validate method`
+                        )
                     );
+                    continue;
                 }
             }
         } // for loop

package/lib/metadataTypes/MetadataType.js

@@ -2080,6 +2080,12 @@ class MetadataType {
                     subtypeExtension,
                     templateVariables
                 );
+                if (!savedResults[originalKey]) {
+                    // happens in case like-filter struck
+                    delete savedResults[originalKey];
+                    filterCounter++;
+                    continue;
+                }
             } catch (ex) {
                 Util.logger.debug(JSON.stringify(savedResults[originalKey]));
                 Util.logger.errorStack(
@@ -2126,7 +2132,7 @@ class MetadataType {
             // normalize results[metadataEntry]
             results[originalKey] = postRetrieveData.json;
 
-            if (Util.OPTIONS.like && !Util.fieldsLike(results[originalKey])) {
+            if (Util.OPTIONS.like && !Util.fieldsLike(results[originalKey], this.definition)) {
                 Util.logger.debug(`Filtered ${originalKey} because of --like option`);
                 return;
             }
@@ -2161,7 +2167,7 @@ class MetadataType {
                     templateVariables
                 );
             }
-            if (Util.OPTIONS.like && !Util.fieldsLike(results[originalKey])) {
+            if (Util.OPTIONS.like && !Util.fieldsLike(results[originalKey], this.definition)) {
                 Util.logger.debug(`Filtered ${originalKey} because of --like option`);
                 return;
             }

package/lib/metadataTypes/TriggeredSendSummary.js

@@ -0,0 +1,102 @@
+'use strict';
+
+import MetadataType from './MetadataType.js';
+import cache from '../util/cache.js';
+import { Util } from '../util/util.js';
+
+/**
+ * @typedef {import('../../types/mcdev.d.js').BuObject} BuObject
+ * @typedef {import('../../types/mcdev.d.js').CodeExtract} CodeExtract
+ * @typedef {import('../../types/mcdev.d.js').CodeExtractItem} CodeExtractItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItem} MetadataTypeItem
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemDiff} MetadataTypeItemDiff
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeItemObj} MetadataTypeItemObj
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMap} MetadataTypeMap
+ * @typedef {import('../../types/mcdev.d.js').MetadataTypeMapObj} MetadataTypeMapObj
+ * @typedef {import('../../types/mcdev.d.js').SoapRequestParams} SoapRequestParams
+ * @typedef {import('../../types/mcdev.d.js').TemplateMap} TemplateMap
+ */
+
+/**
+ * TriggeredSendSummary MetadataType
+ *
+ * @augments MetadataType
+ */
+class TriggeredSendSummary extends MetadataType {
+    /**
+     * Retrieves SOAP based metadata of metadata type into local filesystem. executes callback with retrieved metadata
+     *
+     * @param {string} retrieveDir Directory where retrieved metadata directory will be saved
+     * @param {void | string[]} [_] unused parameter
+     * @param {void | string[]} [__] unused parameter
+     * @param {string} [key] customer key of single item to retrieve
+     * @returns {Promise.<MetadataTypeMapObj>} Promise of metadata
+     */
+    static retrieve(retrieveDir, _, __, key) {
+        /** @type {SoapRequestParams} */
+        let requestParams = {};
+        if (key) {
+            // filter by CustomerKey when a specific key is requested
+            requestParams = {
+                filter: {
+                    leftOperand: 'CustomerKey',
+                    operator: 'equals',
+                    rightOperand: key,
+                },
+            };
+        }
+
+        return super.retrieveSOAP(retrieveDir, requestParams, key);
+    }
+    /**
+     * parses retrieved Metadata before saving
+     *
+     * @param {MetadataTypeItem} metadata a single item
+     * @returns {MetadataTypeItem | void} Array with one metadata object and one sql string
+     */
+    static postRetrieveTasks(metadata) {
+        // CustomerKey for this type is the same as the CustomerKey of the TriggeredSend it relates to
+        const triggeredSend = cache.getByKey('triggeredSend', metadata.CustomerKey);
+        if (!triggeredSend) {
+            Util.logger.verbose(
+                `Could not find related TriggeredSend with CustomerKey '${metadata.CustomerKey}' for the TriggeredSendSummary.`
+            );
+            return null;
+        }
+        metadata['TriggeredSend.CategoryID'] = triggeredSend.CategoryID;
+        // folder path for a TriggeredSendSummary is the same as for the related TriggeredSend. CategoryID is not retrievable for this type, so use the TriggeredSend's field
+        this.setFolderPath(metadata);
+        delete metadata['TriggeredSend.CategoryID'];
+        metadata.r__triggeredSend_name = triggeredSend.Name;
+        metadata.r__triggeredSend_key = triggeredSend.CustomerKey;
+        return metadata;
+    }
+    /**
+     * retrieves the folder path from cache and updates the TriggeredSendSummary metadata with it after retrieve
+     *
+     * @param {MetadataTypeItem} metadata a single item
+     */
+    static setFolderPath(metadata) {
+        try {
+            metadata.r__folder_Path = cache.searchForField(
+                'folder',
+                metadata[this.definition.folderIdField],
+                'ID',
+                'Path'
+            );
+            delete metadata[this.definition.folderIdField];
+        } catch {
+            Util.logger.verbose(
+                ` ☇ skipping ${this.definition.typeName} '${metadata.Name}'/'${metadata.CustomerKey}': Could not find folder.`
+            );
+            // do not save this Triggered Send Summary because it would not be visible in the user interface
+            return;
+        }
+    }
+}
+
+// Assign definition to static attributes
+import MetadataTypeDefinitions from '../MetadataTypeDefinitions.js';
+TriggeredSendSummary.definition = MetadataTypeDefinitions.triggeredSendSummary;
+
+export default TriggeredSendSummary;

package/lib/metadataTypes/definitions/DataExtensionField.definition.js

@@ -14,6 +14,7 @@ export default {
     typeRetrieveByDefault: false,
     typeCdpByDefault: false,
     typeName: 'Data Extension Field',
+    deleteSynchronously: true, // should be run one at a time to allow asking for permission to mass-delete if *.fieldname is used
     fields: {
         'Client.ID': {
             isCreateable: false,

package/lib/metadataTypes/definitions/Journey.definition.js

@@ -261,6 +261,12 @@ export default {
             retrieving: true,
             template: true,
         },
+        'activities[].configurationArguments.isReconcilable': {
+            isCreateable: true,
+            isUpdateable: true,
+            retrieving: true,
+            template: true,
+        },
         'activities[].configurationArguments.isActivityBatchValidated': {
             isCreateable: true,
             isUpdateable: true,

package/lib/metadataTypes/definitions/TriggeredSendSummary.definition.js

@@ -0,0 +1,211 @@
+export default {
+    bodyIteratorField: 'Results',
+    dependencies: [
+        'triggeredSend',
+        'folder-hidden',
+        'folder-triggered_send',
+        'folder-triggered_send_journeybuilder',
+    ],
+    dependencyGraph: {
+        triggeredSend: ['r__triggeredSend_key'],
+    },
+    filter: {},
+    hasExtended: false,
+    idField: 'ObjectID',
+    keepId: false,
+    keyIsFixed: true,
+    keyField: 'CustomerKey',
+    nameField: 'r__triggeredSend_name',
+    folderIdField: 'TriggeredSend.CategoryID',
+    createdDateField: null,
+    createdNameField: null,
+    lastmodDateField: null,
+    lastmodNameField: null,
+    restPagination: null,
+    maxKeyLength: 36,
+    type: 'triggeredSendSummary',
+    soapType: 'triggeredSendSummary',
+    typeDescription: 'Summary data for a Triggered Send',
+    typeRetrieveByDefault: false,
+    typeCdpByDefault: false,
+    typeName: 'Triggered Send Summary',
+    fields: {
+        Bounces: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        Clicks: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        'Client.ID': {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        Conversions: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        CustomerKey: {
+            isCreateable: true,
+            isUpdateable: true,
+            retrieving: true,
+            templating: true,
+        },
+        FTAFEmailsSent: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        FTAFOptIns: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        FTAFRequests: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        ID: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        InProcess: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        NotSentDueToError: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        NotSentDueToOptOut: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        NotSentDueToUndeliverable: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        ObjectID: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        /* ObjectState: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        }, */ // according to the documentation"Reserved for future use"
+        Opens: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        OptOuts: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        Owner: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        PartnerKey: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        PartnerProperties: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        Queued: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        Sent: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        SurveyResponses: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        UniqueClicks: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        UniqueConversions: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        UniqueOpens: {
+            isCreateable: true,
+            isUpdateable: false,
+            retrieving: true,
+            templating: true,
+        },
+        CorrelationID: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false,
+            templating: false,
+        },
+        CreatedDate: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false /** Listed in the type documentation but not retrievable */,
+            templating: false,
+        },
+        ModifiedDate: {
+            isCreateable: false,
+            isUpdateable: false,
+            retrieving: false /** Listed in the type documentation but not retrievable */,
+            templating: false,
+        },
+        r__triggeredSend_name: { skipValidation: true },
+        r__triggeredSend_key: { skipValidation: true },
+        r__folder_Path: { skipValidation: true },
+    },
+};

package/lib/util/devops.js

@@ -50,11 +50,12 @@ const DevOps = {
     async getDeltaList(properties, range, saveToDeployDir, filterPathsCSV, commitHistory) {
         const rangeUserInput = range;
         const filterPaths = filterPathsCSV
-            ? filterPathsCSV.split(',').map((filePath) =>
-                  path
-                      .normalize(properties.directories.retrieve + filePath)
-                      .split('\\')
-                      .join('/')
+            ? filterPathsCSV.split(',').map(
+                  (filePath) =>
+                      path
+                          .normalize(properties.directories.retrieve + filePath)
+                          .split('\\')
+                          .join('/') + '/'
               )
             : [properties.directories.retrieve];
         if (range) {
@@ -194,10 +195,13 @@ const DevOps = {
                         // - retrieve/cred/bu/asset/block/016aecc7-7063-4b78-93f4-aa119ea933c7.asset-block-meta.html
                         // - retrieve/cred/bu/asset/message/003c1ef5-f538-473a-91da-26942024a64a/blocks/views.html.slots.[bottom-8frq7iw2k99].asset-message-meta.html
                         // - retrieve/cred/bu/query/03efd5f1-ba1f-487a-9c9a-36aeb2ae5192.query-meta.sql
-                        file.externalKey =
-                            file.type === 'asset'
-                                ? file.file.split('/')[5].split('.')[0] // assets have an additional folder level for their subtype
-                                : file.file.split('/')[4].split('.')[0];
+                        // assets have an additional folder level for their subtype
+                        // keys could contain dots themselves
+                        file.externalKey = file.file
+                            .split('/')
+                            [file.type === 'asset' ? 5 : 4].split('.')
+                            .slice(0, -2)
+                            .join('.');
                         file.name = null;
                     }
 
@@ -266,14 +270,20 @@ const DevOps = {
         }
         // Write into delta.json to serve as documentation
         const directoryDeltaPkg = 'logs/';
-        await File.writeJSONToFile(directoryDeltaPkg, Util.logFileName + '-delta_package', delta);
-        this.document(directoryDeltaPkg, delta);
+        await File.writeJSONToFile(
+            directoryDeltaPkg,
+            Util.logFileName +
+                '-delta_package-' +
+                filterPathsCSV.replaceAll(',', '-').replaceAll('/', '-'),
+            delta
+        );
+        this.document(directoryDeltaPkg, filterPathsCSV, delta);
         Util.logger.info(
             `- ✔️  Identified changes: Add/Update=${gitActionsCounter['add/update']}, Move=${gitActionsCounter['move']}, Delete=${gitActionsCounter['delete']}`
         );
-        if (gitActionsCounter.delete > 0) {
+        if (gitActionsCounter.move > 0 || gitActionsCounter.delete > 0) {
             Util.logger.warn(
-                'Please note that deletions have to be done manually on the SFMC website.'
+                'Deleted/Changed keys detected! Please note that re-keyed components should have their key changed as a pre-deployment step.'
             );
         }
         Util.logger.info(
@@ -571,10 +581,11 @@ const DevOps = {
      * create markdown file for deployment listing
      *
      * @param {string} directory -
+     * @param {string} filterPathsCSV -
      * @param {object} jsonReport -
      * @returns {void}
      */
-    document(directory, jsonReport) {
+    document(directory, filterPathsCSV, jsonReport) {
         const tabled = jsonToTable(jsonReport);
         let output = `# Deployment Report\n\n`;
         let tableSeparator = '';
@@ -596,7 +607,14 @@ const DevOps = {
         }
         try {
             // write to disk (asynchronously)
-            File.writeToFile(directory, Util.logFileName + '-delta_package', 'md', output);
+            File.writeToFile(
+                directory,
+                Util.logFileName +
+                    '-delta_package-' +
+                    filterPathsCSV.replaceAll(',', '-').replaceAll('/', '-'),
+                'md',
+                output
+            );
         } catch (ex) {
             Util.logger.error(`DevOps.document():: error | ` + ex.message);
         }

package/lib/util/util.js

@@ -1143,14 +1143,17 @@ export const Util = {
      * returns true if no LIKE filter is defined or if all filters match
      *
      * @param {MetadataTypeItem} metadata a single metadata item
+     * @param {object} definition type definition
      * @param {object} [filters] only used in recursive calls
      * @returns {boolean} true if no LIKE filter is defined or if all filters match
      */
-    fieldsLike(metadata, filters) {
+    fieldsLike(metadata, definition, filters) {
         if (metadata.json && metadata.codeArr) {
             // Compensate for CodeExtractItem format
             metadata = metadata.json;
         }
+        // ensure we only convert "key" and "name" fields on the first call to this method
+        const checkDefaultKeyAndName = filters ? false : true;
         filters ||= Util.OPTIONS.like;
         if (!filters) {
             return true;
@@ -1163,14 +1166,20 @@ export const Util = {
                     ? filters[field].split(',')
                     : filters[field];
             if (Array.isArray(metadata[field])) {
-                return metadata[field].some((f) => Util.fieldsLike(f, filter));
+                return metadata[field].some((f) => Util.fieldsLike(f, definition, filter));
             } else {
+                let fieldName;
+                if (field === 'key' && checkDefaultKeyAndName) {
+                    fieldName = definition.keyField;
+                } else if (field === 'name' && checkDefaultKeyAndName) {
+                    fieldName = definition.nameField;
+                }
                 if (typeof filter === 'string') {
-                    return Util.stringLike(metadata[field], filter);
+                    return Util.stringLike(metadata[fieldName || field], filter);
                 } else if (Array.isArray(filter)) {
                     return filter.some((f) => Util.stringLike(metadata[field], f));
                 } else if (typeof filter === 'object') {
-                    return Util.fieldsLike(metadata[field], filter);
+                    return Util.fieldsLike(metadata[field], definition, filter);
                 }
             }
             return false;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mcdev",
-    "version": "8.0.2",
+    "version": "8.2.0",
     "description": "Accenture Salesforce Marketing Cloud DevTools",
     "author": "Accenture: joern.berkefeld, douglas.midgley, robert.zimmermann, maciej.barnas",
     "license": "MIT",
@@ -80,21 +80,21 @@
         "p-limit": "6.2.0",
         "prettier": "3.5.3",
         "prettier-plugin-sql": "0.19.0",
-        "semver": "7.7.1",
+        "semver": "7.7.3",
         "sfmc-sdk": "2.1.2",
-        "simple-git": "3.27.0",
+        "simple-git": "3.29.0",
         "toposort": "2.0.2",
         "update-notifier": "7.3.1",
         "winston": "3.17.0",
         "yargs": "17.7.2",
-        "yocto-spinner": "0.2.2"
+        "yocto-spinner": "1.0.0"
     },
     "devDependencies": {
         "@eslint/js": "9.28.0",
         "@types/fs-extra": "11.0.4",
         "@types/inquirer": "9.0.7",
         "@types/mocha": "10.0.8",
-        "@types/node": "22.15.29",
+        "@types/node": "24.9.1",
         "@types/yargs": "17.0.33",
         "assert": "2.1.0",
         "axios-mock-adapter": "2.0.0",
@@ -104,17 +104,17 @@
         "eslint": "9.28.0",
         "eslint-config-ssjs": "2.0.0",
         "eslint-plugin-jsdoc": "50.7.1",
-        "eslint-plugin-mocha": "11.0.0",
+        "eslint-plugin-mocha": "11.2.0",
         "eslint-plugin-prettier": "5.4.1",
         "eslint-plugin-unicorn": "59.0.1",
-        "fast-xml-parser": "5.2.3",
+        "fast-xml-parser": "5.3.0",
         "globals": "16.2.0",
         "husky": "9.1.7",
-        "lint-staged": "15.5.1",
-        "mocha": "11.5.0",
+        "lint-staged": "16.2.6",
+        "mocha": "11.7.4",
         "mock-fs": "5.3.0",
         "npm-run-all": "4.1.5",
-        "prettier-eslint": "16.4.1",
+        "prettier-eslint": "16.4.2",
         "typescript": "5.8.3"
     },
     "optionalDependencies": {

package/test/mockRoot/.mcdevrc.json

@@ -175,5 +175,5 @@
             "verification"
         ]
     },
-    "version": "8.0.2"
+    "version": "8.2.0"
 }

package/test/resources/1111111/dataFolder/retrieve-ContentTypeINdataextension,hidden,queryactivity,salesforcedataextension,shared_data,shared_dataextension,shared_salesforcedataextension,synchronizeddataextension-response.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="utf-8"?>
+<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+    xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing"
+    xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
+    xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
+    <soap:Header>
+        <wsa:Action>RetrieveResponse</wsa:Action>
+        <wsa:MessageID>urn:uuid:998a6923-b781-40be-abad-0506f0f97477</wsa:MessageID>
+        <wsa:RelatesTo>urn:uuid:a5d518cc-9bfb-45f1-a4a7-5d11cc1a8d44</wsa:RelatesTo>
+        <wsa:To>http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
+        <wsse:Security>
+            <wsu:Timestamp wsu:Id="Timestamp-a6c00a2f-fcfa-4882-a72d-8b8983a8cc7e">
+                <wsu:Created>2025-09-05T16:29:03Z</wsu:Created>
+                <wsu:Expires>2025-09-05T16:34:03Z</wsu:Expires>
+            </wsu:Timestamp>
+        </wsse:Security>
+    </soap:Header>
+    <soap:Body>
+        <RetrieveResponseMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
+            <OverallStatus>OK</OverallStatus>
+            <RequestID>ac40bccd-e8cd-4232-b1ee-e3cfbbfd0b89</RequestID>
+        </RetrieveResponseMsg>
+    </soap:Body>
+</soap:Envelope>

package/test/resources/9999999/automation/create-testNew_automation-expected.md

@@ -13,7 +13,7 @@
 * Start: 2020-05-13 18:30:32.11-06:00 +01:00
 * End: 2079-06-06 21:00:00-06:00 +01:00
 * Timezone: W. Europe Standard Time
-* Recurrance: every 5 minutes until end date
+* Recurrence: every 5 minutes until end date
 
 **Notifications:** _none_
 

package/test/resources/9999999/automation/retrieve-testExisting_automation-expected.md

@@ -13,7 +13,7 @@
 * Start: 2022-07-30 00:00:00 +01:00
 * End: 2022-07-30 00:00:00 +01:00
 * Timezone: W. Europe Standard Time
-* Recurrance: run only once
+* Recurrence: run only once
 
 **Notifications:**
 

package/test/resources/9999999/automation/update-testExisting_automation-expected.md

@@ -13,7 +13,7 @@
 * Start: 2022-07-30 00:00:00 +01:00
 * End: 2022-07-30 00:00:00 +01:00
 * Timezone: W. Europe Standard Time
-* Recurrance: run only once
+* Recurrence: run only once
 
 **Notifications:**