release v7.0.0

[JoernBerkefeld]

Release details

Checklist

Before merge

• Wiki updated with info in ticket listed under Documentation
• ran npm audit fix
• ran npm run lint:fix
• ran npm run version:major/minor/patch
• updated bug template to include the new version
• updated .mcdevrc for tests to the new version

After merge

• merged all dependabot PRs to main branch
• moved version tag to merge commit & pushed to remote
• closed GitHub milestone
• created new GitHub Release

Documentation

• [FEATURE] add method replaceReference to find&replace ampscript contentBlockByX with one of the other options #1270 / Feature/1270 add method replaceReference to find & replace contentBlockByX with one of the other options #1353

see #1353 (comment)

• [FEATURE] add new method that chains buildTemplate and buildDefinition #1329 / Feature/1329 add new method that chains buildtemplate and builddefinition + add --metadata to buildDefinitionBulk #1330

see #1330 (comment) and #1330 (comment)

• [FEATURE] add --metadata option to buildTemplate and buildDefinition #1325 / Feature/1325 add multi type support and metadata option to buildtemplate and builddefinition #1327

see #1327 (comment)

• [FEATURE] add multi-type support and --metadata option to fixKeys #1316 / Feature/1316 add multi type support and metadata option to fixkeys #1317

see #1317 (comment)

• [FEATURE] automatically add suffix to key #1302 / Feature/1302 + Bugfix/1298 automatically add suffix to key #1303
• [FEATURE] no owner check for assets #1301 / Feature/1301 no owner check for assets + Task/905 test callout payloads #1308

see #1308 (comment)

• [TASK] Explain when MID is appended to CustomerKey during assets deployment #1233

see #1233 (comment)

• [TASK] auto-filter dataExtension _MobileAddressApplication  #1289 / TASK/1289: auto-exclude dataExtension _MobileAddressApplication during retrieve #1290

see #1290 (comment)

• [FEATURE] hide -error.log file behind new option #1281 / Feature/1281: add new global option --errorLog #1282

see #1282 (comment)

• [FEATURE] harmonize how type/key combos are passed in with sf-cli #1272 / Feature/1272 add --metadata option to delete&retrieve #1274

see #1272 (comment)

• [FEATURE] add --metadata option to deploy #1275 / Feature/1275 add metadata option to deploy #1283

see #1283 (comment)

• [FEATURE] get name and key for content block id #1238 / Feature/1238: find contentblock by id #1239

see #1239 (comment)

• [FEATURE] enhance delete to support all metadata types (REST) #164 / Feature/164 enhance delete to support all metadata types (REST) #1192
• [FEATURE] Support Sender Profile / CSCLSROZ-173 #54 / Feature/54 support sender profile csclsroz 173 #1258
• [FEATURE] Support Delivery Profile / CSCLSROZ-317 #60 / Feature/60: basic retrieve-support for deliveryProfile #1264
• [FEATURE] add support for sendClassification create/update/delete and resolve DeliveryProfile and SenderProfile #1266 / Feature/1266 add support for sendClassification create/update/delete and resolve deliveryProfile and senderProfile #1267

https://github.com/Accenture/sfmc-devtools/wiki/05.-Metadata-Type-Support/_edit

The following metadata types are currently supported:

