puri-sistemi puri varianti Connettore per codebeamer

Introduzione

pure::variants U connettore per codebeamer permette à l'utilizatori di codebeamer di gestisce i bisogni è di pruvà a variabilità di l'artefatti usendu pure::variants. Coupling pure::variants è codebeamers, a cunniscenza nantu à a variabilità è e varianti pò esse formalizata, spartuta è evaluata automaticamente. Questu permette di ottene risposte à e dumande nantu à cumminazzioni valide di esigenze è teste di artefatti in varianti di produttu rapidamente; permette un seguimentu faciule di varianti di produttu pianificati è liberati à u livellu di i requisiti è di l'artefatti di prova, è permette ancu a produzzione assai efficiente di documenti di esigenze specifiche di varianti, seti di teste è casi di teste fora di i requisiti è di u repertoriu di l'artefatti di prova rispettivamente.

Circa stu manuale

U lettore hè previstu d'avè cunniscenze basi è Sperimenta cù u codebeamer è l'arnesi puri::variants. U manuale di pure::variants hè dispunibule in l'aiutu in linea è in formatu PDF stampabile quì.

Requisiti di u Software

U software chì seguita hè necessariu da u pur::variants Connector per codebeamer:

• Codebeamer PTC 22.10-LTS o 22.10-SP3. A cumpatibilità cù altre versioni di codebeamer ùn hè micca garantita.
• pure::variants cumpunente di u servitore per codebeamer in a listessa versione di u connettore. U connettore richiede l'implementazione di cumpunenti specifichi puri::variants in u servitore codebeamer
• pure::variants Desktop Hub o Web Hub ancu in a stessa versione cum'è u cunnessu stessu:
  Puru::variants Desktop Hub hè furnitu cù u pacchettu di installazione di puri::variants Enterprise Windows è pò esse installatu selezziunate i Componenti di Integrazione in l'assistente di l'installazione, mentre chì l'installazione di Web Hub hè descrittu in a Guida di Setup Pura::variants.

Puru::variants Connector per codebeamer hè una estensione per pure::variants è hè dispunibule nantu à tutte e piattaforme supportate.

Installazione

Per piacè cunsultate a sezione pure::variants Connectors in a pure::variants Setup Guide per infurmazioni detallate nantu à cumu installà u connector (menu Aiutu -> Help Contents è dopu pure::variants Setup Guide -> pure::variants Connectors).Installazione. Passi specifichi per u connettore codebeamer, implementazione di i cumpunenti, è a descrizzione di cumu cunfigurà un sign-on unicu sò descritti in a guida di configurazione pura::variants.

Passi di stallazione specifichi à u connettore codebeamer, implementazione di i cumpunenti, è ancu a descrizzione di cumu cunfigurà un sign-on unicu sò descritti in a guida di configurazione pura::variants.

Utilizà u Connector

Partendu puri::varianti

Sicondu u metudu di stallazione utilizatu, sia principià l'Eclipse pur::variants-enabled o sottu Windows, selezziunate l'elementu pure::variants da u menù di u prugramma.

Se a perspettiva di Gestione Varianti ùn hè micca digià attivata, fate cusì selezziunate da Perspettiva Aperta -> Altru ... in u menù Finestra.

Preparazione di u Project Codebeamer

Per uttene l'infurmazioni di variabilità da l'articuli codebeamer, è ancu per assignà elementi à varianti in codebeamer, i trackers codebeamer anu da esse preparatu inizialmente. Per fà l'infurmazioni di variabilità dispunibuli à pure::variants, un attributu deve esse stabilitu per ogni tracker codebeamer chì deve esse processatu in quantu à a so variabilità.
Per stabilisce questu attributu per ogni tracker sceltu, andate à CodeBeamer è utilizate l'opzione Configurazione di u tracker. Quì, selezziunate a pagina Campi è aghjunghje un novu campu persunalizatu chjamatu "pvRestriction" di u tipu "Text". Inoltre, per preparà a trasfurmazioni Enum per almacenà l'infurmazioni di variabilità in codebeamer, hè necessariu un altru campu persunalizatu, chjamatu "pvVariants" di u tipu "Text".
Per i Passi di Test in Test Cases, in a Definizione di a Tabella, i campi persunalizati "pvRestrictionTestSteps" è "pvVariantsTestSteps" di u tipu "Text" anu da esse aghjuntu, rispettivamente.

Autentificazione

Per utilizà u connettore, hè sempre necessariu esse autenticatu à l'applicazione codebeamer.
Ci sò dui meccanismi di autentificazione supportati

1. Utilizà e credenziali di codebeamer
2. OpenID Connect (per Single Sign-On)

Durante l'usu di u connettore, per i dui meccanismi, l'utilizatore serà dumandatu cù un dialogu di login, chì aspetta i credenziali di l'utilizatore. In u casu di Single-Sign-On, un dialogu di login basatu in u navigatore serà mostratu chì hè furnitu da u Servitore di Autentificazione cunfiguratu.

