Skeeman määrityssivu

Tietoja tästä sivusta

Tällä lomakesivulla voit muokata muokatun skeeman kieliopin muodostavien skeeman objektien rakennetta ja ominaisuuksia.

Skeeman objektien rakennetta muokataan Laajennuspisteen elementit -osassa. Tämä osa näkyy muokkausohjelma-alueen vasemmassa yläreunassa.

Skeeman objektien ominaisuuksia muokataan <schema-object> Tiedot -osissa. Osat aktivoituvat muokkausohjelma-alueen oikeaan yläreunaan sen mukaan, minkä tyyppinen skeeman elementti on valittuna Laajennuspisteen elementit -osassa.

Sivun osat

Tämä sivu koostuu seuraavista osista:

Laajennuspisteen elementit -osa

Tässä osassa voit

Tätä osaa voi käyttää suoraan Skeeman määritys -lomakesivun kautta.

Laajennuspisteen elementit -osan kentät

Laajennuspisteen elementin katseluohjelman kentän avulla voit

Tässä katseluohjelmassa on seuraavat solmut:

Elementit:

Koosterakenteet:

Määritteet:

Esimerkki: Extension-elementti määrittää, että shortcut-elementtien järjestys on sallittu sen alielementteinä. Elementtiviitteen avulla kuvataan shortcut-elementtiä. Sequence-koosterakenteen avulla kuvataan elementtien järjestystä.

Laajennuspisteen elementit, osa 2

Esimerkki: shortcut-elementti määrittää, että joko description- tai category-elementti on sallittu sen alielementtinä. Elementtiviitteiden avulla kuvataan description- ja category-elementtejä. Choice-koosterakenteen avulla kuvataan elementtien valintaa.

Laajennuspisteen elementit, osa 1

Laajennuspisteen elementit -osan toiminnot

Voit lisätä uuden elementin yleisesittelyn laajennuspisteen skeeman kielioppiin napsauttamalla Lisää elementti -painiketta. Toiminto on käytettävissä, kun mikä tahansa solmu on valittuna. Huomautus: Elementtien esittelyjärjestys ei ole merkitsevää.

Voit lisätä uuden paikallisen määritteen esittelyn laajennuspisteen skeeman kieliopissa valittuun elementtiin napsauttamalla Lisää määrite -painiketta. Toiminto on käytettävissä kaikkien valittujen elementtien solmujen yhteydessä paitsi extension-elementin solmun yhteydessä. Extension-elementin solmun määritteet ovat aina samat: id, name ja point. Huomautus: Määritteiden esittelyjärjestys ei ole merkitsevää.

Voit poistaa skeeman objektin laajennuspisteen skeeman kieliopista napsauttamalla valittua solmua hiiren kakkospainikkeella ja valitsemalla vaihtoehdon Poista. Toiminto on käytettävissä kaikkien valittujen solmujen yhteydessä paitsi extension-elementin solmun yhteydessä. Extension-elementin solmu on muokatun skeeman kieliopin tulokohdan määritykseen käytettävä erityisjuurielementti muissa kuin jaetuissa skeemoissa. Lisäosan manifest-tiedoston muokkausohjelmassa määritettyjen laajennusten on määritettävä XML-kieleen liittyvät merkintänsä extension-pääelementin avulla.

Voit määrittää elementin alielementit muodostettaviksi laajennuspisteen skeeman kieliopin muiden elementtien järjestyksestä tai valinnasta seuraavasti:

  1. Valitse sen elementin solmu, jonka haluat määrittää pääelementiksi, ja napsauta sitä hiiren kakkospainikkeella.
  2. Määritä elementtien järjestys valitsemalla vaihtoehdot Uusi > Koosterakenne > Järjestys. Määritä elementtien valinta valitsemalla vaihtoehdot Uusi > Koosterakenne > Valinta.
  3. Valitse uuden koosterakenteen solmu ja napsauta sitä hiiren kakkospainikkeella.
  4. Valitse Uusi > Viittaus -alivalikosta elementti, jonka haluat määrittää pääelementin alielementiksi. Viittaus-alivalikkoon tulevat näkyviin kaikki laajennuspisteen skeeman kielioppiin yleisesti esitellyt elementit.
  5. Toista vaiheet 3 ja 4, jos haluat määrittää lisää alielementtejä. Sequence-koosterakenteen määritys on verrattavissa lisäelementtien määritykseen järjestykseen. Choice-koosterakenteen määritys on verrattavissa lisäelementtien valintojen määritykseen.