| MetadataType | CLI argument | Retrieved by Default | `retrieve` | `deploy` (create) | `deploy` (update) | `delete` | `changeKey` | `buildTemplate` | `retrieveAsTemplate` | Description |
|:---|:---|---|---|---|---|---|---|---|---|:---|
| Asset | `asset` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Assets from Content Builder grouped into subtypes. |
| Data Designer Attribute Groups | `attributeGroup` | Yes | Yes | - | - | - | - | - | - | Groupings of Attribute Sets (Data Extensions) in Data Designer. |
| Data Designer Attribute Sets | `attributeSet` | Yes | Yes | - | - | - | - | - | - | Data Extensions linked together in Attribute Groups in Data Designer. |
| Automation | `automation` | Yes | Yes | Yes | Yes | Yes | Yes f| Yes | Yes | Used via Automation Studio directly - or indirectly via Journey Builder & MC Connect. |
| Campaign Tag | `campaign` | - | Yes | - | - | - | - | - | - | Way of tagging/categorizing emails, journeys and alike. |
| Content Area (Classic) | `contentArea` | - | Yes | - | - | - | - | - | - | DEPRECATED: Old way of saving Content Blocks; please migrate these to new Content Blocks (`Asset: ...`). |
| Data Extension | `dataExtension` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Database table schemas. |
| Data Extension Template | `dataExtensionTemplate` | - | Yes | - | - | - | - | - | - | Templates used for special DE use cases like Triggered Send. |
| Delivery Profile | `deliveryProfile` | - | Yes | - | - | - | - | - | - | Delivery profiles specify details such as IP address, domain, header inclusion, and footer; Via API we can only check for their existence but not see any details. |
| Automation: Data Extract Activity | `dataExtract` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Creates zipped files in your FTP directory or convert XML into CSV. |
| Data Extract Type | `dataExtractType` | - | Yes | - | - | - | - | - | - | Types of Data Extracts enabled for a specific business unit. This normally should not be stored. |
| API Discovery | `discovery` | - | Yes | - | - | - | - | - | - | Description of all API endpoints accessible via REST API; only relevant for developers of Accenture SFMC DevTools. |
| E-Mail (Classic) | `email` | - | Yes | - | - | - | - | - | - | DEPRECATED: Old way of saving E-Mails; please migrate these to new E-Mail (`Asset: message`). |
| E-Mail Send Definition | `emailSend` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | - | Mainly used in Automations as "Send Email Activity". |
| Journey: Entry Event Definition | `event` | Yes | Yes (beta) | Yes (beta) | Yes (beta) | Yes | Yes | Yes | Yes | Used in Journeys (Interactions) to define Entry Events. |
| File Location | `fileLocation` | Yes | Yes | - | - | - | - | - | - | Used for export or import of files to/from Marketing Cloud. Previously this was labeled ftpLocation. |
| Automation: File Transfer Activity | `fileTransfer` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Unzip, decrypt a file or move a file from secure location into FTP directory. |
| Automation: Filter Activity | `filter` | - | Yes (beta) | - | - | - | - | - | - | BETA: Part of how filtered Data Extensions are created. Depends on type "FilterDefinitions". |
| Folder | `folder` | - | Yes | Yes | Yes | - | - | Yes | - | Used to structure all kinds of other metadata. |
| Automation: Import File Activity | `importFile` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Reads files in FTP directory for further processing. |
| Journey | `journey` | Yes | Yes (beta) | Yes (beta) | Yes (beta) | Yes | - | Yes | - | Journey (internally called "Interaction"). |
| List | `list` | Yes | Yes | - | - | Yes | - | - | - | Old way of storing data. Still used for central Email Subscriber DB. |
| Mobile Code | `mobileCode` | Yes | Yes | - | - | - | - | - | - | Used to send SMS Messages |
| Mobile Keyword | `mobileKeyword` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Used for managing subscriptions for Mobile numbers in Mobile Connect |
| MobileConnect SMS | `mobileMessage` | Yes | Yes | Yes | Yes | Yes | - | Yes | - | Used by Journey Builder and to send SMS from MobileConnect triggered by API or manually on-the-fly |
| Automation: SQL Query Activity | `query` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Select & transform data using SQL. |
| Role | `role` | Yes | Yes | Yes | Yes | - | Yes | Yes | - | User Roles define groups that are used to grant users access to SFMC systems. |
| Automation: Script Activity | `script` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Execute more complex tasks via SSJS or AMPScript. |
| Send Classification | `sendClassification` | - | Yes | Yes | Yes | Yes | Yes | Yes | - | Lets admins define Delivery Profile, Sender Profile and CAN-SPAM for an email job in a central location. |
| Sender Profile | `senderProfile` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | - | Specifies the From information for a send in a central location. |
| Transactional Email | `transactionalEmail` | Yes | Yes | Yes | Yes | Yes | - | Yes | - | Lets you send immediate Email messages via API events |
| Transactional Push | `transactionalPush` | Yes | Yes | Yes | Yes | Yes | - | Yes | - | Lets you send immediate Push messages via API events |
| Transactional SMS | `transactionalSMS` | Yes | Yes | Yes | Yes | Yes | - | Yes | - | Lets you send immediate SMS messages via API events |
| Triggered Send | `triggeredSend` | Yes | Yes | Yes | Yes | Yes | Yes | Yes | - | DEPRECATED: Sends emails via API or DataExtension Event. |
| User | `user` | - | Yes | Yes | Yes | - | Yes | Yes | - | Users and Installed Packages including their assigned Roles, BUs and personal permissions |
| Automation: Verification Activity| `verification` | Yes | Yes | Yes | Yes | Yes | - | Yes | - | Check DataExtension for a row count |