Crià u mudellu iniziale (s)

U primu passu hè sempre di creà u mudellu di famiglia currispundente per ogni settore di travagliu pertinente chì cuntene trackers di codice beamer selezziunati. Questi mudelli di famiglia iniziali servenu cum'è punti di partenza per utilizà l'infurmazioni di variabilità esistenti.

A prucedura di impurtazione deve esse eseguita una sola volta per ogni set di travagliu di codice beamer, ma pò esse aghjurnatu dopu. Ogni tracker hè rapprisintatu da un elementu di nodu di mudellu in u mudellu di famiglia pura::varianti chì hè creatu durante l'importazione.

Prima chì l'importazione attuale pò esse iniziata, un prughjettu di Gestione di Varianti deve esse creatu, induve i mudelli impurtati seranu guardati. Selezziunà Prughjettu da Novu in u File menu. Sceglite Variant Projects sottu Variant Management in a prima pagina di l'assistente di u novu prughjettu. Sceglite un nome per u prugettu è selezziunate Empty cum'è u tipu di prughjettu (vede a Figura 1, "Creazione di un prughjettu di Gestione di Varianti vacanti per l'importazione di codice beamer tracker").

L'importazione hè iniziata da selezziunate l'azzione di impurtazione sia in u menù di cuntestu di u Prughjettu view o cù u menù Import in u File menu. Selezziunate Varianti Modelli o Prughjetti è appughjà Next. In a pagina seguente, selezziunate "Importà trackers codebeamer o gruppi di travagliu".
L'assistente d'importazione appare. In a prima pagina, avete da definisce o selezziunate l'indirizzu di u servitore codebeamer da quale vulete impurtà i trackers.

Se ùn site micca autenticatu, pudete aduprà Test Connection. Questu apre u dialogu di login chì furnisce parechje pussibulità per l'autentificazione.

1. U nome d'utilizatore è a password di codebeamer ponu esse furniti cù l'opzione "Credenziali d'Usuariu di codebeamer".
2. U servitore di autentificazione pò esse utilizatu selezziunate l'opzione "Server d'autentificazione (OAuth2)".
   

Quale metudu di login funziona per voi dipende da a cunfigurazione di u servitore codebeamer.
In a pagina dopu, pudete decide s'ellu vulete realizà una impurtazione cumpleta di l'infurmazioni di variabilità di u vostru codebeamer tracker (Modu Full) o se vulete solu impurtà l'intestazione di u modulu (Modu Rapidu). In l'ultimu casu, i dati sò automaticamente sincronizzati prima di una trasfurmazioni, mentri in u modu sanu, l'utilizatore hè rispunsevuli di mantene e dati sincronizati, cum'è e dati esistenti sò usati per trasfurmà e varianti.
Utilizendu u Modu Full, i punti di variazione truvati in i trackers sò rapprisentati in u Modellu Famiglia chì hè creatu.

Chì dati seranu impurtati ponu esse cunfigurati da l'utilizatore nantu à a pagina dopu.
A lista cumpleta di prughjetti di u repository codebeamer hè mostrata, è ancu i gruppi di travagliu sò elencati sottu à ogni prughjettu dispunibule. Navigate à u Working-Set chì cuntene i trackers di interessu è selezziunate u cuntrollu

scatuli nantu à u latu manca. Multiple Working-Sets da diversi prughjetti ponu esse sceltu à tempu per impurtà. Selezziunate una casella di spunta à u latu manca per u Working-Set marca tutti i trackers per impurtà. A selezzione per trackers individuali in un Working-Set hè ancu pussibule usendu u pane drittu.
Nota: Per piacè nutate, solu l'infurmazione hè presentata à quale l'utilizatore hà i diritti d'accessu adattati

Assicuratevi chì u locu di destinazione d'impurtazione datu accantu à "Import in" hè currettu. U locu pò esse cambiatu cù u buttone Sceglie. Selezziunate l'opzione "Store creatu mudelli secondu a struttura di u cartulare", u prucessu d'impurtazione crea cartelle per u prughjettu è u Working-sets rispettivamente, in pura::varianti per i mudelli di famiglia.

I mudelli di famiglia creati sò chjamati per difettu secondu u schema _, ma questu pò esse mudificatu cù a casella di edizione.

Nota: Ancu se i trackers di tutti i tipi ponu esse impurtati, solu i trackers di certi tipi seranu cunsiderati durante a trasfurmazioni (per una lista di tipi, vede u capitulu Trasfurmà una Variante di stu manuale).

Inoltre, i punti di variazione sò cunsiderati solu durante l'importazione in questi trackers.

Utilizendu a pagina dopu, pudete selezziunà a linea di basa per ogni tracker sceltu per esse utilizatu cum'è a versione fonte per a Trasfurmazione di u Set di Travagliu

