pur-systemau amrywiadau pur Connector for codebeamer Llawlyfr Defnyddiwr

pur ::variants Mae'r cysylltydd ar gyfer codbeamer yn galluogi defnyddwyr codbeamer i reoli gofynion yn ogystal â phrofi amrywioldeb arteffactau gan ddefnyddio amrywiadau :: pur. Trwy gyplu: amrywiadau pur a thrawstiau cod, gellir ffurfioli, rhannu, a gwerthuso gwybodaeth am amrywioldeb ac amrywiadau yn awtomatig. Mae hyn yn galluogi cael atebion i gwestiynau am gyfuniadau dilys o ofynion a phrofi arteffactau mewn amrywiadau cynnyrch yn gyflym; yn caniatáu monitro amrywiadau cynnyrch wedi'u cynllunio a'u rhyddhau yn hawdd ar y lefel gofynion a phrofi arteffactau, a hefyd yn caniatáu cynhyrchu dogfennau gofynion amrywiad-benodol yn effeithlon iawn, setiau prawf ac achosion prawf allan o'r gofynion a'r storfa arteffactau prawf yn y drefn honno.

Am y llawlyfr hwn

Disgwylir i'r darllenydd feddu ar wybodaeth sylfaenol am y codbeamer a'r offer amrywiadau::pur ac arbrofi â nhw. Mae'r llawlyfr amrywiadau pur:: ar gael mewn cymorth ar-lein yn ogystal ag mewn fformat PDF y gellir ei argraffu yma.

Gofynion Meddalwedd

Mae angen y feddalwedd ganlynol ar y pur::variants Connector for codebeamer:

Codebeamer PTC 22.10-LTS neu 22.10-SP3. Nid yw cydnawsedd â datganiadau codbeamer eraill wedi'i warantu.

cydran gweinydd pur::amrywiadau ar gyfer codbeamer yn yr un fersiwn â'r cysylltydd. Mae'r cysylltydd yn gofyn am osod: pur: amrywiadau cydrannau penodol ar y gweinydd codbeamer
pur::amrywiadau Desktop Hub neu Web Hub hefyd yn yr un fersiwn â'r cysylltydd ei hun:
Mae'r Pur :: amrywiadau Desktop Hub yn cael ei gyflwyno gyda'r pecyn gosodwr Enterprise Windows pur :: amrywiadau a gellir ei osod trwy ddewis y Cydrannau Integreiddio yn y dewin gosodwr, wrth osod y Web Disgrifir Hub yn y Pur ::variants Setup Guide.

Mae'r pur :: amrywiadau Connector ar gyfer codebeamer yn estyniad ar gyfer amrywiadau :: pur ac mae ar gael ar bob platfform a gefnogir.

Gosodiad

Ymgynghorwch â'r adran bur ::amrywiadau Connectors yn y pur ::amrywiadau Canllaw Setup am wybodaeth fanwl ar sut i osod y cysylltydd (Cymorth dewislen -> Cymorth Cynnwys ac yna pur ::amrywiadau Setup Guide -> pur ::variants Connectors). Gosod disgrifir camau sy'n benodol i'r cysylltydd codbeamer, lleoliad y cydrannau, yn ogystal â disgrifiad o sut i ffurfweddu mewngofnodi sengl yn y Pur ::variants Setup Guide

Disgrifir camau gosod sy'n benodol i'r cysylltydd codbeamer, lleoliad y cydrannau, yn ogystal â disgrifiad o sut i ffurfweddu mewngofnodi sengl yn y pur::variants Setup Guide

Defnyddio'r Connector

Cychwyn pur::variants

Yn dibynnu ar y dull gosod a ddefnyddir, naill ai dechreuwch yr Eclipse pur::galluogwyd amrywiadau neu o dan Windows, dewiswch yr eitem amrywiadau pur:: o ddewislen y rhaglen.

Os nad yw'r persbectif Rheoli Amrywiadau eisoes wedi'i actifadu, gwnewch hynny trwy ei ddewis o Safbwynt Agored -> Arall ... yn y ddewislen Ffenestr.

Paratoi'r Prosiect Codebeamer

Er mwyn cael y wybodaeth amrywioldeb o eitemau codbeamer yn ogystal ag aseinio eitemau i amrywiadau mewn codbeamer, mae angen paratoi'r tracwyr codbeamer i ddechrau. Er mwyn sicrhau bod y wybodaeth amrywioldeb ar gael i::amrywiadau pur, mae'n rhaid gosod priodoledd ar gyfer pob traciwr cod-beamer sydd i'w brosesu mewn perthynas â'i amrywioldeb.
I osod y nodwedd hon ar gyfer pob traciwr a ddewiswyd, ewch i CodeBeamer a defnyddiwch opsiwn Ffurfweddu'r traciwr. Yma, dewiswch y dudalen Fields ac ychwanegu maes arfer newydd o'r enw 'pvCyfyngiad' o'r math 'Text'. Ymhellach, i baratoi'r trawsnewidiad Enum i storio gwybodaeth amrywioldeb yn codebeamer, mae angen maes arferiad pellach, o'r enw 'pvVarants' o'r math 'Text'.
Ar gyfer Camau Prawf o fewn Achosion Prawf, yn y Tabl Diffiniad, mae angen ychwanegu'r meysydd arfer 'pvRestrictionTestSteps' a 'pvVarientsTestSteps' o'r math 'Text', yn y drefn honno.

Dilysu

Er mwyn defnyddio'r cysylltydd mae bob amser yn ofynnol ei ddilysu i'r cymhwysiad codbeamer.
Cefnogir dau fecanwaith dilysu

Defnyddio tystlythyrau codebeamer

OpenID Connect (ar gyfer Arwyddo Sengl)

