Outdated information for ContentService Notifications

[MMasey]

What type of issue is it? (Choose one - delete the others)

Wrong documentation

What article/section is this about?

docs.umbraco.com/umbraco-cms/reference/notifications/contentservice-notifications

Describe the issue

The description documentation for some of the notification events refers to using the raiseEvents parameter if you need to suppress a specific notification. The Content Service not longer appears to have this parameter, for example doing something like _contentService.Save(contentNode), doesn't have a raiseEvents parameter.

I'm not actually sure how you are meant to do this any more so can't update this documentation myself.

[MMasey]

I've just found an old post on our that suggest something like the following which works.

... // Some prior code to update the current content;

using var scope = _scopeProvider.CreateScope(autoComplete: true);
using var _ = scope.Notifications.Suppress();
_contentService.Save(content);

[alina-tincas]

Hi @MMasey thank you for bringing this to our attention! We will look into this as soon as we can 🙏

Meanwhile, for reference, can you please share the link from OUR forum that you have found about this? 😊

[MMasey]

Hey @alina-tincas, this is the forum post. It's referring to the media service, but works the same when I tested it - https://our.umbraco.com/forum/using-umbraco-and-getting-started/110466-mediaservicesave-without-raising-events-umbraco-10#comment-342071

[alina-tincas]

Hi @MMasey I have looked further into this and it seems that the raiseEvents parameter method has been removed from v9 with this PR and reasons: umbraco/Umbraco-CMS#10655 with a "replacement" of scopes.

The content from the table is most likely outdated, where I have started a PR to restructure the notification article to remove the content from the tables and linked to the API docs instead as they are more accurate and are kept up-to-date afaik: #6003

The API docs for IContentService is: https://apidocs.umbraco.com/v13/csharp/api/Umbraco.Cms.Core.Services.IContentService.html

In this case, my suggestion would be to update the articles where raiseEvents are mentioned such as media service, member service and content service with a content similar to this: https://docs.umbraco.com/umbraco-cms/reference/notifications/mediaservice-notifications#what-happened-to-creating-and-created-events with title "What happened to raiseEvent method parameters events?" and add some content with what can be used instead etc. -> these changes need to be done for all versions: 10, 12, 13 and 14.

Would you be up for adding this content? 😊

[alina-tincas]

Hi @MMasey I have created a PR #6022 to add the information about raiseEvents to the 3 services articles as mentioned in my last comment. As the PR is merged, am closing this issue as well. Thank you again for bringing this to our attention 🙌