Jos sovellus tukee RESTful-ohjelmointirajapintoja, voit
muodostaa yhteyden kyseiseen sovellukseen, jotta voit noutaa artefakteja ja luoda niistä elementtejä.
Ennen aloitusta
- Varmista, että sovellus, josta IBM® Rational Focal Point -sovellus
noutaa artefaktit, on julkistanut ohjelmointirajapintansa RESTful-liittymän avulla.
- Valitse Ystävät (lähtevä) -vaihtoehto, jotta voit lisätä sovelluksen lähteväksi ystäväksi Rational Focal Point -ohjelmaan.
Lisätietoja on ohjeaiheessa Yhteyden muodostus CLM (Collaborative Lifecycle Management) -sovelluksen Rational-ratkaisun palvelimeen.
- Varmista, että REST-ohjelmointirajapintoja tukevan sovelluksen sisältö on
XML-muodossa.
- Selvitä sovelluksen artefaktien XML-rakenne ja hanki oikeus käyttää
artefakteja.
Tietoja tästä tehtävästä
Jos jokin sovelluksen määritteen tunnuksista on
Rational Focal Point -ohjelmassa,
GET-metodi päivittää kyseisen määritteen tunnuksiin
liittyvät artefaktit. Jos esimerkiksi ensimmäistä kertaa määrität tunnusten
vastaavuudet ja käytät
GET-metodia, se noutaa
artefaktit sovelluksesta. Jos artefaktit päivitetään
kyseisessä sovelluksessa, kun seuraavalla kerralla määrität samojen tunnusten vastaavuudet ja
käytät
GET-metodia, se päivittää
Rational Focal Point -ohjelman nykyiset artefaktit.
Toimintaohjeet
- Avaa Rational Focal Point -ohjelmassa
työtila, josta haluat noutaa artefaktit.
- Valitse vaihtoehdot ja
valitse Lisää näkymäkomento -vaihtoehto.
- Valitse näkymä, johon haluat lisätä näkymäkomennon.
- Kirjoita REST-työasemaohjelman liittimen nimi -kenttään
yhteyden yksilöivä nimi.
- Valitse REST-pyyntömetodi-kentästä
GET-metodi. Tietoja
kunkin metodin käytöstä on ohjeaiheessa Resurssien hallinnan tuetut
metodit.
- Valitse Ystäväluettelo-luettelosta sovellus,
jonka lisäsit ystäväksi Rational Focal Point -ohjelmaan.
- Kirjoita REST-sovelluspyynnön URL-osoite -kenttään
URL-osoite, jossa sovelluksen artefaktit ovat.
Vihje: Avaa Web-selain ja kirjoita URL-osoite, jota käytit, kun
lisäsit REST-sovelluksen ystäväksi. Näkyviin tulee luettelo ylätason artefakteista. Etsi artefakti, jonka haluat noutaa, ja kopioi
sen URL-osoite REST-sovelluspyynnön URL-osoite -kenttään.
- Napsauta Yhdistä-painiketta.
- Jos yhteyden muodostus onnistuu, valitse artefaktin XPath-pääpolku napsauttamalla Valitse-painiketta. Voit rajoittaa
haun artefaktiin valitsemalla asianmukaisen XPath-pääpolun. Jos
yhteyden muodostus ei onnistunut, et voi valita
XPath-pääpolkua.
- Voit varmistaa, että artefakteista ei ole luotu kaksoiskappaleita, napsauttamalla Tunnistuksen
vastaavuusmääritys -osassa Lisää-painiketta
ja määrittämällä Rational Focal Point -ohjelman
ja toisen sovelluksen määritteen tunnuksen vastaavuuden. Voit määrittää vain yhden määritteen vastaavuuden.
- Valitse Määritteiden vastaavuusmääritys -osassa
Lisää-vaihtoehto ja määritä sovelluksen määritteet
vastaamaan Rational Focal Point -ohjelman määritteitä. Vastaavuusmääritetyt määritteet näkyvät sovelluksesta noudetun
elementin perusteella. Varmista, että kyseiset määritteet ovat muokattavissa.
Huomautus: - Tunnistuksen
vastaavuusmääritys -osassa valittu määrite ei näy Määritteiden
vastaavuusmääritys -osassa, koska kyseisen määritteen vastaavuus on määritetty
sisäisesti ja se on käytettävissä noudettuja elementtejä varten.
- Jos noudat artefakteja sovelluksesta, jossa on mukautettuja määritteitä,
ja jos tarvitset tietyn objektin, voit sisällyttää sen muokkaamalla
XPath-määritystä. Jos sovelluksessa on esimerkiksi useita mukautettuja määritteitä,
jotka koskevat tilaa, prioriteettia ja kustannuksia, voit noutaa tilan määritteen lisäämällä mukautetun määritteen merkinnän jälkeen merkinnän[@attribute:name='Status']. rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute[@attribute:name='Status']/@attribute:literalName
- Kirjoita REST-sovelluksessa tuettu päivämäärämuoto -kenttään
päivämäärämuoto, jota ulkoinen sovellus käyttää.
- Kirjoita Focal Point -erotin -kenttään
erottimen arvo, kuten , tai ;.
Monivalinnan ja linkitetyn luettelon objektit
erotetaan määritetyn erottimen avulla.
- Valitse Pyynnön ylätunnisteen vastaavuusmääritys -osassa Lisää-vaihtoehto ja
kirjoita ylätunnisteen nimi ja arvo. Rational solution for CLM -sovelluksissa
käytetään seuraavia ylätunnisteita:
| Ylätunnisteen nimi |
Ylätunnisteen arvo |
| Hyväksy |
application/rdf+xml |
| Sisältölaji |
application/rdf+xml |
| OSLC-ydinversio |
2.0 |
- Napsauta Tallenna-painiketta.
Tulokset
Voit tarkistaa, noudetaanko artefaktit sovelluksesta,
siirtymällä
Näytä-valikkoon ja napsauttamalla
näkymää. Valitse liittimen nimi avattavasta luettelosta. Järjestelmä
noutaa ja lataa elementit näkymään.