SAP Query as a Web Service Designer Mode d'emploi

Plateforme SAP BusinessObjects Business Intelligence

Version du document : 4.2 – 2015-11-12

SAP BusinessObjects Query as a Web

Service Designer

Contenu

1

1.1

1.2

1.3

Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4

Définition de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4

Utilisation de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

4

Architecture du composant Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5

2

2.1

Installation de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6

Conditions préalables à l'installation de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . .

6

2.2 Installation de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6

2.3 Dépannage de l'installation de Query as a Web Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7

Le CMS doit avoir été lancé avant Tomcat.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

7

Modification du CMS par défaut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8

Activation de traces pour les services Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

8

Optimisation de la disponibilité du CMS.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9

2.4 Optimisation des requêtes sur les sources de données relationnelles pour SAP BusinessObjects

Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

9

Activation du point de terminaison de QaaWS Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10

3

3.1

Lancement de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Conditions préalables à l'exécution de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . .

12

12

3.2 Procédure de lancement de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

12

Démarrage de Query as a Web Service Designer pour la première fois. . . . . . . . . . . . . . . . . . . . . . .

13

Lancement de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

13

Connexion avec différentes références de connexion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15

3.3 Mode de gestion des hôtes Query as a Web Service Designer dans le CMS. . . . . . . . . . . . . . . . . . . . . .

15

Ajout d'un nouvel hôte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15

Modification d'un hôte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16

4

4.1

Création d'une requête à publier comme service Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Créer et publier une requête Query as a Web Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18

18

4.2 Comment créer une nouvelle requête à l'aide de l'Assistant de publication de Query as a Web Service

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

18

Pour exécuter l'Assistant de publication de Query as a Web Service. . . . . . . . . . . . . . . . . . . . . . . . .

19

Pour définir les propriétés de nom et de description de la requête. . . . . . . . . . . . . . . . . . . . . . . . . .

19

Pour sélectionner un univers pour une requête. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21

Pour définir une requête. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

21

Pour afficher et publier une requête. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24

4.3 Création d'une nouvelle requête à partir d'une requête publiée. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24

Pour dupliquer une requête publiée existante. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24

2

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Contenu

5

5.1

Gestion des requêtes Query as a Web Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

26

Gestion des requêtes à partir de la page Catalogue de requêtes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

26

5.2 Pour créer des dossiers dans le catalogue de requêtes.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

26

5.3 Modification d'une requête Query as a Web Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

27

5.4 Pour renommer une requête. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

27

5.5 Suppression d'une requête Query as a Web Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

27

5.6 Pour copier et coller une requête Query as a Web Service. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

28

5.7 Pour afficher les propriétés d'une requête. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

28

5.8 Pour voir les instances de requêtes sous forme de services Web disponibles : . . . . . . . . . . . . . . . . . . .

28

5.9 Déploiement de requêtes vers un autre serveur Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

Modifications de mises à jour du fichier WSDL dans le déploiement de requête. . . . . . . . . . . . . . . .

30

Déploiement vers un autre serveur avec l'outil client Query as a Web Service. . . . . . . . . . . . . . . . . .

30

Déploiement de Query as a Web Service à l'aide de l'Assistant d'importation . . . . . . . . . . . . . . . . . .

31

Déploiement de Query as a Web Service à partir d'un fichier BIAR. . . . . . . . . . . . . . . . . . . . . . . . . .

31

Mise à jour du cache WSDL lors du déploiement de requêtes vers un autre serveur. . . . . . . . . . . . .

32

5.10 Déploiement de Query as a Web Service sur plusieurs serveurs Web. . . . . . . . . . . . . . . . . . . . . . . . . .

33

Pour configurer le client Query as a Web Service pour la connexion à un serveur Web de proxys inverses. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

33

6

6.1

Utilisation de Query as a Web Service avec différentes applications. . . . . . . . . . . . . . . . . . . . . . .

34

Utilisation d'une requête Query as a Web Service avec le WSDL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

34

6.2 Utilisation d'une requête Query as a Web Service dans SAP BusinessObjects Dashboards. . . . . . . . . . .

34

Problème de domaines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

35

Pour sélectionner le service Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

35

Messages entrants. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

36

Messages sortants. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

36

Authentification dans SAP BusinessObjects Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

36

6.3 Utilisation d'une requête Query as a Web Service dans Crystal Reports. . . . . . . . . . . . . . . . . . . . . . . .

37

6.4 Utilisation d'une requête Query as a Web Service sous Microsoft Office InfoPath. . . . . . . . . . . . . . . . . .

38

7 Appel de description API par le service Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

39

8 Limitations lors de l'utilisation de Query as a Web Service Designer. . . . . . . . . . . . . . . . . . . . . . .

41

SAP BusinessObjects Query as a Web Service Designer

Contenu

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

3

1 Introduction

1.1 Définition de Query as a Web Service Designer

Remarque

L'Aide en ligne mise à jour correspondant à cette version est entièrement documentée dans la version PDF du

Guide de l'utilisateur de Query as a Web Service disponible sur le portail d'aide SAP à l'adresse http:// help.sap.com

. La version complète de cette Aide en ligne est également disponible dans la version 4.1 en langue anglaise.

Query as a Web Service Designer est une application SAP BusinessObjects qui permet de créer rapidement des requêtes et de les publier sous forme de services Web.

Une requête publiée sous forme de service Web est une instruction SQL créée dans un univers Business Objects et publiée sur un serveur hôte hébergeant des services Web.

Ce service est à la disposition de toutes les applications qui utilisent les services Web. Il permet d'accéder aux données renvoyées par la requête dans application. Il permet de transmettre de façon sécurisée des informations

Business Intelligence (BI) à toute application prenant en charge les services Web.

Query as a Web Service Designer comporte un composant client à l'aide duquel l'utilisateur peut créer des requêtes à partir d'univers et un service Web hébergé par un serveur qui permet aux développeurs de créer des services Web à partir de requêtes Business Objects spécifiques.

1.2 Utilisation de Query as a Web Service Designer

Query as a Web Service Designer permet de transmettre le contenu Business Intelligence à toute interface utilisateur pouvant traiter les services Web. Avec Query as a Web Service, l'utilisateur peut définir sa propre requête à partir d'un univers, puis la publier en tant que service Web autonome.

Query as a Web Service Designer peut être utilisé dans une plage de solutions côté client dans les outils tels que :

● Microsoft Office, Excel et InfoPath

● SAP NetWeaver

● OpenOffice

● Applications de gestion de processus et de règles de gestion

● Plateformes Enterprise Service Bus

Remarque

Pour en savoir plus sur l'utilisation des services Web fournis par SAP Business Objects, reportez-vous au site

SAP Developer Network http://www.sdn.sap.com/irj/boc/ .

4

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Introduction

1.3 Architecture du composant Query as a Web Service

Designer

Query as a Web Service Designer fonctionne sur les applications Windows. Il est basé sur les applications du service Web W3C :

● SOAP

● WSDL

● XML

Query as a Web Service Designer se compose de deux composants principaux :

Table 1 :

Composant

Côté serveur

Côté client

Description

Inclus dans la plateforme SAP BusinessObjects Business Intelligence), stocke le catalogue Query as a Web

Service Designer et héberge les services Web publiés.

Application client utilisée par les utilisateurs de l'entreprise pour créer et publier les requêtes sous forme de services Web. Vous pouvez installer le client sur plusieurs ordinateurs qui ont alors accès au même catalo­ gue Query as a Web Service Designer stocké sur le serveur.

Remarque

Dans ce guide, l'expression Query as a Web Service Designer fait référence au client. Si des informations font référence au composant serveur, elles comporteront l'expression "composant serveur" de Query as a Web

Service Designer.

Le client communique avec les composants serveur via les services Web.

SAP BusinessObjects Query as a Web Service Designer

Introduction

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

5

2 Installation de Query as a Web Service

Designer

2.1 Conditions préalables à l'installation de Query as a Web

Service Designer

Les conditions préalables à l'installation de Query as a Web Service Designer sont les suivantes :

Table 2 :

Pour...

Côté ser­ veur

Conditions préalables à l'installa­ tion

Suite SAP BusinessObjects Business

Intelligence 4.1

Web Services

Description

Tomcat ou autre application Web prise en charge et JDK

Pour obtenir une liste à jour des applications Web et versions prises en charge, voir : SAP Service Marketplace : https://support.sap.com/pam

Côté client .NET 2.0 Framework Requis pour générer et publier des requêtes.

La plateforme client doit être prise en charge pour une utilisation avec la suite SAP BusinessObjects Business

Intelligence 4.1.

Pour obtenir une liste à jour des versions prises en charge, voir : SAP Ser­ vice Marketplace : https://support.sap.com/pam

2.2 Installation de Query as a Web Service Designer

Le composant serveur de Query as a Web Service Designer fait partie de la suite SAP BusinessObjects Business

Intelligence 4.1 et est installé automatiquement.

Vous devez ensuite installer le client Query as a Web Service Designer sur chaque ordinateur qui aura accès au serveur via les services Web. Une fois l'installation de Query as a Web Service Designer terminée, définissez un système "hôte" lors de la première connexion.

Remarque

Les utilisateurs doivent faire partie des groupes d'administrateurs ou d'utilisateurs de QaaWS Designer pour pouvoir démarrer le client Query as a Web Service Designer et l'utiliser afin de concevoir des requêtes.

1. Naviguez jusqu'au dossier Add-Ons\Query as a Web Service du disque d'installation des documents et ressources d'accompagnement de BusinessObjects Enterprise ou recherchez le fichier setup.exe de la requête Query as a Web Service sur votre réseau.

6

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Installation de Query as a Web Service Designer

2. Cliquez deux fois sur setup.exe pour lancer l'Assistant Query as a Web Service Designer.

3. Suivez les instructions de l'Assistant d'installation qui s'affichent à l'écran pour mener à bien l'installation.

Remarque

Une fois l'installation terminée, vous devez définir un système "hôte" lors de la première connexion. Pour en savoir plus sur le premier démarrage de l'application, voir Rubriques associées.

Informations associées

Procédure de lancement de Query as a Web Service Designer [page 12]

Mode de gestion des hôtes Query as a Web Service Designer dans le CMS [page 15]

2.3 Dépannage de l'installation de Query as a Web Service

