Skema - siden Definition

Om denne side

På denne formularside kan du redigere strukturen og egenskaberne for de skemaobjekter, der udgør det redigerede skemas grammatik.

Skemaobjekternes struktur kan redigeres i afsnittet Udvidelsespunktelementer. Afsnittet er placeret til venstre i den øverste del af editorområdet.

Skemaobjekternes egenskaber redigeres i afsnittene <skemaobjekt> Oplysninger. Disse afsnit aktiveres til højre i den øverste del af editorområdet, afhængigt af hvilken type skemaelement der er valgt i afsnittet Udvidelsespunktelementer.

Sideafsnit

Siden består af følgende afsnit:

Afsnittet Udvidelsespunktelementer

I afsnittet kan du gøre følgende:

Der er direkte adgang til afsnittet via formularsiden Skemadefinition.

Felter i afsnittet Udvidelsespunktelementer

Gør følgende i feltet for fremviseren af udvidelsespunkter:

Fremviseren indeholder følgende noder:

Elementer:

Compositorer:

Attributter:

Eksempel: Med et extension-element angives, at en sekvens på ét eller flere shortcut-elementer er tilladt som dets gyldige underordnede elementer. En elementreference bruges til at repræsentere shortcut-elementet. En sekvens-compositor bruges til at repræsentere en sekvens af elementer.

Udvidelsespunktelementer - afsnit 2

Eksempel: Med dette shortcut-element angives, at enten et description- eller category-element er tilladt som dets gyldige underordnede element. Elementreferencer bruges til at repræsentere description- og category-elementerne. En valg-compositor bruges til at repræsentere valg af elementer.

Udvidelsespunktelementer - afsnit 1

Funktioner i afsnittet Udvidelsespunktelementer

Klik på knappen Tilføj element for at tilføje en ny global elementerklæring til udvidelsespunktskemaets grammatik. Denne funktion er tilgængelig, når der er valgt en node. Bemærk: Rækkefølgen i elementerklæringer er ikke væsentlig.

Klik på knappen Tilføj attribut for at tilføje en ny lokal attributerklæring til et valgt element i udvidelsespunktskemaets grammatik. Funktionen er tilgængelig for alle valgte element-noder, undtagen noden extension-element. Denne extension-element-node har altid de samme attributter: id, name og point. Bemærk: Rækkefølgen i attributerklæringer er ikke væsentlig.

Hvis du vil slette et skemaobjekt fra udvidelsespunktskemas grammatik, skal du højreklikke på en valgt node og vælge Slet. Funktionen er tilgængelig for alle valgte noder, undtagen noden extension-element. For skemaer, der ikke er fælles, er denne extension-element-node det særlige rodelement, som bruges til at definere indgangspunktet for det redigerede skemas grammatik. Alle udvidelser, der defineres i editoren for plugin-manifest, skal bruge et overordnet extension-element til at angive deres XML-relaterede kode.

Gør følgende for at angive, at et elements underordnede elementer består af en sekvens eller et valg af andre elementer i udvidelsespunktskemaets grammatik:

  1. Vælg og højreklik på den element-node, du vil definere som det overordnede element.
  2. Vælg Ny > Compositor > Sekvens for at definere en sekvens af elementer. Vælg Ny > Compositor > Valg for at definere et valg af elementer.
  3. Vælg og højreklik på den nye compositor-node.
  4. Vælg det element fra undermenuen Ny > Reference, som du vil definere som underordnet i forhold til det overordnede element. Undermenuen Reference udfyldes med alle de elementer, der er globalt erklæret i udvidelsespunktskemaets grammatik.
  5. Gentag trin 3 og 4 for at angive flere underordnede elementer. Hvis der er angivet en sekvens-compositor, vil det dreje sig om at angive ekstra elementer i sekvensen. Hvis der er angivet en valg-compositor, vil det dreje sig om at angive ekstra elementvalg.

Bemærk: Når det skal angives, at et element er underordnet i forhold til et andet element, skal det overordnede element altid anvende en mellemliggende sekvens- eller valg-compositor. Compositor-noder er connector-noder, mens elementreference-noder er bladnoder. Derfor skal compositor-noder altid angive mindst én underordnet elementreference-node.