Issues

• closes [FEATURE] Support Sender Profile / CSCLSROZ-173 #54

• closes [FEATURE] Support Delivery Profile / CSCLSROZ-317 #60

• closes [FEATURE] enhance delete to support all metadata types (REST) #164

• closes [BUG] "Blank File Behavior" not retrieved for importFile activity #1189

• closes [TASK] dont show color codes when gitfork & sourcetree run tests as part of a commit hook #1201

• closes [TASK] contributor: only run jsdoc2md if js files were committed #1217

• closes [FEATURE] get name and key for content block id #1238

• closes [FEATURE] add support for .beautyamp.json in mcdev projects #1167

• closes [TASK] vscode setting source.fixAll.eslint needs to default to "explicit" #1247

• closes [TASK] add file icon to ampscript files in vscode #1253

• closes [TASK] add ampscript snippets to make coding easier #1254

• closes [TASK] remove vscode extension recommendation for gruntfuggly.todo-tree #1255

• closes [FEATURE] add support for sendClassification create/update/delete and resolve DeliveryProfile and SenderProfile #1266

• closes [TASK] show dedicated messages to Accenture / non-Accenture? #1200

• closes [FEATURE] harmonize how type/key combos are passed in with sf-cli #1272

• closes [TASK] mention vsce in Readme and Wiki #1269

• closes [BUG] bu selection wizard should be disabled if skipInteraction is active  #1273

• closes [FEATURE] hide -error.log file behind new option #1281

• closes [FEATURE] add --metadata option to deploy #1275

• closes [BUG] explainTypes --json returns incorrect value for script.supports.changeKey #1284

• closes [TASK] auto-filter dataExtension _MobileAddressApplication  #1289

• closes [TASK] Explain when MID is appended to CustomerKey during assets deployment #1233

• closes [FEATURE] automatically add suffix to key #1302

• closes [BUG] fixKeys fails for emailSend and senderProfile #1298

• closes [FEATURE] no owner check for assets #1301

• closes [TASK] allow testing for what we send to axios #905

• closes [BUG] filter empty shell in explainTypes #1306

• closes [FEATURE] resolve email templates #1314

• closes [FEATURE] add multi-type support and --metadata option to fixKeys #1316

• closes [FEATURE] auto-enable AllowChildren on folders during deployment of subfolders #1318

• closes Feature/1320 support creating journey & automation & triggeredSend-journey folders #1321

• closes [FEATURE] resolve sendClassification & senderProfile in triggeredSend, emailSend and journey #62

• closes [BUG] buildTemplate and buildDefinition do not handle unknown keys gracefully #1296

• closes [FEATURE] add --metadata option to buildTemplate and buildDefinition #1325

• closes [FEATURE] add new method that chains buildTemplate and buildDefinition #1329

• closes [BUG] max line width breaks ampscript code in assets #1248

• closes [BUG] mcdev join should not refreshBUs to ensure project setup is not changed accidentally #1332

• closes [TASK] exclude event from fixKeys* #1334

• closes [FEATURE] add method replaceReference to find&replace ampscript contentBlockByX with one of the other options #1270

[github-actions]

Coverage Report

Commit:5733acc
Base: main@50be615

Type	This PR
Total Statements Coverage	68.64%
Total Branches Coverage	67.78%
Total Functions Coverage	79.65%
Total Lines Coverage	68.64%

Details (changed files):

