topic Re: How to create a Warning in Revit API Forum

How to create a Warning

Kevin.Bell — Thu, 07 Jun 2018 20:08:33 GMT

Hi,

I've a routine which moves elements around, but in some occasions it comes across a an element that can't be moved.

I can get the routine to filter them out so its not an issue, but I'd like to create a Warning message for the user.

I can do this with the TaskDialog class, but really I'd like to create a non critical Warning message, which warns the user, but does not stop them working - the same sort of warning you get if you delete a room from the model:

I can't see a way of creating this in the API - can it be done?

Thanks.

Re: How to create a Warning

jeremytammik — Fri, 08 Jun 2018 06:18:28 GMT

The Revit API provides the TaskDialog class for this and nothing else.

It has rather a large number of options.

Maybe some of them satisfy your need.

Check out the Revit UI API labs in 2_Revit_UI_API:

https://github.com/jeremytammik/AdnRevitApiLabsXtra

Cheers,

Jeremy

Re: How to create a Warning

Kevin.Bell — Fri, 08 Jun 2018 14:16:28 GMT

Ok, thanks - I use task dialog, but I was hoping for something that didn't stop the user and force them to hit OK.

Cheers.

Re: How to create a Warning

jeremytammik — Fri, 08 Jun 2018 16:34:44 GMT

Oh, I see.

Yes, for that you can use a modeless Windows form and close it automatically after a specified time period.

No problem; here is a description for AutoCAD that (exdeptionally) applies to Revit as well (since it has nothing to do with either of them, really):

https://drive-cad-with-code.blogspot.com/2014/02/showing-and-closing-modeless-formdialog.html

Please let us know how you end up using this.

Maybe it will be useful for others as well.

Thank you!

Cheers,

Jeremy

Re: How to create a Warning

FAIR59 — Fri, 08 Jun 2018 23:30:16 GMT

you can define your own failure, and let Revit display it.

first you create a FailureDefinitionId and FailureDefinition,

// Create failure definition Ids
Guid guid1 = new Guid("d0cf2412-08fe-476b-a6e6-e9a98583c52c");
FailureDefinitionId  m_idWarning = new FailureDefinitionId(guid1);

// Create failure definitions and add resolutions
FailureDefinition m_fdWarning = FailureDefinition.CreateFailureDefinition(m_idWarning, FailureSeverity.Warning, "Textvalue is changed for all instances in textchain");

m_fdWarning.SetDefaultResolutionType(FailureResolutionType.SetValue);

then you can display the warning,

 FailureMessage fm = new FailureMessage(ExternalApplication.m_idWarning);
 doc.PostFailure(fm);

Re: How to create a Warning

jeremytammik — Sat, 09 Jun 2018 06:54:24 GMT

Cool. Thank you! Is that modeless?

These steps are also demonstrated in the Revit SDK sample files SDK/Samples/ErrorHandling/CS/Command.cs and

SDK/Samples/PerformanceAdviserControl/CS/FlippedDoorCheck.cs.

Cheers,

Jeremy

Re: How to create a Warning

FAIR59 — Sun, 10 Jun 2018 22:02:21 GMT

@jeremytammik wrote:
Cool. Thank you! Is that modeless?

Yes, this is a Revit warning as depicted in the Original question. You can totally ignore it, and keep working.
The one caveat I can think of: it will probably be displayed when the control reverts back to Revit. (not sure)

Frank

Re: How to create a Warning

jeremytammik — Mon, 11 Jun 2018 09:45:24 GMT

Thank you very much for the invaluable help, Frank!

Published here for posterity:

http://thebuildingcoder.typepad.com/blog/2018/06/creating-a-warning-using-the-failure-api.html

Cheers,

Jeremy

Re: How to create a Warning

Kevin.Bell — Mon, 11 Jun 2018 12:17:04 GMT

Perfect, thanks, I'll give that a try.

Re: How to create a Warning

PTHN-NNDuc — Tue, 22 Jun 2021 09:46:51 GMT

Seems like it's locked in Revit 2020