• A selezzione pò esse eseguita à u livellu di u Set di travagliu per e basi pertinenti o separatamente per ognunu di i trackers. À u nivellu di u Set di Travagliu sò listati quelli basi chì sò cumuni per ognunu di i trackers. A selezzione hè assistita da una funzione di ricerca chì filtra e linee di basa per esse sceltu
• In alternativa, pò esse definitu per un tracker per esse cumpresu cum'è spartutu in u Set di travagliu chì hè creatu da a Trasfurmazione di u Set di travagliu.

Nota: U statu spartutu di trackers chì sò per definizione spartuti ùn pò micca esse cambiatu è hè visualizatu cum'è lettura solu in u dialogu.

Nant'à a pagina seguente, i Reguli di Importazione sò mostrati. In questa pagina, pudete selezziunà setti di Reguli d'Importazione, chì seranu utilizati per manipulà u mudellu risultatu dopu l'importazione. Seti di Regule d'Importazione ponu esse aduprati per creà elementi specifichi di mudelli puri::varianti cum'è restrizioni o limitazioni da l'infurmazioni di l'artefatti di codebeamer.

Aghjurnà i mudelli da codebeamer

Utilizendu l'azzione Synchronize, u settore di trackers da esse impurtati cum'è parte di un Working-Set pò esse mudificatu. Inoltre, quandu si usa u Modu Full, hè necessariu aghjurnà i mudelli puri::variants cù l'infurmazioni da codebeamer ogni volta chì sò stati fatti cambiamenti pertinenti. Per inizià l'aghjurnamentu, apre u mudellu chì rapprisenta u Working-Set è appughjà u buttone Synchronize in a barra di strumenti.

pure::variants si cunnetta à codebeamer per presentà a pagina di selezzione di tracker, a pagina di selezzione di basa, è in seguitu l'Editor di Comparazione per i mudelli puri::variants.

L'editore di paragunà hè utilizatu in tutta pure::variants per paragunà e versioni di mudelli, ma in questu casu hè utilizatu per paragunà i dati di codebeamer (visualizati in u latu inferjuri à destra) cù u mudellu currente pure::variants (inferiore left). Tutti i cambiamenti sò listati cum'è elementi separati in a parti suprana di l'editore, urdinatu da l'elementi affettati.

A selezzione di un articulu in questa lista mette in risaltu u cambiamentu rispettivu in i dui mudelli. In questu example, u tracker "Test Cases" hè statu cacciatu da u scopu di l 'importazione.
A barra di strumenti Merge furnisce strumenti per copià una sola o ancu tutti i cambiamenti (senza cunflittu) in tuttu da u mudellu attuale à u mudellu anticu.

Definizione di una Variante

U prossimu passu hè a definizione di e varianti attuali di interessu. Siccomu u mudellu di variabilità generalmente permette a definizione di un gran numaru di varianti, pure::variants mantene a traccia solu di quelli varianti chì sò d'interessu per l'utilizatori. Di genere, stu numeru hè assai più chjucu cà u numeru di varianti pussibuli.

Varianti sò guardati cum'è entità separati chjamati Variant Description Models (VDM). Un VDM appartene sempre à un spaziu di cunfigurazione specificu. Cusì, prima di definisce varianti, un spaziu di cunfigurazione deve esse creatu. Selezziunate u prughjettu chì cuntene i mudelli impurtati in i Prughjetti Varianti view è apre u menù di cuntestu. Sottu l'elementu Novu selezziunate u spaziu di cunfigurazione. Un mago hè apertu. À a prima pagina (Figura 10, "L'Assistente di u spaziu di cunfigurazione"), entre un nome per u spaziu di cunfigurazione. U nome hà da seguità regule strette (senza spazii, nè caratteri speciali). Spuntate a casella prima di Crea una trasformazione standard, postu chì per i mudelli di esigenze puri a trasfurmazioni standard ùn furnisce micca funziunalità pertinenti (Vede u Manuale d'utilizatore puri::variants per più infurmazione nantu à e trasfurmazioni).

A pagina dopu hè aduprata per specificà chì mudelli sò da esse inclusi in stu spaziu di cunfigurazione. Selezziunate quì tutti i mudelli chì rapprisentanu u Working-Sets è cusì i trackers di interessu. In l'example quì sottu, hè sceltu solu un mudellu di famiglia. Avà appughjà u buttone Finish.

A struttura di u prugettu risultatu hè mostrata in (Figura 12, "Struttura di u spaziu di cunfigurazione iniziale"). U DemoVariants.vdm hè creatu è subitu apertu in casu chì a Crea una descrizzione di varianti predeterminata hè stata scelta nantu à a prima pagina di l'assistente.

Trasfurmà una Variante

Varianti almacenati in un mudellu di descrizzione varianti ponu esse dispunibili in codebeamer. U Connector supporta i seguenti modi di rapprisintà varianti: basatu in attributi

Rappresentazione Variante Basata in Attributi
In a rapprisintazioni basata in l'attributi definiscemu un campu persunalizatu per ogni tracker codebeamer sceltu per esse aghjuntu à ogni articulu tracker. Stu modu di trasfurmazioni aghjunghjenu u nome di e varianti (cum'è una lista, siparata da novi linee) se l'elementu di seguimentu hè parti di a variante. U nome di questu attributu pò esse definitu da l'utilizatori per una trasfurmazioni, u default hè pvVariants.
Stu tipu di trasfurmazioni hè applicabile à i seguenti tipi di tracker: Requirement, Test Case (incl. Test Steps), Test Set, Test Configuration, Configuration Items
Nota: In casu chì un tracker hè escludutu da l'utilizatore per una variante in u Modellu Famiglia, u nome di a variante serà eliminatu da questa lista di varianti in codebeamer.
Nota: Questa trasfurmazioni ùn pò micca esse eseguita nantu à i trackers cù linee di basa altru ch'è HEAD è dunque puri::varianti signalanu un errore.

