Groupe de commandes WebServicesAdmin pour l'objet AdminTask

Vous pouvez utiliser les langages de script Jython ou Jacl pour configurer la sécurité à l'aide de l'outil wsadmin. Les commandes du groupe WebServicesAdmin permettent de répertorier tous les services web, les références de service et les attributs, de rechercher les attributs d'un service Web particulier, de déterminer le noeud final d'un service web ou de déterminer le nom des opérations d'un service Web.

Utilisez les commandes du groupe WebServicesAdmin pour rechercher des informations relatives aux services Web installés. Pour plus d'informations sur l'objet AdminTask, voir l'article sur les commandes de l'objet AdminTask.

Les commandes suivantes sont disponibles pour le groupe WebServicesAdmin de l'objet AdminTask :

getWebService

La commande getWebService extrait les attributs d'un service Web. Cette commande s'applique uniquement aux applications d'entreprise.

Objet cible

Aucune.

Paramètres obligatoires

-application
Indique le nom de l'application d'entreprise déployée. (Chaîne, obligatoire)
-module
Spécifie le nom du module. (Chaîne, obligatoire)
-service
Indique le nom du service Web. (Chaîne, obligatoire)

Paramètres facultatifs

-client
Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)

Valeur renvoyée

Cette commande renvoie une liste d'attributs, y compris le nom de service et le type de service, et indique si le service est un fournisseur ou un client. L'attribut de type de service n'est applicable que pour les fournisseurs de service.

Exemple d'utilisation en mode de traitement par lots

Avec une chaîne Jython :
AdminTask.getWebService('[–application application_name -module module_name -service webservice_name
 -client false]')
Exemple de sortie :
'[[service {http://www.ibm.com}service1][type JAX-WS][client false]]'

Syntaxe d'un exemple de mode interactif

Avec Jython :
AdminTask.getWebService ('-interactive')

listServices

La commande listServices demande la configuration de services, de noeuds finaux et d'opérations. Cette commande fournit des fonctions de requête plus génériques que le reste des commandes de ce groupe. Elle concerne les applications Java, ainsi que d'autres actifs tels que des clients WSN (Web Services Notification).

Objet cible

Aucune.

Paramètres facultatifs

-queryProps
Spécifie les propriétés utilisées pour localiser le fournisseur de services ou le client concerné. Par exemple, si vous spécifiez [[type=JAX-WS][client=true]], la commande renvoie chaque référence de client JAX-WS dans les applications d'entreprise. (Propriétés, facultatif)
Le paramètre -queryProps accepte plusieurs propriétés. Vous pouvez utiliser une ou plusieurs propriétés pour spécifier vos critères de recherche. Ne mélangez pas les propriétés de requête entre les différents types d'actif. Par exemple, si vous spécifiez application et bus, la commande signale une erreur.
  • Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger des applications d'entreprise :
    Tableau 1. Propriétés du paramètre -queryProps pour les applications d'entreprise. Utilisez ces propriétés pour interroger les applications d'entreprise.
    Propriété et valeur Description
    assetType=J2EE Application Interroge chaque application Java EE.
    application=nom_application Interroge une application Java EE spécifique.
    module=nom_module Interroge un module d'application Java EE spécifique. Vous devez spécifier les propriétés application et module pour demander des modules d'application.
  • Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger des clients WSN :
    Tableau 2. Propriétés pour l'interrogation des clients WSN. Utilisez ces propriétés pour interroger les clients WSN.
    Propriété et valeur Description
    assetType=WSN Service Interroge chaque client de service WSN.
    bus=nom_bus Interroge un bus spécifique.
    WSNService=nom_service_WSN Interroge un service WSN spécifique. Vous devez spécifier les propriétés bus et WSNService pour un service WSN spécifique.
  • Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger tous les actifs :
    Tableau 3. Propriétés du paramètre -queryProps pour l'interrogation de tous les actifs. Utilisez ces propriétés pour interroger tous les actifs.
    Propriété et valeur Description
    serviceType=type_service Interroge par type de service. Spécifiez JAX-WS pour rechercher des actifs JAX-WS (Java API for XML-Based Web Services). Spécifiez JAX-WS (WSN) pour rechercher des actifs WSN (Web Services Notification).
    client=Booléen Recherche des clients ou des fournisseurs. Spécifiez true pour rechercher des clients. Spécifiez false pour rechercher des fournisseurs.
    service=nom_service Recherche les noeuds finaux et les opérations logiques pour un service spécifique.
  • Spécifiez les propriétés suivantes avec le paramètre -queryProps pour interroger toutes les références de service ou une référence de service spécifique lorsque client=true :
    Tableau 4. Propriétés du paramètre -queryProps pour l'interrogation des références de service. Utilisez ces propriétés pour interroger toutes les références de service des clients de service.
    Propriété et valeur Description
    serviceRef=nom_refservice

    Demandes d'une référence de service spécifique.

    Vous pouvez également utiliser un astérisque (*) comme caractère générique pour spécifier le renvoi de toutes les références de service sous le client de service correspondant.

