Hi Ben,
thanks for that.
Looking at the svn/git history it seems Rini would be the developer in
charge for that functionality, I've cc'ed her, just in case she's back to
work.
Cheers
Andrea
On Sat, May 14, 2016 at 9:35 PM, Ben Caradoc-Davies <[email protected]>
wrote:
> There are some power users who might be able to help off list. I will hook
> you up.
>
> Kind regards,
> Ben.
>
>
> On 15/05/16 05:43, Andrea Aime wrote:
>
>> Well... By anyone that knows really... I'm losing the window of
>> opportunity to improve the docs... Monday I'll be back working on
>> completely different topics.
>> Oh well, that's life I guess
>>
>> Cheers
>> Andrea
>> Il 14 mag 2016 17:29, "Jody Garnett" <[email protected]> ha scritto:
>>
>> I am also interested in feedback on this one. Are you seeking
>>> clarification from Ben?
>>> On Tue, May 10, 2016 at 11:48 AM Andrea Aime <
>>> [email protected]>
>>> wrote:
>>>
>>> Bump :-)
>>>>
>>>> Cheers
>>>> Andrea
>>>>
>>>> On Sun, May 8, 2016 at 10:09 AM, Andrea Aime <
>>>> [email protected]> wrote:
>>>>
>>>> Hi,
>>>>> I've been reading the app-schema documentation end to end
>>>>> and I'm left wondering about the mappingName construct... it is being
>>>>> cited a few times in the
>>>>> docs, and I believe I have the gist of why it's there (to handle
>>>>> polymorphic mappings or cases where the same nested type is used in
>>>>> different places), but there is no real example of it being used.
>>>>>
>>>>> To make sure I've used "git grep mappingName" in the docs and the
>>>>> result
>>>>> is:
>>>>>
>>>>> source/data/app-schema/feature-chaining.rst: * the nested element
>>>>> name, which is normally the targetElement or mappingName of the
>>>>> corresponding type.
>>>>> source/data/app-schema/feature-chaining.rst:This is when the optional
>>>>> mappingName tag mentioned in :ref:`app-schema.mapping-file` comes in.
>>>>> source/data/app-schema/feature-chaining.rst:Instead of passing in the
>>>>> nested feature type's targetElement in the containing type's
>>>>> linkElement,
>>>>> specify the corresponding mappingName.
>>>>> source/data/app-schema/feature-chaining.rst: * The mappingName is
>>>>> namespace aware and case sensitive.
>>>>> source/data/app-schema/feature-chaining.rst: * When the referred
>>>>> mappingName contains special characters such as '-', it must be
>>>>> enclosed
>>>>> with single quotes in the linkElement. E.g.
>>>>> <linkElement>'observation-method'</linkElement>.
>>>>> source/data/app-schema/feature-chaining.rst: * Each mappingName must
>>>>> be unique against other mappingName and targetElement tags across the
>>>>> application.
>>>>> source/data/app-schema/feature-chaining.rst: * The mappingName is
>>>>> only to be used to identify the chained type from the nesting type. It
>>>>> is
>>>>> not a solution for multiple FeatureTypeMapping instances where > 1 of
>>>>> them
>>>>> can be queried as top level features.
>>>>> source/data/app-schema/mapping-file.rst:
>>>>> <mappingName>mappedfeature1</mappingName>
>>>>> source/data/app-schema/mapping-file.rst:* ``mappingName`` is an
>>>>> optional
>>>>> tag, to identify the mapping in :ref:`app-schema.feature-chaining` when
>>>>> there are multiple FeatureTypeMapping instances for the same type.
>>>>> This is
>>>>> solely for feature chaining purposes, and would not
>>>>> source/data/app-schema/polymorphism.rst:Note: NumericType here is a
>>>>> mappingName, whereas gsml:CGI_TermValue is a targetElement.
>>>>> source/data/app-schema/polymorphism.rst:
>>>>> <mappingName>NumericType</mappingName>
>>>>> source/data/app-schema/polymorphism.rst:Otherwise, if NUMERIC_VALUE is
>>>>> less or equal than 1000, it would be encoded with attributes from
>>>>> FeatureTypeMapping with 'numeric_value' mappingName.
>>>>> source/data/app-schema/polymorphism.rst:* **value-n**: value expression
>>>>> which translates to a mappingName or targetElement
>>>>> source/data/app-schema/polymorphism.rst: * When specifying a
>>>>> mappingName or targetElement as a value in functions, make sure they're
>>>>> enclosed in single quotes.
>>>>>
>>>>> The feature chaining page is the most baffling one, it has a set of
>>>>> example mapping files
>>>>> and I was expecting to find some usage of it in there, since the parts
>>>>> talking about mappingName
>>>>> refer to the gsml:CGI_TermValue usage, but it's not actually there.
>>>>>
>>>>> The polymorphism page actually cites it in a snippet, but the context
>>>>> is
>>>>> different, it's about avoiding extra
>>>>> queries on the database. I've read it a few times but was not able to
>>>>> make head or tails of it, until I've found
>>>>> a worked out example in the GeoServer app-schema tests:
>>>>>
>>>>>
>>>>> https://github.com/geoserver/geoserver/blob/master/src/extension/app-schema/app-schema-test/src/test/resources/test-data/CGI_PlanarOrientation.xml
>>>>>
>>>>>
>>>>> https://github.com/geoserver/geoserver/blob/master/src/extension/app-schema/app-schema-test/src/test/resources/test-data/CGI_PlanarOrientation.properties
>>>>>
>>>>> So, if I get the idea correctly (please correct me if I'm wrong):
>>>>>
>>>>> - PlanarOrientation has a aziumth value that's polymorphic, it can
>>>>> be either a gsml:CGI_NumericValue or a gsml:CGI_TermValue (and the
>>>>> same
>>>>> happens for the "dip" attribute)
>>>>> - The property file contains all the information needed as a flat
>>>>> table, two columns to represent each case, one will be populated,
>>>>> the other
>>>>> null
>>>>> - The linkElement uses a function to decide which mappingName to
>>>>> use
>>>>> depending on which attribute is populated
>>>>> - The use of mapping name is necessary because we have literally 5
>>>>> different type mappings using the same source table
>>>>> - Using the mappings this way will make app schema read the table
>>>>>
>>>>> just once, without self joins, and map out the different
>>>>> properties as
>>>>> needed into the target xml document
>>>>>
>>>>> So this example would be "using mappingName to go from a flat table to
>>>>> a
>>>>> document with nested polymorphic types".
>>>>>
>>>>> And then there is the case of no polymorphism, but having the same type
>>>>> used in several different places, it's not polymorphism, it's
>>>>> just that the schema decided to roll out a custom type for something as
>>>>> common as a string for example, in order to be able to scope it with a
>>>>> class/namespace.
>>>>> This case is instead seems to be exemplified in the
>>>>> geologicunit/cgi_termvalue case:
>>>>>
>>>>>
>>>>> https://github.com/geoserver/geoserver/blob/master/src/extension/app-schema/app-schema-test/src/test/resources/test-data/DataReferenceData/gsml_GeologicUnit/gsml_GeologicUnit.xml#L215
>>>>>
>>>>>
>>>>> https://github.com/geoserver/geoserver/blob/master/src/extension/app-schema/app-schema-test/src/test/resources/test-data/DataReferenceData/gsml_GeologicUnit/GU_CGITermValue.xml#L14
>>>>>
>>>>> In this case we have three different term value attributes in geologic
>>>>> unit, each one is associated to a different mapping in the second file,
>>>>> each one having the same structure, but reading from a different table
>>>>> of the database.
>>>>>
>>>>> Finally I beleive there would be a third case which is similar to the
>>>>> above one, again usage of the same type in different places, but with
>>>>> all
>>>>> the terms located in a single table instead of 3, and
>>>>> having an attribute that can be used to tell what role the term plays.
>>>>> I
>>>>> haven't found an example like it in the tests though... have I missed
>>>>> it?
>>>>>
>>>>> Looking forward to your feedback, if the above is more or less correct
>>>>> I'd like to make a pull request adding these examples in the docs.
>>>>>
>>>>>
>>>>> Cheers
>>>>> Andrea
>>>>>
>>>>> --
>>>>> ==
>>>>> GeoServer Professional Services from the experts! Visit
>>>>> http://goo.gl/it488V for more information.
>>>>> ==
>>>>>
>>>>> Ing. Andrea Aime
>>>>> @geowolf
>>>>> Technical Lead
>>>>>
>>>>> GeoSolutions S.A.S.
>>>>> Via di Montramito 3/A
>>>>> 55054 Massarosa (LU)
>>>>> phone: +39 0584 962313
>>>>> fax: +39 0584 1660272
>>>>> mob: +39 339 8844549
>>>>>
>>>>> http://www.geo-solutions.it
>>>>> http://twitter.com/geosolutions_it
>>>>>
>>>>> *AVVERTENZE AI SENSI DEL D.Lgs. 196/2003*
>>>>>
>>>>>
>>>>> Le informazioni contenute in questo messaggio di posta elettronica e/o
>>>>> nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il
>>>>> loro utilizzo è consentito esclusivamente al destinatario del
>>>>> messaggio,
>>>>> per le finalità indicate nel messaggio stesso. Qualora riceviate questo
>>>>> messaggio senza esserne il destinatario, Vi preghiamo cortesemente di
>>>>> darcene notizia via e-mail e di procedere alla distruzione del
>>>>> messaggio
>>>>> stesso, cancellandolo dal Vostro sistema. Conservare il messaggio
>>>>> stesso,
>>>>> divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od
>>>>> utilizzarlo per finalità diverse, costituisce comportamento contrario
>>>>> ai
>>>>> principi dettati dal D.Lgs. 196/2003.
>>>>>
>>>>>
>>>>>
>>>>> The information in this message and/or attachments, is intended solely
>>>>> for the attention and use of the named addressee(s) and may be
>>>>> confidential
>>>>> or proprietary in nature or covered by the provisions of privacy act
>>>>> (Legislative Decree June, 30 2003, no.196 - Italy's New Data Protection
>>>>> Code).Any use not in accord with its purpose, any disclosure,
>>>>> reproduction,
>>>>> copying, distribution, or either dissemination, either whole or
>>>>> partial, is
>>>>> strictly forbidden except previous formal approval of the named
>>>>> addressee(s). If you are not the intended recipient, please contact
>>>>> immediately the sender by telephone, fax or e-mail and delete the
>>>>> information in this message that has been received in error. The sender
>>>>> does not give any warranty or accept liability as the content,
>>>>> accuracy or
>>>>> completeness of sent messages and accepts no responsibility for
>>>>> changes
>>>>> made after they were sent or for other risks which arise as a result of
>>>>> e-mail transmission, viruses, etc.
>>>>>
>>>>> -------------------------------------------------------
>>>>>
>>>>>
>>>>
>>>>
>>>> --
>>>> ==
>>>> GeoServer Professional Services from the experts! Visit
>>>> http://goo.gl/it488V for more information.
>>>> ==
>>>>
>>>> Ing. Andrea Aime
>>>> @geowolf
>>>> Technical Lead
>>>>
>>>> GeoSolutions S.A.S.
>>>> Via di Montramito 3/A
>>>> 55054 Massarosa (LU)
>>>> phone: +39 0584 962313
>>>> fax: +39 0584 1660272
>>>> mob: +39 339 8844549
>>>>
>>>> http://www.geo-solutions.it
>>>> http://twitter.com/geosolutions_it
>>>>
>>>> *AVVERTENZE AI SENSI DEL D.Lgs. 196/2003*
>>>>
>>>>
>>>> Le informazioni contenute in questo messaggio di posta elettronica e/o
>>>> nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il
>>>> loro utilizzo è consentito esclusivamente al destinatario del messaggio,
>>>> per le finalità indicate nel messaggio stesso. Qualora riceviate questo
>>>> messaggio senza esserne il destinatario, Vi preghiamo cortesemente di
>>>> darcene notizia via e-mail e di procedere alla distruzione del messaggio
>>>> stesso, cancellandolo dal Vostro sistema. Conservare il messaggio
>>>> stesso,
>>>> divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od
>>>> utilizzarlo per finalità diverse, costituisce comportamento contrario ai
>>>> principi dettati dal D.Lgs. 196/2003.
>>>>
>>>>
>>>>
>>>> The information in this message and/or attachments, is intended solely
>>>> for the attention and use of the named addressee(s) and may be
>>>> confidential
>>>> or proprietary in nature or covered by the provisions of privacy act
>>>> (Legislative Decree June, 30 2003, no.196 - Italy's New Data Protection
>>>> Code).Any use not in accord with its purpose, any disclosure,
>>>> reproduction,
>>>> copying, distribution, or either dissemination, either whole or
>>>> partial, is
>>>> strictly forbidden except previous formal approval of the named
>>>> addressee(s). If you are not the intended recipient, please contact
>>>> immediately the sender by telephone, fax or e-mail and delete the
>>>> information in this message that has been received in error. The sender
>>>> does not give any warranty or accept liability as the content, accuracy
>>>> or
>>>> completeness of sent messages and accepts no responsibility for changes
>>>> made after they were sent or for other risks which arise as a result of
>>>> e-mail transmission, viruses, etc.
>>>>
>>>> -------------------------------------------------------
>>>>
>>>>
>>>> ------------------------------------------------------------------------------
>>>> Mobile security can be enabling, not merely restricting. Employees who
>>>> bring their own devices (BYOD) to work are irked by the imposition of
>>>> MDM
>>>> restrictions. Mobile Device Manager Plus allows you to control only the
>>>> apps on BYO-devices by containerizing them, leaving personal data
>>>> untouched!
>>>> https://ad.doubleclick.net/ddm/clk/304595813;131938128;j
>>>> _______________________________________________
>>>> Geoserver-devel mailing list
>>>> [email protected]
>>>> https://lists.sourceforge.net/lists/listinfo/geoserver-devel
>>>>
>>>> --
>>> --
>>> Jody Garnett
>>>
>>>
>>
>>
>>
>> ------------------------------------------------------------------------------
>> Mobile security can be enabling, not merely restricting. Employees who
>> bring their own devices (BYOD) to work are irked by the imposition of MDM
>> restrictions. Mobile Device Manager Plus allows you to control only the
>> apps on BYO-devices by containerizing them, leaving personal data
>> untouched!
>> https://ad.doubleclick.net/ddm/clk/304595813;131938128;j
>>
>>
>>
>> _______________________________________________
>> Geoserver-devel mailing list
>> [email protected]
>> https://lists.sourceforge.net/lists/listinfo/geoserver-devel
>>
>>
> --
> Ben Caradoc-Davies <[email protected]>
> Director
> Transient Software Limited <http://transient.nz/>
> New Zealand
>
--
==
GeoServer Professional Services from the experts! Visit
http://goo.gl/it488V for more information.
==
Ing. Andrea Aime
@geowolf
Technical Lead
GeoSolutions S.A.S.
Via di Montramito 3/A
55054 Massarosa (LU)
phone: +39 0584 962313
fax: +39 0584 1660272
mob: +39 339 8844549
http://www.geo-solutions.it
http://twitter.com/geosolutions_it
*AVVERTENZE AI SENSI DEL D.Lgs. 196/2003*
Le informazioni contenute in questo messaggio di posta elettronica e/o
nel/i file/s allegato/i sono da considerarsi strettamente riservate. Il
loro utilizzo è consentito esclusivamente al destinatario del messaggio,
per le finalità indicate nel messaggio stesso. Qualora riceviate questo
messaggio senza esserne il destinatario, Vi preghiamo cortesemente di
darcene notizia via e-mail e di procedere alla distruzione del messaggio
stesso, cancellandolo dal Vostro sistema. Conservare il messaggio stesso,
divulgarlo anche in parte, distribuirlo ad altri soggetti, copiarlo, od
utilizzarlo per finalità diverse, costituisce comportamento contrario ai
principi dettati dal D.Lgs. 196/2003.
The information in this message and/or attachments, is intended solely for
the attention and use of the named addressee(s) and may be confidential or
proprietary in nature or covered by the provisions of privacy act
(Legislative Decree June, 30 2003, no.196 - Italy's New Data Protection
Code).Any use not in accord with its purpose, any disclosure, reproduction,
copying, distribution, or either dissemination, either whole or partial, is
strictly forbidden except previous formal approval of the named
addressee(s). If you are not the intended recipient, please contact
immediately the sender by telephone, fax or e-mail and delete the
information in this message that has been received in error. The sender
does not give any warranty or accept liability as the content, accuracy or
completeness of sent messages and accepts no responsibility for changes
made after they were sent or for other risks which arise as a result of
e-mail transmission, viruses, etc.
-------------------------------------------------------
------------------------------------------------------------------------------
Mobile security can be enabling, not merely restricting. Employees who
bring their own devices (BYOD) to work are irked by the imposition of MDM
restrictions. Mobile Device Manager Plus allows you to control only the
apps on BYO-devices by containerizing them, leaving personal data untouched!
https://ad.doubleclick.net/ddm/clk/304595813;131938128;j
_______________________________________________
Geoserver-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geoserver-devel