Trasfurmazione di u Set di travagliu

L'assi di a Linea di Produttu (150%) ie trackers (requisiti, casi di prova, etc.) sò assignati à un Set di Travagliu dedicatu o à u Set di Travagliu Predeterminatu in codebeamer. U Set di travagliu

A trasfurmazioni pò esse aduprata cù o senza supportu di aghjurnamentu:

• Senza supportu di l'aghjurnamentu, a trasfurmazioni crea una variante specifica di Working Set per ogni esecuzione di trasfurmazioni è per ogni variante (vdm) cù trackers chì cuntenenu i subsets specifichi varianti di elementi di tracker (100%). Per automaticamente, a cunvenzione di nomenclatura per a variante specifica di u Set di Travagliu creatu hè uguale à u , per esempiu "DemoVariant". U nome predeterminatu pò esse cambiatu da u paràmetru di trasfurmazioni "WorkingSetName" (vede u capitulu "Preparazione di una Trasfurmazione"). In casu chì un Set di Travagliu cù u stessu nome esiste digià, un errore hè signalatu è ùn hè micca realizatu trasfurmazioni.
  Un modu praticu per creà gruppi di travagliu cù un nome diversu per ogni corsa hè di appiccicà u tempuamp di a trasfurmazioni di u nome. Pudete fà per stabilisce u valore di 'WorkingSetName' à '$(VARIANT)_$(QUALIFIER)'.
• Cù supportu di l'aghjurnamentu, l'aghjurnamentu di i trackers specifichi di varianti precedentemente trasformati hè supportatu. Ci sò dui modi dispunibuli, u Modu di Merge Manuale, è u Modu di Overwrite Full

Modu di fusione manuale - in questu modu, a variante hè rapprisintata da dui gruppi di travagliu, un settore di travagliu di riferimentu è di copia di travagliu. U settore di travagliu di riferimentu hè creatu novu in a prima corsa di trasfurmazioni è hè soprascritta in ogni trasfurmazioni ulteriore. U travagliu-copia hè ancu creatu da a prima trasfurmazioni è u cuntenutu pò esse mudificatu da l'utilizatore. Stu settore di travagliu ùn hè micca aghjurnatu automaticamente, ma i cambiamenti fatti in u settore di travagliu di riferimentu anu da esse unitu manualmente in a copia di travagliu.

Modu di Overwrite Full: in questu modu, a variante hè rapprisintata da un settore di travagliu chì hè creatu da a prima trasfurmazione è hè soprascritta in ogni trasfurmazioni sussegwenti.

In deve esse decisu in anticipu quale modu di aghjurnamentu à aduprà, cambià trà i modi dopu chì e trasfurmazioni sò state digià realizate ùn hè micca pussibule.

Nota:

• L'utilizatore hà da avè u permessu di u nivellu di tracker per rimpiazzà u cuntenutu di una filiera (impostazione di permessu in codebeamer: 'Branch - Sustituisce u cuntenutu')
• In alcune combinazioni di tracker, a creazione di set di travagliu in codebeamer cambia a cunfigurazione di tracker, ma ùn hè micca supportata da l'aghjurnamentu. Questu restringe l'usabilità di l'aghjurnamentu di certe combinazioni di tracker, per esempiu, i trackers "Specificazioni di u Requisitu di u Sistema" è "Specificazioni di i Requisiti di u Cliente" anu sempre esse inclusi in u settore di travagliu à u stessu tempu.
• Vede 'pure::variants Guida di l'Usuariu', Capitulu 'Configurazione di una Trasfurmazione' per infurmazione cumu per attivà u supportu di l'aghjurnamentu.

Per tutti i modi di a Trasfurmazione di u Set di Travagliu, ci vole à nutà:

• L'utilizatore deve avè permessu di creà gruppi di travagliu. (Configurazione di permessu in codebeamer: 'Working-Set - Admin').
• I trackers inclusi (vale à dì i trackers micca spartuti) sò ramificati da i trackers in u Set di Travagliu urigginatu à a basa definita da l'utilizatore durante l'importazione è sò ridotti à u subset specificu di varianti. I trackers spartuti sò solu aghjunti à u Set di Travagliu, ma senza alcunu cambiamentu in quantu l'infurmazioni di variabilità ùn sò micca cunsiderate quì.
• A versione HEAD di un ramu di tracker specificu di varianti (se apprupriatu) pò esse mudificatu solu in codebeamer per include cuntenutu esclusivu varianti.

Stu tipu di trasfurmazioni hè applicabile à i seguenti tipi di tracker: Requirement, Test Case (incl. Test Steps), Test Set, Configuration Items.

Sustituzione di testu

I seguenti tipi di tracker è campi sò sottumessi à a sustituzione di testu:

• Esigenza (Nome, Descrizzione) Test Case (Nome, Pre-Azione, Post-Azione, Parametri di Test (i dui paràmetri di prova)
• nomi è i so valori), Description) Passi di prova (Tutti i campi di tipu Testu è Wikitext)
• Test Set (Nome, Parametri di Test (i dui nomi di parametri di prova è i so valori), Description)
• Elementi di cunfigurazione (Nome, Descrizzione)

Nota: A sustituzione di testu hè realizata solu durante a "Trasformazione di u Set di travagliu" è solu per i trackers chì ùn sò micca inclusi in un settore di travagliu cum'è spartutu.

Preparazione di una Trasformazione

Per trasfurmà una variante, prima deve esse creata una Configurazione di Trasformazione. Per creà una Configurazione di Trasfurmazione, cliccate nantu à a freccia accantu à u buttone Trasfurmazione in a barra di strumenti è sceglite Open Transformation Config Dialog...

U dialogu di a pruprietà di u spaziu di cunfigurazione si apre, è a tabulazione di Configurazione di Trasfurmazione hè mostrata. U prossimu passu hè di aghjunghje una nova Configurazione di Modulu, clicchendu l'elementu marcatu di a barra di strumenti. Avà aghjunghje un novu Modulu à a Configurazione di Modulu, usendu u buttone Aggiungi.

Da u dialogu apertu, sceglite Intland codebeamer Transformation Module è inserite un nome. A pagina dopu mostra tutti i paràmetri. U paràmetru Modus specifica una di e rappresentazioni di u risultatu varianti, cum'è descrittu sopra

Si deve definisce i seguenti parametri:

• Modu: Definisce u modu di trasfurmazioni. I modi dispunibili sò: Enumerazione - questa opzione sta per a Rappresentazione Variante Basata in Attributi. Working-Set - questa opzione sta per a Trasfurmazione di u Set di travagliu.
• EnumerationField: Specifica u nome di u campu di l'elementu di tracker per esse cumpletu cù nomi varianti in u modu di trasfurmazioni di l'enumerazione. Se ùn hè micca stabilitu u nome standard ("pvVariants") hè utilizatu.
• EnumerationCleanup: Se hè sceltu veru, tutti l'attributi di varianti esistenti sò eliminati prima di esportà a variante attuale. Se falsu, solu i nomi di a variante trasfurmata seranu aghjurnati (sguassati o aghjuntu).
• WorkingSetName: Specifica u nome di u Working Set creatu da a trasfurmazioni.
• PerformPartialTextSubstitution: Se true hè sceltu, a sostituzione parziale di testu hè realizata.
• UpdateMode: Definisce u modu di aghjurnamentu per a Trasfurmazione di u Set di Travagliu in casu chì u supportu di l'aghjurnamentu hè attivatu. I modi di aghjurnamentu dispunibili sò:

ManualMerge - questa opzione sta per u Modu di fusione manuale
FullOverwrite - questa opzione sta per u Modu di Sovrascrittura Completa Dopu avè finitu i dialoghi, a trasfurmazioni pò esse simplicemente aduprata clicchendu nantu à u buttone. Trasfurmà buttone in a barra di strumenti è scegliendu a trasfurmazioni da u menù pull down.

Web Integrazione di Clienti per a trasfurmazioni

Per piacè cunsultate a sezione Transformatio Help Contents in i puri::varianti Web Manuale di Cliente per infurmazioni detallate nantu à cumu fà a Trasformazione utilizendu Web Integrazione di Clienti

Utilizendu l'Integrazione

Per facilità u puru::variants connector per a variabilità di codebeamer, l'infurmazioni deve esse aghjuntu à l'articuli tracker. Questu hè realizatu aghjunghjendu restrizioni à l'articuli di tracker è hè assistitu da l'applicazione Desktop Hub chì hè furnita da l'installazione di client puri::variants o l'integrazione in l'uttellu chjamata pure::variants Integration for CodeBeamer.

Adding Variability Information Utilizendu u Desktop Hub