-expandResource
Indique si les noms de service uniquement ou des détails sur les ressources doivent être renvoyés. Spécifiez logicalEndpoint ou operation. Si vous spécifiez la valeur logicalEndpoint, la commande renvoie les services correspondants et chaque noeud final des services. Si vous spécifiez la valeur operation, la commande renvoie les services, les noeuds finaux et les opérations correspondants. (Chaîne, facultatif)
Vous pouvez utiliser le paramètre expandResource pour renvoyer les informations de ressources détaillées des noeuds finals et des opérations sous la référence de service.

Valeur renvoyée

La commande renvoie une liste de propriétés pour chaque service, ainsi que des informations détaillées sur le noeud final ou l'opération si vous recherchez des noeuds finaux ou des opérations.

Syntaxe d'un exemple de mode de traitement par lots

Les exemples suivants interrogent chaque fournisseur de services dans l'application myApplication. Les exemples renvoient les noeuds finaux logiques pour chaque service car le paramètre -expandResources est défini en tant que logicalEndpoint, comme le montre l'exemple de sortie suivant :
[ [service {http://www.ibm.com}EchoService] [assetType [J2EE Application]]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {http://www.ibm.com}EchoService]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] 
[logicalEndpoint EchoServicePort] ]

[ [service {http://www.ibm.com}PingService] [assetType [J2EE Application]]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS] ]
[ [assetType [J2EE Application]] [service {http://www.ibm.com}PingService]
 [client false] [application MyWSApplication] [module ServicesModule.war] [serviceType JAX-WS]
 [logicalEndpoint PingServicePort] ]
A l'aide de la chaîne Jython :
AdminTask.listServices('[-queryProps [[application MyWSApplication][client false]] -expandResource
 logicalEndpoint]')
A l'aide de la liste Jython :
AdminTask.listServices(['–queryProps', '[[application myApplication][client false]]', '-expandResource',
 'logicalEndpoint'])

Les exemples suivants interrogent chaque client de service sous le bus myBus. Les exemples ne renvoient pas de noeud final ou d'opération logique pour chaque client de service car le paramètre -expandResource n'est pas spécifié.

A l'aide de la chaîne Jython :
AdminTask.listServices('[–queryProps [[bus myBus][client true]] ]')
A l'aide de la liste Jython :
AdminTask.listServices(['–queryProps', '[[bus myBus][client true]]'])

Les exemples suivants interrogent les références de service portant le nom testRef pour chaque client de service de l'application JaxWSServicesSamples. Ils renvoient des informations détaillées sur les ressources relatives aux noeuds finaux logiques et aux opérations pour chaque référence de service, parce que le paramètre -expandResource est spécifié.

A l'aide de la chaîne Jython :
AdminTask.listServices('[-queryProps [[client true] [application JaxWSServicesSamples] [module SampleClientSei.war]
 [serviceRef testRef] -expandResource logicalEndpoint]')
A l'aide de la liste Jython :
AdminTask.listServices(['-queryProps', '[[application JaxWSServicesSamples][client true][module SampleClientSei.war]
[serviceRef testRef]', '-expandResource', 'logicalEndpoint'])
Exemple de sortie :
'[ [serviceRef testRef] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [client true]
 [application JaxWSServicesSamples] [module SampleClientSei.war] [serviceType JAX-WS] ]

[ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true] [service {http://www.ibm.com}TestService] [assetType [J2EE Application]] [logicalEndpoint portA] [application JaxWSServicesSamples] ]

[ [serviceRef testRef] [module SampleClientSei.war] [serviceType JAX-WS] [client true] [service {http://www.ibm.com/}TestService] [assetType [J2EE Application]] [logicalEndpoint portB] [application JaxWSServicesSamples] ]'

Syntaxe d'un exemple de mode interactif

Avec Jython :
AdminTask.listServices('-interactive')

listWebServices

La commande listWebServices extrait la liste des services Web disponibles pour l'une ou la totalité des applications. Si aucun nom d'application n'est fourni, la commande répertorie tous les services Web. Cette commande s'applique uniquement aux applications d'entreprise.

Objet cible

Aucun.

Paramètres obligatoires

Aucune.

Paramètres facultatifs

-application
Indique le nom de l'application d'entreprise déployée. Si ce paramètre n'est pas spécifié, la commande renvoie tous les services Web dans la cellule. (Chaîne, facultatif)
-client
Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)

Valeur renvoyée

Tous les services Web de l'application spécifiée. Pour chaque service Web, cette commande renvoie les attributs suivants et les valeurs correspondantes : le nom de l'application, le nom du module, le nom de service, le type de service. Elle indique aussi si le service Web est un fournisseur ou un client. Le type de service n'est spécifié que si le service Web est un fournisseur de service.

Syntaxe d'un exemple de mode de traitement par lots

A l'aide de la chaîne Jython :
AdminTask.listWebServices('[–application application1 -client false]')
A l'aide de la liste Jython :
AdminTask.listWebServices(['–application', 'application1', '-client', 'false'])
Exemple de sortie :
'[[service {http://www.ibm.com}service1][application application1][module webapp1.war][type JAX-WS][client false]]'

Syntaxe d'un exemple de mode interactif

Avec Jython :
AdminTask.listWebServices('-interactive')

listWebServiceEndpoints

La commande listWebServiceEndpoints renvoie la liste des noeuds finaux logiques pour un service Web. Le nom de noeud final logique correspond au nom de port dans le document WSDL (Web Services Description Language). Cette commande s'applique uniquement aux applications d'entreprise.

Objet cible

Aucun.

Paramètres obligatoires

-application
Indique le nom de l'application d'entreprise déployée. (Chaîne, obligatoire)
-module
Spécifie le nom du module. (Chaîne, obligatoire)
-service
Indique le nom du service Web. (Chaîne, obligatoire)

Paramètres facultatifs

-client
Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)

Valeur renvoyée

Cette commande renvoie le nom de point de contact logique pour le service Web spécifié.

Syntaxe d'un exemple de mode de traitement par lots

A l'aide de la chaîne Jython :
AdminTask.listWebServiceEndpoints('[–application nom_application -module nom_module 
-service nom_service Web -client false]')
A l'aide de la liste Jython :
AdminTask.listWebServiceEndpoints(['–application', 'nom_application', '-module', 'nom_module',
 '-service', 'nom_service Web', '-client', 'false'])
Exemple de sortie :
'[[logicalEndpoint QuotePort01]]'

Syntaxe d'un exemple de mode interactif

Avec Jython :
AdminTask.listWebServiceEndpoints('-interactive')

listWebServiceOperations

La commande listWebServiceOperations renvoie la liste des opérations de service Web. Cette commande s'applique uniquement aux applications d'entreprise.

Objet cible

Aucun.

Paramètres obligatoires

-application
Indique le nom de l'application d'entreprise déployée. (Chaîne, obligatoire)
-module
Spécifie le nom du module. (Chaîne, obligatoire)
-service
Indique le nom du service Web. (Chaîne, obligatoire)
-logicalEndpoint
Nom de port dans le document WSDL (Web Services Description Language). (Chaîne, obligatoire)

Paramètres facultatifs

-client
Indique si le service Web est un fournisseur ou un client. La valeur par défaut est false (fournisseur de service). Lorsque la valeur de ce paramètre est true, la commande ne renvoie que des clients de services Web. (Booléen, facultatif)

Valeur renvoyée

La commande renvoie le nom de l'opération du service Web spécifié.

Syntaxe d'un exemple de mode de traitement par lots

A l'aide de la chaîne Jython :
AdminTask.listWebServiceOperations('[–application nom_application -module 
nom_module -service nom_service Web -client false
 -logicalEndpoint nom_noeud_final]')
A l'aide de la liste Jython :
AdminTask.listWebServiceOperations(['–application', 'nom_application', '-module', 
'nom_module', '-service', 'nom_service_web', '-client',
 'false', '-logicalEndpoint', 'nom_noeud_final'])
Exemple de sortie :
'[[operation ivt_app_op1][operation ivt_app_op2]]'

Syntaxe d'un exemple de mode interactif

Avec Jython :
AdminTask.listWebServiceOperations('-interactive')

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_wsfpwebservicesadmin
Nom du fichier : rxml_wsfpwebservicesadmin.html