Bemærk: Sekvens- og valg-compositorer kan indlejres et vilkårligt antal gange, så der oprettes en mere kompleks grammatik.

Bemærk: Der må ikke være nogen selv-refererende cyklus i grammatikken. Den mest grundlæggende type forbudte cyklus opstår, når Element A kræver Element B som underordnet element, og Element B kræver Element A som underordnet element.

Hvis du vil angive, at et element ikke har nogen underordnede elementer, og at det er tilladt at angive tekst inden for XML-start- og -slutkoderne (tegnindhold), skal du simpelthen lade elementstrukturen være, som den er, ved ikke at tilføje nogen attributter, compositorer og elementreferencer til den (elementindhold). Bemærk: Et element kan ikke angive blandet tegn- og elementindhold.

Afsnittet Beskrivelse

I dette afsnit kan du give en kort beskrivelse af et element, en attribut eller compositor i det redigerede skemas grammatik.

Der er direkte adgang til afsnittet via formularsiden Skemadefinition.

Afsnittet Beskrivelse

Felter i afsnittet Beskrivelse

Redigér feltet med beskrivelsesteksten for at give en kort beskrivelse af den element-, attribut- eller compositor-node, der aktuelt er valgt i afsnittet Udvidelsespunktelementer. Der kan efter behov bruges gyldige HTML-koder i dette felt.

Bemærk: Når beskrivelsen af en elementreference opdateres, opdateres også beskrivelsen af den globale elementerklæring, som den refererer til - og omvendt..

Afsnittet Elementoplysninger

I dette afsnit kan du redigere egenskaberne for et element. Der er to slags elementer: udvidelseselementer og ikke-udvidelseselementer. Et udvidelseselement er den særlige rodelementerklæring, der bruges til at definere indgangspunktet for det redigerede skemas grammatik. Et ikke-udvidelseselement er en global elementerklæring, der bruges som en grundlæggende strukturel byggesten inden for det redigerede skemas grammatik.

Du kan aktivere dette afsnit ved at vælge enten en extension-element-node eller en non-extension-element-node i afsnittet Udvidelsespunktelementer.

Afsnittet Elementoplysninger for et extension-element.

Elementoplysninger - afsnit 1

Afsnittet Elementoplysninger for et non-extension-element.

Elementoplysninger - afsnit 2

Felter i afsnittet Elementoplysninger

Redigér feltet Navn for at angive elementets navn.

Klik enten på knappen true eller knappen false i feltet Intern for at angive, om elementet er internt eller ej. Som standard markeres alle interne XML-udvidelseskoder med en advarsel i editoren til plugin-manifest. Feltet er analogt med attributten x-internal på eksporterede pakker.

Klik enten på knappen true eller knappen false i feltet Forældet for at angive, om elementet er forældet eller ej. Som standard markeres alle forældede XML-udvidelseskoder med en advarsel i editoren for plugin-manifest. Dette felt svarer til Java-koden Javadoc @deprecated.

Hvis et udvidelseselement markeres som forældet, skal du redigere feltet Erstatning for at angive det ikke-forældede udvidelsespunkt, som brugeren i stedet for skal anvende for at opnå samme funktionalitet.

Vælg en af elementets definerede attributter fra feltet Etiketegenskab for at angive den attributværdi, der skal anvendes som elementets etiket i editoren for plugin-manifest. Hvis der f.eks. er valgt en værdi, vil elementets nodeetiket i afsnittet Alle udvidelser på siden Udvidelser i editoren for plugin-manifest se sådan ud: valgt-attributværdi (elementnavn). Hvis der ikke er valgt nogen værdi, vil elementets nodeetiket se sådan ud: (elementnavn).

Vælg en af elementets definerede ressourcetypeattributter fra feltet Ikon for at angive den ikonressource, der skal bruges til at repræsentere elementets node i editoren for plugin-manifest. Følgende betingelser skal overholdes, for at elementets nodeikon kan vises korrekt i afsnittet Alle udvidelser på siden Udvidelser i editoren for plugin-manifest:

Klik enten på knappen true eller knappen false i feltet Kan konverteres for at angive, om elementets tegnindhold kan konverteres eller ej. Dette felt gælder kun for elementer, der ikke har nogen underordnede elementer angivet (elementindhold) eller attributter, og som gør det muligt, at der angives tekst inden for deres XML-start- og -slutkoder (tegnindhold). Hvis et elements tegnindhold er markeret til at kunne konverteres, kan PDE-værktøjer anvendes på de leverede XML-udvidelseskoder for at eksternalisere indholdet ind i en egenskabsfil til understøttelse af flere sprog.

Brug det skrivebeskyttede felt DTD-tilnærmelse til at få vist en tilknytning vha. mapping af elementskemaets grammatik til det tilsvarende elements DTD-grammatik (tilnærmelsesvis en til en). En DTD (Document Type Definition) er et mere læsbart, mindre kraftfuldt alternativ til XML-skemaet til angivelse af et XML-dokuments formelle grammatik. DTD-tilnærmelsen angives vha. følgende notation:

Afsnittet Compositor-oplysninger

I dette afsnit kan du redigere egenskaberne for en compositor. Der er to typer compositorer: sekvens-compositor og valg-compositor. Men en sekvens-compositor kan du angive, at elementets underordnede elementer er sammensat af en sekvens af andre elementer i det redigerede skemas grammatik. Med en valg-compositor kan du angive, at elementets underordnede elementer er sammensat af et valg af andre elementer i det redigerede skemas grammatik.

Du kan aktivere dette afsnit ved at vælge enten en sekvens- eller valg-noden i afsnittet Udvidelsespunktelementer.

Afsnittet Compositor-oplysninger

Felter i afsnittet Compositor-oplysninger

Redigér feltet Min. forekomster for at angive det mindste antal forekomster af denne compositor (af andre elementer) og/eller compositorer, der må vises i den leverede XML-udvidelseskode. Værdien i feltet bruges af PDE til validering af mangfoldighedsbetingelser i editoren for plugin-manifest. Hvis Element A kræver præcist ét Element B eller Element C som sit underordnede element, og det bruger en valg-compositor, hvor der angives minimum to forekomster, så skal enhver dobbeltforekomst af Element B kombineret med Element C defineres i den leverede XML-udvidelseskode for at være gyldig.

Redigér feltet Maks. forekomster for at angive det maksimale antal forekomster af denne compositor (af andre elementer) og/eller compositorer, der må vises i den leverede XML-udvidelseskode. Værdien i feltet bruges af PDE til validering af mangfoldighedsbetingelser i editoren for plugin-manifest. Hvis Element A kræver præcist ét Element B eller Element C som sit underordnede element, og det bruger en valg-compositor, hvor der angives maksimalt to forekomster, så kan ikke mere end to forekomster af Element B kombineret med Element C defineres i den leverede XML-udvidelseskode for at være gyldig.

Afkryds feltet Ubundet for at angive, at der ikke er nogen betingelse for det maksimale antal tilladte forekomster af denne compositor i den leverede XML-udvidelseskode.

Vælg en værdi i feltet Type for at angive, om denne compositor er en sekvens- eller valg-compositor.

Brug det skrivebeskyttede felt DTD-tilnærmelse til at få vist en tilknytning vha. mapping af compositor-skemaets grammatik til den tilsvarende compositors DTD-grammatik (tilnærmelsesvis en til en). Den notation, der bruges ved angivelsen af DTD-tilnærmelsen, beskrives under overskriften Felter i afsnittet Elementoplysninger her i dokumentet.

Afsnittet Oplysninger om elementreference

I dette afsnit kan du redigere egenskaberne for en elementreference. En elementreference er en reference til en global elementerklæring i det redigerede skemas grammatik. Elementreferencer bruges af compositorer som atomiske byggesten til at definere grammatikken for globale elementerklæringer.

Du kan aktivere dette afsnit ved at vælge en elementreference-node i afsnittet Udvidelsespunktelementer.

Afsnittet Oplysninger om elementreference

Felter i afsnittet Oplysninger om elementreference

