如果應用程式支援 RESTful API,您即可連接至該應用程式以擷取構件,並從中建立元素。
開始之前
- 確定 IBM® Rational® Focal Point™ 要從中擷取構件的應用程式已透過 RESTful 介面公開其 API。
- 在 Rational Focal Point 中,將該應用程式新增為夥伴(出埠)。如需相關資訊,請參閱連接至「協同生命週期管理」應用程式伺服器的 Rational 解決方案。
- 確定支援 REST API 的應用程式內容採用 XML 格式。
- 請留意應用程式構件的 XML 結構,並確定您有其存取權。
關於這項作業
如果有任何應用程式屬性 ID 存在於
Rational Focal Point 中,
GET 方法即會更新與該屬性 ID 相關聯的構件。例如,假設您是第一次對映 ID 與使用
GET 方法,該方法會從應用程式擷取構件。如果構件在該應用程式中有所更新,則在您下次對映相同的 ID 並使用
GET 方法時,該方法即會更新您在
Rational Focal Point 中現有的構件。
程序
- 在 Rational Focal Point 中,開啟您要擷取構件的工作區。
- 按一下,然後按一下新增視圖指令。
- 選取要新增視圖指令的視圖。
- 在 REST 用戶端連接器名稱中,輸入用以識別連線的名稱。
- 在 REST 要求方法中,選取 GET 方法。 如需如何使用各種方法的相關資訊,請參閱「支援的資源管理方法」主題。
- 在夥伴清單中,選取您要以夥伴的形式新增至 Rational Focal Point 的應用程式。
- 在 REST 應用程式要求 URL 中,輸入含有應用程式構件的 URL。
提示: 開啟 Web 瀏覽器,然後輸入您將 REST 應用程式新增為夥伴時所使用的 URL。畫面中會顯示高階構件的清單。請找出您要擷取的構件,並將其 URL 複製到 REST 應用程式要求 URL 中。
- 按一下連接。
- 如果連線成功,請按一下選取以選取構件的根 XPath。 您可以選取適當的 XPath,將搜尋限定於某個構件。如果連線不成功,您將無法選取根 XPath。
- 若要確保構件未重複,請在識別對映區段中按一下新增,以對映 Rational Focal Point 與另一個應用程式的屬性 ID。 您只能對映一個屬性。
- 在屬性對映區段中按一下新增,以對映應用程式屬性與 Rational Focal Point 的屬性。 會根據自應用程式提取的元素來顯示對映屬性。請確定這些屬性是可編輯的。
註: - 您在識別對映區段中
選取的屬性不會顯示在屬性對映區段中,因為此屬性是在內部對映,適用於提取的元素。
- 如果在您從中擷取構件的應用程式中有自訂屬性,而您需要特定項目,您可以編輯 XPath 以納入該項目。例如,如果有「狀態」、「優先順序」與「成本」等多個自訂屬性,您可以在客戶屬性項目後面加上 [@attribute:name='Status'],以擷取「狀態」屬性。rrm:collaboration/rrm:attributes/attribute:objectType/attribute:customAttribute[@attribute:name='Status']/@attribute:literalName
- 在 REST 應用程式支援的日期格式中,輸入外部應用程式所使用的日期格式。
- 在 Focal Point 分隔字元中輸入分隔字元值,如 , 或 ;。MultiChoice 與 LinkedList 項目都會以指定的分隔字元隔開。
- 在「要求標頭對映」區段中按一下新增,然後輸入標頭的名稱與值。 若為 Rational solution for CLM 應用程式,標頭如下:
| 標頭名稱 |
標頭值 |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- 按一下儲存。
結果
若要檢查構件是否提取自應用程式,請導覽至
顯示功能表,然後按一下視圖。請從下拉清單中選取連接器名稱。元素會提取並載入視圖中。