Eclipse Community Forums
Forum Search:

Search      Help    Register    Login    Home
Home » Eclipse Projects » Platform - User Assistance (UA) » How can I provide variables for property tests to create dynamic help content
How can I provide variables for property tests to create dynamic help content [message #730001] Tue, 27 September 2011 08:58 Go to next message
Riccardo Missing name is currently offline Riccardo Missing name
Messages: 9
Registered: September 2011
Junior Member
First of all, sorry for the duplicated post, but it seems that I should ask my question here instead of the Eclipse Platform forum.

User assistance provides two variables (platform and workbench) which can be used for property tests to determine the enablement of an element in the documentation. Furthermore you can define a property tester via the extension point org.eclipse.core.expressions.propertyTesters.

My question is how i can provide a new variable (eg. myVariable) which i want to use in my property tester, so that i can enable/disable an element in my XHTML-file?

<p>
  <enablement>
    <with variable="myVariable">
      <test property="my.namespace.propertyName" value="expectedValue"/>
    </with>
  </enablement>
  This paragraph should only be displayed when my provided varibale passes the test.
</p>

Report message to a moderator

Re: How can I provide variables for property tests to create dynamic help content [message #730670 is a reply to message #730001] Wed, 28 September 2011 16:26 Go to previous messageGo to next message
Chris Goldthorpe is currently offline Chris Goldthorpe
Messages: 815
Registered: July 2009
Senior Member
The help system does indeed use org.eclipse.core.expressions to evaluate the filter expressions, and the extension point org.eclipse.core.expressions.propertyTesters can be used to add more kinds of tests. I'm not familiar with where the variables platform and workbench come from - they are not defined by the help system but I can't tell exactly where they are defined.

Report message to a moderator

Re: How can I provide variables for property tests to create dynamic help content [message #730858 is a reply to message #730670] Thu, 29 September 2011 07:54 Go to previous messageGo to next message
Riccardo Missing name is currently offline Riccardo Missing name
Messages: 9
Registered: September 2011
Junior Member
The evaluation context seems to be created in org.eclipse.help.UAContentFilter whereby the platform variable is added via context.addVariable(VARIABLE_PLATFORM, Platform.class). It would be nice to have an extension point which allows to add additional variables to that context.

Since I implement my own providers for tocs and content extensions as well as content producers (see my other post "message #730008"), I have to implement most of the other interfaces (eg. IToc, ITopic, ...) to. This interfaces extend IUAElement which defines the method isEnabled(IEvaluationContext context). In my case it would be better if these method would be defined without the context as a paramter. In this way the implementing class could determine the enabled state by here own rules. In the case of the class org.eclipse.help.internal.UAElement you can use an IEvaluationContext, which is provide by the internals of the org.eclipse.help bundle.

What do you think about that proposal Chris? Would it lead to a better design? At least in my case the context is useless, because I can not define tests for my dynamic created elements in the plugin.xml and the enabled state is determined by other properties.

[Updated on: Thu, 29 September 2011 08:02]

Report message to a moderator

Re: How can I provide variables for property tests to create dynamic help content [message #733428 is a reply to message #730858] Tue, 04 October 2011 13:47 Go to previous messageGo to next message
Chris Goldthorpe is currently offline Chris Goldthorpe
Messages: 815
Registered: July 2009
Senior Member
Adding an extension point to allow the addition of more variables sounds like an interesting idea but it is unlikely that we could implement that for Eclipse 3.8 given our current priorities and staffing levels.

In your case since you have control over the isEnabled() method the best solution might be to check the EvaluationContext ( so that the standard filters will work ) and in addition add your own test for enablement. Your isEnabled() methods do not need to use only tests based the IEvaluationContext parameter - they can contain whatever logic you want.

Report message to a moderator

Re: How can I provide variables for property tests to create dynamic help content [message #735604 is a reply to message #730001] Wed, 12 October 2011 06:56 Go to previous message
Riccardo Missing name is currently offline Riccardo Missing name
Messages: 9
Registered: September 2011
Junior Member
Hallo Chris,

I am not able to check the EvaluationContext since a expression is needed and the context only provides variables.

For this reason it would be better to define the isEnabled method in IUAElement without the parameter of the type IEvaluationContext in my opinion. Implementations of IUAElement of the eclipse.help bundles should than resolve the context internal by a call to helper method or something like that.

I know that this would be an API change which is not backward compatible, but for me it looks like a better approach with a cleaner interface.

Report message to a moderator

Previous Topic:Error Message
Next Topic:Searching in help does not work
Goto Forum:
  

[ Syndicate this forum (XML) ] [ RSS ]

Current Time: Thu May 23 19:10:58 EDT 2013

Powered by FUDForum. Page generated in 0.01807 seconds