File	Statements	Branches	Functions	Lines
lib/Builder.js	87.1%	54.83%	100%	87.1%
lib/Deployer.js	79.72%	70.27%	100%	79.72%
lib/MetadataTypeDefinitions.js	100%	100%	100%	100%
lib/MetadataTypeInfo.js	100%	100%	100%	100%
lib/Retriever.js	82.72%	75%	100%	82.72%
lib/cli.js	0%	0%	0%	0%
lib/index.js	70.08%	58.6%	72.97%	70.08%
lib/retrieveChangelog.js	0%	0%	0%	0%
lib/metadataTypes/Asset.js	69.66%	62.5%	83.33%	69.66%
lib/metadataTypes/AttributeGroup.js	88.52%	70%	100%	88.52%
lib/metadataTypes/AttributeSet.js	83.91%	73.07%	100%	83.91%
lib/metadataTypes/Automation.js	78.68%	62.14%	94.44%	78.68%
lib/metadataTypes/Campaign.js	66.29%	100%	33.33%	66.29%
lib/metadataTypes/ContentArea.js	50.92%	100%	0%	50.92%
lib/metadataTypes/DataExtension.js	80.2%	69.1%	94.28%	80.2%
lib/metadataTypes/DataExtensionField.js	80.84%	66.66%	90%	80.84%
lib/metadataTypes/DataExtensionTemplate.js	84.9%	66.66%	100%	84.9%
lib/metadataTypes/DataExtract.js	91.04%	54.54%	100%	91.04%
lib/metadataTypes/DataExtractType.js	96.15%	100%	50%	96.15%
lib/metadataTypes/DeliveryProfile.js	100%	100%	100%	100%
lib/metadataTypes/Discovery.js	63.07%	100%	0%	63.07%
lib/metadataTypes/Email.js	66.66%	66.66%	33.33%	66.66%
lib/metadataTypes/EmailSend.js	71.53%	35.71%	100%	71.53%
lib/metadataTypes/Event.js	49.21%	60%	22.22%	49.21%
lib/metadataTypes/FileLocation.js	96.15%	100%	50%	96.15%
lib/metadataTypes/FileTransfer.js	89.37%	52.17%	100%	89.37%
lib/metadataTypes/Filter.js	95.55%	100%	0%	95.55%
lib/metadataTypes/Folder.js	56.71%	64.61%	80%	56.71%
lib/metadataTypes/ImportFile.js	72.13%	57.5%	100%	72.13%
lib/metadataTypes/Journey.js	59.81%	54.9%	84.61%	59.81%
lib/metadataTypes/List.js	91.03%	64.28%	66.66%	91.03%
lib/metadataTypes/MetadataType.js	80.66%	77.46%	73.97%	80.66%
lib/metadataTypes/MobileCode.js	87.71%	100%	50%	87.71%
lib/metadataTypes/MobileKeyword.js	89.31%	78.57%	90.9%	89.31%
lib/metadataTypes/MobileMessage.js	88.03%	72.09%	100%	88.03%
lib/metadataTypes/Query.js	94.22%	82.22%	100%	94.22%
lib/metadataTypes/Role.js	42.1%	55.55%	16.66%	42.1%
lib/metadataTypes/Script.js	97.38%	76.19%	100%	97.38%
lib/metadataTypes/SendClassification.js	92.3%	70%	100%	92.3%
lib/metadataTypes/SenderProfile.js	86.59%	63.63%	100%	86.59%
lib/metadataTypes/TransactionalEmail.js	87.35%	70.58%	100%	87.35%
lib/metadataTypes/TransactionalMessage.js	94.07%	86.66%	83.33%	94.07%
lib/metadataTypes/TransactionalPush.js	87.09%	57.14%	100%	87.09%
lib/metadataTypes/TransactionalSMS.js	83.56%	69.56%	81.81%	83.56%
lib/metadataTypes/TriggeredSend.js	55.33%	45.45%	63.63%	55.33%
lib/metadataTypes/User.js	86.2%	71.11%	95.83%	86.2%
lib/metadataTypes/Verification.js	91.12%	76.19%	88.88%	91.12%
lib/util/auth.js	62%	76.47%	66.66%	62%
lib/util/businessUnit.js	32.8%	100%	0%	32.8%
lib/util/cache.js	87.15%	70.58%	88.88%	87.15%
lib/util/cli.js	38.77%	78.04%	25%	38.77%
lib/util/config.js	54.01%	36.84%	100%	54.01%
lib/util/devops.js	14.62%	100%	25%	14.62%
lib/util/file.js	76.33%	62.68%	82.35%	76.33%
lib/util/init.config.js	19.95%	100%	0%	19.95%
lib/util/init.git.js	19.77%	100%	0%	19.77%
lib/util/init.js	18.83%	100%	0%	18.83%
lib/util/init.npm.js	22.01%	100%	0%	22.01%
lib/util/replaceContentBlockReference.js	95.68%	86.48%	100%	95.68%
lib/util/util.js	83.41%	77.84%	88.88%	83.41%