Se un'applicazione supporta le API RESTful, è possibile creare in tale applicazione delle risorse
utente dalle esigenze aziendali in IBM® Rational Focal Point.
Ad esempio,
è possibile creare dei requisiti nell'applicazione Requirements Management
di Rational solution for
Collaborative Lifecycle Management dalle esigenze aziendali in
Rational Focal Point.
Prima di iniziare
- Verificare di disporre dell'accesso appropriato per l'applicazione in cui si stanno creando le risorse utente da Rational Focal Point.
- Aggiungere l'applicazione come friend in uscita in Rational Focal Point.
Per ulteriori informazioni, vedere
Connessione al server delle applicazioni della soluzione Rational per Collaborative Lifecycle Management.
- Verificare che il contenuto dell'applicazione che supporta le API REST abbia il formato XML.
- Considerare la struttura XML delle risorse utente dell'applicazione e accertarsi di disporre dei diritti per accedervi.
Procedura
- In Rational Focal Point,
aprire il workspace.
- Fare clic su e quindi fare clic su Aggiungi comando della vista.
- Selezionare una vista in cui si intende aggiungere il comando della vista.
- Nella sezione Configurazione comando client REST, effettuare le seguenti operazioni:
- In Nome connettore client REST,
immettere un nome per identificare la connessione.
- In Metodo richiesta REST, selezionare il metodo POST. Per informazioni sull'utilizzo di ciascun metodo, fare riferimento a "Metodi supportati per la gestione di risorse".
- In Elenco friend, selezionare l'applicazione aggiunta come friend a
Rational Focal Point.
- In Scegli attributo univoco per POST, fare clic su Seleziona e selezionare un attributo. Questo attributo è vuoto. Dopo la prima operazione POST, l'URL di risposta dall'applicazione viene memorizzato. Quindi, per successive operazioni POST,
se l'URL è lo stesso, l'operazione POST non si verifica per tale URL.
- In URL richiesta applicazione REST, immettere l'URL di livello superiore
dell'area dell'applicazione in cui si creeranno le risorse utente. Ad esempio, per l'applicazione Requirements Management, utilizzare l'URL del factory di creazione requisiti. Per
ottenere tale URL, generalmente si utilizza l'URL dei servizi root per acquisire l'URL RMCatalog. Utilizzare tale
URL per richiamare l'URL dell'area di progetto e utilizzarlo per ottenere l'URL del factory di requisiti.
- Nella sezione Configurazione XML template client REST, effettuare le seguenti operazioni:
- In URL applicazione REST per XML template, immettere l'URL che punta ad una risorsa utente
nell'applicazione e fare clic su Richiama XML template. L'XML viene caricato nella casella di testo XML template applicazione REST. Se si desidera che l'XML non venga caricato in modo dinamico, sarà possibile copiarlo nella casella di testo XML template applicazione REST.
Nota: per l'operazione POST, è necessario conoscere la struttura XML dell'applicazione in cui si stanno inserendo le risorse utente. Quindi, tale XML viene acquisito in modo dinamico o manuale. Una volta acquisito il codice, tale XML dovrà supportare l'inserimento
di nuovi dati nell'applicazione. In alcune applicazioni, se l'XML non supporta tale operazione,
sarà necessario crearlo o modificarlo manualmente.
- In XPath root alla risorsa utente dell'applicazione REST,
fare clic su Seleziona e selezionare l'XPath root per gli attributi. Il pulsante Seleziona è abilitato solo se l'XML nella sezione XML template applicazione REST è corretto.
- Nella sezione Associazione attributi, fare clic su Aggiungi e associare gli attributi di Rational Focal Point agli attributi dell'applicazione. Se, ad esempio, si associa l'attributo Title di
Rational Focal Point all'attributo
Name dell'applicazione, in seguito all'operazione POST, l'attributo Name nell'applicazione sarà modificato in Title.
- Nella sezione Risposta, effettuare le seguenti operazioni:
- In XML template applicazione REST, specificare l'XML ricevuto in risposta al metodo GET o
specificare qualsiasi altro XML dell'applicazione. In XPath root alla risorsa utente dell'applicazione
REST, specificare l'XPath root per gli attributi e quindi, in Associazione attributi
risposta, fare clic su Aggiungi per associare gli attributi.
- Nella sezione Associazione intestazione risposta, fare clic su Aggiungi per
associare l'intestazione dell'applicazione ad un attributo
Rational Focal Point. L'intestazione dell'applicazione memorizza l'XML di tale applicazione. Di solito, l'intestazione delle applicazioni Rational solution for CLM è Location.
- Nella sezione Configurazione, effettuare le seguenti operazioni:
- In Formato data supportato dall'applicazione REST, immettere il formato data utilizzato
dall'applicazione esterna.
- In Separatore Focal Point, immettere un valore separatore, ad esempio una virgola(,) o un punto e virgola (;). Gli elementi MultiChoice e LinkedList verranno separati dal separatore specificato.
- Per associare gli ID degli attributi tra Rational Focal Point e l'applicazione, nella sezione Tabella parametro di richiesta, fare clic su Aggiungi, quindi selezionare un attributo di Rational Focal Point.
Immettere l'ID dell'applicazione nella colonna Chiave. Ad esempio, se si seleziona ID progetto per Rational Focal Point,
nella colonna Chiave immettere l'ID utilizzato per l'ID progetto nell'applicazione.
- Nella sezione Associazione intestazione richiesta, fare clic su Aggiungi e immettere il nome e il valore dell'intestazione. Per le applicazioni Rational solution for CLM, le intestazioni sono:
| Nome intestazione |
Valore intestazione |
| Accept |
application/rdf+xml |
| Content-Type |
application/rdf+xml |
| OSLC-Core-Version |
2.0 |
- Fare clic su Salva.
- Nel menu Mostra, selezionare la vista di cui si desidera creare gli elementi
nell'altra applicazione.
- Per creare tutte le risorse utente disponibili nella vista, dalla barra degli strumenti della vista
fare clic sull'elenco a discesa e
selezionare il comando della vista POST, quindi fare clic sull'icona Vai
.
- Per creare una risorsa utente, dalla barra degli strumenti della risorsa
selezionare il comando della vista POST, quindi fare clic sull'icona Vai
.