Creazione di una nuova verifica

È possibile creare una nuova verifica da aggiungere ad una categoria esistente e a una serie di verifiche.

Informazioni su questa attività

Queste istruzioni descrivono come creare una nuova prova in una categoria e in una serie di verifiche esistenti (ad esempio, la serie di verifiche Code nella categoria Verifiche del gestore code) in IBM® MQ Explorer. Le istruzioni spiegano come definire la verifica nell'ambiente di sviluppo Eclipse. Per informazioni sulla scrittura dell'origine di test Java , consultare l' interfaccia di WMQTest.

Se si desidera creare una nuova serie o una nuova categoria di verifiche invece di utilizzare una serie o una categoria esistenti, o se si è eseguita la creazione di nuovi oggetti da amministrare in IBM MQ Explorer e si stanno scrivendo delle verifiche per i nuovi oggetti, consultare Creazione di nuove categorie di verifiche, serie di verifiche e tipi di oggetto.

Creazione di un progetto Eclipse che contenga la nuova verifica

Prima di iniziare

Accertarsi che siano stati installati gli strumenti Eclipse Graphical Editing Framework (GEF). Per ulteriori informazioni, vedi Installazione di IBM MQ Explorer in ambienti Eclipse.

Informazioni su questa attività

Creare e configurare un nuovo progetto di plug-in che contenga la nuova verifica:

Procedura

  1. Aprire la prospettiva Sviluppo plug-in .
  2. Nella vista Esplora package, fare clic con il tasto destro del mouse, quindi fare clic su Nuovo > Progetto plug-in. Si apre la procedura guidata per la creazione di un nuovo progetto di plug-in.
  3. Nel campo Nome progetto , immettere un nome per il progetto che contiene i nuovi test.
  4. Fare clic su Avanti.
  5. Modificare i dettagli nei campi Versione, Nomee Fornitore , quindi fare clic su Fine.

    Si noti che il valore riportato nel campo ID può essere differente dal valore immesso nel campo Nome nella pagina precedente della procedura guidata. Il nome del progetto viene utilizzato solo durante lo sviluppo; l'ID del plugin viene utilizzato da Eclipse per caricare e identificare il plug-in.

    Il nuovo progetto di plug-in verrà visualizzato nella vista Esplora pacchetti ed il file manifest del plug-in verrà aperto automaticamente.
  6. Nell'editor Manifest del plugin, fare clic sulla scheda Dipendenze . Due dipendenze sono già elencate nel riquadro Plug-in obbligatori.
  7. Aggiungere i seguenti plug-in al riquadro Plug-in richiesti :
    • com.ibm.mq.explorer.tests
    • com.ibm.mq.explorer.ui
    • com.ibm.mq.pcf.event
    • com.ibm.mq.runtime
    • org.eclipse.core.resources

    Se i plug-in elencati non sono disponibili, installare gli strumenti Eclipse Graphical Editing Framework (GEF). Per ulteriori informazioni, vedi Installazione di IBM MQ Explorer in ambienti Eclipse.

  8. Salvare il file MANIFEST.MF .

Risultati

Il progetto di plug-in è pronto per contenere verifiche

Definizione di una nuova verifica

Informazioni su questa attività

Le seguenti istruzioni descrivono come definire una nuova verifica in una serie di verifiche esistenti (ad esempio, nella serie di verifiche Code), nella categoria Verifiche del gestore code. Per ulteriori informazioni sulla creazione di nuove serie di verifiche nella categoria di verifiche del gestore code, sulla creazione di nuove categorie o sulla definizione di nuovi tipi di oggetti da verificare, consultare Creazione di nuove categorie, serie di verifiche e tipi di oggetti.

Configurare il plug-in per contenere una nuova verifica:

Procedura

  1. Verificare che il file plugin.xml o MANIFEST.MF sia aperto in Plug-in Manifest editor.
  2. Nell'editor Manifest del plug-in, fare clic sulla pagina Estensioni per visualizzare la pagina Estensioni .
  3. Fare clic su Aggiungi ....
    Si apre la procedura guidata per la creazione di una nuova estensione.
  4. Evidenziare il punto di estensione com.ibm.mq.explorer.tests.Tests , quindi fare clic su Fine.
    La nuova estensione di verifica viene aggiunta al riquadro Tutte le estensioni nell'Editor plug-in manifest.
  5. Fare clic sulla nuova verifica per evidenziarla, quindi immettere i dettagli della verifica come illustrato nella seguente tabella:
    Attributo Descrizione Valore di esempio
    ID L'identificativo univoco della verifica. com.ibm.mq.explorer.tests.samples.QueueNames
    nome Il nome della verifica. Test verifiche personali
    classe La classe Java che contiene la verifica. Non immettere ancora questo valore; è possibile immettere questo valore automaticamente quando si crea la classe successivamente. com.ibm.mq.explorer.tests.samples.QueueNames
    testset La categoria alla quale appartiene la verifica. Il valore di esempio mostrato associa la verifica alla categoria Queue manager tests. com.ibm.mq.explorer.tests.samples.wmq
    testsubset La sottocategoria alla quale appartiene la verifica. Il valore di esempio mostrato associa la verifica alla sottocategoria Queues. Code
    descrizione Una descrizione della verifica. Controlla i nomi delle code sulla base delle semplici convenzioni di denominazione.
    furtherinfo L'ubicazione di un documento HTML o XHTML che contiene ulteriori informazioni sulla verifica. Questo documento viene visualizzato in IBM MQ Explorer quando si fa doppio clic sulla verifica nella finestra di dialogo Esegui verifiche o sul risultato di una verifica nella vista Risultati della verifica. Per ulteriori informazioni, consultare Test Documentation doc/QueueNamesInfo.html (L'ubicazione del file relativa al file plugin.xml.)
  6. Salvare il file dell'Editor plug-in manifest.

Risultati

Il progetto di plug-in è ora configurato per contenere una nuova verifica; a questo punto, occorre scrivere la verifica.

Definire una nuova verifica per ciascuna nuova verifica che si desidera scrivere.

Creazione di una nuova verifica

Informazioni su questa attività

Creare una nuova classe di Java che contenga il test:

Procedura

  1. Nel riquadro Dettagli elemento estensione , fare clic sull'etichetta del campo classe , sottolineata.
    Verrà aperta la procedura guidata Editor attributi Java.
  2. Assicurarsi che sia selezionata solo la casella Metodi astratti ereditati , quindi fare clic su Fine. Il file di classe Java viene aperto nell'editor Java .
  3. Salvare il file dell'Editor plug-in manifest. Si noti che il valore nel campo relativo alla classe viene inserito automaticamente.
  4. Modificare l'origine Java .
  5. Documentare la verifica in un file XHTML o HTML valido. Salvare il file con il nome e l'ubicazione specificati nell'attributo furtherinfo nel file plugin.xml. L'ubicazione del file XHTML potrebbe essere locale (memorizzato nello stesso plug-in della verifica, ad esempio in una sottocartella doc) oppure remota (memorizzato su un server Web).

Risultati

È stata completata la scrittura della verifica e la configurazione del plug-in che contiene la verifica. Successivamente, esportare il plug-in e distribuirlo per eseguirne la verifica.

Scrivere una nuova verifica per ogni verifica definita nel file plugin.xml.

Distribuzione della nuova verifica

Informazioni su questa attività

Esportare il plug-in che contiene la verifica (o la serie di verifiche) sul file system e riavviare quindi IBM MQ Explorer in modo che il nuovo plug-in venga caricato e sia possibile eseguire le verifiche:

Procedura

  1. Nella vista Esplora package, fare clic con il tasto destro del mouse sul progetto plugin, com.ibm.mq.explorer.tests.samples, quindi fare clic su Esporta .... Esporta ... .
  2. Nella prospettiva Sviluppo plug-in , selezionare Frammenti e plug-in distribuibili per evidenziarlo, quindi fare clic su Avanti.
  3. Nel campo Directory, immettere l'ubicazione del plugin Verifiche IBM MQ Explorer . L'ubicazione è MQ_INSTALLATION_PATH\eclipse, dove MQ_INSTALLATION_PATH rappresenta la directory di alto livello in cui è installato IBM MQ .
  4. Selezionare il plug-in in Frammenti e plug-in disponibilie fare clic su Fine.
  5. Riavviare Eclipsee passare alla vista IBM MQ Explorer .

Risultati

Il nuovo plug-in è stato distribuito. È ora possibile eseguire le nuove verifiche.