Difference between revisions of "SL/EIS"

From Apache OpenOffice Wiki
Jump to: navigation, search
m (Pregled)
 
(20 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:Sistem EIS}}
 
{{DISPLAYTITLE:Sistem EIS}}
[[Category:Quality Assurance]][[Category: Development]][[Category: Specification]][[Category:CWSTooling]][[Category: Sl.openoffice.org]]
+
[[Category: SL]]
 
== Pregled ==
 
== Pregled ==
[http://eis.services.openoffice.org EIS (Environment Information System)] je sestavljen iz zbirke podatkov, ki hrani podatke o [[MWS | glavnih deloviščih (angl. MasterWorkspace, na kratko MWS)]] in [[CWS | otroških deloviščih (angl. ChildWorkspace, na kratko CWS)]], pa tudi druge reči, spletni vmesnik, ki ga uporabljajo vsi vpleteni v delo na [[CWS | CWS-jih]] (npr. [http://development.openoffice.org/ razvijalci], člani [http://qa.openoffice.org/ QA], pisci [http://documentation.openoffice.org/ dokumentacije], člani [[User_Experience_Community | ekipe za uporabniško izkušnjo]], odgovorni za [http://l10n.openoffice.org/#l10n lokalizacijo] in [http://l10n.openoffice.org/#i18n internacionalizacijo] itn.) ter vmesnik [http://en.wikipedia.org/wiki/SOAP SOAP] za kopico [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw orodij ukazne vrstice], ki jih uporabljajo razvijalci za ustvarjanje in vzdrževanje [[CWS | CWS-jev]].
+
[http://eis.services.openoffice.org EIS (Environment Information System)] je sestavljen iz zbirke podatkov, ki hrani podatke o [[MWS | glavnih deloviščih (angl. MasterWorkspace, na kratko MWS)]] in [[CWS | otroških deloviščih (angl. ChildWorkspace, na kratko CWS)]], pa tudi druge reči, spletni vmesnik, ki ga uporabljajo vsi vpleteni v delo na [[CWS | otroških deloviščih]] (npr. [http://development.openoffice.org/ razvijalci], člani [http://qa.openoffice.org/ QA], pisci [http://documentation.openoffice.org/ dokumentacije], člani [[User_Experience_Community | ekipe za uporabniško izkušnjo]], odgovorni za [http://l10n.openoffice.org/#l10n lokalizacijo] in [http://l10n.openoffice.org/#i18n internacionalizacijo] itn.) ter vmesnik [http://en.wikipedia.org/wiki/SOAP SOAP] za kopico [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw orodij ukazne vrstice], ki jih uporabljajo razvijalci za ustvarjanje in vzdrževanje [[CWS | otroških delovišč]].
  
 
V spletni vmesnik se lahko [http://eis.services.openoffice.org/EIS2/Logon prijavite] na naslovu [http://eis.services.openoffice.org http://eis.services.openoffice.org] s svojim e-poštnim naslovom OOo (vključno z @openoffice.org) in svojim geslom OOo. Tam je na voljo tudi [http://eis.services.openoffice.org/EIS2/GuestLogon anonimni dostop samo za branje].
 
V spletni vmesnik se lahko [http://eis.services.openoffice.org/EIS2/Logon prijavite] na naslovu [http://eis.services.openoffice.org http://eis.services.openoffice.org] s svojim e-poštnim naslovom OOo (vključno z @openoffice.org) in svojim geslom OOo. Tam je na voljo tudi [http://eis.services.openoffice.org/EIS2/GuestLogon anonimni dostop samo za branje].
  
[http://eis.services.openoffice.org EIS] je tudi potreben, če želite napisati e-sporočila [[feature announcement|objave funkcionalnosti (angl. feature announcement)]] ali [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowAPIChangesMails spremembah API-ja], s katerimi obveščate razvijalce, inženirje zagotavljanja kakovosti (QA, angl. Quality Assurance), sodelavce pri lokalizaciji (L10N) in dokumentaciji o spremembah v kodi paketa ali če želite [http://eis.services.openoffice.org/EIS2/guide.CheckSpecification preveriti] [http://specs.openoffice.org/ specifikacije].
+
[http://eis.services.openoffice.org EIS] je tudi potreben, če želite napisati e-sporočilo o [[feature announcement|objavi funkcionalnosti (angl. feature announcement)]] ali [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowAPIChangesMails spremembah API-ja], s katerimi obveščate razvijalce, inženirje zagotavljanja kakovosti (QA, angl. Quality Assurance), sodelavce pri lokalizaciji (L10N) in dokumentaciji o spremembah v kodi paketa ali če želite [http://eis.services.openoffice.org/EIS2/guide.CheckSpecification preveriti] [http://specs.openoffice.org/ specifikacije].
  
Poleg tega [http://eis.services.openoffice.org EIS] ponuja več [http://en.wikipedia.org/wiki/RSS_(file_format) virov RSS] z informacijami o [[CWS | otroških deloviščih (CWS)]] in [[MWS | glavnih deloviščih (MWS)]]. [http://eis.services.openoffice.org/EIS2/cws.rss.CWSAnnounceNewsFeed/mws Vir, ki informira o novih mejnikih na glavnih deloviščih] je npr. [http://en.wikipedia.org/wiki/Web_syndication sindiciran] na [http://go-oo.org/planet Planet OpenOffice.org]. Najdete jih lahko tudi na [http://eis.services.openoffice.org glavni strani EIS].
+
Poleg tega [http://eis.services.openoffice.org EIS] ponuja več [http://en.wikipedia.org/wiki/RSS_(file_format) virov RSS] z informacijami o [[CWS | otroških deloviščih]] in [[MWS | glavnih deloviščih]]. [http://eis.services.openoffice.org/EIS2/cws.rss.CWSAnnounceNewsFeed/mws Vir, ki informira o novih mejnikih na glavnih deloviščih] je npr. [http://en.wikipedia.org/wiki/Web_syndication sindiciran] na [http://go-oo.org/planet Planet OpenOffice.org]. Najdete jih lahko tudi na [http://eis.services.openoffice.org glavni strani EIS].
  
Rezultati gradenj [[tinderbox]] so bili v zadnjem času integrirani v spletno pročelje [http://eis.services.openoffice.org EIS].
+
Rezultati gradenj [[tinderbox|smodnišnice (angl. tinderbox)]] so bili v zadnjem času integrirani v spletno pročelje [http://eis.services.openoffice.org EIS].
  
 
== Ozadje in splošni podatki ==
 
== Ozadje in splošni podatki ==
 
Za razvoj [[OpenOffice.org]]/[[StarOffice]] uporabljamo [http://tools.openoffice.org/dev_docs/OOo_cws.html veje] v skladiščih izvorne kode (trenutno [http://en.wikipedia.org/wiki/Subversion_(software) SubVersion], prej [http://en.wikipedia.org/wiki/Concurrent_Versions_System CVS]), nabor [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw orodij ukazne vrstice] in orodje, imenovano  
 
Za razvoj [[OpenOffice.org]]/[[StarOffice]] uporabljamo [http://tools.openoffice.org/dev_docs/OOo_cws.html veje] v skladiščih izvorne kode (trenutno [http://en.wikipedia.org/wiki/Subversion_(software) SubVersion], prej [http://en.wikipedia.org/wiki/Concurrent_Versions_System CVS]), nabor [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw orodij ukazne vrstice] in orodje, imenovano  
[http://eis.services.openoffice.org EIS]. [http://eis.services.openoffice.org EIS] je akronim za Environment Information System in, mimogrede, nemška beseda za led. Zamisel za [[MWS | glavnimi delovišči (MasterWorkspace, na kratko MWS)]] in [[CWS | otroškimi delovišči (ChildWorkspace, na kratko CWS)]] je, da razvoj ne poteka na [[MWS|MWS-jih]]. Namesto tega je vse delo izvedeno na kopiji [[MWS]], to kopijo pa imenujemo [[CWS]]. Le če je [[CWS]] najmanj tako dober kot [[MWS]] (vsebovati ne sme nobenih regresij in novo vpeljane funkcionalnosti morajo biti popolnoma delujoče), bo [[Merging | spojen]] ([[Integration|integriran]]) nazaj v [[MWS]]. Idealno bi to pomenilo, da je [[MWS]] lahko izdan kadarkoli kot popolnoma delujoč drop. Vendar je to tako le v teoriji. Vseeno pa koncept [[MWS]]/[[CWS]] v veliki meri zmanjša število novih zadev/težav, vpeljanih v [[MWS]].
+
[http://eis.services.openoffice.org EIS]. [http://eis.services.openoffice.org EIS] je akronim za Environment Information System in, mimogrede, nemška beseda za led. Zamisel za [[MWS | glavnimi delovišči]] in [[CWS | otroškimi delovišči]] je, da razvoj ne poteka na [[MWS|glavnih deloviščih]]. Namesto tega je vse delo izvedeno na kopiji [[MWS|glavnega delovišča]], to kopijo pa imenujemo [[CWS|otroško delovišče]]. Le če je [[CWS|otroško delovišče]] najmanj tako dobro kot [[MWS|glavno delovišče]] (vsebovati ne sme nobenih regresij in novo vpeljane funkcionalnosti morajo biti popolnoma delujoče), bo [[Merging | spojen]] ([[Integration|integriran]]) nazaj v [[MWS|glavno delovišče]]. Idealno bi to pomenilo, da je [[MWS|glavno delovišče]] lahko izdano kadarkoli kot popolnoma delujoč drop. Vendar je to tako le v teoriji. Vseeno pa koncept [[MWS|glavnih]]/[[CWS|otroških]] delovišč v veliki meri zmanjša število novih zadev/težav, vpeljanih v [[MWS|glavno delovišče]].
  
[http://development.openoffice.org/releases/index.html Codelines za izdaje] uporabljajo različne [[ MWS | MWS-je]] in za minor izdaje je ponavadi uveden tudi nov [[MWS | MWS]], kar stabilizira kodo za to minor izdajo na ločeni veji.
+
[http://development.openoffice.org/releases/index.html Kodne veje (angl. codeline) za izdaje] uporabljajo različna [[ MWS | glavna delovišča]] in za minor izdaje je ponavadi uvedeno tudi novo [[MWS | glavno delovišče]], kar stabilizira kodo za to minor izdajo na ločeni veji.
  
Delo z [[CWS | CWS-ji]] in [[MWS | MWS-ji]] pomeni:
+
Delo z [[CWS | otroškimi]] in [[MWS | glavnimi]] delovišči pomeni:
 
* izvajati celotno razvijalsko delo na kopiji kode izdelka;
 
* izvajati celotno razvijalsko delo na kopiji kode izdelka;
 
* temeljito preizkusiti in preveriti razvito kodo pred ponovno integracijo v kodo izdelka;
 
* temeljito preizkusiti in preveriti razvito kodo pred ponovno integracijo v kodo izdelka;
 
* le povsem preizkušena izvorna koda se vključi v kodo izdelka, zato je manj regresijskih hroščev;
 
* le povsem preizkušena izvorna koda se vključi v kodo izdelka, zato je manj regresijskih hroščev;
* vsi [http://eis.services.openoffice.org/EIS2/cws.MilestoneData mejniki] na [[MWS | MasterWorkspace]] (koda izdelka) so potencialno v stanju možnosti izdaje;
+
* vsi [http://eis.services.openoffice.org/EIS2/cws.MilestoneData mejniki] na [[MWS | glavnih deloviščih]] (koda izdelka) so potencialno v stanju možnosti izdaje;
 
* hrošče pogosteje odkrijemo v času, ko jih uvedemo, in s strani tistih, ki jih uvedejo;
 
* hrošče pogosteje odkrijemo v času, ko jih uvedemo, in s strani tistih, ki jih uvedejo;
 
* ker je koda bolje preverjena in preizkušena pred integracijo v izdelek, ima razvijalec več svobode pri delu.
 
* ker je koda bolje preverjena in preizkušena pred integracijo v izdelek, ima razvijalec več svobode pri delu.
  
[[CWS | Otroška delovišča (CWS)]] imajo v [http://eis.services.openoffice.org EIS] stanje, ki odseva, kaj se trenutno na [[CWS | otroškem delovišču]] dogaja in ali je [[CWS]] že končal v kodi izdelka ali pa se [[CWS]] še razvija. Prihodnje stanje lahko nastavimo glede na trenutno stanje.
+
[[CWS | Otroška delovišča (CWS)]] imajo v [http://eis.services.openoffice.org EIS] stanje, ki odseva, kaj se trenutno na [[CWS | otroškem delovišču]] dogaja in ali je [[CWS|otroško delovišče]] že končalo v kodi izdelka ali pa se še razvija. Prihodnje stanje lahko nastavimo glede na trenutno stanje.
  
Obstaja nabor [[CWS_Policies|ChildWorkspace Policies]], ki ureja delo na [[CWS | otroškem delovišču]], npr. kako se zadeve v sistemu sledenja hroščev v OpenOffice.org issuezilla običajno dodeljujejo [[CWS | otroškim deloviščem]] in kako različni ljudje, vpleteni v življenjski ciklus [[CWS | CWS]] sodelujejo drug z drugim. [http://eis.services.openoffice.org EIS] pozna dve različni vrsti [[CWS | otroških delovišč]]: javni (public) [[CWS]] in notranji (internal) [[CWS]] podjetja [http://www.sun.com Sun]. Za notranje [[CWS]] podjetja [http://www.sun.com Sun] je prikazan le omejen nabor podatkov na [http://eis.services.openoffice.org http://eis.services.openoffice.org]. For example the description, which might contain internal information about a [http://www.sun.com Sun] customer, is not being shown. [http://www.sun.com Sun] internally there exists a different incarnation of the [http://eis.services.openoffice.org EIS] web-frontend which does show this information. Most [[CWS | ChildWorkspaces]] being worked on by [http://www.sun.com Sun] developers are public, only those few containing [[StarOffice]] only modules or features or those which do contain confidential information about a [http://www.sun.com Sun] customer are private [[CWS | ChildWorkspaces]].
+
Obstaja nabor [[CWS_Policies|politik otroških vozlišč]], ki ureja delo na [[CWS | otroškem delovišču]], npr. kako se zadeve v sistemu sledenja hroščev v issuezilli OpenOffice.org običajno dodeljujejo [[CWS | otroškim deloviščem]] in kako različni ljudje, vpleteni v življenjski ciklus [[CWS | otroškega delovišča]], sodelujejo drug z drugim. [http://eis.services.openoffice.org EIS] pozna dve različni vrsti [[CWS | otroških delovišč]]: javno (angl. public) in interno (angl. internal) [[CWS|otroško delovišče]] [http://www.sun.com podjetja Sun]. Za notranje [[CWS|otroško delovišče]] [http://www.sun.com podjetja Sun] je prikazan le omejen nabor podatkov na [http://eis.services.openoffice.org http://eis.services.openoffice.org]. Tako npr. opis, ki lahko vsebuje notranje podatke o stranki [http://www.sun.com podjetja Sun], ni prikazan. V [http://www.sun.com podjetju Sun] interno obstaja drugačna inkarnacija spletnega portala [http://eis.services.openoffice.org EIS], ki te podatke prikaže. Večina [[CWS | otroških delovišč]], na katerih delajo razvijalci [http://www.sun.com podjetja Sun], so javna, le nekaj njih, ki vsebujejo izključne module ali funkcionalnosti [[StarOffice]] ali tisti, ki vsebujejo zaupne podatke o strankah [http://www.sun.com podjetja Sun], so zasebna [[CWS | otroška delovišča]].
[[CWS | ChildWorkspaces]] always have an "Owner" and a "QA representative" which usually should be two distinct persons ;-). Other types of information kept in [http://eis.services.openoffice.org EIS] are for example relevant source code modules, feature and/or bug-fix issues being worked on in the [[CWS]], the release for which the [[CWS]] is planned to be integrated and flags to indicated wether changes on that [[CWS]] are relevant for Documentation and Translation. [http://eis.services.openoffice.org EIS] also offers some statistics about [[CWS | ChildWorkspaces]]. Some fields in the Edit page for a [[CWS]] are required to be set at least when the status is changed to '''ready for QA''' and you will not be able to change to that state without setting those also. Besides the "Owner" and the "QA representative" EIS also provides the role of a "Member" of a ChildWorkspace. Members can be added on the [[CWS]] edit page. All [[CWS]] where you are either "Owner", "QA representative" or "Member" are shown on list provided by the ChildWorkspaces/MyCWS list. The "''ChildWorkspaces/Browse''" submenu provides some treeviews to show [[CWS | ChildWorkspaces]] in the database using different selection criterias. Which entries in this treeviews are shown is limited by a setting. The default is to show only [[CWS]] of the last 6 month. This can be changed by using the Settings link in the right corner and than using the CWS tab page where you will find a field "months displayed in treeviews" which can be set to a new value.
+
[[CWS | Otroško delovišče]] ima vedno "lastnika" (angl. "Owner") in "predstavnika QA" (angl. "QA representative"), ki morata biti praviloma različni osebi ;-). Druge vrste informacij, ki jih hrani [http://eis.services.openoffice.org EIS], so npr. ustrezni moduli izvorne kode, zadeve novih funkcionalnosti in/ali popravkov, ki se obdelujejo v [[CWS|otroškem delovišču]], izdaja, za katero je načrtovana vključitev [[CWS|otroškega delovišča]], in zastavice, ki nakazujejo, če so spremembe v tem [[CWS|otroškem delovišču]] relevantne za dokumentacijo in prevajanje. [http://eis.services.openoffice.org EIS] ponuja tudi nekaj statističnih podatkov o [[CWS | otroških deloviščih]]. Nekatera polja na strani Edit za [[CWS]] je potrebno nastaviti najmanj takrat, ko je stanje spremenjeno na '''ready for QA''' ('''pripravljeno za QA''') in v to stanje ne boste mogli spremeniti, ne da bi spremenili tudi njih. Poleg "lastnika" in "predstavnika za QA" EIS ponuja tudi vlogo "člana" (angl. "Member") otroškega delovišča. Člane lahko dodate na strani urejanja [[CWS|otroškega delovišča]]. Vsa [[CWS|otroška delovišča]], pri katerih ste "lastnik", "predstavnik za QA" ali "član", so prikazane na seznamu, ki ga ponuja seznam ChildWorkspaces/MyCWS. Podmeni "''ChildWorkspaces/Browse''" ponuja nekaj drevesnih pogledov, ki prikazujejo [[CWS | otroška delovišča]] v zbirki podatkov, glede na različne kriterije izbora. Prikaz v teh drevesnih pogledih omejujejo nastavitve. Privzeto so prikazana le [[CWS|otroška delovišča]] zadnjega pol leta. To lahko spremenite prek povezave Settings v desnem kotu in nato na zavihku CWS, kjer poiščete polje "months displayed in treeviews", ki ga lahko nastavite na novo vrednost.
  
  
Additionally to the handling of [[CWS | ChildWorkspaces]] and [[MWS | MasterWorkspaces]] another feature of [http://eis.services.openoffice.org EIS] is the handling of [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowAPIChangesMails API Changes] and [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowFeatureMails Feature Announcements], which are entered into [http://eis.services.openoffice.org EIS] by developers and than mailed to [http://www.openoffice.org/mail_list.html OpenOffice.org mailing lists] and stored in the [http://eis.services.openoffice.org EIS] database. [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowAPIChangesMails API Changes] inform other developers about code changes which might be relevant to them and [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowFeatureMails Feature Announcements] as well as [http://specs.openoffice.org/ Specifications] are essential for those working on documentation or QA. [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowFeatureMails Feature Announcements] and [http://specs.openoffice.org/ Specifications] are also used for semi-automated Release Notes creation and are thus important for informing everyone about changes in new releases, see [http://development.openoffice.org/releases/2.0.4rc3.html OpenOffice.org 2.0.4 Release Notes] for example. [http://specs.openoffice.org/ Specifications] must be created using a [http://specs.openoffice.org/collaterals/template/OpenOffice-org-Specification-Template.ott standard template] and [http://eis.services.openoffice.org EIS] can [http://eis.services.openoffice.org/EIS2/guide.CheckSpecification check] wether documents can be used for the Release Notes creation process or break that process because they do contain changes that make the document unusable for the [http://www.w3.org/TR/xslt XSLT] being used for that or because they are not based on the correct template.
+
Poleg obravnave [[CWS | otroških delovišč]] in [[MWS | glavnih delovišč]] je druga uporabnost [http://eis.services.openoffice.org EIS] obravnava [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowAPIChangesMails sprememb API-ja] in [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowFeatureMails obvestila o funkcionalnostih], ki jih v [http://eis.services.openoffice.org EIS] razvijalci in nato razpošljejo na [http://www.openoffice.org/mail_list.html dopisne sezname OpenOffice.org] in shranijo v zbirko podatkov [http://eis.services.openoffice.org EIS]. [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowAPIChangesMails Spremembe API-ja (angl. API Changes)] obveščajo druge razvijalce o spremembah kode, ki so lahko zanje relevantne, in [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowFeatureMails obvestila o funkcionalnostih (angl. Feature announcements)] kot tudi [http://specs.openoffice.org/ specifikacije] so ključne za vse, ki delujejo na področju dokumentacije ali zagotavljanja kakovosti (QA). [http://eis.services.openoffice.org/EIS2/servlet/changesmails.ShowFeatureMails Obvestila o funkcionalnostih] in [http://specs.openoffice.org/ specifikacije] se uporabijo tudi za pol-samodejno izdelane Opombe ob izdaji in so zato pomembne za obveščanje vseh o spremembah v novih izdajah, za primer si oglejte [http://development.openoffice.org/releases/2.0.4rc3.html Opombe ob izdaji OpenOffice.org 2.0.4 (angl.)]. [http://specs.openoffice.org/ Specifikacije] je potrebno izdelati z uporabo [http://specs.openoffice.org/collaterals/template/OpenOffice-org-Specification-Template.ott standardne predloge] in [http://eis.services.openoffice.org EIS] lahko [http://eis.services.openoffice.org/EIS2/guide.CheckSpecification preveri], ali lahko dokumente uporabite za proces izdelave Opomb ob izdaji ali pa morda dokumenti prelomijo ta proces, ker vsebujejo spremembe, ki naredijo dokument neuporaben za [http://www.w3.org/TR/xslt XSLT], ki se v tem procesu uporabi, ali ker ne temeljijo na pravi predlogi.
  
 
== Seznam stanj, ki jih uporablja [http://eis.services.openoffice.org EIS] ==
 
== Seznam stanj, ki jih uporablja [http://eis.services.openoffice.org EIS] ==
  
# '''planned''' ('načrtovan'): [[CWS]] v tem stanju je načrtovan, vendar dejansko še ne obstaja. Tako ni bil spremenjen noben del kode, niti še ni odločeno, iz katerega mejnika bo ustvarjen CWS. To stanje je uporabno predvsem za dolgoročno načrtovanje, aquisition virov itn.
+
# '''planned''' ('''načrtovano'''): [[CWS|Otroško delovišče]] v tem stanju je načrtovano, vendar dejansko še ne obstaja. Tako ni bil spremenjen noben del kode, niti še ni odločeno, iz katerega mejnika bo ustvarjeno otroško delovišče. To stanje je uporabno predvsem za dolgoročno načrtovanje, zagotavljanje virov itn.
# '''new''' ('nov'): [[CWS]] v tem stanju je bil ustvarjen, they do have a physical representation somewhere and development is currently working on it. The '''cwscreate''' [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw commandline tool] is used to create directory for source code of a new [[CWS | ChildWorkspace]]. If a [[CWS | ChildWorkspace]] with state '''planned''' and the name given as argument to '''cwscreate''' already exists this one is propagated to state '''new''' in [http://eis.services.openoffice.org EIS] otherwise a new entry is created in [http://eis.services.openoffice.org EIS]. If you create a [[CWS | ChildWorkspace]] using '''cwscreate''' please use the [http://eis.services.openoffice.org web frontend] afterwards and add as much additional information as possible.
+
# '''new''' ('''novo'''): [[CWS|Otroško delovišče]] v tem stanju je bilo ustvarjeno, zdaj fizično obstaja in razvoj na njem je trenutno v teku. [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw Orodje ukazne vrstice] '''cwscreate''' se uporabi za ustvarjanje mape za izvorno kodo novega [[CWS | otroškega delovišča]]. Če [[CWS | otroško delovišče]] v stanju '''planned''' in ime, podano kot parameter ukazu '''cwscreate''' že obstaja, je povzdignjeno v stanje '''new''' v [http://eis.services.openoffice.org EIS], sicer je ustvarjen nov vnos v [http://eis.services.openoffice.org EIS]. Če ustvarite [[CWS | otroško delovišče]] z ukazom '''cwscreate''', zatem uporabite [http://eis.services.openoffice.org spletni vmesnik] in dodajte kar se da veliko dodatnih informacij.
# '''ready for qa''': The developers think they are ready. They have prepared installation sets and hand the [[CWS]] over to QA by changing to this state. Depending on how the [[CWS]] handling for the [[MWS | MasterWorkspace]] is configured QA can now either set the state to '''nominated''' or '''approved by QA''' if QA accepts the changes on the [[CWS | ChildWorkspace]]. If changes on the [[CWS]] are note accepted QA sets the state back to '''new'''.
+
# '''ready for qa''' ('''pripravljeno za QA'''): Razvijalci menijo, da so končali z delom. S to spremembo stanja so pripravili namestitvene pakete in predali [[CWS|otroško delovišče]] v QA. Odvisno od tega, kako je obravnava [[CWS|otroškega delovišča]] nastavljena v [[MWS | glavnem delovišču]], lahko QA zdaj nastavi stanje na '''nominated''' ali '''approved by QA''', če QA sprejme spremembe v [[CWS | otroškem delovišču]]. Če spremembe v [[CWS|otroškem delovišču]] niso sprejete, QA nastavi stanje nazaj na '''new'''.
# '''approved by QA''': This is a special intermediate state used when a more controlled approach is active for the [[MWS | MasterWorkspace]] the [[CWS]] was created on. In this case QA approves a [[CWS]] but program management has the final say if and when something goes into the [[MWS | MasterWorkspace]]. That is program management will set the state to '''nominated''' after QA has set this state.
+
# '''approved by QA''' ('''odobreno s strani QA'''): To je posebno vmesno stanje, ko je za [[MWS | glavno delovišče]], v katerem je bilo ustvarjeno [[CWS|otroško delovišče]], uporabljamo bolj nadzorovan pristop. V takšnem primeru QA odobri [[CWS|otroško delovišče]], vendar ima zadnjo besedo, če in kdaj kaj vstopi v [[MWS | glavno delovišče]], programska uprava. To pomeni, da programska uprava nastavi stanje na '''nominated''', potem ko je QA nastavilo to stanje.
# '''nominated''': The [[CWS]] is being handed over to Release Engineering which can now start to integrate the [[CWS]] into the [[MWS |MasterWorkspace]]
+
# '''nominated''' ('''nominirano'''): [[CWS|Otroško delovišče]] je predano Release Engineering, ki lahko zdaj začne z njegovo integracijo v [[MWS |glavno delovišče]].
# '''integrated''': all work on the [[CWS]] is finished and the changes on the [[CWS | ChildWorkspace]] have been integrated into the [[MWS | MasterWorkspace]].
+
# '''integrated''' ('''integrirano'''): Celotno delo na [[CWS|otroškem delovišču]] je dokončano in spremembe iz [[CWS | otroškega delovišča]] so bile vključene v [[MWS | glavno delovišče]].
# '''canceled''': A canceled [[CWS]] has been abandoned, no more work will be done on it. This state is for [[CWS]] which where once in state '''new''' but are not needed anymore.
+
# '''canceled''' ('''preklicano'''): Preklicano [[CWS|otroško delovišče]] je bilo opuščeno, v njem se delo ne bo več nadaljevalo. To stanje je za [[CWS|otroška delovišča]], ki so bila prej v stanju '''new''', vendar niso več potrebna.
# '''deleted''': similar to '''canceled''' this is for [[CWS]] which are not needed any more. The difference is that the '''deleted''' state can only be set for '''planned''' [[CWS]] which never made it to being actually physically created and thus to the state '''new'''.
+
# '''deleted''' ('''izbrisano'''): Podobno kot '''canceled''' - to stanje je za [[CWS|otroška delovišča]], ki niso več potrebna. Razlika je, da lahko stanje '''deleted''' nastavimo le za '''planned''' [[CWS|otroška delovišča]], ki nikoli niso prišla do dejanske fizične manifestacije in s tem do stanja '''new'''.
# '''fixed on master''': this is used to reflect changes in [http://eis.services.openoffice.org EIS] done by Release Engineering directly on the Master usually to fix a very special urgent problem or a merge conflict. [[CWS]] in this state are not really existing physically these are just entries in [http://eis.services.openoffice.org EIS] keeping information about changes done directly on the source code repository branch of the [[MWS | MasterWorkspace]].  
+
# '''fixed on master''' ('''popravljeno na glavnem'''): Uporabljamo za odsev sprememb v [http://eis.services.openoffice.org EIS], ki jih Release Engineering opravi neposredno na glavnem delovišču, običajno gre za popravek zelo posebne, urgentne težave ali spor pri spajanju. [[CWS|Otroško delovišče]] v tem stanju dejansko ne obstajajo, to so le vnosi v [http://eis.services.openoffice.org EIS], ki hranijo informacije o spremembah, neposredno opravljenih v skladiščni veji izvorne kode za [[MWS | glavno delovišče]].  
# '''finished''': This is a special state used for Special-Product-Release [[CWS | ChildWorkspaces]] which will never get integrated into a [[MWS | MasterWorkspace]] but represent a Special Release Version, eg. some version done for a single customer with a change that will never get into the [[MWS | MasterWorkspace]].
+
# '''finished''' ('''dokončano'''): To je posebno stanje, ki ga uporabljamo za [[CWS | otroška delovišča]] posebnih izdaj izdelka, ki nikoli ne bodo integrirana v [[MWS | glavno delovišče]], vendar predstavljajo posebno različico izdelka (angl. Special Release Version), npr. neko različico, izdelano le za posebno stranko s spremembami, ki ne bodo nikoli vključene v [[MWS | glavno delovišče]].
# '''pre-nominated for PP''': a historic state used for special Product Patch [[CWS]] handling, no longer used.
+
# '''pre-nominated for PP''' ('''pred-nominirano za popravek programa'''): zgodovinsko stanje, uporabljeno za obravnavo posebnih [[CWS|otroških delovišč]] produktnih popravkov (angl. Product Patch), ni več v uporabi.
# '''cloned''': There are times when changes for a [[MWS | MasterWorkspace]] created to stabalize a minor release must also be integrated into a [[MWS | MasterWorkspace]] for the current main release trunk or vice versa. In this case [[CWS | ChildWorkspaces]] are being cloned. Eg. there can be a [[CWS | ChildWorkspace]] xyz created on the [[MWS | MasterWorkspace]] SRC680 and to integrate the same changes also into the OOE680 [[MWS | MasterWorkspace]] a clone xyz_OOE680 will be created. Release Engineering has a special commandline tool to create such clones.
+
# '''cloned''' ('''klonirano'''): Zgodi se, da je potrebno spremembe [[MWS | glavnega delovišča]], ustvarjene za stabilizacijo minor izdaje, prav tako integrirati v [[MWS | glavno delovišče]] za trenutno glavno deblo izdaje ali obratno. V tem primeru kloniramo [[CWS | otroška delovišča]]. Npr. obstaja lahko [[CWS | otroško delovišče]] xyz, ustvarjeno na [[MWS | glavnem delovišču]] SRC680, in če želimo integrirati enake spremembe tudi v [[MWS | glavno delovišče]] OOE680, bo ustvarjen klon xyz_OOE680. Release Engineering ima posebno orodje ukazne vrstice, ki ustvari tovrstne klone.
  
 
== Vstopne točke EIS ==
 
== Vstopne točke EIS ==
The main webpage for [http://eis.services.openoffice.org EIS] is [http://eis.services.openoffice.org http://eis.services.openoffice.org]. There you can find a link to [http://eis.services.openoffice.org EIS] [http://eis.services.openoffice.org/EIS2/Logon logon] where you must use your OpenOffice.org email address as username. There is also an [http://eis.services.openoffice.org/EIS2/GuestLogon anonymous guest logon link] on this page for those who do not have an [http://www.openoffice.org/servlets/Join OpenOffice.org account] and the [http://en.wikipedia.org/wiki/RSS_(file_format) RSS feeds] [http://eis.services.openoffice.org EIS] provides can also be found on that page. Besides,  the "[http://eis.services.openoffice.org/EIS2/cws.InfoForTask Find] a ChildWorkspace (CWS) name for a given IssueTracker issue ID", "[http://eis.services.openoffice.org/EIS2/wsm.FixedTasks List] integrated issues within the most current master build" and "[http://eis.services.openoffice.org/EIS2/wsm.FixedTasksExplorer Show] treeview of all integrated master builds" features on [ http://qa.openoffice.org/issuelinks.html http://qa.openoffice.org/issuelinks.html] are also features provided by EIS. At http://specs.openoffice.org there is a Specification Checking Tool link, which is also a feature offered by [http://eis.services.openoffice.org EIS]. You may find direct links to [[CWS | ChildWorkspace]]information in some [http://en.wikipedia.org/wiki/RSS_(file_format) RSS feeds] and webpages like [http://go-oo.org/planet Planet OpenOffice.org] or in some documentation on [http://www.openoffice.org http://www.openoffice.org]. If you need to create such a direct link to [[CWS | ChildWorkspace]] information on some webpage yourself you can use something like the following:
+
Glavni spletni naslov za [http://eis.services.openoffice.org EIS] je [http://eis.services.openoffice.org http://eis.services.openoffice.org]. Tam lahko najdete povezavo do [http://eis.services.openoffice.org EIS] [http://eis.services.openoffice.org/EIS2/Logon prijave], kjer morate uporabiti svoj e-poštni naslov OpenOffice.org kot uporabniško ime. Na tej strani je tudi [http://eis.services.openoffice.org/EIS2/GuestLogon povezava za prijavo anonimnega gosta] za tiste, ki nimajo [http://www.openoffice.org/servlets/Join računa OpenOffice.org], in [http://en.wikipedia.org/wiki/RSS_(file_format) vire RSS], ki jih ponuja [http://eis.services.openoffice.org EIS], tudi najdete na tej strani. Poleg tega so možnosti "[http://eis.services.openoffice.org/EIS2/cws.InfoForTask Find] a ChildWorkspace (CWS) name for a given IssueTracker issue ID", "[http://eis.services.openoffice.org/EIS2/wsm.FixedTasks List] integrated issues within the most current master build" in "[http://eis.services.openoffice.org/EIS2/wsm.FixedTasksExplorer Show] treeview of all integrated master builds" na [ http://qa.openoffice.org/issuelinks.html http://qa.openoffice.org/issuelinks.html] prav tako funkcionalnosti, ki jih ponuja EIS. Na http://specs.openoffice.org se nahaja povezava Specification Checking Tool, ki je tudi funkcionalnost [http://eis.services.openoffice.org EIS]. Neposredne povezave k podatkom o [[CWS | otroških deloviščih]] najdete v nekaterih [http://en.wikipedia.org/wiki/RSS_(file_format) virih RSS] in spletnih straneh, kot je [http://go-oo.org/planet Planet OpenOffice.org] ali v dokumentaciji na [http://www.openoffice.org http://www.openoffice.org]. Če želite ustvariti takšno neposredno povezavo na podatke o [[CWS | otroškem delovišču]] na neki spletni strani, lahko uporabite naslednje:
  
 
[http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fcwsqueryenhance http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fcwsqueryenhance ]
 
[http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fcwsqueryenhance http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fcwsqueryenhance ]
  
where 'cwsqueryenhance' is the name of the [[CWS | ChildWorkspace]] and 'SRC680' is the [[MWS |MasterWorkspace]] it was created on without milestone information. The general formular for such URLs is
+
kjer je 'cwsqueryenhance' ime [[CWS | otroškega delovišča]] in 'SRC680' je [[MWS |glavno delovišče]], v katerem je bilo ustvarjeno, brez informacije o mejniku. Splošen obrazec za takšen URL je:
  
http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=<MasterWorkspace>%2F<ChildWorkspace>
+
http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=<glavnodelovišče>%2F<otroškodelovišče>
  
Such links and also the features on the [http://qa.openoffice.org/issuelinks.html QA issuelinks page] and the [http://eis.services.openoffice.org/EIS2/guide.CheckSpecification Specification Checking Tool] can be used without [http://eis.services.openoffice.org/EIS2/Logon logon].
+
Takšne povezave in tudi funkcionalnosti na [http://qa.openoffice.org/issuelinks.html QA issuelinks page] in [http://eis.services.openoffice.org/EIS2/guide.CheckSpecification Specification Checking Tool] lahko uporabljate brez [http://eis.services.openoffice.org/EIS2/Logon prijave].
The [http://en.wikipedia.org/wiki/SOAP SOAP] interface of [http://eis.services.openoffice.org EIS] is at [https://eis.services.openoffice.org/soap/servlet/rpcrouter https://eis.services.openoffice.org/soap/servlet/rpcrouter]. The [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw CWS commandline tools] authenticate there using [http://en.wikipedia.org/wiki/Concurrent_Versions_System CVS] username and crypted [http://en.wikipedia.org/wiki/Concurrent_Versions_System CVS] password. This must be configured in a .cwsrc file, details about this .cwsrc file can be found on the [[CWS]] Wiki entry. The [http://en.wikipedia.org/wiki/SOAP SOAP] interface is currently not yet documented, but with [http://tools.openoffice.org/source/browse/tools/solenv/bin/modules/Cws.pm CWS.pm] there is a [http://en.wikipedia.org/wiki/Perl perl] module for using it available in the OpenOffice.org source code.
+
Vmesnik [http://en.wikipedia.org/wiki/SOAP SOAP] spletišča [http://eis.services.openoffice.org EIS] se nahaja na naslovu [https://eis.services.openoffice.org/soap/servlet/rpcrouter https://eis.services.openoffice.org/soap/servlet/rpcrouter]. [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw Orodja ukazne vrstice za otroška delovišča] se tam overijo z uporabniškim imenom [http://en.wikipedia.org/wiki/Concurrent_Versions_System CVS] in šifriranim geslom [http://en.wikipedia.org/wiki/Concurrent_Versions_System CVS]. Slednje mora biti prilagojeno v datoteki .cwsrc, podrobnosti o tej datoteki .cwsrc lahko najdete v wiki-vnosu [[CWS|otroško delovišče (angl.)]]. Vmesnik [http://en.wikipedia.org/wiki/SOAP SOAP] trenutno še ni dokumentirano, vendar z [http://tools.openoffice.org/source/browse/tools/solenv/bin/modules/Cws.pm CWS.pm] je za uporabno na voljo modul [http://en.wikipedia.org/wiki/Perl perl] v izvorni kodi OpenOffice.org.
  
 
== Triki in namigi ==
 
== Triki in namigi ==
* You can change the menu to being displayed at the left side instead of on top via using the Settings link in the right corner and than using the Menu-Style radio buttons on the "Frames" tab page.
+
* Spremenite lahko, da se meni prikaže na levi strani namesto na vrhu, in sicer prek povezave Settings v desnem kotu in nato uporabite izbirni gumb v slogu menijev na zavihku "Frames".
* If you are a member of QA and you want to find [[CWS | ChildWorkspaces]] which do not yet have a QA representative use the "''ChildWorkspaces / Seek QA''" menu entry.  
+
* Če ste član QA in želite najti [[CWS | otroško delovišče]], ki še nima predstavnika za QA, uporabite menijski ukaz "''ChildWorkspaces / Seek QA''".  
* to find out what the latest milestone on a given [[MWS|MasterWorkspace]] is you can either look at [http://eis.services.openoffice.org EIS (Environment Information System)] using the menu entry "''MasterWorkspaces / MasterWorkspace Info''" or use the command "'''cwsquery latest'''".
+
* Če želite ugotoviti, kaj je zadnji mejnik na danem [[MWS|MasterWorkspace]], lahko pogledate v [http://eis.services.openoffice.org EIS (Environment Information System)] z menijskim ukazom "''MasterWorkspaces / MasterWorkspace Info''" ali pa uporabite ukaz "'''cwsquery latest'''".
 
* {{LinkBanner}}
 
* {{LinkBanner}}
  
Line 71: Line 71:
  
 
== Sorodne povezave ==
 
== Sorodne povezave ==
* [http://tools.openoffice.org/dev_docs/child_workspace_policies.html ChildWorkspace Policies]
+
* [http://tools.openoffice.org/dev_docs/child_workspace_policies.html Politike otroških delovišč (angl.)]
* [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw Dokumentacija orodij ukazne vrstice za CWS]
+
* [http://tools.openoffice.org/dev_docs/ooo-cws-tools-doc.sxw Dokumentacija orodij ukazne vrstice za otroško delovišče (angl.)]
* [http://tools.openoffice.org/servlets/ReadMsg?list=dev&msgNo=5044 E-pismo, ki je uvedlo orodja ukazne vrstice za CWS]
+
* [http://tools.openoffice.org/servlets/ReadMsg?list=dev&msgNo=5044 E-pismo, ki je uvedlo orodja ukazne vrstice za otroško delovišče (angl.)]
* [http://eric.bachard.free.fr/UTBM_TX20/reports/Carbon_vcl.pdf Poročilo TX 20] - Dokument [http://eric.bachard.free.fr/news/ Erica Bacharda], ki med drugim vključuje nekaj dobrih stvari o [http://eis.services.openoffice.org EIS] in obravnavi [[CWS | otroških deloviščih (CWS)]], npr. zaslonske slike spletnega vmesnika EIS, razlago o stanjih CWS in primer tipične uporabe orodij ukazne vrstice CWS za razvijalce.
+
* [http://eric.bachard.free.fr/UTBM_TX20/reports/Carbon_vcl.pdf Poročilo TX 20] - Dokument [http://eric.bachard.free.fr/news/ Erica Bacharda], ki med drugim vključuje nekaj dobrih stvari o [http://eis.services.openoffice.org EIS] in obravnavi [[CWS | otroških delovišč]], npr. zaslonske slike spletnega vmesnika EIS, razlago o stanjih otroških delovišč in primer tipične uporabe orodij ukazne vrstice otroških delovišč za razvijalce.
* [[RedTinderboxStatusInEIS]]
+
* [[RedTinderboxStatusInEIS|Rdeče stanje smodnišnice v EIS (angl.)]]

Latest revision as of 12:50, 28 March 2010

Pregled

EIS (Environment Information System) je sestavljen iz zbirke podatkov, ki hrani podatke o glavnih deloviščih (angl. MasterWorkspace, na kratko MWS) in otroških deloviščih (angl. ChildWorkspace, na kratko CWS), pa tudi druge reči, spletni vmesnik, ki ga uporabljajo vsi vpleteni v delo na otroških deloviščih (npr. razvijalci, člani QA, pisci dokumentacije, člani ekipe za uporabniško izkušnjo, odgovorni za lokalizacijo in internacionalizacijo itn.) ter vmesnik SOAP za kopico orodij ukazne vrstice, ki jih uporabljajo razvijalci za ustvarjanje in vzdrževanje otroških delovišč.

V spletni vmesnik se lahko prijavite na naslovu http://eis.services.openoffice.org s svojim e-poštnim naslovom OOo (vključno z @openoffice.org) in svojim geslom OOo. Tam je na voljo tudi anonimni dostop samo za branje.

EIS je tudi potreben, če želite napisati e-sporočilo o objavi funkcionalnosti (angl. feature announcement) ali spremembah API-ja, s katerimi obveščate razvijalce, inženirje zagotavljanja kakovosti (QA, angl. Quality Assurance), sodelavce pri lokalizaciji (L10N) in dokumentaciji o spremembah v kodi paketa ali če želite preveriti specifikacije.

Poleg tega EIS ponuja več virov RSS z informacijami o otroških deloviščih in glavnih deloviščih. Vir, ki informira o novih mejnikih na glavnih deloviščih je npr. sindiciran na Planet OpenOffice.org. Najdete jih lahko tudi na glavni strani EIS.

Rezultati gradenj smodnišnice (angl. tinderbox) so bili v zadnjem času integrirani v spletno pročelje EIS.

Ozadje in splošni podatki

Za razvoj OpenOffice.org/StarOffice uporabljamo veje v skladiščih izvorne kode (trenutno SubVersion, prej CVS), nabor orodij ukazne vrstice in orodje, imenovano EIS. EIS je akronim za Environment Information System in, mimogrede, nemška beseda za led. Zamisel za glavnimi delovišči in otroškimi delovišči je, da razvoj ne poteka na glavnih deloviščih. Namesto tega je vse delo izvedeno na kopiji glavnega delovišča, to kopijo pa imenujemo otroško delovišče. Le če je otroško delovišče najmanj tako dobro kot glavno delovišče (vsebovati ne sme nobenih regresij in novo vpeljane funkcionalnosti morajo biti popolnoma delujoče), bo spojen (integriran) nazaj v glavno delovišče. Idealno bi to pomenilo, da je glavno delovišče lahko izdano kadarkoli kot popolnoma delujoč drop. Vendar je to tako le v teoriji. Vseeno pa koncept glavnih/otroških delovišč v veliki meri zmanjša število novih zadev/težav, vpeljanih v glavno delovišče.

Kodne veje (angl. codeline) za izdaje uporabljajo različna glavna delovišča in za minor izdaje je ponavadi uvedeno tudi novo glavno delovišče, kar stabilizira kodo za to minor izdajo na ločeni veji.

Delo z otroškimi in glavnimi delovišči pomeni:

  • izvajati celotno razvijalsko delo na kopiji kode izdelka;
  • temeljito preizkusiti in preveriti razvito kodo pred ponovno integracijo v kodo izdelka;
  • le povsem preizkušena izvorna koda se vključi v kodo izdelka, zato je manj regresijskih hroščev;
  • vsi mejniki na glavnih deloviščih (koda izdelka) so potencialno v stanju možnosti izdaje;
  • hrošče pogosteje odkrijemo v času, ko jih uvedemo, in s strani tistih, ki jih uvedejo;
  • ker je koda bolje preverjena in preizkušena pred integracijo v izdelek, ima razvijalec več svobode pri delu.

Otroška delovišča (CWS) imajo v EIS stanje, ki odseva, kaj se trenutno na otroškem delovišču dogaja in ali je otroško delovišče že končalo v kodi izdelka ali pa se še razvija. Prihodnje stanje lahko nastavimo glede na trenutno stanje.

Obstaja nabor politik otroških vozlišč, ki ureja delo na otroškem delovišču, npr. kako se zadeve v sistemu sledenja hroščev v issuezilli OpenOffice.org običajno dodeljujejo otroškim deloviščem in kako različni ljudje, vpleteni v življenjski ciklus otroškega delovišča, sodelujejo drug z drugim. EIS pozna dve različni vrsti otroških delovišč: javno (angl. public) in interno (angl. internal) otroško delovišče podjetja Sun. Za notranje otroško delovišče podjetja Sun je prikazan le omejen nabor podatkov na http://eis.services.openoffice.org. Tako npr. opis, ki lahko vsebuje notranje podatke o stranki podjetja Sun, ni prikazan. V podjetju Sun interno obstaja drugačna inkarnacija spletnega portala EIS, ki te podatke prikaže. Večina otroških delovišč, na katerih delajo razvijalci podjetja Sun, so javna, le nekaj njih, ki vsebujejo izključne module ali funkcionalnosti StarOffice ali tisti, ki vsebujejo zaupne podatke o strankah podjetja Sun, so zasebna otroška delovišča. Otroško delovišče ima vedno "lastnika" (angl. "Owner") in "predstavnika QA" (angl. "QA representative"), ki morata biti praviloma različni osebi ;-). Druge vrste informacij, ki jih hrani EIS, so npr. ustrezni moduli izvorne kode, zadeve novih funkcionalnosti in/ali popravkov, ki se obdelujejo v otroškem delovišču, izdaja, za katero je načrtovana vključitev otroškega delovišča, in zastavice, ki nakazujejo, če so spremembe v tem otroškem delovišču relevantne za dokumentacijo in prevajanje. EIS ponuja tudi nekaj statističnih podatkov o otroških deloviščih. Nekatera polja na strani Edit za CWS je potrebno nastaviti najmanj takrat, ko je stanje spremenjeno na ready for QA (pripravljeno za QA) in v to stanje ne boste mogli spremeniti, ne da bi spremenili tudi njih. Poleg "lastnika" in "predstavnika za QA" EIS ponuja tudi vlogo "člana" (angl. "Member") otroškega delovišča. Člane lahko dodate na strani urejanja otroškega delovišča. Vsa otroška delovišča, pri katerih ste "lastnik", "predstavnik za QA" ali "član", so prikazane na seznamu, ki ga ponuja seznam ChildWorkspaces/MyCWS. Podmeni "ChildWorkspaces/Browse" ponuja nekaj drevesnih pogledov, ki prikazujejo otroška delovišča v zbirki podatkov, glede na različne kriterije izbora. Prikaz v teh drevesnih pogledih omejujejo nastavitve. Privzeto so prikazana le otroška delovišča zadnjega pol leta. To lahko spremenite prek povezave Settings v desnem kotu in nato na zavihku CWS, kjer poiščete polje "months displayed in treeviews", ki ga lahko nastavite na novo vrednost.


Poleg obravnave otroških delovišč in glavnih delovišč je druga uporabnost EIS obravnava sprememb API-ja in obvestila o funkcionalnostih, ki jih v EIS razvijalci in nato razpošljejo na dopisne sezname OpenOffice.org in shranijo v zbirko podatkov EIS. Spremembe API-ja (angl. API Changes) obveščajo druge razvijalce o spremembah kode, ki so lahko zanje relevantne, in obvestila o funkcionalnostih (angl. Feature announcements) kot tudi specifikacije so ključne za vse, ki delujejo na področju dokumentacije ali zagotavljanja kakovosti (QA). Obvestila o funkcionalnostih in specifikacije se uporabijo tudi za pol-samodejno izdelane Opombe ob izdaji in so zato pomembne za obveščanje vseh o spremembah v novih izdajah, za primer si oglejte Opombe ob izdaji OpenOffice.org 2.0.4 (angl.). Specifikacije je potrebno izdelati z uporabo standardne predloge in EIS lahko preveri, ali lahko dokumente uporabite za proces izdelave Opomb ob izdaji ali pa morda dokumenti prelomijo ta proces, ker vsebujejo spremembe, ki naredijo dokument neuporaben za XSLT, ki se v tem procesu uporabi, ali ker ne temeljijo na pravi predlogi.

Seznam stanj, ki jih uporablja EIS

  1. planned (načrtovano): Otroško delovišče v tem stanju je načrtovano, vendar dejansko še ne obstaja. Tako ni bil spremenjen noben del kode, niti še ni odločeno, iz katerega mejnika bo ustvarjeno otroško delovišče. To stanje je uporabno predvsem za dolgoročno načrtovanje, zagotavljanje virov itn.
  2. new (novo): Otroško delovišče v tem stanju je bilo ustvarjeno, zdaj fizično obstaja in razvoj na njem je trenutno v teku. Orodje ukazne vrstice cwscreate se uporabi za ustvarjanje mape za izvorno kodo novega otroškega delovišča. Če otroško delovišče v stanju planned in ime, podano kot parameter ukazu cwscreate že obstaja, je povzdignjeno v stanje new v EIS, sicer je ustvarjen nov vnos v EIS. Če ustvarite otroško delovišče z ukazom cwscreate, zatem uporabite spletni vmesnik in dodajte kar se da veliko dodatnih informacij.
  3. ready for qa (pripravljeno za QA): Razvijalci menijo, da so končali z delom. S to spremembo stanja so pripravili namestitvene pakete in predali otroško delovišče v QA. Odvisno od tega, kako je obravnava otroškega delovišča nastavljena v glavnem delovišču, lahko QA zdaj nastavi stanje na nominated ali approved by QA, če QA sprejme spremembe v otroškem delovišču. Če spremembe v otroškem delovišču niso sprejete, QA nastavi stanje nazaj na new.
  4. approved by QA (odobreno s strani QA): To je posebno vmesno stanje, ko je za glavno delovišče, v katerem je bilo ustvarjeno otroško delovišče, uporabljamo bolj nadzorovan pristop. V takšnem primeru QA odobri otroško delovišče, vendar ima zadnjo besedo, če in kdaj kaj vstopi v glavno delovišče, programska uprava. To pomeni, da programska uprava nastavi stanje na nominated, potem ko je QA nastavilo to stanje.
  5. nominated (nominirano): Otroško delovišče je predano Release Engineering, ki lahko zdaj začne z njegovo integracijo v glavno delovišče.
  6. integrated (integrirano): Celotno delo na otroškem delovišču je dokončano in spremembe iz otroškega delovišča so bile vključene v glavno delovišče.
  7. canceled (preklicano): Preklicano otroško delovišče je bilo opuščeno, v njem se delo ne bo več nadaljevalo. To stanje je za otroška delovišča, ki so bila prej v stanju new, vendar niso več potrebna.
  8. deleted (izbrisano): Podobno kot canceled - to stanje je za otroška delovišča, ki niso več potrebna. Razlika je, da lahko stanje deleted nastavimo le za planned otroška delovišča, ki nikoli niso prišla do dejanske fizične manifestacije in s tem do stanja new.
  9. fixed on master (popravljeno na glavnem): Uporabljamo za odsev sprememb v EIS, ki jih Release Engineering opravi neposredno na glavnem delovišču, običajno gre za popravek zelo posebne, urgentne težave ali spor pri spajanju. Otroško delovišče v tem stanju dejansko ne obstajajo, to so le vnosi v EIS, ki hranijo informacije o spremembah, neposredno opravljenih v skladiščni veji izvorne kode za glavno delovišče.
  10. finished (dokončano): To je posebno stanje, ki ga uporabljamo za otroška delovišča posebnih izdaj izdelka, ki nikoli ne bodo integrirana v glavno delovišče, vendar predstavljajo posebno različico izdelka (angl. Special Release Version), npr. neko različico, izdelano le za posebno stranko s spremembami, ki ne bodo nikoli vključene v glavno delovišče.
  11. pre-nominated for PP (pred-nominirano za popravek programa): zgodovinsko stanje, uporabljeno za obravnavo posebnih otroških delovišč produktnih popravkov (angl. Product Patch), ni več v uporabi.
  12. cloned (klonirano): Zgodi se, da je potrebno spremembe glavnega delovišča, ustvarjene za stabilizacijo minor izdaje, prav tako integrirati v glavno delovišče za trenutno glavno deblo izdaje ali obratno. V tem primeru kloniramo otroška delovišča. Npr. obstaja lahko otroško delovišče xyz, ustvarjeno na glavnem delovišču SRC680, in če želimo integrirati enake spremembe tudi v glavno delovišče OOE680, bo ustvarjen klon xyz_OOE680. Release Engineering ima posebno orodje ukazne vrstice, ki ustvari tovrstne klone.

Vstopne točke EIS

Glavni spletni naslov za EIS je http://eis.services.openoffice.org. Tam lahko najdete povezavo do EIS prijave, kjer morate uporabiti svoj e-poštni naslov OpenOffice.org kot uporabniško ime. Na tej strani je tudi povezava za prijavo anonimnega gosta za tiste, ki nimajo računa OpenOffice.org, in vire RSS, ki jih ponuja EIS, tudi najdete na tej strani. Poleg tega so možnosti "Find a ChildWorkspace (CWS) name for a given IssueTracker issue ID", "List integrated issues within the most current master build" in "Show treeview of all integrated master builds" na [ http://qa.openoffice.org/issuelinks.html http://qa.openoffice.org/issuelinks.html] prav tako funkcionalnosti, ki jih ponuja EIS. Na http://specs.openoffice.org se nahaja povezava Specification Checking Tool, ki je tudi funkcionalnost EIS. Neposredne povezave k podatkom o otroških deloviščih najdete v nekaterih virih RSS in spletnih straneh, kot je Planet OpenOffice.org ali v dokumentaciji na http://www.openoffice.org. Če želite ustvariti takšno neposredno povezavo na podatke o otroškem delovišču na neki spletni strani, lahko uporabite naslednje:

http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=SRC680%2Fcwsqueryenhance

kjer je 'cwsqueryenhance' ime otroškega delovišča in 'SRC680' je glavno delovišče, v katerem je bilo ustvarjeno, brez informacije o mejniku. Splošen obrazec za takšen URL je:

http://eis.services.openoffice.org/EIS2/cws.ShowCWS?Path=<glavnodelovišče>%2F<otroškodelovišče>

Takšne povezave in tudi funkcionalnosti na QA issuelinks page in Specification Checking Tool lahko uporabljate brez prijave. Vmesnik SOAP spletišča EIS se nahaja na naslovu https://eis.services.openoffice.org/soap/servlet/rpcrouter. Orodja ukazne vrstice za otroška delovišča se tam overijo z uporabniškim imenom CVS in šifriranim geslom CVS. Slednje mora biti prilagojeno v datoteki .cwsrc, podrobnosti o tej datoteki .cwsrc lahko najdete v wiki-vnosu otroško delovišče (angl.). Vmesnik SOAP trenutno še ni dokumentirano, vendar z CWS.pm je za uporabno na voljo modul perl v izvorni kodi OpenOffice.org.

Triki in namigi

  • Spremenite lahko, da se meni prikaže na levi strani namesto na vrhu, in sicer prek povezave Settings v desnem kotu in nato uporabite izbirni gumb v slogu menijev na zavihku "Frames".
  • Če ste član QA in želite najti otroško delovišče, ki še nima predstavnika za QA, uporabite menijski ukaz "ChildWorkspaces / Seek QA".
  • Če želite ugotoviti, kaj je zadnji mejnik na danem MasterWorkspace, lahko pogledate v EIS (Environment Information System) z menijskim ukazom "MasterWorkspaces / MasterWorkspace Info" ali pa uporabite ukaz "cwsquery latest".
  • Tip: On this wiki you can use {{CWS}}, {{m}}, {{Bug}} templates to easily link to child workspaces, milestones and issues.

Stik

EIS je storitev, ki jo upravlja podjetje Sun in jo trenutno vzdržuje Bernd Eilers. Če ste našli hrošča v EIS ali želite dodatno funkcionalnost, lahko vnesete zadevo v IssueZillo pod kategorijo (Category) 'tools' in s ciljem (target) 'DevTools' zanj.

Sorodne povezave

Personal tools