Creazione di un report in stile documento sui dati di Engineering Lifecycle Management utilizzando Engineering Publishing

È possibile utilizzare IBM Engineering Lifecycle Optimization - Publishing per progettare report basati sui dati delle applicazioni IBM Engineering Lifecycle Management, tra cui la gestione dei requisiti, Engineering Workflow Management e gli archivi di gestione della qualità. I modelli di gestione dei requisiti possono essere importati nell'applicazione per essere utilizzati nell'interfaccia web di Jazz.

Attività preliminari

Engineering Publishing non è incluso in Engineering Lifecycle Management; sono necessarie un'installazione e una licenza separate. Prima di iniziare a usare Engineering Publishing per personalizzare i report, è necessario impostare un server di chiavi di licenza con licenze valide per l'uso. Rivolgersi all'amministratore del server per verificare che ciò è stato fatto e per individuare il percorso del server delle licenze che è necessario utilizzare per connettersi al server delle licenze. Se non è già installato Engineering Publishing, l'amministratore deve installarlo e verificare che sia possibile connettersi al server delle licenze.

Attività di supporto:

Procedura

Engineering Publishing offre la possibilità di creare nuovi modelli di report in stile documento. I report basati sulla gestione delle modifiche e delle configurazioni e sui dati di Engineering Test Management possono essere generati solo utilizzando Engineering Publishing. I modelli creati per la gestione dei requisiti possono essere caricati in modo che gli utenti della gestione dei requisiti possano generare report in stile documento, basati sui modelli, dall'interfaccia web di Jazz. La licenza Engineering Publishing è necessaria per creare i modelli, ma non per eseguirli dall'applicazione di gestione dei requisiti.

Le attività necessarie per creare rapporti di tipo documentale sono descritte nella documentazione del prodotto Engineering Publishing. Questo argomento contiene una panoramica di queste attività e collegamenti alla documentazione del prodotto Engineering Publishing per istruzioni dettagliate.

Per creare report con Engineering Publishing che utilizzano i dati dell'applicazione Engineering Lifecycle Management, completare i seguenti passaggi in base al proprio ruolo:

1: Collegarsi a Engineering Publishing
2: Progettazione dei modelli di report
3: Connessione all'origine dati dell'applicazione
4: Aggiunta al modello di query di dati basati sull'applicazione
5: Creazione specifiche del documento
6: Creazione report (facoltativo)
7: Importazione del report in stile documento personalizzato

Passo 1: collegarsi a Engineering Publishing

Se non è già installato Engineering Publishing, l'utente o l'amministratore deve installarlo e quindi collegarsi al server delle licenze. Gli autori possono utilizzare Engineering Publishing Document Studio per importare fonti di applicazioni e creare modelli di report. Possono anche utilizzare l'Engineering Publishing Launcher per creare specifiche di documenti, che incorporano modelli di report, e generare report.

Connessione a un server delle licenze

Passo 2: Progettazione dei modelli di report

Avviare Document Studio per creare un progetto di modello di report.

Creare o importare un progetto di modello. Tale progetto determina il layout del report. Engineering Publishing viene fornito con una serie di tour guidati e modelli da esplorare.

Document Studio
Informazioni preliminari sulla creazione e sulla personalizzazione di modelli
Creazione di un modello di documento
Configurazione dei metadati in Engineering Publishing per i report in stile documento : aggiungere il modello di sistema di tipi a un modello Engineering Publishing che può essere importato.

Passo 3: Connessione all'origine dati dell'applicazione

Individuare lo schema di origine dati che si desidera importare. È possibile utilizzare gli elementi nello schema per aggiungere query ai dati dell'applicazione per il modello. Queste query specificano quale parte di informazioni vengono generate per ultime nel report.