Yn ystod y defnydd o'r cysylltydd, ar gyfer y ddau fecanwaith, bydd y defnyddiwr yn cael deialog mewngofnodi, sy'n disgwyl tystlythyrau'r defnyddiwr. Yn achos Single-Sign-On bydd deialog mewngofnodi sy'n seiliedig ar borwr yn cael ei ddangos a ddarperir gan y Gweinydd Dilysu sydd wedi'i ffurfweddu.

Creu'r Model(au) Cychwynnol

Y cam cyntaf bob amser yw creu'r model teulu cyfatebol ar gyfer pob set waith berthnasol sy'n cynnwys tracwyr trawstiau cod dethol. Mae'r modelau teulu cychwynnol hyn yn fannau cychwyn ar gyfer defnyddio gwybodaeth amrywioldeb sy'n bodoli eisoes.

Dim ond unwaith y mae'n rhaid gweithredu'r weithdrefn fewnforio ar gyfer pob set waith trawstiau cod ond gellir ei diweddaru wedyn Cynrychiolir pob traciwr gan un elfen nod model yn y model teulu pur::amrywiadau a grëir yn ystod y mewnforio.

Cyn y gellir cychwyn y mewnforio gwirioneddol, mae'n rhaid creu prosiect Rheoli Amrywiadau, lle bydd y modelau a fewnforir yn cael eu storio. Dewiswch Prosiect o Newydd yn y File bwydlen. Dewiswch Prosiectau Amrywiadau isod Rheoli Amrywiadau ar dudalen gyntaf y dewin prosiect Newydd. Dewiswch enw ar gyfer y prosiect a dewiswch Gwag fel y math o brosiect (gweler Ffigur 1, “Creu prosiect Rheoli Amrywiadau gwag ar gyfer mewnforio traciwr trawstiau cod”)

Dechreuir mewnforio trwy ddewis y weithred mewnforio naill ai yn newislen cyd-destun y Prosiect view neu gyda Mewnforio ddewislen yn y File bwydlen. Dewiswch Modelau neu Brosiectau Amrywiad a gwasgwch Next. Ar y dudalen ganlynol dewiswch 'Mewnforio olrheinwyr codbeamer neu setiau gweithio'.
Mae'r dewin mewnforio yn ymddangos. Yn y dudalen gyntaf, mae'n rhaid i chi ddiffinio neu ddewis y cyfeiriad gweinydd codbeamer rydych chi am fewnforio'r tracwyr ohono.

Os nad ydych eisoes wedi'ch dilysu, gallwch ddefnyddio Test Connection.Bydd hwn yn agor yr ymgom mewngofnodi sy'n darparu posibiliadau lluosog ar gyfer dilysu.

Gellir darparu'r enw defnyddiwr codebeamer a chyfrinair gyda'r opsiwn 'codebeamer User Credentials'.
Gellir defnyddio gweinydd dilysu gan ddewis yr opsiwn 'Gweinydd Dilysu (OAuth2)'.

Mae pa ddull mewngofnodi sy'n gweithio i chi yn dibynnu ar ffurfweddiad y gweinydd codbeamer.
Ar y dudalen nesaf, gallwch chi benderfynu a ydych chi am fewnforio gwybodaeth amrywioldeb eich traciwr codbeamer yn llawn (Modd Llawn) neu a ydych chi am fewnforio pennawd y modiwl (Modd Cyflym). Yn yr achos olaf, mae'r data'n cael ei gydamseru'n awtomatig cyn trawsnewid, ond yn y modd llawn, y defnyddiwr sy'n gyfrifol am gadw'r data wedi'i gysoni, gan fod y data presennol yn cael ei ddefnyddio i drawsnewid yr amrywiadau.
Gan ddefnyddio Modd Llawn, cynrychiolir pwyntiau amrywiad a geir mewn tracwyr yn y Model Teulu sy'n cael ei greu.

Gall y defnyddiwr ffurfweddu pa ddata fydd yn cael ei fewnforio ar y dudalen nesaf.
Dangosir rhestr gyflawn o brosiectau'r ystorfa godbeamer, yn ogystal â'r setiau gwaith a restrir isod pob prosiect sydd ar gael. Llywiwch i'r Working-Set sy'n cynnwys y tracwyr o ddiddordeb a dewiswch y siec

blychau ar yr ochr chwith. Gellir dewis Setiau Gwaith Lluosog o wahanol brosiectau ar unwaith i'w mewnforio. Mae dewis blwch ticio ar yr ochr chwith ar gyfer y Working-Set yn nodi pob traciwr i'w fewnforio. Mae dewis ar gyfer tracwyr unigol o fewn un Working-Set hefyd yn bosibl gan ddefnyddio'r cwarel cywir.
Nodyn: Sylwch, dim ond gwybodaeth a gyflwynir y mae gan y defnyddiwr hawliau mynediad priodol iddi

Gwnewch yn siŵr bod y lleoliad targed mewnforio a roddir wrth ymyl “Mewnforio i mewn” yn gywir. Gellir newid y lleoliad trwy ddefnyddio'r botwm Dewis. Gan ddewis yr opsiwn "Storio modelau a grëwyd yn ôl strwythur ffolder," mae'r broses fewnforio yn creu ffolderi ar gyfer y prosiect a'r setiau Gweithio yn y drefn honno, mewn pur :: amrywiadau ar gyfer y modelau teulu.

Mae'r modelau teulu sy'n cael eu creu yn cael eu henwi yn ddiofyn yn ôl y cynllun _, ond gellir addasu hyn gan ddefnyddio'r blwch golygu.

Nodyn: Er y gellir mewnforio tracwyr o bob math, dim ond olrheinwyr o fathau penodol fydd yn cael eu hystyried yn ystod y trawsnewid (am restr o fathau, gweler y bennod Trawsnewid Amrywiad yn y llawlyfr hwn).

Hefyd, dim ond wrth fewnforio'r tracwyr hyn y caiff pwyntiau amrywiad eu hystyried.