Redigér feltet Min. forekomster for at angive det mindste antal forekomster af dette element, der må vises i den leverede XML-udvidelseskode. Værdien i feltet bruges af PDE til validering af mangfoldighedsbetingelser i editoren for plugin-manifest. Hvis Element A angiver mindst to forekomster, skal der defineres to forekomster af Element A i den leverede XML-udvidelseskode, for at den kan være gyldig.

Redigér feltet Maks. forekomster for at angive det maksimale antal forekomster af dette element, der må vises i den leverede XML-udvidelseskode. Værdien i feltet bruges af PDE til validering af mangfoldighedsbetingelser i editoren for plugin-manifest. Hvis Element A angiver maksimalt to forekomster, kan der ikke defineres mere end to forekomster af Element A i den leverede XML-udvidelseskode, for at den kan forblive gyldig.

Afkryds feltet Ubundet for at angive, at der ikke er nogen betingelse for det maksimale antal tilladte forekomster af dette element i den leverede XML-udvidelseskode.

Brug det skrivebeskyttede felt DTD-tilnærmelse til at få vist en tilknytning vha. mapping af elementskemaets grammatik til det tilsvarende elements DTD-grammatik (tilnærmelsesvis en til en). Den notation, der bruges ved angivelsen af DTD-tilnærmelsen, beskrives under overskriften Felter i afsnittet Elementoplysninger her i dokumentet.

Funktioner i afsnittet Oplysninger om elementreference

Klik på hyperlinket elementnavn i feltet Reference for at redigere egenskaberne for den globale elementerklæring, som denne lokale elementreference refererer til. Når denne funktion er udført, vælges den element-node, der refereres til, i afsnittet Udvidelsespunktelementer, og det tilsvarende afsnit Elementoplysninger aktiveres.

Afsnittet Attributoplysninger

I dette afsnit kan du redigere egenskaberne for en attribut. Attributter bruges til at levere supplerende oplysninger om elementer.

Du kan aktivere dette afsnit ved at vælge enten en påkrævet attribut-, en valgfri attribut-, en klasseattribut- eller en ressourceattribut-node i afsnittet Udvidelsespunktelementer.

Afsnittet Attributoplysninger for en påkrævet attribut af typen string, som angiver en enumerationsbegrænsning.

Attributoplysninger - afsnit 1

Afsnittet Attributoplysninger for en valgfri attribut af typen boolean, der angiver en standardværdi.

Afsnittet Attributoplysninger - afsnit 2

Afsnittet Attributoplysninger for en klasseattribut, som angiver, at den klasse, der repræsenteres af attributværdien, skal udvide den angivne klasse og/eller implementere den angivne grænseflade.

Attributoplysninger - afsnit 3

Afsnittet Attributoplysninger for en ressourceattribut.

Attributoplysninger - afsnit 4

Brug af skema-id-attributten

Forfattere af udvidelsespunkter kan definere attributter, der refererer til andre attributter. Det opnår du ved at angive udvidelsespunktets attributter som type-id og vælge den attribut, den refererer til. Et eksempel er udvidelsespunktet org.eclipse.ui.handlers. Attributten commandId refererer til kommandoer, der er defineret i udvidelsespunktet org.eclipse.ui.commands.

Syntaks for skema-id

Udviklere af udvidelser, der bidrager med en behandler, kan derefter vælge værdien til attributten commandId blandt alle de gyldige id'er. Der afsendes advarsler for id'er, der ikke findes, for at undgå den almindelige fejl, der skyldes en forkert stavet id.

Felter i afsnittet Attributoplysninger

Redigér feltet Navn for at angive attributtens navn.

Klik enten på knappen true eller knappen false i feltet Forældet for at angive, om attributten er forældet eller ej. Som standard markeres alle forældede XML-udvidelseskoder med en advarsel i editoren for plugin-manifest. Dette felt svarer til Java-koden Javadoc @deprecated.

Vælg en værdi i feltet Brug for at angive, om attributten skal angives i det definerende element i den leverede XML-udvidelseskode. Der er følgende valgmuligheder:

Redigér feltet Standardværdi for at angive den standardværdi, der skal bruges til en attribut, når den ikke er angivet i det definerende element i den leverede XML-udvidelseskode. Feltet kan kun anvendes, når værdien default er valgt i feltet Brug.

Vælg en værdi i feltet Type for at angive attributværdiens type. Der er følgende valgmuligheder:

Klik enten på knappen true eller knappen false i feltet Kan konverteres for at angive, om attributtens værdi kan konverteres eller ej. Feltet kan kun anvendes, når værdien string er valgt i feltet Type. Hvis en attributs værdi er markeret til at kunne konverteres, kan PDE-værktøjer anvendes på de leverede XML-udvidelseskoder for at eksternalisere denne værdi ind i en egenskabsfil til understøttelse af flere sprog.

Brug feltet Begrænsninger til at få vist en liste over de strengværdier, som attributten er begrænset til at bruge som sin egen værdi. Hvis feltet ikke indeholder nogen værdier, er der ingen begrænsninger for attributværdien. Feltet kan kun anvendes, når værdien string er valgt i feltet Type. Bemærk: En enumerationsbegrænsning for basistypen string anvendes i det redigerede skemas grammatik for at opnå denne funktionalitet.

Redigér feltet Udvider for at angive et fuldstændigt klassenavn i målplatformens classpath (f.eks. org.eclipse.ui.part.EditorPart), hvor den klasse, der angives som attributværdien, skal være underklasse. PDE validerer klasseattributværdien i den leverede XML-udvidelseskode for at sikre, at den udvider superklassen. Feltet kan kun anvendes, når værdien java er valgt i feltet Type.

Redigér feltet Implementerer for at angive et fuldstændigt grænsefladenavn i målplatformens classpath (f.eks. org.eclipse.ui.IEditorPart), som skal implementeres af den klasse, der er angivet som attributværdien. PDE validerer klasseattributværdien i den leverede XML-udvidelseskode for at sikre, at den implementerer grænsefladen. Feltet kan kun anvendes, når værdien java er valgt i feltet Type.

Funktioner i afsnittet Attributoplysninger

Klik på knappen Tilføj... i feltet Begrænsning for at åbne dialogboksen Ny begrænsning for at tilføje en ny begrænsning til attributværdien. Når du har udfyldt dialogboksen, tilføjes den nye begrænsning til listen over de strengværdier, attributten er begrænset til at bruge som sin egen værdi. Funktionen kan kun anvendes, når værdien string er valgt i feltet Type.

Vælg en strengværdi i feltet Begrænsninger, og klik på knappen Fjern for at fjerne en begrænsning fra listen over de strengværdier, som attributten er begrænset til at bruge som sin egen værdi. Funktionen kan kun anvendes, når værdien string er valgt i feltet Type.

Hvis den værdi, der angives i feltet Udvider refererer til et fuldstændigt klassenavn i målplatformens classpath, åbnes den pågældende klasse i en ny Java-kildeeditor, når du klikker på hyperlinket Udvider. Hvis ikke, åbnes guiden Ny Java-klasse, hvor du kan oprette den nye klasse, når du klikke på hyperlinket Udvider. Funktionen kan kun anvendes, når værdien java er valgt i feltet Type.

Hvis den værdi, der angives i feltet Implementerer refererer til et fuldstændigt grænsefladenavn i målplatformens classpath, åbnes den pågældende grænseflade i en ny Java-kildeeditor, når du klikker på hyperlinket Implementerer. Hvis ikke, åbnes guiden Ny Java-klasse, hvor du kan oprette den nye grænseflade, når du klikke på hyperlinket Implementerer. Funktionen kan kun anvendes, når værdien java er valgt i feltet Type.

Klik på knappen Gennemse... for at åbne dialogboksen Vælg type for at vælge en eksisterende klasse i målplatformens classpath og bruge den som værdien i feltet Udvider. Funktionen kan kun anvendes, når værdien java er valgt i feltet Type.

Klik på knappen Gennemse... for at åbne dialogboksen Vælg type for at vælge en eksisterende grænseflade i målplatformens classpath og bruge den som værdien i feltet Implementerer. Funktionen kan kun anvendes, når værdien java er valgt i feltet Type.

Relevante link