U Desktop Hub usa u clipboard per inserisce infurmazioni da pure::variants in altre applicazioni incollandu in i campi attivi editati da l'utilizatore. In codebeamer, l'elementu tracker deve esse apertu in modu di edizione prima, dopu selezziunate u campu "pvRestriction" prima di attivà Desktop Hub utilizendu a combinazione di tasti di scelta rapida.

Nota: Più infurmazione nantu à u Desktop Hub pò esse truvata in u puramente::variants Desktop Hub Manual'

Adding Variability Information Utilizendu u widget puri::variants

Una volta chì l'Integrazione hè stata aghjunta à codebeamer (vede u rispettivu capitulu 'pure::variants Connectors' in a pure::variants Setup Guide) per a prima volta, a tabulazione Generale. view sottu a pagina di Settings serà mostratu chì basamente piglia l'input da l'utilizatore finale per selezziunà trà unu di i dui modi dispunibili, l'Integrazione duveria eseguisce in u modu Desktop Hub, o Web Modu Hub. Per automaticamente, u modu di Desktop Hub hè stallatu cum'è u modu predeterminatu

Prerequisiti per u Modu Hub Desktop

Per eseguisce l'integrazione in u modu Desktop Hub, una istanza in esecuzione di Desktop Hub hè necessaria in fondo. Mentre l'istanza di Desktop Hub hè in esecuzione, in l'Integrazione, andate à a tabulazione Generale view sottu a pagina Settings. Avvisu chì u Desktop Hub hè digià sceltu in Connect via u drop-down (hè perchè Desktop Hub hè u modu predeterminatu di l'integrazione); l'unicu ciò chì hè necessariu hè u numeru di portu nantu à quale l'istanza di Desktop Hub hè in esecuzione, per quessa, inserite u numeru di portu in u tipu di input di Desktop Hub datu. Dopu, appughjà u buttone OK per salvà i paràmetri di u modu. L'integrazione redirigerà dopu à a so pagina principale è cumincià à correre in u modu Desktop Hub.

Per carica u Spaziu di cunfigurazione in u Modu Hub di Desktop: Per selezziunà un Spaziu di cunfigurazione, premete u buttone Open Configuration Space da a barra di menu di Integrazione. U Desktop Hub file dialogu di selezzione serà mostratu per selezziunà u spaziu di cunfigurazione desideratu. Quandu u Spaziu di cunfigurazione hè sceltu, l'Integrazione mostrarà immediatamente u Spaziu di cunfigurazione sceltu.

Prerequisiti per u Web Modu Hub