Huomautus: Määritettäessä elementtiä toisen elementin alielementiksi pääelementin on aina käytettävä välittävää Sequence- tai Choice-koosterakennetta. Koosterakenteen solmut ovat liitinsolmuja, kun taas elementtiviitteen solmut ovat lehtisolmuja. Näin ollen koosterakenteen solmujen tulee aina määrittää ainakin yksi elementtiviitteen solmu.

Huomautus: Sequence- ja Choice-koosterakenteita voi määrittää sisäkkäisiksi rajattomasti. Näin voi luoda monimutkaisempia kielioppeja.

Huomautus: Kielioppi ei saa sisältää itseen viittaavia kehäviittauksia. Yksinkertaisimmillaan kielletty kehäviittaus ilmenee, kun Elementti A edellyttää Elementtiä B alielementtinään ja Elementti B edellyttää Elementtiä A alielementtinään.

Jos haluat määrittää, että elementillä ei ole alielementtejä ja se sallii tekstin määrityksen alku- ja loppu-XML-tunnisteidensa sisään (merkkisisältö), jätä elementin rakenne sellaisekseen: älä lisää määritteitä, koosterakenteita tai elementtiviitteitä (elementtisisältö). Huomautus: Elementtiin ei voi määrittää sekamuotoista sisältöä (sekä merkki- että elementtisisältöä).

Kuvaus-osa

Tämän osan avulla voit toimittaa minkä tahansa muokattavan skeeman kieliopin sisäisen elementin, määritteen tai koosterakenteen lyhyen kuvauksen.

Tätä osaa voi käyttää suoraan Skeeman määritys -lomakesivun kautta.

Kuvaus-osa

Kuvaus-osan kentät

Kuvaus-tekstikenttää muokkaamalla voit toimittaa lyhyen kuvauksen Laajennuspisteen elementit -osassa valittuna olevaan nykyiseen elementtiin, määritteeseen tai koosterakenteeseen. Kentässä voi tarvittaessa käyttää kelvollisia HTML-merkintöjä.

Huomautus: Elementtiviitteen kuvauksen päivitys päivittää myös sen elementin yleisen esittelyn, johon elementtiviite viittaa, ja päinvastoin.

Elementin tiedot -osa

Tässä osassa voit muokata elementin ominaisuuksia. Elementtejä on kahta lajia: extension-elementit ja muut kuin extension-elementit. Extension-elementti on muokatun skeeman kieliopin tulokohdan määritykseen käytettävä erityisjuurielementin esittely. Muut kuin extension-elementit ovat yleisiä elementtien esittelyjä, joita käytetään muokatun skeeman kieliopissa rakenteen perusosina.

Osan voi aktivoida valitsemalla joko extension-elementin solmun tai muun kuin extension-elementin solmun Laajennuspisteen elementit -osassa.

Extension-elementin Elementin tiedot -osa.

Elementin tiedot, osa 1

Muun kuin extension-elementin Elementin tiedot -osa.

Elementin tiedot, osa 2

Elementin tiedot -osan kentät

Voit määrittää elementin nimen muokkaamalla Nimi-kenttää.

Osoita, onko elementti sisäinen, napsauttamalla joko tosi- tai epätosi-painiketta Sisäinen-kentässä. Lisäosan manifest-tiedoston muokkausohjelma merkitsee laajennuksen sisäiset XML-merkinnät varoitusmerkinnällä (oletusarvoisesti). Kenttä vastaa vietyjen pakettien x-internal-määritettä.

Osoita, onko elementti vanhentunut, napsauttamalla joko tosi- tai epätosi-painiketta Vanhentunut-kentässä. Lisäosan manifest-tiedoston muokkausohjelma merkitsee laajennuksen vanhentuneet XML-merkinnät varoitusmerkinnällä (oletusarvoisesti). Kenttä vastaa Javadoc-tunnistetta @deprecated.

