iptc / sportsml-3

Development of SportsML 3
9 stars 1 forks source link

Organization-element structure #14

Open trondhuso opened 8 years ago

trondhuso commented 8 years ago

If I want to add main organization information to a sportsML file, there really isn’t a placeholder for this.

I’m currently converting all FIS events into SML2.2 (but will change to 3.0 as it gives me the chance to provide more information) which then will be imported into a database. It would be nice to have some information about the provider of the data somewhere in the file.

What I’d like to add is: Name of the content provider – both long name (in English or French or any other language) and short (International Ski Federation (FIS)) E-mail to any contact Website for content provider Website for timing provider (if this is defined somewhere)

I am looking at affiliation, but then I have to add a team or player element which is not needed. Can I suggest a new element called organization with same structure as site? Place for this element: either in sports-metadata, standalone or inside schedule/sports-event

This was discussed during the 3.0 work. As requested a possible structure:

<organization>
    <organization-metadata>
        <name role="role:full" xml:lang="en-GB">International Ski Federation</name>
        <name role="role:full" xml:lang="fr-FR">Fédération Internationale de Ski</name>
        <name role="role:full" xml:lang="de-DE">Internationaler Ski Verband</name>
        <name role="role:short">FIS</name>
        <home-location>
            <POIDetails>
                <openHours>08h00 - 12h00 CET and 13h00 - 17h00 CET</openHours>
                <contactInfo>
                    <address>
                        <line role="role:line1">FIS Headquarters</line>
                        <line role="role:line2">Marc Hodler House</line>
                        <line role="role:line3">Blochstrasse 2</line>
                        <locality>
                            <name xml:lang="en-GB">Oberhofen / Thunersee</name>
                        </locality>
                        <country>
                            <name xml:lang="en-GB">Switzerland</name>
                        </country>
                        <postalCode>3653</postalCode>
                    </address>
                    <email role="role:orgemail">mail@fisski.com</email>
                    <web role="role:orgwebsite">http://www.fisski.com</web>
                    <phone role="role:orgphone">+41 (0)33 244 6161</phone>
                    <fax role="role:orgfax">+41 (0)33 244 6171</fax>
                </contactInfo>
            </POIDetails>
        </home-location>
    </organization-metadata>
</organization>
jolla56 commented 7 years ago

I think this need a bit of studying. I can see two variants. One that you like to indicate the organiser/owner of the data. But also the provider of the data. They need not be the same. In sports-metadata we have an attribute for provider. But that is only a string. You like a whole structure. So maybe the solution is a repeatable optional element under sports-metadata with some general structure from NAR and a role-attribute. It could even be in the form of a pointer to a concept.

jolla56 commented 7 years ago

@trondhuso Suggestion from @pauljkelly is to check out the group element that already exist. If that does not work we can pick up the discussion again.

trondhuso commented 7 years ago

Ok.

So the code below works. Question though: group is only available under statistic and I feel it is a bad name for the data it holds. organization is a specific name and can and will hold information about a) the owner of the competitions (like fifa, uefa, ioc, fis) or b) the organizor of the current event - like for instance Lahti2016, ROCOG 2016, LOCOG 2012, Kitzbühel and so on. (Like you said, Johan).

How can it be used. Both in a rather large XML-file, but also in APIs where someone would like to get data about the organisator of the event(s).

Sample from group below.

<statistic>
    <statistic-metadata></statistic-metadata>
    <group>
        <group-metadata group-type="organization">
            <name role="role:full" xml:lang="en-GB">International Ski Federation</name>
            <site>
                <site-metadata>
                    <home-location>
                        <POIDetails>
                            <openHours>08h00 - 12h00 CET and 13h00 - 17h00 CET</openHours>
                            <contactInfo>
                                <address>
                                    <line role="role:line1">FIS Headquarters</line>
                                    <line role="role:line2">Marc Hodler House</line>
                                    <line role="role:line3">Blochstrasse 2</line>
                                    <locality>
                                        <name xml:lang="en-GB">Oberhofen / Thunersee</name>
                                    </locality>
                                    <country>
                                        <name xml:lang="en-GB">Switzerland</name>
                                    </country>
                                    <postalCode>3653</postalCode>
                                </address>
                                <email role="role:orgemail">mail@fisski.com</email>
                                <web role="role:orgwebsite">http://www.fisski.com</web>
                                <phone role="role:orgphone">+41 (0)33 244 6161</phone>
                                <fax role="role:orgfax">+41 (0)33 244 6171</fax>
                            </contactInfo>
                        </POIDetails>
                    </home-location>
                </site-metadata>
            </site>
        </group-metadata>
    </group>
</statistic>