Re: How to create a Warning

Sean_Page — Mon, 15 May 2023 14:39:33 GMT

I know this is a little older, but would you have any guidance on how (if possible) to get the Warning to stick to the document? I am able to display the warning, set the resolution and all that, but as stated in the Docs, it is NOT stored in the document.

For this request, I am working inside an IUpdater and would like to throw the warning (working) AND keep in the Warnings list if that is possible.

Re: How to create a Warning

jeremy_tammik — Mon, 15 May 2023 15:40:16 GMT

Sorry, dunno off-hand. I asked the development team for you.

Re: How to create a Warning

ricaun — Mon, 15 May 2023 20:21:00 GMT

I believed that the PostFailure stored the FailureMessage in the document, but looks like it does not.

In the documentation explain: https://www.revitapidocs.com/2017/7184ff0a-f30e-03fb-904f-fb557df6fa37.htm

Remarks: If code inside transaction detects a problem that needs to be communicated to the user, it should report these conditions via this method. Failures will be validated and possibly resolved at the end of transaction. Warnings posted via this method will not be stored in the document after they are resolved. A unique key returned by postFailure can be stored for the lifetime of transaction and used to remove failure message if it is no longer relevant.

Warnings look not as useful as I thought. 😐

Re: How to create a Warning

Sean_Page — Mon, 15 May 2023 20:25:28 GMT

I am assuming it is related to the FailureAccessor approach with the same method, but I was wanting to see if it was possible to "store" a warning before I headed down that path.

https://www.revitapidocs.com/2017/5d25d459-a1b0-eef4-4766-b00bd1f5ba79.htm

Re: How to create a Warning

jeremy_tammik — Tue, 16 May 2023 11:41:13 GMT

Yes, apparently ricaun is right; the development team replies:

> I do not think reviewable warnings are exposed to API.

If this is important for you, you could submit a wish for this functionality to the Revit Idea Station.

Whenever you require a new or enhanced Revit product or Revit API functionality, the Revit Idea Station is the place to go.

Please search there for a corresponding wish list entry for the suggested functionality and add your comments to it, or create a new one, if none already exists:

https://forums.autodesk.com/t5/revit-ideas/idb-p/302

Tag it as an API wish:

https://forums.autodesk.com/t5/revit-ideas/idb-p/302/tab/most-recent/label-name/api

Ensuring that a wish gets as many votes as possible helps underline its importance to you and the rest of the developer community.

The Revit Idea Station is currently one of the main driving input forces for Revit API enhancements.

The Revit development team looks there. Your comment here in the discussion forum might be overlooked.

Thank you!

Re: How to create a Warning

Sean_Page — Tue, 16 May 2023 11:54:19 GMT

Thanks @jeremy_tammik , I was unfortunately prepared for that answer, just wanted to make sure I hadn't missed something. As always, I appreciate your time!

Re: How to create a Warning

Sean_Page — Tue, 16 May 2023 14:45:16 GMT

Maybe I am the only one, but seems like this would be nice to have.

https://forums.autodesk.com/t5/revit-ideas/post-custom-warnings-to-the-warnings-list-inside-the-document/idi-p/11967658

Re: How to create a Warning

schnierer.gabor — Mon, 20 Nov 2023 11:21:04 GMT

For me it took quite a while to figure out how to display the modeless yellow pop-up called miniwarning.

Because although the original question asks for a modeless dialog, the solution provides a modal one.

The key is the ForcedModalHandling flag in FailureHandlingOptions is by default true. You have to manually set it to false.

options.SetForcedModalHandling(false);

Here is the context

using (Transaction t = new Transaction(doc, "Post failure")) { var options = t.GetFailureHandlingOptions(); var preproccessor = new FailurePreproccessor(); options.SetFailuresPreprocessor(preproccessor); options.SetForcedModalHandling(false); t.SetFailureHandlingOptions(options); t.Start(); FailureMessage fm = new FailureMessage(failureDefinitionId); doc.PostFailure(fm); t.Commit(); }