Per eseguisce l'integrazione in Web Modu Hub, un'istanza in esecuzione di e varianti pure:: Web I cumpunenti hè necessariu (vede u capitulu "pure::variants Web Components' in a 'pure::variants Setup Guide'). Mentre i puri::varianti Web Cumpunenti hè in esecuzione, in l'Integrazione in a scheda Generale view sottu a pagina Settings, sceglie u Web U valore di u Hub da u Connect via drop-down è poi inserite l'URI à l'istanza in esecuzione di a variante pura:: Web Cumpunenti in u datu Web Tipu di input di hub. Dopu, appughjà u buttone OK per salvà i paràmetri di u modu. L'integrazione hà da esse reindirizzatu à a so pagina principale è cumincià à correre Web Modu Hub

Definite i paràmetri di trasfurmazioni

In a pagina di Configurazione, più paràmetri pertinenti di trasfurmazioni ponu esse definiti per l'istanza di tracker attivu:

• Utilizendu a tabulazione Generale, l'attributu utilizatu per almacenà e restrizioni pò esse definitu. U valore predeterminatu hè 'pvRestriction'.
• Per l'articuli di tracker in Table-Fields, u nome di u campu hè appiccicatu senza spazii bianchi è caratteri speciali à u valore definitu sopra, per esempiu per "Test Steps" risulta in "pvRestrictionTestSteps".
• Utilizendu a tabulazione Calculation, i marcatori di sustituzzioni di testu ponu esse definiti. I valori predeterminati sò: U caratteru d'apertura hè [ Carattere di chjude hè ] U caratteru Escape hè

. Introduzione à l'Integrazione GUI

A pagina principale view di l'Integrazione hè mostrata in Figura 16, "Integrazione Main page view”

L'integrazione hè visualizata in u pannellu laterale di u Documentu View è hè dispunibule per i tipi di tracker supportati induve u DocumentuView hè dispunibule. Funzione di i buttoni di a barra di menu, da manca à diritta:

1. Si riferisce à u buttone Open Config Space - cliccate per selezziunà u spaziu di cunfigurazione cum'è spiegatu in u Desktop Hub è u Web Sezioni Hub.
2. Si riferisce à u mudellu Viewer buttone - cliccate per apre u Configspace / VDM attualmente sceltu in u Modellu Viewer web applicazione. (Visibile solu in u Web Modu Hub)
3. Si riferisce à u buttone Refresh - cliccate per rinfriscà l'arburu mudellu Feature / Variant in l'Arburu-view.
4. Si riferisce à u buttone Expand - cliccate per espansione tuttu l'arburu in l'Arburu-view.
5. Si riferisce à u buttone Collapse - cliccate per colapsà l'arburu renditu in l'Arburu-view.
6. Si riferisce à Mostra Preview buttone - cliccate per attivà u preview per visualizing Variability Information; dispunibule in u Documentu View è sustene u formatu Wiki solu per i campi cù u tipu WikiText.
7. Si riferisce à Reset Preview buttone - cliccate per disattivà u Preview.
8. Si riferisce à u buttone Verificatu Errore - cliccate per apre u Verificatu Errore view, per vede l'errore in e regule PVSCL.
9. Si riferisce à u buttone Calculi - cliccate per apre a pagina di Calculi, cusì per edità i calculi presenti in i campi di un articulu di tracker.
10. Si riferisce à u buttone Restriction - cliccate per apre a pagina Restriction, cusì per edità a restrizione in i campi pvRestriction di un articulu tracker.
11. Si riferisce à u buttone Settings - cliccate per navigà à a pagina di Settings per cunfigurà i paràmetri Generali, i paràmetri specifichi di i calculi, è ancu per vede l'infurmazione specifica di Integrazione.

Sottu à a barra di menu, ci hè u menù di selezzione VDM chì lista tutti i mudelli varianti attaccati à u spaziu di cunfigurazione sceltu. Quandu selezziunate qualsiasi mudellu di varianti da u menù, u mudellu serà resu in l'Arburu-view. L'arbre -view elenca i mudelli di Funzioni / Varianti selezziunati.

Nota:

• U buttone per Error Check hè disattivatu in casu chì u DesktopHub sbagliatu o WebA versione Hub hè aduprata (vede Capitulu "Requisiti di u Software").
• Durante a preview U scrolling verticale di a sezione principale di u documentu hè supportatu per attivà review di u documentu.

U travagliu cù l'editore di restrizioni

L'Editor di Restrizzione pò esse apertu clicchendu l'icona di Restrizioni. Edite una restrizione in l'Editor di Restrizzione selezziunate un articulu in un tracker. L'Editor di Restrizzione furnisce l'abilità di pruposte di cumpletamentu automaticu è evidenziazione di sintassi mentre editanu restrizioni per l'articuli di tracker

U travagliu cù l'editor di calculi

L'Editor di Calculi pò esse usatu per edità i calculi presenti in i campi di un articulu tracker. Pudete apre u clicchendu nantu à l'icona Calculations. I calculi ponu esse editati selezziunate un articulu in un tracker è dopu, in l'Editor di calculi, elettu u campu di un articulu chì cuntene i marcatori di calculu. Dopu avè sceltu un campu, tutti i calculi in quellu campu appariscenu in a lista sottu. Sceglite un calculu da a lista è edità in l'editore sottu.
L'editor di calculi supporta l'autocumplementu di e pruposte è l'evidenziazione di sintassi mentre editanu i calculi.

U travagliu cù Passi di Test

Sia a restrizione è l'Editor di Calculu supportanu Passi di Test cum'è elencati in i Casi di Test in u Documentu View di codebeamer. Quì, una fila concreta chì rapprisenta un Passu di Testa deve esse selezziunata in a tavula di Passi di Testa ampliata, è cusì i dati di questu Passu di Testa appariscenu in l'editori. E restrizioni saranu aghjunte à u campu "pvRestrictionsTestSteps", mentre chì i calculi seranu aghjuntu à i lochi indicati da i marcatori di sustituzione in i campi supportati, cum'è mostratu in l'ex.ample sottu (Figura 19, "Editing Calculations Inside Test Steps").

Verificate l'errore

L'infurmazione di variabilità aghjunta pò esse verificata per errori utilizendu a funzione di Verificazione di Errore. L'errori in i scripts pvSCL sò signalati se a sintassi di u script ùn hè micca conforme à pvSCL, o se un elementu hè scunnisciutu basatu annantu à i mudelli puri::variants caricati.
I prublemi sò visualizati in una lista chì cuntene l'infurmazioni seguenti:

• Missaghju: Descrizzione di l'errore.
• pvSCL: L'espressione pvSCL chì cuntene l'errore.
• Campu: u nome di u campu chì cuntene l'errore.
• Item Link: URI di l'articulu affettatu

A gravità di u prublema hè indicata da un icona (errore o avvisu).
Nota: Per verificà cù strutture di mudelli di caratteristiche gerarchiche chì cuntenenu istanze varianti, un mudellu di variante deve ancu esse sceltu per una valutazione curretta.

Variabilità in WIKI-Tables

Per aghjunghje variabilità à WIKI-Tables ci vole esse una fila è una colonna esplicite per mantene l'infurmazioni di variabilità. Questa colonna è a linea pò esse aghjuntu in ogni locu in a tavula, ma anu bisognu di cuntene a keyword specifica, chì hè ancu utilizata per indicà una restrizione, per esempiu, un requisitu. Per automaticamente, sta keyword hè pv Restriction.

Cum'è illustratu in l'example table, e cellule pvRestriction evidenziate descrizanu a variabilità per a so fila è colonna rispettiva. L'infurmazione di variabilità di una cellula specifica in a tavula hè u pruduttu AND di i valori di restrizzioni di a so fila è a so colonna. In l'example tutta a colonna "Static Cornering Lights" serà solu parte di a variante, se a funzione CorneringStaticLights hè stata scelta. A cellula sottu à l'intestazione in quella colonna serà inclusa in una variante se CorneringStaticLights AND LED hè statu sceltu. E cellule d'infurmazione di variabilità (per esempiu, e cellule pvRestriction gialle marcate in l'example) sò eliminati da a variante per difettu.

I calculi seranu ancu calculati s'ellu sò marcati cù i rispettivi caratteri aperti è chjusi, è tavule nidificate, cusì i tavulini cù cellule, chì elli stessi mantenenu una tavola, sò supportati è rispettanu e listessi regule cum'è descritte sopra.

Restrizzione

Limitazioni riguardanti a sustituzione di testu in i campi di WikiText

Siccomu l'inseme di caratteri di marcatura di sustituzzioni di puri::variants pò cunflittu cù i caratteri speciali di WikiText (per esempiu, "[…]" definisce un hyperlink di WikiText), u prucessu di sustituzzioni di testu di puri::variants cerca a forma di escape di WikiText di quelli caratteri speciali ( per esempiu '~[' è '~]' per i marcatori predeterminati '[' è ']'). Questa forma hè creata in a maiò parte di i casi da u codebeamer WikiText Rich Text editor quandu aghjunghje sti caratteri. Ancu a funziunalità di u widget d'integrazione aduprà sta forma scappata.

L'utilizazione di l'editore di Codebeamer WikiText RichText è e restrizioni di sintassi di WikiText in generale saranu limitazioni di l'usu di sustituzzioni di testu in u cuntenutu di WikiText:

• E sezzioni di sustituzione di testu sò supportate solu induve u testu furmatu pò esse usatu in u cuntenutu WikiText. Cusì hè per exampùn hè micca supportatu per aghjunghje sustituzzioni in sequenze di cuntrollu di WikiText o in u mira URL parte di un hyperlink WikiText.
• Siccomu a sequenza di testu "${…}" hà un significatu speciale in codebeamer, ùn hè micca cunsigliatu di utilizà "{" è "}" cum'è marcatori di sustituzione aperta è chjude è "$" cum'è marcatore di escape di sustituzione.
• Ùn hè micca supportatu per utilizà a formattazione di testu in o attraversu e fruntiere di a sezione di sustituzione di testu. Questu pò esse risultatu in espressioni pvSCL invalide o in a creazione di cuntenutu WikiText invalidu durante a trasfurmazioni. L'unica eccezzioni hè l'usu di furmatu in un testu pvSCL literale.
• In codebeamer, u furmatu di u campu di descrizzione di l'articulu pò esse cambiatu da WikiText à u testu chjaru per ogni articulu. L'usu di sustituzzioni di testu in tali descrizzioni di testu chjaru ùn hè micca supportatu.

Limitazioni cunnisciute di e versioni di codebeamer supportate

In questa sezione sò listati i prublemi cunnisciuti di codebeamer, chì causanu limitazioni di e funziunalità di u puru::variants Connector for codebeamer:

• Durante l'aghjurnamentu di i trackers di Test Set in varianti di travagliu, per i casi di prova riferiti, chì ùn sò micca parte di a variante, i referenze di casi di prova à u 150% Test Case tracker sò falsamente aghjunte.
• L'aghjurnamentu di i gruppi di travagliu varianti basati nantu à certe combinazioni di basa di fonti à u nivellu di tracker sò falsamente declinati. Dunque, se almenu per un tracker a linea di base HEAD hè selezziunata è per almenu dui trackers hè sceltu a stessa linea di basa, u codice beamer annulerà l'aghjurnamentu cù un missaghju d'errore "Duplicate key ...".
• E linee di base di u tracker, vale à dì, e linee di base create per un tracker unicu, sò sempre create in u ramu maestru di u set di travagliu predeterminatu. Allora l'usu di basi di tracker in u cuntestu di un set di travagliu micca predeterminatu ùn funziona micca.
  Dunque, hè cunsigliatu di utilizà e linee di basa di u prugettu per definisce u statu di u funziunamentu di u funziunamentu per esse usatu per a trasfurmazioni

Documenti / Risorse

puri-sistemi puri varianti Connettore per codebeamer [pdfManuale d'usu varianti pure, Connettore per codebeamer, varianti pure Connettore per codebeamer, varianti pure Connettore, connettore

Referenze

• Manuale d'usu