OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

wsrp message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [wsrp] Navigation params comments



Always good to push toward clarity ... adding the phrase "a previously supplied value or" and breaking that complex sentence into two where the second is providing an example of when the Consumer might choose to not follow the SHOULD guidance.

Rich



Subbu Allamaraju <subbu@bea.com>

12/15/05 09:15 AM

To
Rich Thompson/Watson/IBM@IBMUS
cc
OASIS WSRP TC <wsrp@lists.oasis-open.org>
Subject
Re: [wsrp] Navigation params comments






> By the way, sections numbers are always handy ... your page 29 resolves
> to section 5.1.17 on page 30 for me.

Just waiting for OpenOffice (I use Linux) to advance enough to recognize
subsection numbers in Word documents. It conveniently omits all
subsection numbers.

> a. The TC decided that "it is always a Consumer choice to supply them
> /(navigationParameters)/ on a particular invocation". The direct fallout
> of this is that the navigationParameterDescription is not allowed to
> require supplying if a particular item. This results in a model where
> the Consumer only supplies new values when they occur and the Portlet.
> Perhaps what is missing is a more concrete description (both here and in
> 6.1.11) that navigationParameters are simply an input which the Portlet
> SHOULD then store in its navigational state.

There is a very minor issue. To capture that the consumer supplies new
values when they occur, we can add "the Portlet should use a previously
supplied or a default value". The full sentence would then read

"When a Consumer does not supply a value for a particular
navigationParameter, the Portlet should use a previously supplied or a
default value."

> b. This sentence is providing guidance about how navigationParameters
> are shared between portlets, but is explicitly noting that the guidance
> likely doesn't apply when two portlets customized from the same POP
> within the sharing scope (likely the page).

The current sentence is not easily parseable. Could you break this into
two sentences, with the second one talking about cloned portlets?

Subbu


>
> *Subbu Allamaraju <subbu@bea.com>*
>
> 12/14/05 03:06 PM
>
>                  
> To
>                  OASIS WSRP TC <wsrp@lists.oasis-open.org>
> cc
>                  
> Subject
>                  [wsrp] Navigation params comments
>
>
>                  
>
>
>
>
>
> Two questions/comments on the navigationParameterDescriptions (page 29
> of draft 12):
>
> a. There is a statement that says that
>
> "As such, regardless of the values in the PropertyDescription's
> capabilities field, navigationParameters are always modifiable and
> optional."
>
> Does not this weaken the notion of wsrp:required capability?
>
> b. The intent of the next sentence is not clear to me.
>
> "While Consumer policy governs what navigation parameters are supplied
> to each invocation of a Portlet, Consumers SHOULD supply the same value
> to Portlets which are related to distinct Producer offered portlet
> handles and provide a navigationParameterDescription referencing the
> same QName for the parameter's name."
>
> I think what we want to say is that the consumer should try to supply
> the same value to any portlet with a matching name as specified in
> navigationParameterDescription. How about changing this text to the
> following?
>
> "While Consumer policy governs what navigation parameters are supplied
> to each invocation of a Portlet, Consumers SHOULD supply the same value
> to any portlet with the same QName for the parameter's name as specified
> in the portlet's navigationParameterDescription."
>
> Subbu
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail.  You may a link to this group and all your TCs in OASIS
> at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>
>
> --------------------------------------------------------------------- To
> unsubscribe from this mail list, you must leave the OASIS TC that
> generates this mail. You may a link to this group and all your TCs in
> OASIS at:
> https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php


---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  You may a link to this group and all your TCs in OASIS
at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php




[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]