Esaminare gli schemi di dati disponibili che si desidera utilizzare nel report. Ognuno dei prodotti dispone di un singolo schema oppure di un insieme di schemi.
- IBM Engineering Requirements Management DOORS® Next Informazioni sullo schema: Schema su Jazz®.net
- IBM Engineering Workflow Management Informazioni sullo schema: Schema su Jazz.net
- IBM Engineering Test Management Informazioni sullo schema: Schema su Jazz.net
  Engineering Test Management offre due diversi tipi di schemi:
  - Schema di raccolta: questo schema fa riferimento allo schema di singole risorse
  - Schema singola risorsa: questo schema contiene le definizioni per tutte le risorse utente nel repository Quality management.
Creare un URL che punti allo schema dell'origine dati. Di seguito sono riportati esempi di URL che puntano alle risorse dell'applicazione. Questi esempi potrebbero essere modificati per restringere l'ambito dell'URL affinché punti ad un sottoinsieme di schemi. Visitare i link alle informazioni di supporto per i dettagli.
- Engineering Requirements Management DOORS Next URL dello schema dell'origine dati:
  - Formato:
```
https://server:port/rmContextRoot/publish/artifact?metadata=schema
```
  - Esempio:
```
https://localhost:9443/rm/publish/text?metadata=schema
```
  - Variabili:
    - rmContextRoot: root di contesto dell'istanza dell'applicazione Requirements management
    - artefatto: tipo di artefatto dei requisiti che si sta interrogando (testo, risorse, ecc.). Vedi Tipi di artefatti supportati sul Jazz.net wiki.
- URL dell'origine dati di Engineering Workflow Management :
  - Formato:
```
https://server:port/ccmContextRoot/rpt/repository/resource?metadata=schema
```
  - Esempio:
```
https://localhost:9443/ccm/rpt/repository/workitem?metadata=schema
```
  - Variabili:
    - rmContextRoot: root di contesto dell'istanza dell'applicazione Requirements management
    - risorsa: Tipo di risorsa di Engineering Workflow Management che si sta interrogando (testo, risorse, ecc.).
- URL dell'origine dati di Engineering Test Management :
  - Formato:
```
https://host:port/qmcontextRoot/service/com.ibm.rqm.integration.service.IIntegrationService/schema/schema file name
```
  - Esempio - Schema di raccolta:
```
https://localhost:9443/qm/service/com.ibm.rqm.integration.service.IIntegrationService/schema/feed.xsd
```
  - Esempio - Schema singola risorsa:
```
https://localhost:9443/qm/service/com.ibm.rqm.integration.service.IIntegrationService/schema/qm.xsd
```
  - Variabili:
    - qmContextRoot: Radice del contesto dell'istanza dell'applicazione Engineering Test Management
    - nome del file dello schema: nome dello schema che si sta interrogandotasks.xsd, testscript.xsd, ecc.). Per informazioni sui file di Schema su Jazz.net schema disponibili, consultare.
