• Tidak ada hasil yang ditemukan

Change Requests | OGC

N/A
N/A
Protected

Academic year: 2017

Membagikan "Change Requests | OGC"

Copied!
7
0
0

Teks penuh

(1)

CR-Form-v3

CHANGE REQUEST

06-135r6

CR ?

 rev

-

 Current version:

-For HELP

 

on using this form, see bottom of this page or look at the pop-up text over the symbols.

Proposed change affects:  AS Imp Spec Best Practices Paper Other X

Title:  Policies Related to OGC Standards

Source:  Peter Baumann, WCS 1.2 RWG

Work item code:Date:  2009-04-01

Category:B (Add needed information)

Use one of the following categories:

F (Critical correction)

A (corresponds to a correction in an earlier release)

B (Addition of feature),

C (Functional modification of feature)

D (Editorial modification)

Reason for change:  In its current state, 06-135r6 lacks some information essential for spec submitters. Also, some items appear ambiguous.

Summary of change:  Extensions to determine the exact packaging & publishing of standards

Consequences if not approved:

(2)

Clauses affected:  14

Other specs  Other core specifications 

Affected: Abstract specifications

Best Practices Papers

Supporting Doc.

Other comments:  This change request is to OGC 06-135r6.

Status

Disposition

A) Add clarification on allowed schema modifications in an extension:

Rationale:

While extensions informally are described with a clear semantics (extending functionality available in the core of a standard), it is not completely clear what schema modifications are allowed in an extension.

Consequence if not done:

If such rules are not added schema then writers will continue deriving extension schemas based on their individual ideas, which may or may not compromise the extension

principle.

Recommendation:

(3)

Annex A (Normative)

This Annex describes the allowed and not allowed ways of deriving an extension’s schema from the corresponding core schema.

 How to EXTEND an XML Schema?

 A new element (or attribute) can be declared that uses an existing named type.

 A new element or type can be declared that includes existing named elements (and attributes).

 A new element or type can be declared that extends an existing named type.

 A new element can be declared that in the substitutionGroup of an existing globally-named element, allows the new element to be substituted for that existing element.

 Such a new element in the substitutionGroup of an existing element can use a newly declared type that extends or restricts the existing globally-named type of that substitutionGroup element.

 How to NOT EXTEND an XML Schema?

An XML Schema extension can NOT make any significant changes in an existing element, attribute, or type.

More specifically, an XML Schema extension CANNOT:

 Extend or restrict the allowed multiplicity of an element, or optionality of an attribute, within an existing element or type

 Add any element or attribute to the contents of an existing element or type

 Change the specified conditions on when to use, or not use, specified element multiplicity and attribute optionality

 Change the specified conditions on, or deprecate, use of an existing element or attribute

 Change the name or XML namespace identifier of an existing element, attribute, or type

 Change the definition or <documentation> of an existing element, attribute, or type

B) Clarify package contents and structure:

(4)

Currently it is not sufficiently codified how the component files of a standard should be packaged into the downloadable zip file.

Consequence if not done:

Packages will remain incoherent, which may lead to problems in particular when several packages are to be used simultaneously.

Recommendation:

Add Section 14.1 as described below.

C) Clarify document types:

Rationale:

The OGC portal does not allow, when submitting documents to pending, to pick the document types foreseen. Consequently, many different document indications are used in the text, and not always is the appropriate one picked during submission.

Consequence if not done:

Document type indicators will remain incoherent, which can lead to confusion and might lead to legal problems.

Recommendation:

 Agree on a set of designators, list them in 06-135 Section 14 (see below)

 Update the selection available on the portal submission page to reflect the items wanted

 From the spec template remove “Category” as it duplicates “Document Type”

 And, for ignorant people like me, have a hint somewhere that documents will be purged from pending once they are published as standards.

D) Clarify schema root file name:

Rationale:

By undocumented convention, each schema package should have, per namespace, a canonical entry point represented by a file which imports/includes all other files making up this namespace. This file should have a standard name to make it easier determining it easily. Among the alternatives that are floating around are, for some standard with short name “xxx”, xxx.xsd and xxxAll.xsd.

Consequence if not done:

More difficult – and potentially error prone – to find the entry point to a schema.

(5)

Mandate use of xxx.xsd. (Actually, it is not decisive which variant to take, as long as it is only one in future.)

Change Section 14 para 1 in 06-135r6 from:

For all OGC XML schemas, when writing a candidate standard and when publishing that standard, one XML schema document shall be provided that includes, either directly or indirectly, all of the components defined and declared in the namespace for that XML schema (the "all-components" document). This "all-components" XML schema document for each XML schema shall be clearly identified in the document file name.

EXAMPLES: The "all-components" XML schema document for GML is named gml.xsd, and for OWS Common is named owsAll.xsd.