Gan ddefnyddio'r dudalen nesaf, gallwch ddewis y llinell sylfaen ar gyfer pob traciwr a ddewiswyd i'w ddefnyddio fel y fersiwn ffynhonnell ar gyfer Trawsnewid Setiau Gweithio

Gellir perfformio'r dewis ar lefel Set Gweithio ar gyfer llinellau sylfaen perthnasol neu ar wahân ar gyfer pob un o'r tracwyr. Ar lefel Set Gweithio rhestrir y llinellau sylfaen hynny sy'n gyffredin ar gyfer pob un o'r tracwyr. Cynorthwyir y dewis gan swyddogaeth chwilio sy'n hidlo'r llinellau sylfaen i'w dewis
Fel arall, gellir ei ddiffinio ar gyfer cynnwys traciwr fel y'i rhennir yn y Set Waith a grëir gan y Trawsnewid Setiau Gweithio

Nodyn: Ni ellir newid cyflwr a rennir tracwyr sy'n cael eu rhannu yn ôl diffiniad ac fe'i dangosir fel rhai darllen yn unig yn yr ymgom.

Ar y dudalen ganlynol, dangosir y Rheolau Mewnforio. Ar y dudalen hon, gallwch ddewis setiau o Reolau Mewnforio, a fydd yn cael eu defnyddio i drin y model canlyniadol ar ôl mewnforio. Gellir defnyddio Setiau Rheolau Mewnforio i greu elfennau model pur::amrywiadau penodol fel cyfyngiadau neu gyfyngiadau o wybodaeth am arteffactau codbeamer.

Diweddaru Modelau o codebeamer

Gan ddefnyddio'r weithred Cydamseru, gellir addasu'r set o dracwyr i'w mewnforio fel rhan o Set Waith. Yn ogystal, wrth ddefnyddio Modd Llawn, mae angen diweddaru'r modelau pur::variants gyda gwybodaeth o codebeamer pryd bynnag y bydd newidiadau perthnasol wedi'u gwneud. I gychwyn y diweddariad, agorwch y model sy'n cynrychioli'r Working-Set a gwasgwch y botwm Cydamseru yn y bar offer.

pur ::bydd amrywiadau yn cysylltu â codebeamer i gyflwyno'r dudalen dewis traciwr, y dudalen dewis llinell sylfaen, ac wedi hynny y Compare Editor ar gyfer modelau amrywiadau :: pur.

Defnyddir y golygydd cymharu drwyddi draw pur ::amrywiadau i gymharu fersiynau model, ond yn yr achos hwn fe'i defnyddir i gymharu data codbeamer (a ddangosir yn yr ochr dde isaf) â'r model amrywiadau pur ::amrywiadau cyfredol (ochr chwith isaf). Rhestrir yr holl newidiadau fel eitemau ar wahân yn rhan uchaf y golygydd, wedi'u trefnu yn ôl yr elfennau yr effeithir arnynt.

Mae dewis eitem yn y rhestr hon yn amlygu'r newid priodol yn y ddau fodel. Yn y cynampLe, tynnwyd y traciwr “Achosion Prawf” o gwmpas y mewnforio.
Mae bar offer Merge yn darparu offer i gopïo newidiadau unigol neu hyd yn oed yr holl newidiadau (nad ydynt yn gwrthdaro) yn ei gyfanrwydd o'r model presennol i'r model hen ffasiwn.

Diffinio Amrywiad

Y cam nesaf yw'r diffiniad o'r amrywiadau diddordeb gwirioneddol. Gan fod y model amrywiad fel arfer yn caniatáu diffiniad o nifer fawr iawn o amrywiadau, mae amrywiadau pur::yn cadw golwg yn unig ar yr amrywiadau hynny sydd o ddiddordeb i'r defnyddwyr. Yn nodweddiadol, mae'r nifer hwn yn llawer llai na nifer yr amrywiadau posibl.

Mae amrywiadau yn cael eu storio fel endidau ar wahân o'r enw Modelau Disgrifiad Amrywiad (VDM). Mae VDM bob amser yn perthyn i Ofod Ffurfweddu penodol. Felly, cyn diffinio amrywiadau, mae'n rhaid creu gofod ffurfweddu. Dewiswch y prosiect sy'n cynnwys y modelau a fewnforiwyd yn y Prosiectau Amrywiol view ac agorwch y ddewislen cyd-destun. O dan yr eitem New select Configuration Space. Agorir dewin. Ar y dudalen gyntaf (Ffigur 10, “Y Dewin Gofod Ffurfweddu”), rhowch enw ar gyfer y gofod ffurfweddu. Rhaid i'r enw ddilyn rheolau llym (dim bylchau, dim nodau arbennig). Dad-diciwch y blwch cyn Creu trawsnewid safonol, oherwydd ar gyfer modelau gofynion pur nid yw'r trawsnewid safonol yn darparu unrhyw swyddogaeth berthnasol (Gweler y Llawlyfr Defnyddiwr pur ::amrywiadau am ragor o wybodaeth am drawsnewidiadau

Defnyddir y dudalen nesaf i nodi pa fodelau sydd i'w cynnwys yn y gofod ffurfweddu hwn. Dewiswch yma'r holl fodelau sy'n cynrychioli'r Setiau Gweithio ac felly'r olrheinwyr diddordeb. Yn y cynampIsod, dim ond un Model Teulu sy'n cael ei ddewis. Nawr pwyswch y botwm Gorffen.

Dangosir strwythur canlyniadol y prosiect yn (Ffigur 12, “Strwythur Gofod Ffurfweddu Cychwynnol”). Mae'r DemoVariants.vdm yn cael ei greu a'i agor ar unwaith rhag ofn bod y disgrifiad Creu amrywiad rhagosodedig yn cael ei ddewis ar dudalen gyntaf y dewin.

Trawsnewid Amrywiad

Gall amrywiadau sydd wedi'u storio mewn model disgrifio amrywiad fod ar gael yn codebeamer. Mae'r Connector yn cefnogi'r ffyrdd canlynol o gynrychioli amrywiadau: seiliedig ar briodoleddau

