Ha egy alkalmazás támogatja a RESTful API-kat, akkor csatlakozhat
az adott alkalmazáshoz, hogy műtermékeket kérjen le és elemeket hozzon létre
belőlük.
Mielőtt elkezdené
- Győződjön meg róla, hogy az alkalmazás, ahonnan a IBM® Rational Focal Point lekéri
a műtermékeket, kiajánlja-e az alkalmazásprogramozási felületeit RESTful felületen keresztül.
- Vegye fel az alkalmazást Barátok(kimenő) alkalmazásként a Rational Focal Point termékben.
További információkért lásd: Csatlakozás a Rational solution for Collaborative Lifecycle Management alkalmazáskiszolgálójához.
- Gondoskodjék róla, hogy a REST API-kat támogató alkalmazás tartalma XML formátumú legyen.
- Ismerje meg az alkalmazás műtermékek XML struktúráját,
és rendelkezzen a hozzáférési jogokkal az elérésükhöz.
Erről a feladatról
Ha bármelyik alkalmazás attribútum azonosítója létezik a
Rational Focal Point termékben,
akkor a
GET metódus frissíti az adott attribútum azonosítókhoz
tartozó műtermékeket. Például ha első alkalommal kiosztja az azonosítókat
és a
GET metódust használja, akkor a metódus
lekéri a műtermékeket az alkalmazásból. Ha a műtermékek frissítésre kerülnek
az adott alkalmazásban, majd legközelebb kiosztja ugyanazokat az azonosítókat és
a
GET metódust használja, akkor a metódus frissíti a
meglévő műtermékeket a
Rational Focal Point termékben.
Eljárás
- A Rational Focal Point termékben
nyissa meg a munkaterületet, ahol be kívánja olvasni a műtermékeket.
- Kattintson a , majd a Nézet
parancs hozzáadása lehetőségre.
- Jelöljön ki egy nézetet, ahol fel kívánja venni a nézet parancsot.
- A REST ügyfélcsatlakozó neve részben adjon meg egy nevet a csatlakozás azonosításához.
- A REST kérési metódus részben válassza ki a GET metódust. Az egyes metódusok felhasználásáról információkért lásd:
Támogatott metódusok erőforrások kezelésére témakör.
- A Barátok lista részben jelölje ki azt az alkalmazást, amit
barátként felvett a Rational Focal Point termékben.
- A REST alkalmazáskérés URL részben adja meg azt
az URL címet, amely az alkalmazás műtermékeit tartalmazza.
Tipp: Nyisson meg egy webböngészőt és írja be azt az URL címet,
amit a REST alkalmazás barátként való hozzáadása során használt. Megjelenik
a magas szintű műtermékek listája. Keresse meg a lekérni kívánt műterméket, majd
másolja be az URL címét a REST alkalmazáskérés
URL mezőbe.
- Kattintson a Csatlakozás gombra.
- Ha a csatlakozás sikeres, akkor kattintson a Kijelölés lehetőségre
a műtermékhez gyökér XPath kiválasztásához. Korlátozhatja a keresést egy műtermékre
a megfelelő XPath kijelölésével. Ha a csatlakozás nem volt sikeres,
akkor nem fogja tudni kijelölni a gyökér XPath elemet.
- Annak érdekében, hogy a műtermékek ne legyenek többszörözve, az Azonosító
kiosztás részben kattintson a Hozzáadás gombra, majd
ossza ki a Rational Focal Point attribútum
azonosítóját másik alkalmazáshoz. Csak egy attribútumot oszthat ki.
- Az Attribútum kiosztás részben kattintson
a Hozzáadás gombra az alkalmazás attribútumok kiosztása érdekében
a Rational Focal Point attribútumaihoz. A kiosztott attribútumok megjelennek az alkalmazásból lehívott elemekkel
szemben. Ellenőrizze, hogy az attribútumok szerkeszthetők-e.
Megjegyzés: - Az Azonosító kiosztás részben kijelölt attribútumok nem jelennek meg
az Attribútum kiosztás részben, mert az adott attribútumok
belső kiosztásúak, és elérhetők a lehívott elemek számára.
- Ha vannak egyéni attribútumok az alkalmazásban, ahonnan műtermékeket kér le,
és egy adott elemet igényel, akkor szerkesztheti az XPath elemet,
hogy tartalmazza az adott elemet. Például több egyéni attribútum
(Status, Priority és Cost) esetén hozzáadhatja a [@attribute:name='Status'] kifejezést
az attribútum bejegyzés után a Status attribútum lekéréséhez. rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute[@attribute:name='Status']/@attribute:literalName
- A REST alkalmazás támogatott dátumformátuma részben
írja be a külső alkalmazás által használt dátumformátumot.
- A Focal Point elválasztó részben adjon meg egy
elválasztó értéket, például , vagy ;.
A Többszörös választás (MultiChoice) és a Hivatkozott lista (LinkedList) elemek a megadott elválasztó által lesznek elválasztva.
- A Kérés fejléc kiosztás részben kattintson a Hozzáadás gombra, majd
adja meg a fejléc nevét és értékét. Rational solution for CLM alkalmazások
esetén a fejlécek a következők:
| Fejléc neve |
Fejléc értéke |
| Elfogadás |
application/rdf+xml |
| Tartalomtípus |
application/rdf+xml |
| OSLC-Core-Változat |
2.0 |
- Kattintson a Mentés gombra.
Eredmények
Annak ellenőrzéséhez, hogy a műtermékek lehívásra kerültek-e
az alkalmazásból, navigáljon a
Megjelenítés menühöz és kattintson
a nézet lehetőségre. A legördülő listából válassza ki a csatlakozó nevet. Az elemek
lehívásra kerülnek és betöltődnek a nézetbe.