Cette section contient des informations destinées à vous aider à résoudre divers problèmes d'installation possibles. Reportez-vous aux rubriques associées qui se trouvent à la fin de la section pour en savoir plus sur les

éléments suivants :

● Le CMS doit avoir été lancé avant Tomcat.

● Modification du CMS par défaut.

● Activation de traces pour les services Web.

● Optimisation de la disponibilité de la CMS.

Informations associées

Le CMS doit avoir été lancé avant Tomcat. [page 7]

Optimisation de la disponibilité du CMS. [page 9]

2.3.1 Le CMS doit avoir été lancé avant Tomcat.

Le CMS doit être lancé avant Tomcat. Lors du lancement de Tomcat, le servlet Query as a Web Service Designer est initialisé et requiert la définition de Query as a Web Service Designer à partir du CMS pour générer correctement le cache. Le CMS doit être disponible pour ce processus.

Si vous lancez le CMS automatiquement à l'aide des services NT, vous n'avez pas besoin de répéter l'opération manuellement.

SAP BusinessObjects Query as a Web Service Designer

Installation de Query as a Web Service Designer

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

7

2.3.2 Modification du CMS par défaut

Par défaut, les services Web se connectent au CMS du nom de l'ordinateur local (port 6400). Pour utiliser un autre CMS dédié, vous devez spécifier un numéro de port du CMS différent de celui par défaut en modifiant la propriété de domaine dans le fichier dsws.properties. Procédez comme suit :

1. Arrêtez Tomcat.

2. Localisez le fichier dsws.properties sous : <CHEMIN_NSTALLATION>\warfiles\WebApps\dswsbobje

\WEB-NF\classes.

3. Ouvrez le fichier dsws.properties et recherchez :

<domain=CMSserverName:port>

4. Saisissez le nom du CMS. Vous pouvez saisir un nom de domaine complet pour spécifier l'emplacement du

CMS.

5. Enregistrez le fichier dsws.properties et fermez-le.

6. Redémarrez Tomcat.

Remarque

Si vous ne modifiez pas la propriété de domaine dans le fichier dsws.properties, le message d'erreur suivant s'affiche : "Serveur CMS introuvable ou hors service (FWM01003)". Si vous recevez ce message d'erreur, vous devez modifier le numéro de port du CMS par défaut.

Pour en savoir plus sur la gestion des serveurs dans la CMC, voir le Guide d'administration de la plateforme de

Business Intelligence disponible sur le SAP Help Portal : http://help.sap.com

2.3.3 Activation de traces pour les services Web

S'il existe un problème de configuration, l'administrateur SAP Business Objects peut être amené à configurer des traces afin d'optimiser le dépannage.

SAP Business Objects recommande vivement d'utiliser des traces, et ce à des fins de dépannage uniquement et dans des environnements de test.

1. Dans le CCM (Central Configuration Manager), arrêtez le service "Apache Tomcat 5.5.20".

2. Changez le niveau de traçage.

Par défaut, Query as a Web Service trace uniquement les erreurs. Vous devrez peut-être fournir des traces supplémentaires pour l'assurance client.

3. Modifiez le fichier log4j.properties, situé à l'emplacement suivant : [CheminD'Installation]

\dswsbobje\WEB-INF\classes\

4. Saisissez les données suivantes dans le fichier des propriétés : log4j.logger.com.businessobjects=DEBUG, BO1

5. Changez l'emplacement de traçage.

Par défaut, le traçage est effectuée dans la console de sortie. Pour tracer un fichier, commentez le

ConsoleAppender et ne commentez pas le RollingFileAppender. Si Tomcat est défini en tant que service, le traçage est effectué dans le fichier dswsbobje.log, qui se situe à l'emplacement suivant : C:

\WINDOWS\system32.: # console appender # log4j.appender.BO1=org.apache.log4j.ConsoleAppender # log4j.appender.AXIS1=org.apache.log4j.ConsoleAppender #rolling file appender

8

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Installation de Query as a Web Service Designer

log4j.appender.BO1=org.apache.log4j.RollingFileAppender log4j.appender.BO1.File=dswsbobje.log log4j.appender.BO1.Append=false log4j.appender.BO1.MaxBackupIndex=5 log4j.appender.BO1.Max FileSize=10

6. Dans le CCM, démarrez le service "Apache Tomcat 5.5.20".

2.3.4 Optimisation de la disponibilité du CMS.

Le CMS ne peut disposer que d'une seule base de données système. Il est possible de perdre la connexion à la base de données système CMS pour les raisons suivantes :

● La base de données est arrêtée.

● Interruption du réseau entre le CMS et la base de données système du CMS

● Panne logicielle ou matérielle de l'application ou du poste CMS

Dans chacun de ces cas de figure, le déploiement de deux CMS réduit la probabilité de problèmes de connexion avec la base de données système du poste CMS.

Toutefois, si la base de données système du CMS présente un dysfonctionnement, aucun CMS ne peut traiter les requêtes entrantes sans erreur, que le cluster contienne un seul CMS ou plusieurs.

Pour limiter ce risque, vous pouvez utiliser une solution de tolérance des pannes livrée par le fournisseur de la base de données. Chaque fournisseur de base de données propose des solutions de tolérance des pannes visant à réduire le risque d'indisponibilité des bases de données. L'une des options de tolérance des pannes consiste à configurer une base de données miroir secondaire, s'exécutant sur un serveur secondaire. Si la première base de données présente un dysfonctionnement, par exemple, le fichier tns.ora est automatiquement mis à jour pour pointer vers le serveur de base de données secondaire. Comme les indicateurs de tolérance des pannes disponibles sont spécifiques à chaque base de données, il est recommandé de consulter la documentation de votre fournisseur pour en savoir plus.

Remarque

Si la fonctionnalité est disponible et activée, même si la connexion avec la base de données système est perdue, le CMS rétablit automatiquement la connexion à la base de données, sans nécessiter l'intervention de l'administrateur.

2.4 Optimisation des requêtes sur les sources de données relationnelles pour SAP BusinessObjects Dashboards

Vous pouvez bénéficier de deux serveurs Query as a Web Service Designer (QaaWS) Dashboards pour optimiser les requêtes Query as a Web Service Designer sur les sources de données relationnelles à partir de SAP

BusinessObjects Dashboards. Les serveurs sont les suivants :

● Dashboards Cache Server

● Serveur de traitement Dashboards

SAP BusinessObjects Query as a Web Service Designer

Installation de Query as a Web Service Designer

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

9

Remarque

Vous ne devez pas nécessairement activer le point de terminaison et les serveurs Dashboards si vous ne rencontrez pas de problème d'extensibilité Query as a Web Service Designer.

Les deux serveurs sont installés avec la plateforme SAP BusinessObjects Business Intelligence. Vous devez activer manuellement les serveurs et le point de terminaison de QaaWS Dashboards dans le serveur d'applications Web pour implémenter l'optimisation de la requête.

Cette section décrit l'activation du point de terminaison de QaaWS Dashboards après l'installation et l'activation des serveurs. Le point de terminaison de QaaWS Dashboards redirige les requêtes relationnelles de QaaWS

Dashboards vers les nouveaux serveurs de QaaWS Dashboards.

Pour une description complète des nouveaux serveurs et des avantages accessibles aux utilisateurs Dashboards qui utilisent des requêtes Query as a Web Service Designer sur des sources de données relationnelles, reportezvous à la documentation relative à l'administration d'entreprise.

2.4.1 Activation du point de terminaison de QaaWS

Dashboards

Avant d'activer le point de terminaison de QaaWS Dashboards pour optimiser les requêtes Query as a Web

Service Designer depuis SAP BusinessObjects Dashboards, vous devez effectuer les étapes suivantes :

● Installez la plateforme SAP BusinessObjects Business Intelligence.

● Créez les nouveaux serveurs dans la CMC (Central Management Console). Pour en savoir plus à ce sujet et sur la tâche suivante, reportez-vous au Guide d'administration de la plateforme de Business Intelligence sur le

SAP Help Portal : http://help.sap.com

.

● Activez puis démarrez les nouveaux serveurs Dashboards.

Vous activez le point de terminaison de QaaWS Dashboards pour permettre aux nouveaux serveurs de filtrer les données. Cela permet d'optimiser le nombre de requêtes qui peuvent être traitées par Query as a Web Service

Designer pour les utilisateurs Dashboards.

1. Arrêtez le serveur d'applications.

2. Accédez au fichier /DSWSBOBJE_INSTALLDIR/WEB-INF/web.xml et ouvrez-le.

3. Ajoutez les informations suivantes :

<filter>

<filter-name> XcelsiusQaawsAccelerator </filter-name>

<description> Qaaws Runtime Query Accelerator </description>

<filter-class> com.sap.xcelsius.server.QaawsRuntimeRequestFilter </filter-class>

</filter>

<filter-mapping>

<filter-name> XcelsiusQaawsAccelerator </filter-name>