Cynrychiolaeth ar Amrywiad Seiliedig ar Briodoledd
Yn y gynrychiolaeth ar sail priodoledd rydym yn diffinio maes wedi'i deilwra ar gyfer pob traciwr codbeamer a ddewiswyd i'w ychwanegu at bob eitem traciwr. Mae'r modws trawsnewid hwn yn ychwanegu enw'r amrywiadau (fel rhestr, wedi'u gwahanu gan linellau newydd) os yw'r eitem olrhain yn rhan o'r amrywiad. Gall enw'r nodwedd hon gael ei ddiffinio gan ddefnyddiwr ar gyfer trawsnewidiad, rhagosodiad yw pvVarians.
Mae'r math hwn o drawsnewid yn berthnasol i'r mathau olrhain canlynol: Gofyniad, Achos Prawf (gan gynnwys Camau Prawf), Set Brawf, Ffurfweddu Prawf, Eitemau Ffurfweddu
Nodyn: Rhag ofn i draciwr gael ei eithrio gan y defnyddiwr ar gyfer amrywiad yn y Model Teuluol, mae enw'r amrywiad yn mynd i gael ei dynnu oddi ar y rhestr hon o amrywiadau yn codebeamer.
Nodyn: Ni ellir rhedeg y trawsnewid hwn ar dracwyr gyda llinellau sylfaen heblaw HEAD ac felly pur::bydd amrywiadau yn adrodd am wall.

Trawsnewid Set Waith

Mae asedau Llinell Cynnyrch (150%) hy olrheinwyr (gofynion, achosion prawf, ac ati) yn cael eu neilltuo i Set Waith bwrpasol neu'r Set Weithio Ragosodedig yn codebeamer. Y Set Waith

Gellir defnyddio trawsnewid gyda chymorth diweddaru neu hebddo:

Heb gefnogaeth diweddaru, mae'r trawsnewidiad yn creu Set Waith benodol amrywiad ar gyfer pob rhediad trawsnewid ac ar gyfer pob amrywiad (vdm) gyda thracwyr sy'n cynnwys yr is-setiau amrywiol penodol o eitemau olrhain (100%). Yn ddiofyn, mae'r confensiwn enwi ar gyfer y Set Waith benodol amrywiad a grëwyd yn hafal i'r , ee ‚DemoVariant'. Gellir newid yr enw rhagosodedig trwy osod y paramedr trawsnewid 'WorkingSetName' (gweler y bennod 'Paratoi Trawsnewidiad'). Rhag ofn bod Set Waith gyda'r un enw eisoes yn bodoli, adroddir gwall ac ni pherfformir trawsnewid.
Ffordd ymarferol o greu setiau gweithio ag enwau gwahanol ar gyfer pob rhediad yw atodi'r amserauamp o'r trawsnewidiad i'r enw. Gallwch wneud hyn trwy osod gwerth 'WorkingSetName' i '$(VARIANT)_$(QUALIFIER)'.

Gyda chefnogaeth diweddaru, cefnogir diweddariad o dracwyr amrywiad penodol a drawsnewidiwyd yn flaenorol. Mae dau fodd ar gael, y Modd Cyfuno â Llaw, a'r Modd Trosysgrifo Llawn

Modd Cyfuno â Llaw - yn y modd hwn, mae'r amrywiad yn cael ei gynrychioli gan ddwy set waith, cyfeiriad - a set weithio copi gweithio. Mae'r set waith cyfeirio yn cael ei chreu yn newydd yn y rhediad trawsnewid cyntaf ac yn cael ei throsysgrifo ym mhob trawsnewidiad pellach. Mae'r copi gweithio hefyd yn cael ei greu gan y trawsnewidiad cyntaf a gall y defnyddiwr addasu'r cynnwys. Nid yw'r set waith hon yn cael ei diweddaru'n awtomatig, ond mae angen cyfuno'r newidiadau a wneir yn y set waith gyfeirio â llaw â'r copi gweithio.

Modd Trosysgrifo Llawn: yn y modd hwn, mae'r amrywiad yn cael ei gynrychioli gan un set weithredol sy'n cael ei chreu gan y trawsnewidiad cyntaf ac sy'n cael ei throsysgrifo ym mhob trawsnewidiad dilynol.

Mae angen penderfynu ymlaen llaw pa fodd diweddaru i'w ddefnyddio, nid yw'n bosibl newid rhwng y moddau ar ôl i drawsnewidiadau gael eu perfformio eisoes.

Nodyn:

Bydd y defnyddiwr yn cael caniatâd lefel traciwr i ddisodli cynnwys cangen (gosodiad caniatâd yn codebeamer: 'Cangen - Amnewid cynnwys')

Mewn rhai cyfuniadau traciwr, mae creu set weithredol yn codebeamer yn newid cyfluniad y traciwr fodd bynnag nid yw'n cael ei gefnogi gan y diweddariad. Mae hyn yn cyfyngu ar ddefnyddioldeb diweddaru rhai cyfuniadau tracio, ee mae angen cynnwys 'Manyleb Gofyniad System' a 'Manyleb Gofyniad Cwsmer' yn y set waith ar yr un pryd bob amser.
Gweler 'pur::variants Canllaw Defnyddiwr', Pennod 'Sefydlu Trawsnewid' am wybodaeth ar sut i alluogi cymorth diweddaru.

Ar gyfer pob dull o'r Trawsnewid Set Weithredol, mae angen nodi'r canlynol:

Rhaid i'r defnyddiwr gael caniatâd i greu setiau gweithio. (gosodiad caniatâd yn codebeamer: 'Working-Set - Admin').
Mae olrheinwyr sydd wedi'u cynnwys (hy nid olrheinwyr a rennir) yn cael eu canghennog o'r tracwyr yn y Set Waith wreiddiol ar y llinell sylfaen a ddiffinnir gan y defnyddiwr yn ystod y mewnforio ac yn cael eu lleihau i'r is-set amrywiad penodol. Dim ond at y Set Waith y caiff tracwyr a rennir eu hychwanegu ond heb unrhyw newid gan nad yw gwybodaeth amrywioldeb yn cael ei hystyried yno.
Dim ond mewn codebeamer y gellir addasu fersiwn HEAD o gangen olrhain amrywiad-benodol (os yw'n briodol) i gynnwys cynnwys amrywiolyn unigryw.

Mae'r math hwn o drawsnewid yn berthnasol i'r mathau olrhain canlynol: Gofyniad, Achos Prawf (gan gynnwys Camau Prawf), Set Brawf, Eitemau Ffurfweddu.

Amnewid Testun

Mae mathau a meysydd tracio canlynol yn amodol ar amnewid testun:

Gofyniad (Enw, Disgrifiad) Achos Prawf (Enw, Cyn-weithredu, Ôl-weithredu, Paramedrau Prawf (y ddau baramedr prawf
enwau a'u gwerthoedd), Disgrifiad) Camau Prawf (Pob maes o'r math Testun a Wikitext)
Set Prawf (Enw, Paramedrau Prawf (enwau paramedr prawf a'u gwerthoedd), Disgrifiad)

Eitemau Ffurfweddu (Enw, Disgrifiad)

Nodyn: Perfformir amnewid testun yn ystod 'Trawsnewid Set Waith' yn unig a dim ond ar gyfer olrheinwyr nad ydynt wedi'u cynnwys mewn set weithio fel y'i rhennir.

Paratoi Trawsnewid

I drawsnewid amrywiad, yn gyntaf mae'n rhaid creu Cyfluniad Trawsnewid. I greu Ffurfweddiad Trawsnewid cliciwch ar y saeth wrth ymyl y botwm Trawsnewid yn y bar offer a dewis Agor Deialog Ffurfweddu Trawsnewid…

Mae'r ymgom eiddo gofod cyfluniad yn agor, a dangosir y tab Ffurfweddu Trawsnewid. Y cam nesaf yw ychwanegu Ffurfweddiad Modiwl newydd , trwy glicio ar yr eitem bar offer wedi'i farcio. Nawr ychwanegwch fodiwl newydd at Gyfluniad y Modiwl, gan ddefnyddio'r botwm Ychwanegu.

O'r ymgom a agorwyd, dewiswch Modiwl Trawsnewid codbeamer Intland a rhowch enw. Mae'r dudalen nesaf yn dangos yr holl baramedrau. Mae paramedr Modus yn nodi un o'r cynrychioliadau canlyniad amrywiol, fel y disgrifir uchod

Mae angen diffinio'r paramedrau canlynol:

Modd: Diffiniwch y modd trawsnewid. Y moddau sydd ar gael yw: Cyfrif – mae'r opsiwn hwn yn sefyll am y Cynrychiolaeth Amrywiad ar Sail Priodoledd. Set Gweithio - mae'r opsiwn hwn yn sefyll am y Working Set Transformation.

EnumerationField: Mae'n pennu enw'r maes eitem traciwr i'w lenwi ag enwau amrywiolion yn y modd trawsnewid Enumeration. Os na chaiff ei osod, defnyddir yr enw safonol ('pvVarians').
EnumerationCleanup: Os yw'n wir yn cael ei ddewis, mae'r holl briodweddau amrywiad presennol yn cael eu dileu cyn allforio'r amrywiad cyfredol.
WorkingSetName : Yn pennu enw'r Set Waith a grëwyd gan y trawsnewidiad.

PerformPartialTextSubstitution: Os gwir yn cael ei ddewis, mae'r amnewid testun rhannol yn cael ei berfformio.
UpdateMode: Yn diffinio'r modd diweddaru ar gyfer Trawsnewid Setiau Gweithio rhag ofn y bydd cymorth diweddaru yn cael ei alluogi. Y dulliau diweddaru sydd ar gael yw:

ManualMerge - mae'r opsiwn hwn yn sefyll am y Modd Cyfuno Llawlyfr
FullOverwrite - mae'r opsiwn hwn yn sefyll am y Modd Trosysgrifo Llawn Ar ôl gorffen y deialogau, gellir defnyddio'r trawsnewidiad yn syml trwy glicio ar y Trawsnewid botwm yn y bar offer a dewis y trawsnewid o'r ddewislen tynnu i lawr.

Web Integreiddio Cleient ar gyfer trawsnewid

Edrychwch ar yr adran Trawsnewid Cynnwys Cymorth yn yr amrywiadau pur:: Web Llawlyfr Cleient am wybodaeth fanwl ar sut i berfformio Trawsnewid gan ddefnyddio Web Integreiddio Cleient

Defnyddio'r Integreiddio

Er mwyn hwyluso'r cysylltydd pur:: amrywiadau ar gyfer amrywioldeb codbeamer, mae angen ychwanegu gwybodaeth at yr eitemau olrhain. Perfformir hyn trwy ychwanegu cyfyngiadau at eitemau tracio ac fe'i cynorthwyir gan y rhaglen Desktop Hub a ddarperir gan y gosodiad cleient pur:: amrywiadau neu'r integreiddiad mewn-offer a elwir yn bur ::amrywiadau Integreiddio ar gyfer CodeBeamer.

Ychwanegu Gwybodaeth Amrywioldeb Gan Ddefnyddio'r Hyb Penbwrdd

Mae'r Bwrdd Penbwrdd yn defnyddio'r clipfwrdd i fewnosod gwybodaeth o amrywiadau pur:: i gymwysiadau eraill trwy ei gludo i feysydd gweithredol sy'n cael eu golygu gan y defnyddiwr. Yn codebeamer, mae angen agor yr eitem olrhain yn y modd golygu yn gyntaf, yna dewiswch y maes “pvCyfyngiad” cyn actifadu Desktop Hub gan ddefnyddio'r set cyfuniad hotkey.

Nodyn: Mae rhagor o wybodaeth am yr Hyb Penbwrdd i'w chael yn y pur::variants Desktop Hub Manual'

Ychwanegu Gwybodaeth Amrywiant Gan ddefnyddio'r Pur::amrywiadau Widget

Unwaith y bydd yr Integreiddiad wedi'i ychwanegu at codebeamer (gweler y bennod berthnasol 'pur::variants Connectors' yn y Pur ::variants Setup Guide) am y tro cyntaf erioed, y tab Cyffredinol view o dan y dudalen Gosodiadau dangosir sydd yn y bôn yn cymryd y mewnbwn gan y defnyddiwr terfynol i ddewis rhwng un o'r ddau fodd sydd ar gael, dylai Integreiddio redeg i mewn i hy modd Desktop Hub neu Web Modd both. Yn ddiofyn, mae modd Desktop Hub yn cael ei osod fel y modd rhagosodedig

Rhagofynion ar gyfer y Modd Hyb Penbwrdd

Er mwyn rhedeg yr integreiddiad yn y modd Desktop Hub, mae angen enghraifft redeg o'r Hwb Penbwrdd yn y cefndir. Tra bod yr enghraifft Hyb Penbwrdd yn rhedeg, y tu mewn i'r Integreiddio, ewch i'r tab Cyffredinol view o dan y dudalen Gosodiadau. Sylwch, bod yr Hyb Penbwrdd eisoes wedi'i ddewis yn Connect trwy'r gwymplen (hynny yw oherwydd Desktop Hub yw gosodiad modd rhagosodedig yr integreiddio); yr unig beth sydd ei angen yw'r rhif porthladd y mae'r enghraifft Hyb Penbwrdd yn rhedeg arno, felly, nodwch rif y porthladd y tu mewn i'r math mewnbwn Hub Penbwrdd a roddir. Wedi hynny, pwyswch y botwm OK er mwyn arbed y gosodiadau modd. Bydd integreiddio wedyn yn ailgyfeirio i'w brif dudalen ac yn dechrau rhedeg yn y modd Desktop Hub.

Ar gyfer llwytho Gofod Ffurfweddu yn y Modd Hyb Penbwrdd: Er mwyn dewis Gofod Ffurfweddu, pwyswch y botwm Open Configuration Space o far dewislen Integration's. Yr Hyb Penbwrdd file bydd deialog dewis yn cael ei ddangos i ddewis y Gofod Ffurfweddu a ddymunir. Unwaith y bydd y Gofod Ffurfweddu wedi'i ddewis, bydd yr Integreiddiad yn dangos y Gofod Ffurfweddu a ddewiswyd ar unwaith.

Rhagofynion ar gyfer y Web Modd Hyb

Er mwyn rhedeg yr integreiddio i mewn Web Modd Hub, enghraifft rhedeg o'r pur:: amrywiadau Web Mae angen cydrannau (gweler y bennod “pur::variants Web Cydrannau' yn y 'pur::variants Setup Guide”). Tra bod y pur::variants Web Mae cydrannau'n rhedeg, y tu mewn i'r Integreiddio ar y tab Cyffredinol view o dan y dudalen Gosodiadau, dewiswch y Web Gwerth hwb o'r Connect trwy'r gwymplen ac yna rhowch yr URI i enghraifft redeg yr amrywiad :: pur Web Cydrannau yn y a roddir Web Math mewnbwn both. Wedi hynny, pwyswch y botwm OK i arbed y gosodiadau modd. Bydd integreiddio wedyn yn ailgyfeirio i'w brif dudalen ac yn dechrau rhedeg i mewn Web Modd Hub

Diffinio Gosodiadau Cysylltiedig â Thrawsnewid

Ar y dudalen Gosodiadau, gellir diffinio gosodiadau perthnasol trawsnewid pellach ar gyfer yr enghraifft traciwr gweithredol:

Gan ddefnyddio'r tab Cyffredinol, gellir diffinio'r priodoledd a ddefnyddir ar gyfer storio'r cyfyngiadau. Y gwerth rhagosodedig yw 'pvCyfyngiad'.
Ar gyfer eitemau tracio y tu mewn i Table-Fields, mae enw'r maes wedi'i atodi heb ofod gwyn a nodau arbennig i'r gwerth a ddiffiniwyd uchod, ee ar gyfer ”Camau Prawf' mae'n arwain at 'PvRestrictionTestSteps'

Gan ddefnyddio'r tab Cyfrifo, gellir diffinio'r marcwyr amnewid testun. Y gwerthoedd rhagosodedig yw: Nod agoriadol yw [ Nod cau yw ] Nod dianc yw

. Cyflwyniad i Integreiddio GUI

Y Prif dudalen view o'r Integreiddio i'w weld yn Ffigur 16, “Integration Main page view”

Mae'r integreiddiad yn cael ei arddangos ym mhanel ochr y Ddogfen View ac mae ar gael ar gyfer mathau traciwr a gefnogir lle mae'r DdogfenView ar gael. Swyddogaeth botymau'r bar dewislen, o'r chwith i'r dde:

Yn cyfeirio at Open Config Space botwm - cliciwch i ddewis y gofod ffurfweddu fel yr eglurir yn y Penbwrdd Hwb a'r Web Adrannau both.
Yn cyfeirio at y Model Viewer - cliciwch i agor Configspace/VDM a ddewiswyd ar hyn o bryd yn y Model Viewer web cais. (Dim ond yn weladwy yn y Web Modd both)

Yn cyfeirio at y botwm Adnewyddu - cliciwch i adnewyddu'r goeden fodel Nodwedd/Amrywiad y tu mewn i'r Goeden-view.
Yn cyfeirio at y botwm Expand - cliciwch i ehangu'r goeden gyfan y tu mewn i'r goeden-view.
Yn cyfeirio at y botwm Cwymp - cliciwch i ddymchwel y goeden sydd wedi'i rendro y tu mewn i'r goeden-view.

Yn cyfeirio at Show Preview botwm - cliciwch i alluogi'r cynview ar gyfer delweddu amrywioldeb Gwybodaeth; ar gael yn y Ddogfen View ac yn cefnogi fformat Wiki yn unig ar gyfer meysydd gyda'r math WikiText.
Yn cyfeirio at Ailosod Cynview botwm - cliciwch i analluogi'r Preview.
Yn cyfeirio at y botwm Gwirio Gwallau - cliciwch i agor y Gwiriad Gwall view, i weld y gwallau yn rheolau PVSCL.

Yn cyfeirio at y botwm Cyfrifiadau - cliciwch i agor y dudalen Cyfrifiadau, felly i olygu cyfrifiadau sy'n bresennol y tu mewn i feysydd eitem olrhain.
Yn cyfeirio at y botwm Cyfyngu - cliciwch i agor y dudalen Cyfyngiadau, felly i olygu'r cyfyngiad y tu mewn i feysydd pvCyfyngiad eitem olrhain.
Yn cyfeirio at y botwm Gosodiadau - cliciwch i lywio i'r dudalen Gosodiadau er mwyn ffurfweddu'r gosodiadau Cyffredinol, gosodiadau penodol Cyfrifiadau, a hefyd i weld y wybodaeth Integreiddio benodol.

O dan y bar dewislen, mae'r gwymplen Dewisydd VDM sy'n rhestru'r holl fodelau amrywiad sydd ynghlwm wrth y gofod ffurfweddu a ddewiswyd. Wrth ddewis unrhyw un o'r model amrywiad o'r gwymplen, bydd y model yn cael ei rendro y tu mewn i'r Goeden-view. Y Goeden -view yn rhestru'r model(au) Nodwedd/Amrywiad a ddewiswyd.

Nodyn:

Mae'r botwm ar gyfer Gwirio Gwall wedi'i analluogi rhag ofn y DesktopHub anghywir neu WebDefnyddir fersiwn yr hwb (gweler y Bennod 'Gofynion Meddalwedd').

Yn ystod cynview cefnogir sgrolio fertigol o'r brif adran ddogfen i alluogi ailview o'r ddogfen.

Gweithio gyda Golygydd Cyfyngiadau

Gellir agor y Golygydd Cyfyngiadau trwy glicio ar yr eicon Cyfyngiadau. Golygu cyfyngiadyn Golygydd Cyfyngiadau trwy ddewis eitem mewn traciwr. Mae'r Golygydd Cyfyngiadau yn darparu gallu cynigion cwblhau ceir ac amlygu cystrawen wrth olygu cyfyngiadau ar gyfer eitemau traciwr

Gweithio gyda Golygydd Cyfrifiadau

Gellir defnyddio'r Golygydd Cyfrifiadau i olygu'r cyfrifiadau sy'n bresennol ym meysydd eitem olrhain. Gallwch ei agor trwy glicio ar yr eicon Cyfrifiadau. Gellir golygu cyfrifiadau trwy ddewis eitem mewn traciwr ac yna, yn y Golygydd Cyfrifiadau, dewis maes eitem sy'n cynnwys y marcwyr cyfrifo. Ar ôl dewis maes, mae'r holl gyfrifiadau yn y maes hwnnw yn ymddangos yn y rhestr isod. Dewiswch gyfrifiad o'r rhestr a'i olygu yn y golygydd isod.
Mae'r Golygydd Cyfrifiadau yn cefnogi cwblhau cynigion yn awtomatig ac amlygu cystrawen wrth olygu cyfrifiadau.

Gweithio gyda Chamau Prawf

Mae'r cyfyngiad a'r Golygydd Cyfrifo yn cefnogi Camau Prawf fel y'u rhestrir o fewn Achosion Prawf yn y Ddogfen View o godbeamer. Yma, mae angen dewis rhes goncrit sy'n cynrychioli Cam Prawf yn y tabl Camau Profion estynedig, ac felly bydd data'r Cam Prawf hwn yn ymddangos yn y golygyddion. Bydd cyfyngiadau'n cael eu hychwanegu at y maes “pvRestrictionsTestSteps”, tra bydd cyfrifiadau'n cael eu hychwanegu yn y lleoliadau a nodir gan farcwyr amnewid y tu mewn i feysydd a gefnogir, fel y dangosir yn yr example isod (Ffigur 19, “Golygu Cyfrifiadau Y Tu Mewn i Gamau Prawf”).

Gwirio Gwall

Gellir gwirio gwybodaeth amrywioldeb ychwanegol am wallau gan ddefnyddio'r swyddogaeth Gwirio Gwallau. Mae gwallau mewn sgriptiau pvSCL yn cael eu hadrodd os nad yw cystrawen y sgript yn cydymffurfio â pvSCL, neu os yw elfen yn anhysbys yn seiliedig ar y modelau amrywiolion pur:: wedi'u llwytho.
Dangosir y problemau mewn rhestr sy'n cynnwys y wybodaeth ganlynol:

Neges: Disgrifiad o'r gwall.
pvSCL: Y mynegiad pvSCL sy'n cynnwys y gwall.

Maes: Enw'r maes sy'n cynnwys y gwall.
Dolen Eitem: URI yr eitem yr effeithiwyd arni

Mae difrifoldeb y broblem yn cael ei nodi gan eicon (gwall neu rybudd).
Nodyn: I wirio gyda strwythurau model nodwedd hierarchaidd sy'n cynnwys achosion amrywiol, mae angen dewis model amrywiad hefyd i'w werthuso'n iawn.

Amrywiaeth mewn Tablau WIKI

Er mwyn ychwanegu amrywioldeb at Dablau WIKI mae angen rhes a cholofn benodol i ddal y wybodaeth amrywioldeb. Gellir ychwanegu'r golofn a'r llinell hon unrhyw le yn y tabl, ond mae angen iddynt gynnwys yr allweddair penodedig, a ddefnyddir hefyd i nodi cyfyngiad, ar ee gofyniad. Yn ddiofyn, yr allweddair hwn yw Cyfyngiad pv.

Fel y dangosir yn yr exampLe table, mae'r celloedd pvCyfyngiad a amlygwyd yn disgrifio'r amrywioldeb ar gyfer eu rhes a'u colofn priodol. Gwybodaeth amrywioldeb cell benodol yn y tabl yw cynnyrch AND gwerthoedd cyfyngu ei rhes a'i cholofn. Yn y cynampBydd y golofn gyfan “Static Cornering Lights” ond yn rhan o'r amrywiad, os dewiswyd y nodwedd CorneringStaticLights. Bydd y gell o dan y pennawd yn y golofn honno yn cael ei chynnwys mewn amrywiad os dewiswyd CorneringStaticLights AND LED. Mae'r celloedd gwybodaeth amrywioldeb (ee y celloedd pvCyfyngiad melyn wedi'u marcio yn yr example) yn cael eu tynnu o'r amrywiad yn ddiofyn.

Bydd cyfrifiadau hefyd yn cael eu cyfrifo os ydynt wedi'u marcio â'r nodau agored a chau priodol, a thablau nythu, fel bod byrddau â chelloedd, sydd eu hunain eto'n dal bwrdd, yn cael eu cefnogi ac yn cydymffurfio â'r un rheolau ag a ddisgrifir uchod.

Cyfyngiadau

Cyfyngiadau Perthynol i Amnewid Testun mewn Meysydd WikiText

Gan fod y set o nodau marcio amnewidiad pur::amrywiadau yn gallu gwrthdaro â nodau arbennig WikiText (ee mae '[…]' yn diffinio hyperddolen WikiText), mae'r pur::amrywiadau prosesu amnewid testun yn edrych am ffurf dianc WikiText o'r nodau arbennig hynny ( felly ee '~[' a '~]' ar gyfer y marcwyr rhagosodedig '[' a ']'). Mae'r ffurflen hon yn cael ei chreu yn y rhan fwyaf o achosion gan olygydd codbeamer WikiText Rich Text wrth ychwanegu'r nodau hyn yno. Hefyd bydd swyddogaeth teclyn integreiddio yn defnyddio'r ffurflen hon sydd wedi dianc.

Bydd defnyddio golygydd codbeamer WikiText RichText a chyfyngiadau cystrawen WikiText yn gyffredinol yn arwain at gyfyngiadau ar y defnydd o amnewidiadau testun o fewn cynnwys WikiText:

Dim ond lle gellir defnyddio testun wedi'i fformatio o fewn cynnwys WikiText y cefnogir adrannau amnewid testun. Felly y mae ar gyfer cynampNi chefnogir ychwanegu amnewidiadau yn dilyniannau rheoli WikiText nac yn y targed URL rhan o hyperddolen WikiText.
Gan fod gan y dilyniant testun '${…}' ystyr arbennig yn codebeamer, ni argymhellir defnyddio '{' a '}' fel marcwyr agor a chau amnewid a '$' fel marciwr dianc amnewid.
Nid yw'n cael ei gefnogi i ddefnyddio fformatio testun o fewn neu ar draws ffiniau adrannau amnewid testun. Gall hyn arwain at fynegiadau pvSCL annilys neu at greu cynnwys WikiText annilys yn ystod trawsnewid. Yr unig eithriad yw'r defnydd o fformatio o fewn testun llythrennol pvSCL.

Mewn codebeamer, gellir newid fformat maes disgrifiad yr eitem o WikiText i destun plaen ar gyfer pob eitem unigol. Ni chefnogir defnyddio amnewidiadau testun mewn disgrifiadau testun plaen o'r fath.

Cyfyngiadau Hysbys y Fersiynau Codebeamer â Chymorth

Yn yr adran hon rhestrir materion hysbys o godbeamer, sy'n achosi cyfyngiadau ar ymarferoldeb y cysylltydd pur::amrywiadau ar gyfer codbeamer:

Wrth ddiweddaru olrheinwyr Set Brawf mewn setiau gweithio amrywiolion, ar gyfer achosion prawf y cyfeirir atynt, nad ydynt yn rhan o'r amrywiad, mae cyfeiriadau achos prawf at y traciwr Achos Prawf 150% yn cael eu hychwanegu'n ffug.

Mae diweddaru setiau gweithio amrywiolion yn seiliedig ar gyfuniadau gwaelodlin ffynhonnell penodol ar lefel traciwr yn cael eu gwrthod ar gam. Felly, os dewisir gwaelodlin HEAD ar gyfer un traciwr o leiaf ac ar gyfer o leiaf ddau draciwr yr un llinell sylfaen yn cael ei ddewis, bydd beamer cod yn canslo'r diweddariad gyda neges gwall 'Allwedd ddyblyg ...'.
Mae llinellau sylfaen traciwr, hy, llinellau sylfaen a grëwyd ar gyfer traciwr sengl, bob amser yn cael eu creu ar brif gangen y set waith ddiofyn. Felly ni fydd defnyddio llinellau sylfaen tracio yng nghyd-destun set waith nad yw'n ddiofyn yn gweithio.
Felly argymhellir defnyddio llinellau sylfaen prosiect yn lle hynny i ddiffinio cyflwr y set waith ffynhonnell i'w defnyddio ar gyfer trawsnewid

Dogfennau / Adnoddau

pur-systemau amrywiadau pur Connector for codebeamer [pdfLlawlyfr Defnyddiwr
amrywiadau pur, Connector ar gyfer codbeamer, amrywiadau pur Connector ar gyfer codbeamer, amrywiadau pur Connector, Connector

Cyfeiriadau

Llawlyfr Defnyddiwr

Rhagymadrodd