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
2.4 Optimisation des requêtes sur les sources de données relationnelles pour SAP BusinessObjects
2
© 2015 SAP SE ou société affiliée SAP. Tous droits réservés.
SAP BusinessObjects Query as a Web Service Designer
Contenu
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
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
.
