Esimerkki: Artefaktien nouto RESTful-ohjelmointirajapintaa tukevista sovelluksista

Tässä esimerkissä kuvataan, miten voit noutaa artefakteja Rational solution for Collaborative Lifecycle Management -ohjelman Requirements Management -sovelluksesta ja luoda elementtejä IBM® Rational Focal Point -ohjelmaan.

Tarkoitus

Jos Requirements Management -sovelluksessa on vaatimuksia, joiden prioriteetit haluat määrittää Rational Focal Point -ohjelmassa, voit noutaa vaatimukset käyttämällä REST-työasemaohjelman näkymäkomentoa.
Edellytykset:
  • Rational solution for CLM -palvelimen IP-osoite ja pääkoneen nimi on määritettävä sen tietokoneen pääkoneen tiedostoon, johon määrität integroinnin. Windows-käyttöjärjestelmissä pääkoneen tiedosto on yleensä hakemistossa C:\Windows\System32\drivers\etc ja Linux-käyttöjärjestelmissä hakemistossa /etc/hosts.
  • Requirements Management -sovellus on lisättävä Rational Focal Point -ohjelman Ystävät (lähtevä) -luetteloon. Lisätietoja on ohjeaiheessa Yhteyden muodostus CLM (Collaborative Lifecycle Management) -sovelluksen Rational-ratkaisun palvelimeen.
  • Requirements Management -sovelluksen XML-rakenteen on oltava selvillä ja rakenteiden käyttöön on oltava oikeudet.

Malli

Tässä esimerkissä oletetaan, että Rational Focal Point -ohjelmassa on työtila nimeltä FP-RRC ja näkymä Näytä RRC-vaatimukset. Seuraavassa taulukossa on osa Rational Focal Point -ohjelmassa ja Requirements Management -sovelluksessa käytettävissä olevista määritteistä.
Taulukko 1. Rational Focal Point -ohjelman ja Requirements Management -sovelluksen määritteet
Rational Focal Point -ohjelman määritteet Requirements Management -sovelluksen määritteet
Polttoainevalinta rrm:description
Polttoainetehokkuus rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
Integrointilinkki rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
Otsikko ds:location/ds:project/rrm:title
  1. Avaa Rational Focal Point -ohjelmassa FP-RRC-työtila, johon haluat noutaa artefakteja.
  2. Valitse vaihtoehdot Määritä kokoonpano > REST-työasemaohjelman näkymäkomento ja valitse Lisää näkymäkomento -vaihtoehto.
  3. Kirjoita REST-työasemaohjelman liittimen nimi -kenttään yhteyden nimeksi RRC-liitin.
  4. Valitse REST-pyyntömetodi-kohdasta GET-metodi.
  5. Valitse Ystäväluettelo-kohdasta RRC-vaihtoehto.
  6. Kirjoita REST-sovelluspyynnön URL-osoite -kenttään sen sovelluksen URL-osoite, jonka sisältämät artefaktit haluat noutaa. Jos esimerkiksi haluat noutaa artefaktit Requirements Management -sovelluksesta, kirjoita https://<pääkoneen_nimi>:<portin_numero>/rm/<projektin_nimi>/<kokoelman_nimi>
    Vihje: Avaa Web-selain ja kirjoita siihen sama Requirements Management -sovelluksen URL-osoite, jonka määritit ystäväsovelluksen osoitteeksi. Luettelo ylätason artefakteista tulee näkyviin. Etsi artefakti, jonka haluat noutaa, ja kopioi sen URL-osoite REST-sovelluspyynnön URL-osoite -kenttään.
  7. Napsauta Yhdistä-painiketta.
  8. Rajoita haku kokoelman artefakteihin valitsemalla Valitse REST-sovelluksen artefaktin XPath-polku -vaihtoehto. Valitse vaihtoehto /ds:dataSource/ds:artifact. XPath-polku määrittää haun kohdistettavaksi vain artefakteihin. XPath-polut ovat sovelluksen hierarkkisia XML-rakenteita.
  9. Varmista, ettei järjestelmä luo artefakteista kaksoiskappaleita napsauttamalla Tunnistuksen vastaavuusmääritys -osassa Lisää-painiketta ja määrittämällä sitten Rational Focal Point -ohjelman Polttoainevalinta-määrite Requirements Management -sovelluksen rrm:description-määritettä vastaavaksi. Voit määrittää vain yhden määritteen vastaavuuden.
  10. Napsauta Määritteiden vastaavuusmääritys -osan Lisää-painiketta ja määritä seuraavat vastaavuudet Requirements Management -sovelluksen ja Rational Focal Point -ohjelman määritteiden välille. Vastaavuusmääritetyt määritteet näkyvät sovelluksesta noudettuja elementtejä vastaavasti. Varmista, että määritteitä voi muokata.
    Huomautus: Tunnistuksen vastaavuusmääritys -osassa valitsemasi määrite ei näy Määritteiden vastaavuusmääritys -osassa, koska se on sisäisesti vastaavuusmääritetty määrite, joka on käytettävissä noudetuissa elementeissä.
    Taulukko 2. Rational Focal Point -ohjelman ja Requirements Management -sovelluksen määritteiden väliset vastaavuudet
    Rational Focal Point -ohjelman määritteet Requirements Management -sovelluksen määritteet
    Polttoainetehokkuus rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute/@attribute:isEnumeration
    Integrointilinkki rrm:collaboration/rrm:attributes/attribute:objectType/@attribute:projectAreaName
    Otsikko ds:location/ds:project/rrm:title
  11. Kirjoita REST-sovelluksessa tuettu päivämäärämuoto -kenttään 2012-08-18.
  12. Älä muuta Focal Point -erotin -kentän arvoa (,).
  13. Napsauta Tallenna-painiketta.
  14. Avaa Näytä RRC-vaatimukset -näkymä ja valitse avattavasta luettelosta RRC-liitin-vaihtoehto. Järjestelmä noutaa vaatimus- ja määriteluettelon ja luo vaatimukset ja määritteet näkymän elementeiksi.

Palaute