如果某個應用程式支援 RESTful API,您即可從 IBM® Rational® Focal Point™ 中的商業需求在該應用程式中建立構件。例如,您可以根據 Rational Focal Point 中的商業需求,在 Rational solution for
Collaborative Lifecycle Management 的「需求管理」應用程式中建立需求。
開始之前
- 確定您具有適當的存取權可存取您要用來從 Rational Focal Point 中建立構件的應用程式。
- 在 Rational Focal Point 中,將應用程式新增為出埠夥伴。如需相關資訊,請參閱連接至「協同生命週期管理」應用程式伺服器的 Rational 解決方案。
- 確定支援 REST API 的應用程式內容採用 XML 格式。
- 請留意應用程式構件的 XML 結構,並確定您有其存取權。
程序
- 在 Rational Focal Point 中,開啟工作區。
- 按一下,然後按一下新增視圖指令。
- 選取要新增視圖指令的視圖。
- 在「REST 用戶端指令配置」區段中,完成下列步驟:
- 在 REST 用戶端連接器名稱中,輸入用以識別連線的名稱。
- 在 REST 要求方法中,選取 POST 方法。 如需使用每一種方法的相關資訊,請參閱「支援的資源管理方法」主題。
- 在夥伴清單中,選取您要以夥伴的形式新增至 Rational Focal Point 的應用程式。
- 在選擇 POST 的唯一屬性中按一下選取,然後選取屬性。 此屬性是空的。在第一項 POST 作業之後,它會儲存來自應用程式的回應 URL。因此,對後續的 POST 作業而言,如果 URL 相同,即不會為了該 URL 執行 POST 作業。
- 在 REST 應用程式要求 URL 中,輸入您要在應用程式中建立構件之所在區域的最上層 URL。 例如,針對「需求管理」應用程式,請使用需求建立 Factory URL。為取得此 URL,通常您會使用根服務 URL 來取得 RMCatalog URL。您可以先使用 RMCatalog URL 取得專案區域 URL,然後再使用專案區域 URL 取得需求 Factory URL。
- 在「REST 用戶端範本 XML 配置」區段中,完成下列步驟:
- 在範本 XML 的 REST 應用程式 URL 中,輸入 URL 以指向應用程式中的某個構件,然後按一下取得範本 XML。 XML 會載入 REST 應用程式範本 XML 文字框中。如果您不想讓 XML 動態載入,您可以將 XML 複製到 REST 應用程式範本 XML 文字框中。
註: 對於 POST 作業,您必須知道要公佈構件之應用程式的 XML 結構為何。如此您才能以動態或手動方式取得 XML。取得程式碼之後,該 XML 必須支援將新資料公佈到應用程式的作業。在某些應用程式中,如果 XML 不支援該作業,您必須手動建立或編輯 XML。
- 在 REST 應用程式構件的根 XPath 中按一下選取,然後選取屬性的根 XPath。 只有在 REST 應用程式範本 XML 中的 XML 正確時,才會啟用選取按鈕。
- 在屬性對映區段中按一下新增,然後將 Rational Focal Point 屬性與應用程式的屬性相對映。 例如,如果您將 Rational Focal Point 的「標題」屬性與應用程式的「名稱」屬性相對映,則在執行 POST 作業之後,應用程式中的「名稱」屬性即會變更為標題。
- 在「回應」區段中,完成下列步驟:
- 在 REST 應用程式範本 XML 中,指定在回應 GET 方法時所收到的 XML,或指定應用程式的任何其他 XML。在 REST 應用程式構件的根 XPath 中指定屬性的根 XPath,然後在回應屬性對映中按一下新增,以對映屬性。
- 在「回應標頭對映」區段中按一下新增,以對映應用程式標頭與 Rational Focal Point 屬性。 應用程式標頭會儲存該應用程式的 XML。一般而言,Rational solution for CLM 應用程式標頭為 Location。
- 在「配置」區段中,完成下列步驟:
- 在 REST 應用程式支援的日期格式中,輸入外部應用程式所使用的日期格式。
- 在 Focal Point 分隔字元中輸入分隔字元值,如逗點 (,) 或分號 (;)。MultiChoice 與 LinkedList 項目都會以指定的分隔字元隔開。
- 若要在 Rational Focal Point 與應用程式之間對映屬性的 ID,請在「要求參數表格」區段中按一下新增,然後選取 Rational Focal Point 屬性。在金鑰欄中,輸入應用程式的 ID。 例如,如果您選取 Rational Focal Point 的專案 ID,請在金鑰欄中輸入在應用程式中用來作為專案 ID 的 ID。
- 在「要求標頭對映」區段中按一下新增,然後輸入標頭的名稱和值。 若為 Rational solution for CLM 應用程式,標頭如下:
| 標頭名稱 |
標頭值 |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- 按一下儲存。
- 在顯示功能表中,選取您要在其他應用程式中建立其元素的視圖。
- 若要建立視圖中所有可用的構件,請按一下視圖工具列中的下拉清單,並在選取 POST 視圖指令之後按一下執行圖示
。
- 若只要建立一項構件,請在構件工具列中選取 POST 視圖指令,然後按一下執行圖示
。