RE: Help system: javax.help.BadIDException

2011-11-09T18:49:38Z

Norman,

Thanks! I thought it was likely a dependency issue...even tried putting it in the seadas/pom.xml with no success - didn't think about the seadas-app/pom.xml!

We will very likely want to have customized SeaDAS help, so many thanks for pointing us in the right direction

Sean

RE: Help system: javax.help.BadIDException

2011-11-09T13:54:10Z

Hi Sean,

I fixed it by adding a (missing) dependency to beam-help module to your seadas-app/pom.xml:

1
2       <dependency>
3          <groupId>org.esa.beam</groupId>
4          <artifactId>beam-help</artifactId>
5          <version>4.10-SNAPSHOT</version>
6       </dependency>

If you want a branded or otherwise customised SeaDAS help (I guess so), you should create your owen seadas-help module (copy beam-help module and rename stuff).

More customisation could be done in your seadas-app/src/main/resources/module.xml. For example, you could remove the default actions from the VISAT help menu:

1
2 <extension point="beam-ui:applicationDescriptors">
3       <applicationDescriptor>
4          <applicationId>SeaDAS</applicationId>
5          <displayName>SeaDAS</displayName>
6          <version>7.0-SNAPSHOT</version>
7          <buildId>${beam.build.id}</buildId>
8          <buildDate>${beam.build.date}</buildDate>
9          <excludedActions>
10             
11             
12             <id>helpTopics</id>
13             <id>showHomePage</id>
14             <id>showDataSources</id>
15             <id>about</id>
16          </excludedActions>
17          <excludedToolViews>
18             
19             
20          </excludedToolViews>
21       </applicationDescriptor>
22 </extension>

If you want to add your own help menu actions, you need to also define them in seadas-app/src/main/resources/module.xml. For example:

1
2 <extension point="beam-ui:actions">
3
4       <action>
5          <id>showObpgHomePage</id>
6          <parent>help</parent>
7          <class>gov.nasa.obpg.seadas.actions.ShowObpgHomePageAction</class>
8          <text>SeaDAS Home Page</text>
9          <description>Opens the SeaDAS home page.</description>
10          <placeAfter>helpTopics</placeAfter>
11       </action>
12
13 </extension>

Help system: javax.help.BadIDException

2011-11-08T17:02:43Z

We are experiencing a problem regarding the help system....it doesn't work
Well, it works if we run the full Beam, but not if we run our 'subset' SeaDAS (on GitHub).

Specifically, we get the following error:

javax.help.BadIDException: Not valid ID: ...

It seems as if the help system hasn't been properly initialized, as it
consistently errors when attempting to set the current id:

javax.help.DefaultHelpBroker.setCurrentID

Any idea what we're missing? The error is easily replicated. Start SeaDAS and
try to use the help from the main menu (or press F1).

Regards,
Sean