<url-pattern>/qaawsservices/*</url-pattern>

</filter-mapping>

10

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Installation de Query as a Web Service Designer

4. Redémarrez le serveur d'applications. Les deux nouveaux serveurs Dashboards sont prêts à traiter toute requête Query as a Web Service Designer.

SAP BusinessObjects Query as a Web Service Designer

Installation de Query as a Web Service Designer

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

11

3 Lancement de Query as a Web Service

Designer

3.1 Conditions préalables à l'exécution de Query as a Web

Service Designer

Avant de démarrer Query as a Web Service Designer, vérifiez que les conditions préalables suivantes sont remplies :

Table 3 :

Conditions préalables à l'exécution utilisateur connecté comme administrateur ou défini comme

Concepteur dans le groupe QaaWS.

Description

L'appartenance à un groupe peut être définie dans la CMS. S'il est nécessaire de vous ajouter à ce groupe d'utilisateurs, con­ sultez votre administrateur.

3.2 Procédure de lancement de Query as a Web Service

Designer

Query as a Web Service Designer est utilisé avec un système de gestion centralisée (CMS). Le CMS contient le composant serveur qui héberge le catalogue Query as a Web Service Designer et les services Web publiés.

Vous devez définir le serveur hôte lorsque vous lancez Query as a Web Service Designer pour la première fois.

Par la suite, à chaque nouvelle exécution de Query as a Web Service Designer, vous devrez sélectionner un serveur hôte disponible avant de vous connecter au CMS.

Lorsque vous êtes connecté, la page d'accueil du catalogue de requêtes de Query as a Web Service Designer s'ouvre. Cette page permet de démarrer l'assistant de création et de publication de requêtes, afin de publier une nouvelle requête ou de modifier une requête existante.

Informations associées

Démarrage de Query as a Web Service Designer pour la première fois [page 13]

Lancement de Query as a Web Service Designer [page 13]

Connexion avec différentes références de connexion [page 15]

12

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Lancement de Query as a Web Service Designer

3.2.1 Démarrage de Query as a Web Service Designer pour la première fois

Lorsque vous démarrez Query as a Web Service Designer pour la première fois, vous devez définir le serveur hôte sur le CMS sur lequel sont installés les services Web. Une fois que vous avez défini un serveur hôte, cet hôte est automatiquement disponible au prochain démarrage de l'application. Il est possible de définir plusieurs serveurs hôte, mais vous ne pouvez vous connecter qu'à un seul serveur à la fois.

1. Dans le menu Démarrer de Windows, pointez votre curseur sur

Programmes Plateforme SAP

BusinessObjects de BI Outils client de la plateforme SAP BusinessObjects de BI Query As A Web Service

Designer

.

La boîte de dialogue

Gérer les hôtes

s'affiche. Elle affiche la liste des serveurs hôte disponibles et permet d'ajouter ou de modifier des serveurs existants. Cette liste est vide lorsque vous démarrez Query as a Web

Service Designer pour la première fois. Avant de pouvoir créer une requête, vous devez définir un serveur hôte.

2. Cliquez sur

Ajouter

.

La boîte de dialogue

Modifier un hôte

s'affiche. Elle contient les paramètres à définir pour créer un nouveau serveur hôte. Vous trouverez une description de chaque paramètre dans la section afférente des Rubriques apparentées.

3. Saisissez les informations nécessaires dans la boîte de dialogue

Modifier un hôte

.

La boîte de dialogue

Gérer les hôtes

s'affiche. Elle affiche la liste des serveurs hôte disponibles et permet d'ajouter ou de modifier des serveurs existants. Cette liste est vide lorsque vous démarrez Query as a Web

Service Designer pour la première fois. Avant de pouvoir créer une requête, vous devez définir un serveur hôte.

4. Cliquez sur OK.

La boîte de dialogue

Gérer les hôtes

s'affiche. Le nouvel hôte apparaît dans la liste.

5. Sélectionnez le nouvel hôte et cliquez sur

Fermer

.

La boîte de dialogue

Sélectionnez vos références de connexion

s'affiche. Les informations du nouvel hôte sont disponibles.

6. Saisissez votre mot de passe et cliquez sur

OK

.

La page d'accueil du client Query as a Web ServiceDesigner s'ouvre.

3.2.2 Lancement de Query as a Web Service Designer

Remarque

Ces informations s'appliquent à une version antérieure de Query as a Web Service Designer et de

BusinessObjects Enterprise. Pour obtenir des informations actualisées, consultez la dernière version du guide de l'utilisateur Query as a Web Service sur le SAP Help portal : http://help.sap.com

.

Avant de démarrer Query as a Web Service Designer, assurez-vous que vous répondez aux conditions préalables suivantes. Pour en savoir plus, reportez-vous à Rubriques associées.

● Votre nom d'utilisateur doit figurer dans le groupe d'utilisateurs

Concepteur QaaWS

, faute de quoi vous devez vous connecter comme administrateur.

SAP BusinessObjects Query as a Web Service Designer

Lancement de Query as a Web Service Designer

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

13

● Vous avez défini un serveur hôte pour héberger Query as a Web Service. Cette opération s'effectue lorsque vous démarrez Query as a Web Service Designer pour la première fois ou, par la suite, en ajoutant un hôte dans la boîte de dialogue

Modifier un hôte

.

Pour exécuter Query as a Web Service Designer, vous devrez sélectionner un serveur hôte et saisir les informations de connexion dans la zone de connexion. Vous devez renseigner les champs de connexion suivants :

Table 4 :

Informations de connexion

Hôte

Système

Utilisateur

Mot de passe

Authentification

Description

Le serveur CMS qui héberge Query as a Web Service. Avant de pouvoir créer une re­ quête, vous devez définir un serveur hôte.

Le CMS (Central Management Server) qui héberge le serveur hôte.

Un nom d'utilisateur. Ce nom doit figurer dans le groupe d'utilisateurs

Concepteur

QaaWS

, faute de quoi vous devez vous connecter comme administrateur.

Un mot de passe utilisateur Il vous est normalement attribué par votre administra­ teur.

Le type de service d'authentification requis pour accéder au CMS. Cette information vous est fournie par votre administrateur. Les protocoles disponibles sont les sui­ vants :

● Enterprise

● LDAP

● Windows AD

Autoriser l'ouverture de session unique d'Active Directory

Indiquez si l'ouverture de session unique doit être prise en charge par le protocole d'authentification. Cette option est uniquement disponible pour Active Directory.

Paramètres régionaux de l'interface Langue utilisée pour l'interface utilisateur. Sélectionnez une langue dans la liste dé­ roulante. Cette liste contient les langues installées prises en charge par la plateforme

SAP Business Objects de BI.

1. Dans le menu Démarrer de Windows, pointez votre curseur sur

Programmes Plateforme SAP

BusinessObjects de BI Outils client de la plateforme SAP BusinessObjects de BI Query As A Web Service

Designer

La boîte de dialogue de connexion s'affiche.

2. Sélectionnez le nom d'un serveur hôte dans la liste déroulante.

3. Saisissez le système, le nom d'utilisateur et le mot de passe appropriés.

4. Cliquez sur

Options

.

La boîte de dialogue de connexion affiche les options d'authentification, d'ouverture de session unique et de paramètres régionaux de l'interface.

5. Indiquez les informations de connexion

6. Cliquez sur OK.

La page du catalogue de requêtes s'affiche. Cette page permet de créer, publier et gérer des requêtes Query as a Web Service.

14

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Lancement de Query as a Web Service Designer

3.2.3 Connexion avec différentes références de connexion

Il est possible de se connecter à Query as a Web Service avec d'autres références de connexion sans pour autant quitter l'application.

Sélectionnez

Outils Se connecter en tant que

La boîte de dialogue de connexion s'affiche. Saisissez les nouvelles informations utilisateur, puis cliquez sur OK.

3.3 Mode de gestion des hôtes Query as a Web Service

Designer dans le CMS

Un hôte Query as a Web Service Designer désigne le composant serveur dans le CMS qui enregistre le catalogue

Query as a Web Service Designer et les services Web publiés. Vous créez un hôte lorsque vous lancez Query as a

Web Service Designer pour la première fois.

Vous ajoutez un hôte au CMS et configurez les paramètres de connexion pour les hôtes existants depuis la boîte de dialogue

Gérer les hôtes

.

Cette boîte de dialogue est accessible à partir du menu

Outils

, ainsi qu'à partir de la boîte de dialogue de connexion lorsque vous vous connectez à Query as a Web Service .

La boîte de dialogue

Gérer les hôtes

affiche la liste des serveurs hôte. Vous pouvez choisir les options d'administration des hôtes suivantes :

Table 5 :

Option de gestion d'un hôte

Ajouter

Modifier

Supprimer

Effacer

Description

Cliquez pour définir un nouvel hôte

Sélectionnez le nom d'un hôte dans la liste, puis cliquez pour modifier la définition de cet hôte.

Sélectionnez le nom d'un hôte dans la liste, puis cliquez pour supprimer cet hôte de la liste.

Cliquez pour supprimer tous les hôtes de la liste.

Informations associées

Ajout d'un nouvel hôte [page 15]

Modification d'un hôte [page 16]

3.3.1 Ajout d'un nouvel hôte

L'ajout d'un nouvel hôte s'effectue dans la boîte de dialogue

Gérer les hôtes

.

SAP BusinessObjects Query as a Web Service Designer

Lancement de Query as a Web Service Designer

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

15

1. Sélectionnez

Outils Gérer les hôtes

.

La boîte de dialogue

Gérer les hôtes

s'affiche.

Remarque

Cette boîte de dialogue est également accessible à partir de la boîte de dialogue de connexion lorsque vous vous connectez à Query as a Web Service.

2. Cliquez sur le bouton

Ajouter

.

La boîte de dialogue

Modifier un hôte

s'affiche.

3. Saisissez les informations de paramétrage de l'hôte et cliquez sur

OK

.

L'hôte est ajouté à la liste de la boîte de dialogue

Gérer les hôtes

.

4. Cliquez sur

Fermer

.

3.3.2 Modification d'un hôte

Pour modifier la définition d'un hôte, utilisez la boîte de dialogue

Modifier un hôte

. Vous pouvez modifier les paramètres d'hôte suivants :

Table 6 :

Modifier les paramètres d'un hôte

Nom

URL

Description

Nom du serveur hôte. Ce nom apparaît dans le champ

Hôte

de la boîte de dialogue de connexion.

Adresse URL du serveur hôte. Une URL par défaut est automatiquement attribuée à l'hôte. Celle-ci peut être modifiée au besoin. Il est conseillé de vérifier que le port indiqué à la fin de l'URL est correct.

CMS

Nom du CMS (Central Management Server) qui héberge l'hôte. Ce nom apparaît dans le champ

Système

de la boîte de dialogue de connexion.

●

Utilisateur

●

Authentification

●

Autoriser l'ouverture de session unique d'Active

Directory

Ces paramètres sont décrits dans la section Rubriques associées.

1. Sélectionnez

Outils Gérer les hôtes

.

La boîte de dialogue

Gérer les hôtes

s'affiche.

Remarque

Cette boîte de dialogue est également accessible à partir de la boîte de dialogue de connexion lorsque vous vous connectez à Query as a Web Service.

2. Cliquez sur un hôte dans la liste.

3. Cliquez sur le bouton

Modifier

.

La boîte de dialogue

Modifier un hôte

s'affiche. Cette page contient les paramètres de l'hôte pouvant être modifiés.

4. Saisissez ou modifiez une ou plusieurs valeurs.

16

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Lancement de Query as a Web Service Designer

5. Cliquez sur

OK

, puis sur

Fermer

.

La boîte de dialogue de connexion s'affiche. Les modifications de l'hôte prennent effet immédiatement.

SAP BusinessObjects Query as a Web Service Designer

Lancement de Query as a Web Service Designer

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

17

4 Création d'une requête à publier comme service Web

4.1 Créer et publier une requête Query as a Web Service

Deux méthodes permettent de créer et publier une requête Query as a Web Service :

● Utiliser l'

Assistant de publication de Query as a Web Service

pour définir entièrement une requête.

● Dupliquer une requête existante pour l'utiliser comme modèle, en modifiant sa définition pour créer une nouvelle requête.

Informations associées

Comment créer une nouvelle requête à l'aide de l'Assistant de publication de Query as a Web Service [page 18]

Création d'une nouvelle requête à partir d'une requête publiée [page 24]

4.2 Comment créer une nouvelle requête à l'aide de l'Assistant de publication de Query as a Web Service

L'

Assistant de publication de Query as a Web Service

permet de définir une nouvelle requête à publier comme service Web.

Si vous préférez utiliser une requête existante comme modèle, consultez la section expliquant comment dupliquer une requête publiée dans les Rubriques apparentées.

Pour créer et publier une requête, procédez comme suit. Reportez-vous aux rubriques et au bas de la page pour accéder directement à la page d'aide correspondant à chaque étape de l'assistant. Chaque page d'aide décrit en détail les propriétés que vous définissez dans la page en cours de l'assistant.

Table 7 :Processus de création et publication d'une requête avec l'Assistant

Processus de création et publication d'une requête Description

Exécutez l'

Assistant de publication de Query as a Web Service

L'assistant peut être lancé à partir de la page du catalogue de requêtes. Cette page apparaît lorsque vous vous connectez à un hôte.

Tapez le nom et la description de la nouvelle requête.

Définissez les propriétés avancées.

Saisissez le nom et les commentaires de la requête.

Vous pouvez définir les paramètres d'utilisation d'un proxy in­ verse, des contraintes d'expiration de la session et du type d'authentification.

18

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

Processus de création et publication d'une requête

Choisissez un univers comme source de données pour la re­ quête.

Créez la requête dans l'Editeur de requête.

Vérifiez et publiez la requête sous forme de service Web.

Description

Cet univers doit être celui qui contient les objets utilisés par la requête. L'univers est la source de données de la requête.

Dans l'Editeur de requête, créez la requête en combinant les dimensions et les indicateurs, puis en définissant des condi­ tions.

Vérifiez le code SQL de la requête, puis publiez celle-ci comme service Web sur le serveur hôte.

Informations associées

Pour exécuter l'Assistant de publication de Query as a Web Service [page 19]

Pour définir les propriétés de nom et de description de la requête [page 19]

Pour sélectionner un univers pour une requête [page 21]

Pour définir une requête [page 21]

Pour afficher et publier une requête [page 24]

4.2.1 Pour exécuter l'Assistant de publication de Query as a

Web Service

L'

Assistant de publication de Query as a Web Service

permet de créer et publier une nouvelle requête. L'assistant peut être lancé à partir de la page du catalogue des requêtes. Chacune des pages successives de l'assistant comporte sa propre page d'aide.

1. Démarrez Query as a Web Service

La page du catalogue de requêtes s'affiche. Elle affiche la liste des requêtes publiées sur le serveur hôte sous forme de services Web.

2. Choisissez

Requête Nouveau Requête

.

L'

Assistant de publication de Query as a Web Service

ouvre la page

Description

. Cette page permet de saisir le nom, la description et les paramètres avancés de la requête.

4.2.2 Pour définir les propriétés de nom et de description de la requête

La page

Description

de l'

Assistant de publication de Query as a Web Service

permet de spécifier le nom et la description de la nouvelle requête à publier comme service Web.

1. Saisissez le nom et la description de la requête.

2. Effectuez l'une des actions suivantes :

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

19

○ Si vous souhaitez définir des paramètres d'utilisation d'un proxy inverse, des contraintes d'expiration de la session ou un type d'authentification, cliquez sur le bouton

Paramètres avancés

.

○ Si vous ne voulez pas définir de paramètres avancés, cliquez sur

Suivant

.

Suivant l'option choisie, la boîte de dialogue des paramètres avancés ou la page suivante de l'assistant,

Sélectionner un univers

, apparaît.

4.2.2.1 Pour définir les paramètres avancés du service Web

La boîte de dialogue

Paramètres avancés

permet de définir les paramètres suivants :

● Utilisation d'un proxy inverse à l'aide d'une URL de base de service Web

● Contraintes d'expiration de la session

● Mode d'authentification utilisé pour se connecter au service Web. Ce paramètre s'applique uniquement au service Web lorsqu'il est utilisé.

Chacune de ces options est décrite dans les rubriques répertoriées à la fin de la section.

1. Cliquez sur le bouton

Avancé

dans la page

Description

de l'

Assistant de publication de Query as a Web Service

.

La boîte de dialogue

Paramètres avancés

s'affiche.

2. Effectuez l'une des actions suivantes :

○ Saisissez ou modifiez l'URL de base de service Web

○ Pour la contrainte d'expiration de la session, saisissez une nouvelle valeur ou utilisez les touches fléchées vers le haut et le bas.

○ Sélectionnez un mode d'authentification dans la liste déroulante.

3. Cliquez sur

OK

.

La page Description s'affiche. Elle vous permet de poursuivre la définition de la requête.

4.2.2.1.1 URL de base du service Web

Un proxy inverse est une traduction de l'adresse réseau d'un ordinateur d'une URL de réseau donné en une URL d'un autre réseau (en général un réseau externe tel qu'Internet).

Un serveur appelé monserveur.entreprise.com au sein d'un réseau d'entreprise peut s'appeler www.monentreprise.com sur un réseau externe.

Pour prendre en charge ce type de déploiement, vous devez définir une URL de base de service Web. L'URL de base contient l'URL externe qui doit donner accès au service Web. Par exemple www.monentreprise.com/ dswsbobje/.

4.2.2.1.2 Expiration de la session

Pour améliorer les performances de Query as a Web Service, notamment le scénario d'appel en cascade, la connexion de l'utilisateur au serveur est mise en cache par le fournisseur de services Web. Vous pouvez

20

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

configurer le délai d'expiration de la session (en secondes) pour chaque connexion Query as a Web Service. La valeur par défaut est 60 secondes.

Par exemple, si un utilisateur donné appelle service 1 puis service 2 dans les 60 secondes qui suivent, avec les mêmes identifiants de connexion (nom d'utilisateur et mot de passe), le serveur réutilise la même connexion et réinitialise le délai d'expiration de la session.

4.2.2.1.3 Mode d'authentification

Le mode d'authentification correspond au type de répertoire utilisé par la plateforme Business Objects XI pour valider la connexion.

Par exemple : Enterprise, LDAP, Windows AD et SAP.

Vous pouvez paramétrer le mode d'authentification pour qu'il soit défini en fonction du service ou par l'utilisateur :

● Service

En tant qu'administrateur, vous sélectionnez le répertoire d'authentification. Tous les utilisateurs qui accèdent ensuite au service s'authentifient dans ce répertoire (sauf dans le cas de l'option ID de session).

Tous les répertoires d'authentification pris en charge par le serveur peuvent être sélectionnés dans la liste déroulante Mode d'authentification.

● Défini par l'utilisateur

L'utilisateur de la requête sélectionne le mode d'authentification en tant que paramètre d'entrée appelé authenticationType.

4.2.3 Pour sélectionner un univers pour une requête

La page

Sélectionnez un univers

de l'

Assistant de publication de Query as a Web Service

affiche les univers disponibles dans le CMS. Choisissez l'univers à utiliser comme source de données pour la requête.

1. Cliquez sur un univers dans la liste.

La description de l'univers sélectionné s'affiche dans la zone de description.

2. Cliquez sur

Suivant

.

La page

Requête

de l'assistant s'affiche.

4.2.4 Pour définir une requête

La page

Requête

de l'

Assistant de publication de Query as a Web Service

permet d'utiliser l'éditeur de requêtes pour définir une requête basée sur un univers. L'éditeur de requêtes est basé sur l'

l'Editeur de rapport HTML de

Web Intelligence

. L'éditeur de requêtes est brièvement décrit dans cette section, avec des instructions pour créer une requête. Il est toutefois intégralement documenté dans le guide Création de requêtes à l'aide de l'Editeur de rapport HTML Web Intelligence. Pour plus d'informations, il est conseillé de se reporter à ce guide, qui fait partie de la documentation de cette version.

L'éditeur de requêtes contient les zones suivantes :

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

21

Table 8 :

Zone de l'éditeur de requête

Volet Univers

Volet Objets du résultat

Volet Objets du filtre

Description

Le volet de la partie gauche contient les classes, les dimensions et les indica­ teurs de l'univers, organisés en arborescence. Ces objets correspondent à des structures SQL dans la base de données. Ils sont utilisés pour construire la requête.

Glissez les objets nécessaires à votre requête dans ce volet. Il est possible d'appliquer un tri aux données de chaque objet en cliquant avec le bouton droit sur celui-ci et en choisissant le type de tri.

Glissez dans ce volet des objets définissant un filtre à appliquer aux données renvoyées par la requête. Vous pouvez sélectionner des opérateurs dans une liste, appliquer un filtre sur la base d'une constante ou d'une liste de valeurs, ou définir une invite pour attendre une saisie par l'utilisateur

1. Dans le volet

Univers

, effectuez l'une des opérations suivantes :

○ Cliquez deux fois sur des objets de la requête.

○ Sélectionnez des objets et faites-les glisser dans le volet

Objets du résultat

.

Les objets de la requête s'affichent dans le volet

Objets du résultat

. Vous pouvez modifier la position d'un objet au sein de la requête en cliquant dessus et en le faisant glisser à l'emplacement de votre choix. Pour supprimer un objet de la requête, sélectionnez-le et faites-le glisser à nouveau dans le volet

Univers

.

2. Pour créer un filtre, cliquez deux fois sur un objet filtre ou faites-le glisser dans le volet

Objets du filtre

.

L'objet est automatiquement associé à une liste déroulante pour les opérateurs, à une zone de texte pour une constante et à une liste déroulante pour une liste de valeurs ou une invite.

3. Sélectionnez un opérateur et le filtre requis dans les listes déroulantes. Tous les filtres disponibles sont décrits dans les Rubriques apparentées.

4. Cliquez sur

OK

.

La page

Aperçu

de l'assistant s'affiche.

4.2.4.1 Pour définir les contraintes d'une requête

Il est possible de définir des contraintes pour optimiser les performances de la requête. Vous pouvez définir les contraintes suivantes :

Table 9 :

Contrainte

Avec doublons de lignes

Durée maximale d'extraction

Durée maximale Lignes extraites

Description

Cette contrainte permet de renvoyer des doublons. Par défaut, la re­ quête ne renvoie pas les doublons.

Durée maximale de l'extraction des données. La valeur par défaut

"-1" signifie que cette option est désactivée et que la valeur définie dans les paramètres de la connexion à l'univers sera utilisée.

Nombre maximal de lignes à extraire lors de l'exécution de la re­ quête. La valeur par défaut "-1" signifie que cette option est désacti­ vée et que la valeur définie dans les paramètres de la connexion à l'univers sera utilisée.

22

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

Contrainte

Exemple d'ensemble de résultats

Description

Nombre de lignes à renvoyer pour un exemple d'ensemble de résul­ tats avant d'exécuter la requête.

1. Dans l'éditeur de requêtes, cliquez sur l'icône Options, dans le coin supérieur gauche de la page.

Une boîte de dialogue s'affiche et présente les options de contrainte.

2. Définissez les valeurs de contrainte selon vos besoins.

3. Cliquez sur

OK

.

4.2.4.2 Pour définir l'ordre de tri de la requête

Vous pouvez définir un ordre de tri pour chaque objet de l'univers. Il est aussi possible de définir une priorité de tri pour un objet.

1. Dans l'éditeur de requêtes, cliquez sur l'icône

Gérer les tris

, au-dessus du volet

Univers

Une boîte de dialogue s'affiche et présente les options de tri.

2. Développez les dossiers du volet

Objets disponibles

et sélectionnez un objet.

3. Cliquez deux fois sur l'objet, ou cliquez sur la flèche pour placer l'objet dans le volet

Tris sur la requête

.

4. Sélectionnez l'objet dans le volet

Tris sur la requête

et cliquez sur

Croissant

ou

Décroissant

.

5. Si nécessaire, sélectionnez un objet puis cliquez sur le bouton

Monter

ou

ou Descendre

.

6. Cliquez sur

OK

.

4.2.4.3 Pour définir des listes de valeurs

Pour définir une liste de valeurs, sélectionnez l'objet dans la page Requête, puis définissez la liste des valeurs dans une page de liste de valeurs.

1. Dans la page Requête, faites glisser un objet vers le volet Objets du filtre.

Une zone de texte apparaît, accompagnée de deux filtres de listes déroulantes.

2. Sélectionnez Dans liste dans la liste déroulante placée à gauche de la zone de texte, puis Liste de valeurs dans la liste déroulante placée à droite de cette zone.

La boîte de dialogue Listes de valeurs s'affiche.

3. Cliquez deux fois sur chaque valeur de la liste Dans liste que vous souhaitez voir apparaître dans la liste de valeurs. La valeur s'affiche alors dans le volet Valeurs sélectionnées.

4. Cliquez sur OK.

Les valeurs apparaissent dans la zone de texte.

4.2.4.4 Pour définir une invite

Pour définir une invite, sélectionnez l'objet dans la page Requête, puis ouvrez une page d'invites.

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

23

1. Dans la page Requête, faites glisser un objet Invite vers le volet Objets du filtre.

Une zone de texte apparaît, accompagnée de deux filtres de listes déroulantes.

2. Sélectionnez I'invite dans la liste déroulante située à droite de la zone de texte.

L'icône d'une invite apparaît.

3. Cliquez sur l'icône Invite.

La boîte de dialogue Définir une invite apparaît. Saisissez le texte de l'invite, puis sélectionnez les options qui s'appliquent à cette invite.

4. Cliquez sur OK.

4.2.5 Pour afficher et publier une requête

La page

Aperçu

de l'

Assistant de publication de Query as a Web Service

permet de voir les objets de la requête et le résultat de celle-ci. Lorsque le résultat de la requête vous convient, vous pouvez publier celle-ci comme service

Web sur le serveur hôte.

1. Vérifiez que l'univers, les objets et le résultat de la requête sont corrects.

2. Cliquez sur

Publier

.

La requête est publiée sur le serveur hôte sous forme de service Web. Elle apparaît alors dans la page du catalogue de requêtes.

4.3 Création d'une nouvelle requête à partir d'une requête publiée

Il est possible de créer une nouvelle requête en dupliquant une requête existante, afin de l'utiliser comme modèle.

Une fois dupliquée la requête originale, l'

Assistant de publication de Query as a Web Service

s'exécute automatiquement pour vous permettre de modifier la définition de la même manière que lors de la création d'une nouvelle requête à l'aide de l'assistant.

Vous devez disposer des autorisations appropriées pour copier une requête dans un dossier et ajouter une nouvelle requête à un autre dossier.

Informations associées

Pour dupliquer une requête publiée existante [page 24]

4.3.1 Pour dupliquer une requête publiée existante

Pour dupliquer une requête afin de l'utiliser comme modèle d'une nouvelle requête, procédez comme suit :

24

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

1. Effectuez l'une des actions suivantes :

○ Sélectionnez une requête dans la page du catalogue des requêtes, puis choisissez

Requête

Dupliquer

.

○ Cliquez avec le bouton droit sur une requête dans la page du catalogue des requêtes, puis choisissez

Dupliquer

dans le menu contextuel qui apparaît alors.

L'

Assistant de publication de Query as a Web Service

se lance.

2. Suivez les étapes de l'assistant pour renommer et modifier la définition de la requête.

SAP BusinessObjects Query as a Web Service Designer

Création d'une requête à publier comme service Web

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

25

5 Gestion des requêtes Query as a Web

Service

5.1 Gestion des requêtes à partir de la page Catalogue de requêtes

La page du catalogue des requêtes apparaît au démarrage de Query as a Web Service Designer. Elle affiche la liste des requêtes publiées sur le serveur hôte, ainsi que les univers utilisés par ces requêtes. Pour chaque requête sélectionnée dans la liste, le nom, le nom de l'univers, la description et l'adresse URL de la description WSDL de cette requête sont affichés dans le volet des informations à droite.

Dans la page du catalogue des requêtes, vous pouvez créer et publier des requêtes, ainsi que gérer les requêtes déjà publiées sur le serveur hôte.

Vous pouvez effectuer les actions suivantes à partir de cette page :

Table 10 :

Menu

Requête

Edit

Outils

Actions disponibles

● Créer une requête, ou créer des dossiers dans la liste du catalogue afin d'enregistrer et organi­ ser les requêtes.

● Modifier la définition d'une requête.

● Dupliquer une requête existante pour l'utiliser comme modèle d'une nouvelle requête.

● Supprimer, renommer et actualiser des requêtes dans la liste.

● Déployer une requête sur un autre serveur hôte.

Les actions d'édition standard de Windows (Couper, Copier et Coller) sont disponibles.

● Accéder à la boîte de dialogue

Gérer les hôtes

afin d'ajouter, modifier ou supprimer des ser­ veurs hôte.

● Vous déconnecter, puis ouvrir une nouvelle connexion sous un autre nom d'utilisateur ou sur un autre hôte, sans quitter l'application.

● Accéder à la boîte de dialogue des paramètres avancés pour définir des adresses URL sur le

Web, les délais de déconnexion de session et le mode d'authentification de chaque requête.

5.2 Pour créer des dossiers dans le catalogue de requêtes.

Pour organiser les requêtes de la liste, il est possible de créer des dossiers dans le catalogue de requêtes.

Dans la page du catalogue de requêtes, suivez l'une de ces procédures :

○ Cliquez sur le dossier racine et choisissez

Requête Nouveau dossier

.

○ Cliquez avec le bouton droit sur le dossier racine et choisissez

Nouveau dossier

dans le menu contextuel.

Un nouveau dossier est ajouté dans la liste. Chaque dossier de la liste peut à son tour contenir des dossiers.

26

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

5.3 Modification d'une requête Query as a Web Service

Il est possible à tout moment de modifier la définition d'une requête qui a été publiée comme service Web. Si vous modifiez une requête Query as a Web Service, il est possible que le WSDL associé soit modifié et que le lien utilisé par d'autres utilisateurs pour communiquer avec les services Web soit rompu.

Business Objects

™

conseille d'informer les utilisateurs des modifications effectuées.

1. Dans le catalogue de requêtes, sélectionnez la requête à modifier.

2. Effectuez l'une des actions suivantes :

○ Choisissez

Requête Edition

.

○ Cliquez deux fois sur une requête.

○ Faites un clic droit sur une requête et choisissez

Modifier

dans le menu contextuel

L'

Assistant de publication de Query as a Web Service

se lance.

3. Suivez les étapes de l'assistant pour modifier la requête, puis publiez celle-ci à nouveau.

5.4 Pour renommer une requête

Vous pouvez renommer une requête dans le catalogue de requêtes. Le nouveau nom est appliqué immédiatement. Il n'est pas nécessaire de publier à nouveau la requête pour que le nouveau nom soit appliqué. En effet, le service Web est identifié dans le CMS par un identifiant (CUID) unique et non plus par le nom de la requête comme dans les versions antérieures.

1. Dans la page du catalogue de requêtes, suivez l'une de ces procédures :

○ Cliquez deux fois sur une requête dans la liste.

○ Sélectionnez une requête dans la liste, puis choisissez

Requête Renommer.

La requête est mise en surbrillance.

2. Saisissez un nouveau nom.

Le nouveau nom est appliqué immédiatement.

5.5 Suppression d'une requête Query as a Web Service

Vous pouvez supprimer une requête à partir de la liste du catalogue des requêtes.

Effectuez l'une des actions suivantes :

○ Sélectionnez une requête dans la liste du catalogue des requêtes, puis choisissez

Edition Supprimer

.

○ Cliquez avec le bouton droit sur une requête dans la liste du catalogue des requêtes, puis choisissez

Supprimer

dans le menu contextuel qui apparaît alors.

La requête est supprimée sur l'hôte.

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

27

5.6 Pour copier et coller une requête Query as a Web Service

Dans le catalogue des requêtes, il est possible de copier une requête et de la coller dans un autre dossier. Vérifiez que vous disposez des droits nécessaires pour copier la requête dans un autre emplacement.

1. Effectuez l'une des actions suivantes :

○ Sélectionnez une requête dans la liste du catalogue des requêtes, puis choisissez

Edition Copier

.

○ Cliquez avec le bouton droit sur une requête dans la liste du catalogue des requêtes, puis choisissez

Copier

dans le menu contextuel qui apparaît alors.

2. Cliquez à l'emplacement où vous souhaitez coller la copie de la requête, puis choisissez

Edition Coller

ou cliquez avec le bouton droit et choisissez

Coller

dans le menu contextuel qui apparaît alors.

La requête copiée apparaît dans la liste du catalogue des requêtes.

5.7 Pour afficher les propriétés d'une requête

Vous pouvez afficher les propriétés d'une requête à partir de la page du catalogue des requêtes.

1. Dans le catalogue des requêtes, sélectionnez une requête dans la liste. Si nécessaire, ouvrez des dossiers pour atteindre la requête voulue.

Les propriétés s'affichent sur le côté droit de la liste des requêtes.

2. Cliquez sur l'URL.

Le lien pointant vers la description de la requête est affiché dans une définition WSDL qui apparaît dans une page du navigateur Web.

3. Cliquez sur le lien WSDL dans la page Web pour voir le WSDL.

5.8 Pour voir les instances de requêtes sous forme de services Web disponibles :

Vous pouvez afficher les instances de Query as a Web Service Designer disponibles dans un navigateur Web.

Ouvrez votre navigateur Web et accédez à l'URL suivante : http://<nom du serveur>:<numéro de port Tomcat>/dswsbobje/qaawsservices

28

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

5.9 Déploiement de requêtes vers un autre serveur Web

Cette section explique comment déployer des requêtes sur un autre serveur. Pour ce faire, il suffit de copier la définition d'une requête Query as a Web Service d'un serveur à l'autre. Par exemple, vous pouvez transférer une définition de requête d'un serveur de développement vers un serveur de production ou de test.

Pour procéder au déploiement vers un autre serveur, vous disposez des méthodes suivantes :

● Query as a Web Service Designer

Vous utilisez l'option

Déployer sur un autre serveur

. Cette méthode a cet avantage que la requête va automatiquement mettre à jour le cache WSDL pour la requête sur le nouveau serveur d'application. Si vous n'utilisez pas cette méthode, vous devez mettre à jour le cache WSDL manuellement.

● Assistant d'importation. Vous devez mettre à jour manuellement le cache WSDL pour la requête déployée.

● Fichier BIAR. Vous devez mettre à jour manuellement le cache WSDL pour la requête déployée.

Remarque

Avant toute chose, vérifiez que l'univers et les utilisateurs sont identiques sur les deux ordinateurs. Utilisez l'Assistant d'importation ou les fichiers BIAR pour importer des univers et des utilisateurs. Lors des opérations de l'Assistant d'importation, le CUID doit être le même.

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

29

Informations associées

Mise à jour du cache WSDL lors du déploiement de requêtes vers un autre serveur [page 32]

5.9.1 Modifications de mises à jour du fichier WSDL dans le déploiement de requête

Les mises à jour du fichier WSDL ont été modifiées dans cette version. Dans cette nouvelle version, le servlet stocke tous les fichiers WSDL dans un fichier .ZIP sur le serveur d'application. Auparavant, le servlet devait se connecter au CMS à chaque fois qu'une requête était publiée. Le WSDL pour la requête était mis à jour de façon dynamique. Dorénavant, les connexions au CMS ne sont plus nécessaires. Les fichiers WSDL sont ajoutés au fichier .ZIP dès qu'une nouvelle requête QaaWS est publiée ou mise à jour. Des paramètres d'exécution supplémentaires sont également stockés dans le cache WSDL, par exemple le mode d'authentification et les valeurs de paramètres régionaux et d'expiration utilisés pour la consommation du service Web.

Lorsque vous utilisez l'option

Déployer sur un autre serveur

pour déployer une requête vers un serveur d'application différent, le cache WSDL est mis à jour automatiquement. Si vous utilisiez l'Assistant d'importation ou le fichier BIAR pour déployer une requête sur un autre serveur d'application, vous devez mettre à jour manuellement le fichier WSDL .ZIP. Cette procédure est décrite dans la section Rubriques associées.

Informations associées

Mise à jour du cache WSDL lors du déploiement de requêtes vers un autre serveur [page 32]

5.9.2 Déploiement vers un autre serveur avec l'outil client

Query as a Web Service

Query as a Web Service Designer vous permet de déployer des requêtes sur un autre serveur une seule fois, en utilisant le même nom de service.

Vous pouvez utiliser l'option Déployer vers un autre serveur entre deux serveurs disposant de la même version de

Query as a Web Service Designer. Cette option ne permet pas de faire migrer des requêtes d'une version à une autre.

1. Dans le catalogue de requêtes, sélectionnez une requête Query as a Web Service.

2. Cliquez sur

Déployer vers un autre serveur

.

La boîte de dialogue Sélectionnez vos références de connexion s'affiche.

3. Saisissez les informations sur le système dans lequel vous souhaitez déployer les services Web, puis cliquez sur

OK

.

La requête Query as a Web Service s'affiche dans l'Assistant de publication de Query as a Web Service.

30

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

4. Publiez la requête Query as a Web Service dans le nouveau système.

Déployer une définition Query as a Web Service vers un autre serveur modifie automatiquement l'emplacement

WSDL et l'emplacement d'exécution des services.

Remarque

Vous pouvez personnaliser cette URL de service avec l'Assistant. Vous pouvez également la rendre dynamique dans un projet Xcelsius en utilisant la zone de texte Valeurs d'entrée de la connectivité des services Web. Grâce

à cette fonctionnalité, vous pouvez faire passer un tableau de bord du développement à la production en modifiant simplement l'URL.

Vous ne pouvez pas déployer le même nom de service de requête plusieurs fois sur le même serveur.

5.9.3 Déploiement de Query as a Web Service à l'aide de l'Assistant d'importation

Pour effectuer un déploiement avec l'Assistant d'importation, vous devez importer la définition Query as a Web

Service du serveur source vers le serveur de destination.

1. Lancez l'Assistant d'importation sur le serveur source.

2. Une fois connecté au CMS source, sélectionnez le fichier cible vers lequel vous voulez exporter les définitions.

3. Dans le volet

Sélectionnez des objets à importer

de la boîte de dialogue Assistant d'importation, sélectionnez

Importer les dossiers et les objets

, puis

Importer les dossiers et objets d'application

.

4. Dans le volet Sélectionner les dossiers et objets d'application de la boîte de dialogue Assistant d'importation, développez le

dossier QaaWS

, puis les définitions Query as a Web Service ou les noms de service de votre choix.

5. Effectuez les opérations restantes de l'Assistant d'importation en cliquant sur

Suivant

.

6. Ouvrez l'Assistant d'importation sur le serveur de destination.

7. Dans la boîte de dialogue Environnement source, sélectionnez le fichier source vers lequel vous avez exporté les définitions.

8. Connectez-vous au CMS de destination.

9. Dans le volet

Sélectionnez des objets à importer

de la boîte de dialogue

Assistant d'importation

, sélectionnez

Importer les dossiers et les objets

, puis

Importer les dossiers et objets d'application

.

10. Dans le volet

Sélectionner les dossiers et objets d'application

de la boîte de dialogue

Assistant d'importation

, sélectionnez les définitions Query as a Web Service qui vous intéressent.

11. Effectuez les opérations restantes de l'Assistant d'importation en cliquant sur

Suivant

.

12. Après l'importation, faites pointer la définition de requête que vous venez de déployer vers le serveur Web du système de destination.

5.9.4 Déploiement de Query as a Web Service à partir d'un fichier BIAR

Assurez-vous que l'Assistant d'importation est installé sur les serveurs source et cible.

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

31

1. Ouvrez l'Assistant d'importation

™

sur le serveur source.

2. Une fois connecté au CMS source, sélectionnez le fichier BIAR cible vers lequel vous allez exporter les définitions.

3. Dans le volet

Sélectionnez des objets à importer

de la boîte de dialogue Assistant d'importation, sélectionnez

Importer les dossiers et les objets

, puis

Importer les dossiers et objets d'application

.

4. Dans le volet

Sélectionner les dossiers et objets d'application

de la boîte de dialogue Assistant d'importation, développez le

dossier QaaWS

, puis les définitions Query as a Web Service ou les noms de service de votre choix.

5. Effectuez les autres opérations de l'Assistant d'importation.

6. Ouvrez l'Assistant d'importation sur le serveur de destination.

7. Dans la boîte de dialogue Environnement source, sélectionnez le fichier BIAR vers lequel vous avez exporté les définitions.

8. Connectez-vous au CMS ™ de destination.

9. Dans la boîte de dialogue Sélectionner les objets à importer, sélectionnez

Importer les dossiers et les objets

>

Importer les dossiers et objets d'application

.

10. Dans la boîte de dialogue Sélectionnez les dossiers et objets d'application, sélectionnez les définitions Query as a Web Service de votre choix.

11. Effectuez les autres opérations de l'Assistant d'importation.

12. Après l'importation, faites pointer la définition de requête que vous venez de déployer vers le serveur Web du système de destination.

5.9.5 Mise à jour du cache WSDL lors du déploiement de requêtes vers un autre serveur

Si vous n'utilisez pas l'option

Déployer sur un autre serveur

dans la Query as a Web Service pour déployer une requête vers un autre serveur, vous devez mettre à jour manuellement le cache WSDL afin de vous assurer que la requête est synchronisée avec le CMS. Pour ce faire, utilisez l'assistant d'importation, ou fichier BIAR pour déployer une requête sur un autre serveur.

Pour mettre à jour manuellement le WSDL lorsqu'une requête est déployée sur un autre serveur d'application, effectuez les opérations suivantes :

● Accédez à l'URL : http://<AppServerName>:<port>/dswsbobje/qaawsservices/wsdlGenerator

● Si nécessaire, saisissez les informations de connexion requises pour accéder au CMS.

Les fichiers WSDL sont automatiquement mis à jour.

32

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

5.10 Déploiement de Query as a Web Service sur plusieurs serveurs Web

5.10.1 Pour configurer le client Query as a Web Service pour la connexion à un serveur Web de proxys inverses

Un proxy inverse est une traduction de l'adresse réseau d'un ordinateur d'une URL de réseau donné en une URL d'un autre réseau externe. Comme le client Query as a Web Service est lié aux services Web Report Engine, Query et BICatalog, vous devez spécifier l'URL externe des services Web.

wsresource4=QueryService|query web service alone|http://

[monserveur.monentreprise.com]/dswsbobje/services/query

1. Recherchez le fichier dsws.properties.

Ce fichier est situé dans l'application Web dswsbobje.

2. Mettez à jour les propriétés suivantes :

Table 11 :

Nom de la propriété wsresource1 wsresource2 wsresource4

Valeur de la propriété

ReportEngine|reportengine web servicealone|http://

<[monserveur.monentreprise.com]> /dswsbobje/services/ reportengine

BICatalog|bicatalog web service alone|

<[monserveur.monentreprise.com]> dswsbobje/services/ bicatalog

QueryService|query web service alone|http://

<[monserveur.monentreprise.com]>

/dswsbobje/services/query

SAP BusinessObjects Query as a Web Service Designer

Gestion des requêtes Query as a Web Service

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

33

6 Utilisation de Query as a Web Service avec différentes applications

6.1 Utilisation d'une requête Query as a Web Service avec le

WSDL

WSDL est une description basée XML du mode de communication avec le service Web. Il décrit les liaisons de protocoles et les formats de messages requis pour interagir avec les services Web répertoriés dans son répertoire.

Les opérations et messages pris en charge sont décrits à un niveau supérieur, puis liés à un format de message et un protocole de réseau concret. Le WSDL est souvent associé au schéma XML et SOAP pour fournir des services Web sur Internet.

Lorsqu'un programme client se connecte à un service Web, il peut lire le WSDL pour connaître les fonctions disponibles sur le serveur.

Pour rechercher le WSDL d'une requête Query as a Web Service, sélectionnez-la dans le catalogue de requêtes.

6.2 Utilisation d'une requête Query as a Web Service dans

SAP BusinessObjects Dashboards

Pour utiliser une requête Query as a Web Service dans SAP BusinessObjects Dashboards, utilisez le connecteur de service Web.

Le composant du connecteur de service Web permet à un document Flash créé dans SAP BusinessObjects

Dashboards de communiquer avec Query as a Web Service Designer via SOAP, à l'aide de commandes pointer et cliquer. Le document Flash SAP BusinessObjects Dashboards est indépendant et communique avec le service Web pour afficher des données visuellement. Seule condition préalable : un service Web SOAP doit être disponible pour le document Flash.

Lorsqu'il est activé, le composant du connecteur de service Web crée un message SOAP (un document XML) et l'envoie au service Web. Le service Web répond par un message SOAP. Le connecteur de service Web envoie ensuite ces données à tous les autres composants, ce qui permet d'obtenir une représentation visuelle dynamique des données.

De nombreux services Web publics sont disponibles et il existe beaucoup de kits d'outils et de packs dédiés aux services Web SOAP. Pour utiliser un pack ou un service Web public déjà associé à un service Web, il suffit de disposer du document WSDL de ce service. Pour Query as a Web Service Designer, vous trouverez le WSDL dans les propriétés de chaque service Web, en le sélectionnant dans le catalogue de requêtes.

Pour en savoir plus, voir la documentation de SAP BusinessObjects Dashboards.

34

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Utilisation de Query as a Web Service avec différentes applications

6.2.1 Problème de domaines

Une fois le widget SAP BusinessObjects Dashboards téléchargé sur le Web, il se peut que vous rencontriez des difficultés pour extraire les données avec Query as a Web Service Designer si l'outil client et l'outil Flash proviennent de domaines Web différents.

Ce problème est dû au dispositif de sécurité de Macromedia Flash. L'outil Flash affiché dans le navigateur ne peut accéder à des données qui se trouvent à l'extérieur du domaine Web d'origine du format de fichier Flash (SWF).

La solution dépend du nombre d'ordinateurs utilisés pour l'installation du serveur Dashboards et de l'outil client

Query as a Web Service Designer.

Un seul et même ordinateur

Ouvrez la boîte de dialogue Paramètres facultatifs à l'aide du bouton

Paramètres avancés

et modifiez l'URL de base de service Web de façon à ce qu'elle soit identique au domaine Web utilisé pour télécharger Dashboards.

Deux ordinateurs différents

Pour des instructions, voir : http://www.adobe.com/cfusion/knowledgebase/index.cfm?id=tn_14213

6.2.2 Pour sélectionner le service Web

Pour sélectionner le service Web, vous devez faire pointer le connecteur de service Web vers le document WSDL.

1. Dans une feuille de calcul Excel, cliquez deux fois sur le connecteur de service Web pour ouvrir le panneau

Propriétés.

2. Dans le volet de gauche, cliquez sur le bouton Actualiser la connexion et faites-le glisser dans le tableau de bord à droite de l'écran de l'application.

3. Effectuez l'une des actions suivantes :

○ Sélectionnez

Données Connexions.

○ Cliquez sur le bouton

Actualisation des données

.

La boîte de dialogue Sélection du service Web s'affiche.

4. Cliquez sur

Ajouter

.

Une liste des types de connexion disponibles apparaît.

5. Dans la liste, sélectionnez

Query as a Web Service Designer

.

Le fait de sélectionner Query as a Web Service Designer permet de garantir que SAP BusinessObjects

Dashboards gère l'authentification correcte pour les paramètres de connexion.

6. Saisissez un nom pour la connexion.

SAP BusinessObjects Query as a Web Service Designer

Utilisation de Query as a Web Service avec différentes applications

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

35

7. Dans la zone URL WSDL, saisissez ou collez l'emplacement du document WSDL.

8. Cliquez sur

Importer

.

En cas d'erreur, il se peut que le document WSDL ne soit pas entièrement validé ou qu'il ne réponde pas aux conditions du connecteur de service Web.

9. Dans la liste Méthodes, sélectionnez la méthode choisie pour la liaison.

La liaison ne porte que sur une méthode par composant, pour un service Web donné.

10. Cliquez sur

OK

.

Vous pouvez maintenant lier les messages entrants et sortants aux données.

6.2.3 Messages entrants

Pour les messages entrants, vous pouvez uniquement lier des éléments aux données.

Utilisez le bouton "

-

" pour supprimer des dossiers et des éléments. Ainsi, le dossier ou le champ n'est pas envoyé dans le message.

Vous pouvez utiliser le bouton "

+

" pour ajouter un dossier ou un élément qui se répète.

6.2.4 Messages sortants

Pour les messages sortants, vous pouvez lier des éléments et des dossiers aux données.

Lorsque vous sélectionnez un dossier, le nombre de colonnes du dossier s'affiche. Lorsque vous liez un dossier aux données, chaque élément du dossier est affecté à une colonne dans l'ordre d'apparition des éléments.

Si vous sélectionnez moins de colonnes, les données liées au nombre de colonnes sélectionnées sont plus restreintes. Si vous sélectionnez des colonnes supplémentaires, des colonnes vierges sont insérées. Si un

élément se répète sous le dossier, seul le premier élément est relié à la colonne. La liaison ne concerne pas les dossiers situés sous le dossier sélectionné.

Utilisez le bouton "

-

" pour supprimer les éléments inutiles. La vue de l'arbre est ainsi plus réduite, ce qui permet de limiter éventuellement le temps de traitement du document Flash.

6.2.5 Authentification dans SAP BusinessObjects Dashboards

SAP BusinessObjects Dashboards propose un mécanisme d'authentification vous permettant d'empêcher la connexion à la zone de lancement SAP BusinessObjects de BI deux fois avec le même ID de session.

Tenez compte des règles suivantes si vous personnalisez l'authentification :

● L'ID de session existant est uniquement utilisé si le nom d'utilisateur et le mot de passe sont vides, c'es-à-dire non codés de façon permanente ou non transmis comme valeurs d'entrée dans une boîte de dialogue. Cela se produit lorsque Query as a Web Server Designer s'exécute dans la zone de lancement BI ou dans les espaces de travail SAP BusinessObjects de BI.

36

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Utilisation de Query as a Web Service avec différentes applications

● Si le nom d'utilisateur et le mot de passe sont présents, utilisez ces valeurs pour authentifier l'utilisateur.

Aucune session n'est créée. Cette option, qui offre les meilleures possibilités d'extension, est préconisée pour une utilisation à grande échelle.

● S'il n'existe pas de session (et que le nom d'utilisateur et le mot de passe sont vides), Dashboards ouvre la boîte de dialogue de sécurité standard pour créer une session. C'est le cas lorsque les concepteurs

Dashboards ne créent pas leur propre boîte de dialogue de sécurité.

6.3 Utilisation d'une requête Query as a Web Service dans

Crystal Reports

Cette section décrit comment SAP Crystal Reports utilise une requête Query as a Web Service en tant que source de données.

1. Dans l'

Assistant de création de rapports standard

SAP Crystal Reports, créez une nouvelle connexion XML dans la page d'accès aux données.

2. Sur la page Type et emplacement XML de la boîte de dialogue XML, sélectionnez

Utiliser la source de données service Web

et cliquez sur

Suivant

.

L'écran Emplacement des services Web s'affiche.

3. Dans le champ URL WSDL HTTP, saisissez le WSDL de la requête Query as a Web Service sélectionnée.

La page d'authentification s'affiche.

4. Définissez le paramètre Authentification de base (si ce n'est pas déjà fait) et cliquez sur

Suivant

.

La page Service Web, port et méthode s'affiche.

5. Entrez les informations, puis cliquez sur

Terminer

.

La boîte de dialogue

Saisie de valeurs

s'affiche.

6. Définissez les paramètres des services Web (nom de connexion, mot de passe et invites), puis cliquez sur

OK

.

La page d'accès aux données de l'Assistant de création de rapports standard s'ouvre à nouveau.

7. Sélectionnez l'une des options disponibles, puis cliquez sur

Suivant

.

○

runQueryAsServiceResponse

○

runQueryAsServicetable

○

runQueryAsServicerow

La page Champs s'affiche.

8. Sélectionnez le champ sur lequel vous voulez créer la requête, puis cliquez sur

Suivant

.

Un rapport est créé.

9. Actualisez le rapport.

Les paramètres corrects s'affichent dans le rapport.

SAP BusinessObjects Query as a Web Service Designer

Utilisation de Query as a Web Service avec différentes applications

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

37

6.4 Utilisation d'une requête Query as a Web Service sous

Microsoft Office InfoPath

Cette section décrit comment Microsoft Office InfoPath utilise une requête Query as a Web Service en tant que source de données.

1. Dans InfoPath, accédez à la liste des tâches Créer un formulaire.

2. Cliquez sur

Créer à partir d'une connexion de données

.

L'Assistant Connexion de données s'affiche.

3. Sélectionnez

Service Web

et cliquez sur

Suivant

.

4. Sélectionnez

Réception et envoi des données

, puis cliquez sur

Suivant

.

5. Saisissez le nom du fichier WSDL ou utilisez la fonction Parcourir, puis cliquez sur

Suivant

.

6. Sélectionnez l'opération du service Web, puis cliquez sur

Suivant

.

7. Saisissez le nom de la connexion de données, puis cliquez sur

Suivant

.

8. Saisissez le nom du service Web auquel les utilisateurs doivent soumettre leurs formulaires ou utilisez la fonction Parcourir, puis cliquez sur

Suivant

.

La page Paramètres s'affiche.

9. Pour chaque paramètre, sélectionnez

Formulaire entier

, puis cliquez sur

Suivant

.

10. Saisissez le nom de la connexion de données qui soumet les données, puis cliquez sur

Suivant

.

Le formulaire de données s'affiche à gauche et la source de données à droite.

11. Créez le formulaire, puis cliquez sur

Exécuter la requête

.

38

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Utilisation de Query as a Web Service avec différentes applications

7 Appel de description API par le service

Web

Cette section décrit les méthodes générées par une requête.

Query as a Web Service Designer génère toujours les deux méthodes suivantes :

● runQueryAsAService

● runQueryAsAServiceEx

Chacune des méthodes correspond à l'appel de requête mais du fait que runQueryAsAServiceEx est généré pour des invites d'index, il existe une différence dans le type de paramètre d'entrée pour Enter_value_s_for_Year_. Cela est décrit ci-dessous.

Ces deux méthodes nécessitent toujours la même définition de paramètre d'entrée et produisent la même définition de paramètre de sortie à l'exception de la liste des valeurs d'invite d'entrée étant donné qu'il existera autant de paramètres d'entrée que d'invites dans une requête.

valuesOf_Year est la troisième méthode générée. Ce nom (ainsi que les noms des paramètres d'invite) dépend des noms d'objet utilisés dans la requête et est généré de façon dynamique. Cette procédure est également décrite dans le tableau suivant :

● Paramètres entrée

Table 12 :

Paramètre connexion password searchLOV

Type chaîne chaîne chaîne

Enter_value_s_for_Year_

ID de session

● Pour runQueryAsAService : chaine[]

● Pour runQueryAsAServiceEx :

LovValueIndex[] chaîne

Description

Informations de connexion

Mot de passe

Définit le modèle de recherche dans la liste des va­ leurs. Vous pouvez utiliser les caractères génériques suivants dans le modèle de chaine : ? : 0 ou 1 carac­ tère, * : 0 ou n caractères; par exemple, "M?Greggor" trouve la valeur McGreggor, et "M*Greggor" trouve les valeurs McGreggor et MacGreggor.

Invite pour les valeurs Année.

La méthode runQueryAsAService requiert la chaîne

Enter_Year_ As comme invite valeur pour Année.

La méthode runQueryAsAServiceEx est générée pour les invites d'index et requiert une instance de

LovValueIndex.

Identificateur pour une session BusinessObjects En­ terprise qui permet au service Web de se connecter au CMS sans identification et mot de passe. Le ser­ vice Web obtient l'identificateur de session de l'appel getSessionInfo.

SAP BusinessObjects Query as a Web Service Designer

Appel de description API par le service Web

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

39

Paramètre sessionSérialisée

Type chaîne

Description

Permet au service Web de se connecter au CMS sans identification et mot de passe via une session déjà ouverte (session sérialisée). Une session publiée s'obtient à partir de la session de la plateforme du service Web grâce à l'appel getSessionInfo.

● Paramètres sortie

Table 13 :

Paramètre un tableau simple message creatorname creationdate creationdateformated une description ; univers queryruntime fetchedrows delegated

Type

Tableau chaîne chaîne dateTime chaîne chaîne chaîne int int boolean

Description

Les données de sortie sont représentées dans un tableau sous forme d'ensemble de lignes, chaque ligne étant un nuplet de valeurs pour chaque colonne. Ceci est l'équivalent d'un tableau vertical dans Web Intelligence.

Texte qui contient des messages d'erreur ou alertes pouvant être générés par le serveur lors de l'exécution d'une requête.

Nom du créateur de la requête.

Date de création de la requête.

Date de création de la requête, définie dans les paramètres régionaux de l'ordina­ teur utilisé pour créer la requête.

Commentaires

Nom de l'univers

Métadonnées d'univers qui indiquent la durée d'exécution de la base de donnée de la requête.

Nombre de lignes renvoyées par les métadonnée de la base de donnée et de l'uni­ vers.

Renvoie "true" si l'univers définit LOV en tant que recherche déléguée et que la liste des valeurs est déterminée par base de donnée avec le modèle d'utilisateur d'entrée donné, sinon, renvoie "false"

40

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Appel de description API par le service Web

8 Limitations lors de l'utilisation de Query as a Web Service Designer

Restrictions liées à la création d'une requête

● Multicubes non disponibles

● Requêtes et sous-requêtes combinées non disponibles

● Invites de reconnaissance d'index non mises en œuvre

Restrictions lors de l'exécution de la requête

● Restrictions d'objet non disponibles

SAP BusinessObjects Query as a Web Service Designer

Limitations lors de l'utilisation de Query as a Web Service Designer

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

41

Clauses de non-responsabilité importantes et informations juridiques

Exemples de code source

Le code et les lignes ou chaînes de code ("Code") inclus dans la présente documentation ne sont que des exemples et ne doivent en aucun cas être utilisés dans un environnement productif. Le Code est utilisé uniquement pour mieux expliquer et visualiser les règles de syntaxe de certains codages. SAP ne sera pas tenu responsable des erreurs ou dommages causés par l'utilisation de ce Code, sauf si de tels dommages étaient causés par SAP intentionnellement ou par négligence grave.

Accessibilité

Les informations contenues dans la documentation SAP représentent la vision actuelle de SAP concernant les critères d'accessibilité, à la date de publication de ladite documentation, et ne peuvent en aucun cas être considérées comme juridiquement contraignantes pour garantir l'accessibilité aux produits logiciels. SAP décline toute responsabilité pour le présent document. Cette clause de non-responsabilité ne s'applique toutefois pas à des cas de faute intentionnelle ou lourde de la part de SAP. En outre, ce document n'entraîne pas des obligations contractuelles directes ou indirectes pour SAP.

Langage non discriminatoire

Dans la mesure du possible, la documentation SAP est non discriminatoire au titre du genre féminin ou masculin. Selon le contexte, le texte s'adresse au lecteur en utilisant le pronom "vous" ou un substantif neutre (tel que "commercial" ou "jour ouvrable"). Lorsque le texte se réfère à des hommes et des femmes, que la troisième personne du singulier ne peut pas être évitée ou qu'un substantif neutre n'existe pas, SAP se réserve le droit d'utiliser la forme masculine du nom ou du pronom. Ceci permet d'assurer la bonne compréhension de la documentation.

Hyperliens Internet

La documentation SAP peut contenir des hyperliens vers Internet. Lesdits hyperliens sont utilisés pour indiquer où trouver l'information. SAP ne garantit pas la disponibilité et l'exactitude des informations ou leur capacité à répondre à un but précis. SAP ne saurait être tenu responsable des dommages causés par l'utilisation desdites informations sauf si de tels dommages étaient causés par une négligence grave ou une faute intentionnelle de SAP. Tous les liens sont catégorisés pour transparence (voir : http://help.sap.com/disclaimer ).

42

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

SAP BusinessObjects Query as a Web Service Designer

Clauses de non-responsabilité importantes et informations juridiques

SAP BusinessObjects Query as a Web Service Designer

Clauses de non-responsabilité importantes et informations juridiques

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

43

www.sap.com/contactsap

© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.

Toute reproduction ou communication de la présente publication, même partielle, par quelque procédé et à quelque fin que ce soit, est interdite sans l'autorisation expresse et préalable de SAP SE ou d'une société affiliée SAP. Les informations du présent document sont susceptibles d’être modifiées sans préavis.

Certains logiciels commercialisés par SAP SE et ses distributeurs contiennent des composants logiciels qui sont la propriété d'éditeurs tiers. Les spécifications des produits peuvent varier d’un pays à l’autre.

Les informations du présent document sont fournies par SAP SE ou par une société affiliée SAP uniquement à titre informatif, sans engagement ni garantie d'aucune sorte. SAP SE ou ses sociétés affiliées ne pourront en aucun cas être tenues responsables des erreurs ou omissions relatives à ces informations. Les seules garanties fournies pour les produits et les services de SAP SE ou d'une société affiliée SAP sont celles énoncées expressément à titre de garantie accompagnant, le cas échéant, lesdits produits et services. Aucune des informations contenues dans le présent document ne saurait constituer une garantie supplémentaire.

SAP et tous les autres produits et services SAP mentionnés dans ce document, ainsi que leurs logos respectifs, sont des marques commerciales ou des marques déposées de SAP SE (ou d'une société affiliée SAP) en Allemagne ainsi que dans d'autres pays.

Tous les autres noms de produit et service mentionnés sont des marques commerciales de leurs sociétés respectives.

Pour plus d'informations sur les marques déposées, voir http:// www.sap.com/corporate-en/legal/copyright/index.epx

.