Jos laajennuselementti merkitään vanhentuneeksi, määritä Korvaus-kentän avulla laajennuspiste, joka ei ole vanhentunut ja jota samat toiminnot haluavien käyttäjien tulee käyttää vanhentuneen elementin sijasta.

Määritä Lisäosan manifest-tiedoston muokkausohjelmassa elementin nimiönä käytettävä määritteen arvo valitsemalla jokin elementin määritetyistä määritteistä Nimiön ominaisuus -kentästä. Jos esimerkiksi valittuna on arvo, elementin solmun nimiö Lisäosan manifest-tiedoston muokkausohjelman Laajennukset-sivun Kaikki laajennukset -osassa on seuraava: valitun-määritteen-arvo (elementin-nimi). Muussa tapauksessa, jos arvoa ei ole valittuna, elementin solmun nimiö on seuraava: (elementin-nimi).

Voit määrittää kuvakeresurssin, jonka avulla elementin solmu kuvataan Lisäosan manifest-tiedoston muokkausohjelmassa, valitsemalla jonkin elementin määritetyistä resurssilajimääritteistä Kuvake-kentästä. Jotta elementin solmun kuvake näkyisi oikein Lisäosan manifest-tiedoston muokkausohjelman Laajennukset-sivun Kaikki laajennukset -osassa, seuraavien ehtojen on täytyttävä:

Osoita, onko elementin merkkisisältö käännettävä, napsauttamalla joko tosi- tai epätosi-painiketta Käännettävä-kentässä. Tämä kenttä on sovellettavissa vain elementteihin, joihin ei ole määritetty alielementtejä (elementtisisältöä) tai määritteitä ja jotka sallivat tekstin (merkkisisällön) määrityksen alku- ja loppu-XML-tunnisteidensa sisään. Jos elementin merkkisisältö on merkitty käännettäväksi, PDE-työkalujen avulla toimitetun laajennuksen XML-merkintäsisällön voi ulkoistaa ominaisuustiedostoon monikielisyyden tukea varten.

DTD-arvio-lukukentän avulla voit tarkastella elementin skeeman kieliopin arvioitua yhdeltä yhdelle -vastaavuusmääritystä vastaavan elementin DTD-kielioppiin. DTD (Document Type Definition, asiakirjalajin määritys) on XML-skeeman helppolukuisempi ja vähemmän tehokas vaihtoehto XML-asiakirjan muodollisen kieliopin määritykseen. DTD-arvio määritetään seuraavien huomautusten avulla:

Koosterakenteen tiedot -osa

Tässä osassa voit muokata koosterakenteen ominaisuuksia. Koosterakenteita on kahta lajia: sequence-koosterakenne ja choice-koosterakenne. Sequence-koosterakenteen avulla elementin alielementit voi määrittää muodostettaviksi muokattavan skeeman kieliopin muiden elementtien järjestyksestä. Choice-koosterakenteen avulla elementin alielementit voi määrittää muodostettaviksi muokattavan skeeman kieliopin muiden elementtien valinnasta.

Osan voi aktivoida valitsemalla joko Sequence-solmun tai Choice-solmun Laajennuspisteen elementit -osassa.

Koosterakenteen tiedot -osa

Koosterakenteen tiedot -osan kentät

Voit määrittää tämän muiden elementtien tai koosterakenteiden koosterakenteen esiintymien sallitun vähimmäismäärän lisätyn laajennuksen XML-merkinnöissä muokkaamalla Esiintymiä vähintään -kenttää. PDE-työkalut tarkistavat Lisäosan manifest-tiedoston muokkausohjelman monimuotoisuusrajoitteet tämän kentän avulla. Jos Elementti A edellyttää täsmälleen yhtä Elementtiä B tai Elementtiä C alielementtinään ja käyttää Choice-koosterakennetta, joka määrittää vähintään kaksi esiintymää, mitkä tahansa kaksi Elementin B ilmentymää sekä Elementti C on määritettävä lisätyn laajennuksen XML-merkintöihin, jotta ne olisivat kelvolliset.