To:

For all OGC XML schemas, when writing a candidate standard and when publishing that standard, one XML schema document shall be provided that includes, either directly or indirectly, all of the components defined and declared in the namespace for that XML schema (the "all-components" document). This "all-components" XML schema document for each XML schema shall bear the short name of the standard.

EXAMPLE: The "all-components" XML schema document for GML is named gml.xsd.

E) Standards web site structure:

Rationale:

For each standard “xxx”, a website www.opengeospatial.org/standards/xxx is generated. This is not editable by the corresponding SWG (and this makes sense to maintain uni-form, coherent structure). By convention, there often is an additional page www.ogc net -work/services/xxx which the SWG can edit. Often this is used for additional information, which turns out valuable for standards users. Hence, this should be done by default and following the pattern indicated above.

Consequence if not done:

No hint for spec writers that they might provide additional information. If they decide to do so then pages will follow individual patterns and will live outside OGC.

Recommendation:

Substitute this current text:

14 Publication Rules for OGC Schemas

(6)

14 Publication Rules

11.1 Publication Rules for OGC Standards

For upload to the public standards section of the OGC website, documents SHALL be provided as follows:

 If the standard consists of only one document, this SHALL be provided as is, adhering to the naming convention

nn-nnn_Full-Standard-Name.ext

where

nn-nnn is the OGC document number, possibly with a revision number

Full-Standard-Name is the spelled-out name of the standard

ext is the file type extension.

Example: 08-068r2_Web-Coverage-Processing-Service.doc

 If the standard consists of several documents, these SHALL be provided as a zip file, adhering to the naming convention

nn-nnn_Full-Standard-Name.zip

where

nn-nnn is the OGC document number, possibly with a revision number

Full-Standard-Name is the spelled-out name of the standard

ext is the file type extension.

Example: 08-059r3_WCS-Processing-Extension.zip

The zip file SHALL contain one subdirectory named

nn-nnn_Full-Standard-Name

and nothing else. The subdirectory SHALL contain:

 The core specification file, following the naming schema nn-nnn_Full-Standard-Name.ext

Example: 08-059r3_WCS-Processing-Extension.doc

 The Abstract Test Suite (unless it is included verbatim in Annex A of the core specification document), following the naming schema

(7)

Example:

08-059r3_WCS-Processing-Extension_Abstract-Test Suite.doc

 All pertinent XML schema files, organized in one or more directories exactly like on the OGC schema website.

Example: for WCPS, a sample file in the subdirectory contained in the zip file is

wcps/1.0.0/wcpsProcessCoverages.xsd

as the WCPS schema is available under URL www.ogcschemas.org/wcps.

 Any further files. They MAY be organized into subdirectories without further constraints.

When uploading a specification document to the portal, the document type picked in the upload menu SHALL be the same as the one indicated on the title page of the document.

The web page for publication of a standard with short name “xxx” SHALL be

www.opengeospatial.org/standards/xxx. This page SHALL contain all documents making up the standard, a link to the schema location (see next section), and a link to a page

www.ogcnetwork.org/services/xxx where the SWG on duty SHOULD provide additional background material useful for readers of the standard.

Example: www.opengeospatial.org/standards/wcps and

www.ogcnetwork.org/services/wcps.

Referensi

Dokumen terkait

Hasil: Pada penelitian ini didapat kadar KGD puasa, HbA1c dan ferritin yang lebih tinggi bermakna ( p&lt; 0,001) pada penderita DM tipe 2 yang tidak terkontrol dibandingkan

Metode ini dipilih untuk menemukan faktor prima dari bilangan bulat yang besar dengan hanya menggunakan jumlah lokasi memori yang konstan.. Pengujian keprimaan dalam

Larger normalized distortions are obtained for the nonlinear than for the linear-elastic ground, for the same relative stiffness, with differences increasing as the tunnel becomes

SISTEM PENGUKUR KUALITAS LAYANAN PENDIDIKAN MENGGUNAKAN EDUCATIONAL QUALITY Universitas Pendidikan Indonesia | repository.upi.edu |perpustakaan.upi.edu!.

Excitingly, recent studies have shown that Nrf2 also affects mitochondrial function in stem cells with implications for stem cell self-renewal, cardiomyocyte regeneration, and

Sikap Guru Sekolah Dasar terhadap Penyelenggaraan Sekolah Inklusif (Studi Mengenai Pengaruh Jenis Sekolah, Latar Belakang Pendidikan Guru, Pelatihan Pendidikan

For example, the right to access adequate healthcare (article 24) falls under provision rights, protection from all forms of exploitation (article 32) is part of the

tunjangan kinerja sesuai dengan aturan yang berlaku kepada para. pegawainya dan melakukan evaluasi berkelanjutan demi