Ha egy alkalmazás támogatja a RESTful API-kat, akkor létrehozhat műtermékeket
az adott alkalmazásban az IBM® Rational Focal Point üzleti igényekből.
Például létrehozhat követelményeket a Rational solution for
Collaborative Lifecycle Management követelménykezelési alkalmazásában
az üzleti igényekből a Rational Focal Point termékben.
Mielőtt elkezdené
- Gondoskodjék róla, hogy rendelkezzen megfelelő hozzáféréssel az alkalmazáshoz,
amelyben műtermékeket hoz létre a Rational Focal Point programból.
- Adja hozzá az alkalmazást kimenő barátként a Rational Focal Point programban.
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.
Eljárás
- A Rational Focal Point termékben
nyissa meg a munkaterületet.
- 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élparancs konfiguráció szakaszban hajtsa végre ezeket:
- 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 POST 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.
- Az Egyedi attribútum kiválasztása POST művelethez részben
kattison a Kijelölés gombra, majd válasszon ki egy attribútumot. Ez az attribútum üres. Az első POST művelet után eltárolja az alkalmazás
válasz URL címét. Így a további POST műveletek esetén ha az URL cím ugyanaz, akkor
az adott URL címre nem történik POST művelet.
- A REST alkalmazáskérés URL részben írja be az alkalmazás azon területének felső szintű
URL címét, ahol műtermékeket hoz létre. Például a követelménykezelési alkalmazás esetén használja a követelmény létrehozási
gyár URL címét. Az URL lekéréséhez
jellemzően a gyökérszolgáltatások URL címét használja, hogy megkapja az RMCatalog
URL címet. Az RMCatalog URL címmel a projektterület URL címét kapja meg; ezután a
projektterület URL címmel kapja meg a követelménygyár URL címét.
- A REST ügyfélsablon XML konfiguráció szakaszban hajtsa végre ezeket:
- A REST alkalmazás URL cím sablon XML fájlhoz részben írja be
az URL címet, ami egy műtermékre mutat az alkalmazásban, majd kattintson a Sablon
XML lekérése lehetőségre. Az XML betöltésre kerül a REST
alkalmazás sablon XML szövegmezőbe. Ha nem szeretné, hogy az XML fájl
dinamikusan töltődjön be, akkor másolja be az XML fájlt a REST
alkalmazás sablon XML szövegmezőbe.
Megjegyzés: A POST művelethez ismernie kell az alkalmazás XML struktúráját, ahová
műtermékeket küld. Az XML fájl lekérhető dinamikusan vagy saját kezűleg. Miután lekérésre került a kód,
az XML fájlnak támogatnia kell az új adatok elküldését az alkalmazás felé. Bizonyos
alkalmazásokban ha az XML fájl nem támogatja azt, akkor saját kezűleg kell
létrehoznia vagy szerkesztenie az XML fájlt.
- A Gyökér XPath REST alkalmazás műtermékhez részben
kattintson a Kijelölés lehetőségre, majd válassza ki
az attribútumokhoz tartozó gyökér XPath elemet. A Kijelölés gomb csak akkor engedélyezett,
ha a REST alkalmazássablon XML XML fájlja hibátlan.
- Az Attribútum leképezés részben kattintson
a Hozzáadás lehetőségre, majd társítsa a Rational Focal Point attribútumokat
az alkalmazás attribútumaival. Például ha a Rational Focal Point Cím attribútumát
társítja az alkalmazás Név attribútumával, akkor a POST művelet után a
Név attribútum az alkalmazásban Címre változik.
- A Válasz szakaszban hajtsa végre ezeket:
- A REST alkalmazássablon XML részben adja meg
a GET metódusra válaszul visszaadott XML fájlt, vagy adja meg az
alkalmazás bármely más XML fájlját. A Gyökér XPath
REST alkalmazás műtermékhez részben adja meg a gyökér XPath elemet
az alkalmazásokhoz, majd a Válasz attribútum kiosztás részben kattintson a Hozzáadás
lehetőségre az attribútumok kiosztásához.
- A Válasz fejléc kiosztás részben kattintson a Hozzáadás gombra az
alkalmazás fejléc Rational Focal Point attribútumhoz történő kiosztásához. Az alkalmazás fejléc tárolja az adott alkalmazás XML részét. A
Rational solution for CLM alkalmazások esetén
a fejléc jellemzően Hely.
- A Konfiguráció szakaszban hajtsa végre ezeket:
- 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ó szakaszban adjon meg egy
elválasztó értéket, például egy vesszőt (,) vagy egy
pontosvesszőt (;). A Többszörös választás (MultiChoice) és a Hivatkozott lista (LinkedList) elemek a megadott elválasztó által lesznek elválasztva.
- Az attribútumok azonosítóinak a Rational Focal Point és
az alkalmazás közötti kiosztásához a Kérés paramétertáblázat részben kattintson a Hozzáadás gombra, majd
jelöljön ki egy Rational Focal Point attribútumot.
Írja be az alkalmazás azonosítóját a Kulcs oszlopba. Például ha Rational Focal Point Projectazonosítót jelöl ki
a Kulcs oszlopban, akkor írja be az alkalmazásban projektazonosítóként használt
azonosítót.
- 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.
- A Megjelenítés menüben válassza ki annak az
elemnek a megjelenítését, amelyet létre kíván hozni a másik alkalmazásban.
- A nézetben elérhető összes műtermék létrehozásához a nézet eszköztárban
kattintson a legördülő menüre és válassza ki a POST nézet parancsot,
majd katintson a Mehet ikonra
.
- Egy műtermék létrehozásához a műtermék eszköztárban válassza ki a
POST nézet parancsot, majd kattintson a Mehet ikonra
.