Voit määrittää tämän muiden elementtien tai koosterakenteiden koosterakenteen esiintymien sallitun enimmäismäärän lisätyn laajennuksen XML-merkinnöissä muokkaamalla Esiintymiä enintään -kenttää. PDE-työkalut tarkistavat Lisäosan manifest-tiedoston muokkausohjelman monimuotoisuusrajoitteet tämän kentän avulla. Jos Elementti A edellyttää täsmälleen yhtä Elementtiä B tai Elementtiä C alielementtinään ja käyttää Choice-koosterakennetta, joka määrittää enintään kaksi esiintymää, enintään kaksi Elementin B ilmentymää sekä Elementti C voidaan määrittää lisätyn laajennuksen XML-merkintöihin, jotta ne olisivat kelvolliset.

Valitse Sitomaton-kenttä, jos haluat määrittää, että tämän koosterakenteen esiintymillä ei ole sallittua enimmäismäärää lisätyn laajennuksen XML-merkinnöissä.

Valitsemalla arvon Laji-kentästä voit määrittää, onko koosterakenne sequence- vai choice-koosterakenne.

DTD-arvio-lukukentän avulla voit tarkastella koosterakenteen skeeman kieliopin arvioitua yhdeltä yhdelle -vastaavuusmääritystä vastaavan koosterakenteen DTD-kielioppiin. DTD-arvion määritykseen käytettävät huomautukset on kuvattu tämän asiakirjan Elementin tiedot -osan kentät -otsikon alla.

Elementtiviitteen tiedot -osa

Tässä osassa voit muokata elementtiviitteen ominaisuuksia. Elementtiviite on viittaus muokatun skeeman kieliopin sisäiseen elementin yleiseen esittelyyn. Koosterakenteet käyttävät elementtiviitteitä elementtien yleisten esittelyjen kieliopin ydinosina.

Osan voi aktivoida valitsemalla elementtiviite-solmun Laajennuspisteen elementit -osassa.

Elementtiviitteen tiedot -osa

Elementtiviitteen tiedot -osan kentät

Voit määrittää tämän elementin esiintymien sallitun vähimmäismäärän lisätyn laajennuksen XML-merkinnöissä muokkaamalla Esiintymiä vähintään -kenttää. PDE-työkalut tarkistavat Lisäosan manifest-tiedoston muokkausohjelman monimuotoisuusrajoitteet tämän kentän avulla. Jos Elementti A määrittää vähintään kaksi esiintymää, kaksi Elementin A ilmentymää on määritettävä lisätyn laajennuksen XML-merkintöihin, jotta ne olisivat kelvolliset.

Voit määrittää tämän elementin esiintymien sallitun enimmäismäärän lisätyn laajennuksen XML-merkinnöissä muokkaamalla Esiintymiä enintään -kenttää. PDE-työkalut tarkistavat Lisäosan manifest-tiedoston muokkausohjelman monimuotoisuusrajoitteet tämän kentän avulla. Jos Elementti A määrittää enintään kaksi esiintymää, lisätyn laajennuksen XML-merkintöihin on määritettävä enintään kaksi Elementin A ilmentymää, jotta merkinnät olisivat kelvolliset.

Valitse Sitomaton-kenttä, jos haluat määrittää, että tämän elementin esiintymillä ei ole sallittua enimmäismäärää lisätyn laajennuksen XML-merkinnöissä.

DTD-arvio-lukukentän avulla voit tarkastella elementin skeeman kieliopin arvioitua yhdeltä yhdelle -vastaavuusmääritystä vastaavan elementin DTD-kielioppiin. DTD-arvion määritykseen käytettävät huomautukset on kuvattu tämän asiakirjan Elementin tiedot -osan kentät -otsikon alla.

Elementtiviitteen tiedot -osan toiminnot