Aggiungere una nuova origine dati in Document Studio. Per connettersi allo Engineering Workflow Management schema, è possibile seguire i passaggi riportati di seguito oppure utilizzare la procedura guidata Schema Discovery ( Dati > Schema Discovery > REST Schema Discovery e inserire lo schema dell'origine dati URL.
Nota: La procedura guidata di individuazione dello schema non funziona con le API REST delle applicazioni Engineering Requirements Management DOORS Next e Engineering Test Management, pertanto è necessario aggiungere lo schema direttamente con i passaggi seguenti.
1. Nella vista Schemi origine dati, fare clic sul pulsante Aggiungi nuova origine .
2. Per Engineering Workflow Management, selezionare REST come tipo di schema e inserire un ID. Per Engineering Test Management o Engineering Requirements Management DOORS Next, selezionare Generic XML per ottenere prestazioni migliori.
3. Inserite l' URL costruito al punto 2 per accedere alle risorse dell'applicazione Engineering Lifecycle Management.
4. Immettere le credenziali appropriate che forniscono accesso al repository dell'applicazione.
Configurare dinamicamente lo schema di origine dati in modo che possa essere selezionato al runtime. Se si prevede di importare ed eseguire il modello dall'interfaccia utente di Engineering Lifecycle Management, si può decidere di recuperare dinamicamente i dati dalla propria applicazione o da un'applicazione amica in fase di esecuzione, anziché durante la progettazione del modello.
Per ciascuna origine dati il cui URL viene configurato dinamicamente da un elemento di configurazione dell'origine dati nel modello, aggiungere un ulteriore schema dell'origine dati al modello. Il nome dello schema non deve iniziare con un trattino basso (_). Questa fonte di dati aggiuntiva non deve essere referenziata nel modello.

Aggiunta di uno schema dell'origine dati

Passo 4: Aggiunta al modello di query di dati basati sull'applicazione

Designer di report: Usare Document Studio per aggiungere dati dalle fonti di dati di Engineering Workflow Management a un modello di report esistente. Le query di dati aggiunte individuano quale parte di dati vengono create in varie parti dell'output del report. È necessario selezionare i punti di dati nella vista Schemi origine dati e aggiungerli in ordine gerarchico al modello.

Passo 5: Creazione specifiche del documento

Una volta terminata la creazione del modello di report ed averlo popolato con i punti di dati dell'applicazione, è possibile creare un report in vari formati. Quando si genera un report è necessario connettersi all'origine dati che contiene le informazioni su cui si desidera eseguire il report. Per fare ciò specificare un URI che punti al repository dell'applicazione che contiene i dati pertinenti. Per connettersi a un'origine dati di Engineering Workflow Management, è possibile utilizzare anche la procedura guidata Schema Discovery.

È possibile utilizzare i filtri, che sono versioni più specifiche dell'URI generale dell'origine dati, per puntare a sottoinsiemi specifici di dati, in modo che PUB non cerchi di recuperare più informazioni del necessario dal repository dell'applicazione durante la generazione dei report. Questi filtri devono essere ampi abbastanza da consentire di recuperare tutti i dati necessari a cui il modello fa riferimento ed evitare che il report creato sia incompleto.

Specificare i modelli da includere nel report.
Specificare il formato e la posizione dell'output.
Individuare l'URI dell'origine dati. È possibile puntare ad un'origine dati generale che richiami tutti i dati all'interno del repository o facoltativamente utilizzare i filtri, che sono URI più specifici, mediante la specifica di parametri, che richiamano un insieme più piccolo di dati dal repository.
- Engineering Requirements Management DOORS Next URI
  - Accedere a tutti gli oggetti nel
    - Formato:
```
https://server:port/rmContextRoot/publish/artifact/*
```
    - Esempio:
```
https://localhost:9443/rm/publish/text
```
  - Accedere a tutti gli oggetti in un progetto:
    - Formato:
```
https://server:port/rmContextRoot/publish/artifact?projectName=guid
```
    - Esempio:
```
https://localhost:9443/rm/publish/resources?projectName=JKESample
```
  - Accedere ad un oggetto specifico nel database:
    - Formato:
```
https://server:port/rmContextRoot/publish/artifact?resourceURI=rrc1,rrc2,rrc3
```
    - Esempio:
```
https://localhost:9443/rm/publish/resources?resourceURI=_c1cm0L3VEeCPFbe791FOoQ
```
  - Variabili:
    - rmContextRoot: root di contesto dell'istanza dell'applicazione Requirements management
    - artefatto: tipo di artefatto dei requisiti che si sta interrogando (testo, risorse, ecc.). Vedi Tipi di artefatti supportati sul Jazz.net wiki.
    - guid: ID univoco per il progetto di requisiti. Per informazioni sui parametri opzionali, consultare la sezione Scope and Filtering Parameters (Ambito e parametri di filtraggio) sul Jazz.net wiki.
    - rrc1,rrc2,rrc3: ID univoci (separati da virgola) per oggetti di requisiti specifici
- Engineering Workflow Management URI
  Nota: Un tipico URI dell'origine dati per l' Engineering Workflow Management può essere costruito prendendo l' URL dello schema dell'origine dati, che è stato usato per aggiungere lo schema al modello, e rimuovendo il suffisso ?metadata=schema.
  - Formato:
```
https://host:port/ccmcontextRoot/rpt/repository/resource/filtering properties
```
  - Esempio - Accesso alla risorsa generale:
```
https://localhost:9443/ccm/rpt/repository/workitem
```
  - Esempio - Accesso ad una risorsa specifica:
```
https://localhost:9443/ccm/rpt/repository/workitem?fields=workitem/workItem/id
```
    Restituisce il campo ID di tutti gli elementi workItem
  - Esempio - Accesso ad una risorsa specifica:
```
https://localhost:9443/ccm/rpt/repository/workitem?fields=workitem/workItem/(id|summary)
```
    Restituiscono i campi ID e di riepilogo di tutti gli elementi workItem
  - Variabili:
    - ccmContextRoot: Radice del contesto dell'istanza dell'applicazione di Engineering Workflow Management
    - risorsa: Tipo di risorsa utente su cui si sta eseguendo la query (esempio, foundation, scm, build, work item, apt).
    - (facoltativo) proprietà di filtro: parametri e indicatori di filtro facoltativi. Per informazioni sui parametri opzionali, consultare il wiki Reportable REST API: Selezione dei campi e filtraggio sul Jazz.net wiki.
- Engineering Test Management URI
  - Formato:
```
https://host:port/qmcontextRoot/service/com.ibm.rqm.integration.service.IIntegrationService/resources/project name/resource/filtering properties
```
  - Esempio:
```
https://localhost:9443/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/project1/testcase?abbreviate=false
```
  - Variabili:
    - qmContextRoot: Radice del contesto dell'istanza dell'applicazione Engineering Test Management
    - nome del progetto: nome del progetto di Engineering Test Management a cui si vuole accedere. Per visualizzare l'elenco dei nomi di progetto disponibili, visitare https://host:port/qmcontextRoot/service/com.ibm.rqm.integration.service.IIntegrationService/projects
    - risorsa: Tipo di artefatto che si sta interrogando (es. caso di test, piano di test, ecc.). Per informazioni sui tipi di risorse supportati, consultare la sezione Oggetti risorsa e loro relazioni sul wiki Jazz.net.
    - (facoltativo) proprietà di filtro: proprietà e indicatori di filtro facoltativi Per informazioni sui parametri opzionali, consultare la sezione Funzionalità avanzate sul Jazz.net wiki.
Immettere l'URI dell'origine dati.
Facoltativo: immettere le credenziali di accesso per accedere all'origine dati specificata. Se la specifica del documento è condivisa con altri utenti, è possibile voler lasciare vuoti i campi delle credenziali. Se non sono specificate le credenziali ed un utente tenta di eseguire un report dalla specifica del documento gli verranno richieste le credenziali. Se sono specificate le credenziali e un utente tenta di eseguire il report, per accedere al repository verranno utilizzate le credenziali salvate anche se non sono le credenziali di tale utente.

Condizioni di filtro supportate dai filtri nativi REST

Passo 6: Creazione report (facoltativo)

È possibile creare report dalle specifiche del documento. Quando si crea un report, è necessario connettersi all'origine dati o alle origini dati che forniscono i dati per il report. Per informazioni sulla generazione di documenti utilizzando PUB, vedere Generazione di un documento con la procedura guidata di generazione dei documenti.

Passo 7: Importazione del report in stile documento personalizzato

È possibile importare questo report nell'applicazione di gestione delle modifiche e delle configurazioni o dei requisiti e gli utenti possono generare report in stile documento utilizzando la procedura guidata di creazione di report nell'interfaccia web di Jazz per la gestione dei requisiti. Per ulteriori informazioni, consultare Impostazione di report in stile documento in Engineering Lifecycle Management dai modelli di Engineering Publishing.