Voit muokata sen yleisen elementin esittelyn ominaisuuksia, johon tämä paikallinen elementtiviite viittaa, napsauttamalla Viittaus-kentässä olevaa elementin-nimi-hyperlinkkiä. Kun toiminto on valmis, viitatun elementin solmu on valittuna Laajennuspisteen elementit -osassa ja vastaava Elementin tiedot -osa aktivoidaan.

Määritteen tiedot -osa

Tässä osassa voit muokata määritteen ominaisuuksia. Määritteiden avulla voi toimittaa lisätietoja elementeistä.

Osan voi aktivoida valitsemalla pakollinen määrite-, valinnainen määrite-, luokan määrite- tai resurssimäärite-solmun Laajennuspisteen elementit -osassa.

Luettelointirajoituksen määrittävän, lajia string olevan pakollisen määritteen Määritteen tiedot -osa.

Määritteen tiedot, osa 1

Oletusarvon määrittävän, lajia boolean olevan valinnaisen määritteen Määritteen tiedot -osa.

Määritteen tiedot, osa 2

Sellaisen luokan määritteen Määritteen tiedot -osa, joka osoittaa, että määritteen arvon kuvaaman luokan on laajennettava määritetty luokka ja / tai toteutettava määritetty rajapinta.

Määritteen tiedot, osa 3

Resurssimääritteen Määritteen tiedot -osa.

Määritteen tiedot, osa 4

Skeeman tunnistemääritteen käyttäminen

Laajennuspisteiden tekijät voivat määrittää muihin määritteisiin viittaavia määritteitä. Tätä varten laajennuspisteen määritteiden lajiksi asetetaan tunniste ja valitaan määrite, johon se viittaa. Esimerkki tästä on laajennuspiste org.eclipse.ui.handlers. Määrite commandId viittaa laajennuspisteessä org.eclipse.ui.commands määritettyihin komentoihin.

Skeeman tunnisteen käyttö

Käsittelytoimintoa laativat laajennuskehittäjät voivat tämän jälkeen valita haluamansa commandId-määritteen kaikista kelvollisista tunnisteista. Järjestelmä antaa varoituksen olemattomien tunnisteiden yhteydessä, jotta väärin kirjoitetuilta tunnisteilta vältyttäisiin.

Määritteen tiedot -osan kentät

Voit määrittää määritteen nimen muokkaamalla Nimi-kenttää.

Osoita, onko määrite vanhentunut, napsauttamalla joko tosi- tai epätosi-painiketta Vanhentunut-kentässä. Lisäosan manifest-tiedoston muokkausohjelma merkitsee laajennuksen vanhentuneet XML-merkinnät varoitusmerkinnällä (oletusarvoisesti). Kenttä vastaa Javadoc-tunnistetta @deprecated.

Valitsemalla arvon Käyttö-kentästä voit osoittaa, onko määrite määritettävä sen määrittävään elementtiin lisätyn laajennuksen XML-merkinnöissä. Käytettävissä on seuraavat valinnat:

Voit määrittää oletusarvon, jota käytetään määritteessä, kun sitä ei ole määritetty sen määrittävään elementtiin lisätyn laajennuksen XML-merkinnöissä, muokkaamalla Oletusarvo-kenttää. Kenttä on käytettävissä vain, jos oletus-arvo on valittuna Käyttö-kentässä.

Voit määrittää määritteen arvolajin valitsemalla arvon Laji-kentästä. Käytettävissä on seuraavat valinnat:

Osoita, onko määritteen arvo käännettävä, napsauttamalla joko tosi- tai epätosi-painiketta Käännettävä-kentässä. Kenttä on käytettävissä vain, jos string-arvo on valittuna Laji-kentässä. Jos määritteen arvo on merkitty käännettäväksi, PDE-työkalujen avulla toimitetun laajennuksen XML-merkinnöissä olevat arvot voi ulkoistaa ominaisuustiedostoon monikielisyyden tukea varten.

Rajoitukset-kentän avulla voit tarkastella sellaisten merkkijonoarvojen luetteloa, joita määrite on rajoitettu käyttämään omana arvonaan. Jos kenttä ei sisällä arvoja, määritteen arvolla ei ole rajoituksia. Kenttä on käytettävissä vain, jos string-arvo on valittuna Laji-kentässä. Huomautus: Toiminto toteutetaan käyttämällä luettelointirajoitusta muokatun skeeman kieliopin string-peruslajissa.

Muokkaamalla Laajennus-kenttää voit määrittää sellaisen kohdekäyttöympäristön luokkapolussa olevan luokan tarkennetun nimen (esimerkiksi org.eclipse.ui.part.EditorPart), joka on määritettävä määritteen arvoksi määritetyn luokan aliluokaksi. PDE-työkalut tarkistavat luokan määritteen arvon lisätyn laajennuksen XML-merkinnöissä ja varmistavat näin, että se laajentaa yliluokan. Kenttä on käytettävissä vain, jos java-arvo on valittuna Laji-kentässä.

Muokkaamalla Toteuttaa kohteen -kenttää voit määrittää sellaisen kohdekäyttöympäristön luokkapolussa olevan rajapinnan tarkennetun nimen (esimerkiksi org.eclipse.ui.IEditorPart), jonka määritteen arvoksi määritetyn luokan on toteutettava. PDE-työkalut tarkistavat luokan määritteen arvon lisätyn laajennuksen XML-merkinnöissä ja varmistavat näin, että se toteuttaa rajapinnan. Kenttä on käytettävissä vain, jos java-arvo on valittuna Laji-kentässä.

Määritteen tiedot -osan toiminnot

Napsauttamalla Lisää...-painiketta Rajoitukset-kentässä voit avata Uusi rajoitus -valintaikkunan ja lisätä määritteen arvoon uuden rajoituksen. Kun valintaikkunan tiedot ovat valmiit, uusi rajoitus lisätään niiden merkkijonoarvojen luetteloon, joita määrite on rajoitettu käyttämään omana arvonaan. Toiminto on käytettävissä vain, jos string-arvo on valittuna Laji-kentässä.

Jos haluat poistaa rajoituksen niiden merkkijonoarvojen luettelosta, joita määrite on rajoitettu käyttämään omana arvonaan, valitse merkkijonoarvo Rajoitukset-kentästä ja napsauta Poista-painiketta. Toiminto on käytettävissä vain, jos string-arvo on valittuna Laji-kentässä.

Jos Laajennus-kenttä viittaa kohdekäyttöympäristön luokkapolussa olevan luokan tarkennettuun nimeen, kyseisen luokan voi avata uudessa Java-lähdekoodin muokkausohjelmassa napsauttamalla Laajennus-hyperlinkkiä. Muussa tapauksessa Laajennus-hyperlinkkiä napsauttamalla voi avata ohjatun uuden Java-luokan luontitoiminnon, jonka avulla voi luoda uuden luokan. Toiminto on käytettävissä vain, jos java-arvo on valittuna Laji-kentässä.

Jos Toteuttaa kohteen -kenttä viittaa kohdekäyttöympäristön luokkapolussa olevan rajapinnan tarkennettuun nimeen, kyseisen rajapinnan voi avata uudessa Java-lähdekoodin muokkausohjelmassa napsauttamalla Toteuttaa kohteen -hyperlinkkiä. Muussa tapauksessa Toteuttaa kohteen -hyperlinkkiä napsauttamalla voi avata ohjatun uuden Java-luokan luontitoiminnon, jonka avulla voi luoda uuden rajapinnan. Toiminto on käytettävissä vain, jos java-arvo on valittuna Laji-kentässä.

Napsauttamalla Selaa...-painiketta voit avata Valitse laji -valintaikkunan ja valita kohdekäyttöympäristön luokkapolussa olevan aiemmin luodun luokan käytettäväksi Laajennus-kentän arvona. Toiminto on käytettävissä vain, jos java-arvo on valittuna Laji-kentässä.

Napsauttamalla Selaa...-painiketta voit avata Valitse laji -valintaikkunan ja valita kohdekäyttöympäristön luokkapolussa olevan aiemmin luodun rajapinnan käytettäväksi Toteuttaa kohteen -kentän arvona. Toiminto on käytettävissä vain, jos java-arvo on valittuna Laji-kentässä.

Aiheeseen liittyviä linkkejä