Structure de service BI. SAP Rich Client

PDF

Документ

2. Sélectionnez

Visualiser Afficher les requêtes QaaWS

pour afficher les requêtes QaaWS.

3. Sélectionnez la requête QaaWS que vous souhaitez importer, puis cliquez sur

Importer la requête de service

Web

La requête QaaWS est ajoutée au document en tant que requête Web Intelligence. Un onglet de rapport qui porte le même nom que la requête QaaWS apparaît. L'onglet de rapport contient un tableau correspondant aux objets de la requête.

4. Actualisez la requête que vous venez d'ajouter pour afficher les données de la requête de service Web.

5. Cliquez avec le bouton droit de la souris sur le tableau qui vient d'être ajouté, puis sélectionnez

Publier en tant que service Web

pour publier le tableau en tant que service Web.

Informations associées

Pour publier un bloc de rapport en tant que service Web

[page 332]

6.4.4 Structure de service BI

Les applications Web externes accèdent au contenu Web Intelligence publié en tant que service Web en appelant deux fonctions :

● GetReportBlock_blockname

● Drill_blockname

Pour ces deux appels de fonction, blockname est le nom du bloc défini dans le service Web.

Les applications utilisent le protocole SOAP pour appeler les fonctions et recevoir leurs résultats qu'elles peuvent ensuite analyser.

6.4.4.1 GetReportBlock_blockname

Nom de la fonction

GetReportBlock_blockname

Paramètres d'entrée

Nom connexion

Description

Connexion CMS

338

Obligatoire ?

Oui, à moins que le paramètre sessionID ou

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

Nom password reportfilter invite closeDocument endRow startRow

Description Obligatoire ?

serializedSession ne soit indiqué.

Mot de passe pour le CMS un ou plusieurs filtres de rapport. Pour en savoir plus, voir le tableau cidessous.

Oui, à moins que le paramètre sessionID ou serializedSession ne soit indiqué.

Oui lorsque le bloc du rapport contient des entrées de section ; Sinon, non.

Ainsi, les blocs à sections ont à la fois des paramètres reportfilter obligatoires et optionnels.

Valeurs d'invite Pour en savoir plus sur les paramètres ValeurIndexLdV , voir ci-dessous

Oui lorsque refresh = true et que l'invite est obligatoire ; sinon, non false . Si vous ne définissez aucune valeur d'invite, l'invite utilise les dernières valeurs définies. La consommation de services Web ayant des invites dans Web Intelligence ne se traduit pas forcément par l'apparition d'invites. Vous devez saisir des valeurs d'invite dans la fenêtre Fournisseur de données personnalisé - Service Web.

Force la fermeture du document une fois que le service Web a répondu avec le contenu demandé. Ce comportement aide à optimiser la consommation de mémoire sur le serveur, puisque les consommateurs peuvent contrôler la durée de stockage des documents.

Booléen, valeur par défaut : false (par défaut, le document reste ouvert lorsque le service Web a répondu).

Valeurs : false

ou true

Définit le numéro de la dernière ligne extraite de la source. Ce paramètre est utilisé avec le paramètre startRow pour définir la taille du bloc à extraire dans le paramètre de sortie de la table (p. ex. startRow = 10 / endRow= 55, 46 lignes seront extraites entre la ligne n°10 et la ligne n°55 incluses). Le classement de la dernière ligne de la table est défini comme étant égal à la taille de la table, toute valeur supérieure est corrigée en interne par ce numéro.

Facultatif. Sans déclaration, le contenu entier de la table est extrait. Par défaut, le contenu entier de la table est extrait.

Définit le numéro de la première ligne extraite de la source. Ce paramètre est utilisé avec le paramètre endRow pour définir la taille du bloc à extraire dans le paramètre de sortie de la table (p. ex. startRow = 10 / endRow= 55, 46 lignes seront extraites entre la ligne n°10 et la

Facultatif. Sans déclaration, le contenu entier de la table est extrait. Par défaut, le contenu entier de la table est extrait.

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

339

Nom resetState refresh getFromLatestDocumentInstance getFromUserInstance turnOutputToVTable sessionID serializedSession

Description Obligatoire ?

ligne n°55 incluses). Le numéro de la première ligne d'une table est 1, toute valeur inférieure est corrigée en interne par la valeur 1.

Ouvre à nouveau le document lorsque le service Web est appelé, réinitialisant ainsi les explorations et les filtres.

Non, la valeur par défaut est false .

Force l'actualisation du document.

Non, la valeur par défaut est false

Extrait les données de la dernière instance du document.

Extrait les données de la boîte de réception de l'utilisateur si le document a été publié.

Transforme le résultat en tableau vertical.

Non, la valeur par défaut est true .

Non, la valeur par défaut est false

Non, la valeur par défaut est false .

Remarque

Le bloc est toujours transformé en tableau vertical lorsque c'est un diagramme, même si ce paramètre est paramétré sur false .

Jeton de session pour éviter de saisir l'identification et le mot de passe.

Augmente le nombre de sessions lors de la soumission.

Session sérialisée pour éviter de saisir l'identification et le mot de passe.

N'augmente pas le nombre de sessions lors de la soumission.

Non.

paramètre reportfilter

Les paramètres reportfilter comprennent deux éléments :

Nom valeur_filtrage opérateur_filtrage

Description

Valeur utilisée pour filtrer les données

Opérateur du filtre

Valeurs

Quelconque

EQUAL (par défaut)¦ GREATER ¦

GREATER_OR_EQUAL ¦ LESS ¦

LESS_OR_EQUAL ¦ NOT_EQUAL ¦

INLIST ¦ NOT_INLIST

340

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

Exemple de paramètre filtrerapport

Le filtre [Pays]="Etats-Unis" est indiqué de la façon suivante :

<operator>EQUAL</operator>

</Country>

Paramètres de sortie

Nom tableau en-têtes pieds de page utilisateur documentation nomdocument datedernièreactualisation datecréation créateur estPlanifié heureDébutPlanifiée heureFinPlanifiée typeTableau nbColonnes nbLignes

Type

TableauT

En-têteT

PiedPageT chaîne chaîne chaîne dateHeure dateTime chaîne booléen dateTime dateTime chaîne int int

Description

Cellules du tableau

En-têtes du tableau

Pieds de page du tableau

Identification utilisée par l'appel du service Web

Description du service Web fournie par le concepteur du service

Nom du document

Date de la dernière actualisation du document

Date de création du service Web

Nom d'utilisateur du créateur du service

Web

Indique si le document est planifié

Date de démarrage prévue si le document est planifié

La date de fin prévue si le document est planifié

Type de tableau

Nombre de colonnes dans le tableau de résultat

Nombre de lignes dans le tableau de résultat

Informations associées

Drill_blockname

[page 342]

Exemple de renvoi de données de service BI

[page 345]

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

341

6.4.4.2 Drill_blockname

Nom de la fonction

Drill_blockname

Remarque

Cet appel de service Web ne peut pas être utilisé quand l'option de partage du document (

Partager le contenu du rapport pour tous les consommateurs

dans l'assistant

Publier le contenu

) est activée (de telles méthodes ne seront pas spécifiées dans un fichier WSDL de service Web), une erreur sera renvoyée au consommateur s'il est appelé lorsque cette option est activée.

Paramètres d'entrée

La syntaxe de la fonction Drill_<nom_bloc> est similaire à GetReportBlock_<nom_bloc> avec les différences suivantes :

● il n'existe pas de paramètre reportfilter

● il existe des paramètres drillpath supplémentaires

● il existe un paramètre drillfilter supplémentaire

Nom drillpath drillfilter

Description

Indique une instruction d'exploration

Indique le filtre à appliquer lors de l'exploration

Obligatoire ?

Oui

Non

Paramètre chemind'exploration

les paramètres drillpath sont de type DrillPath. Ils contiennent les éléments suivants :

Nom from

Valeur opérationd'exploration

Description

La dimension à explorer

La valeur pour explorer sur

Le type d'opération d'exploration

Valeurs

Quelconque

N'importe lequel

UP ¦ DOWN

Remarque

● La valeur peut transmettre des définitions telles que "Toutes les villes" aussi bien que des valeurs uniques

(par exemple, "Los Angeles".

● Le service Web renvoie les données du tableau d'origine si l'instruction d'exploration est invalide.

342

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

● A la fin de la hiérarchie d'exploration, le service Web renvoie la dernière valeur disponible dans la hiérarchie d'exploration

● Vous pouvez fournir plus d'un paramètre drillpath à condition que les paramètres ne fassent pas référence à des niveaux différents dans la même hiérarchie.

Paramètre filtred'exploration

Les paramètres drillpath vous permettent d'appliquer des filtres d'exploration au cours de l'exploration :

Nom dimension valeur opérateur

Description

La dimension pour filtrer

La valeur sur laquelle filtrer

L'opérateur filtre

Valeurs

Toute

N'importe lequel

EQUAL ¦ GREATER ¦

GREATER_OR_EQUAL ¦ LESS ¦

LESS_OR_EQUAL ¦ NOT_EQUAL ¦

INLIST ¦ NOT_INLIST

Remarque

● La valeur peut transmettre des définitions telles que "Toutes les villes" aussi bien que des valeurs uniques

(par exemple, "Los Angeles")

● Le service Web renvoie les données du tableau d'origine si l'instruction d'exploration est non valide

● A la fin de la hiérarchie d'exploration, le service Web renvoie la dernière valeur disponible dans la hiérarchie d'exploration

● Vous pouvez fournir plusieurs plusieurs paramètres drillpath à condition que les paramètres ne fassent pas référence à des niveaux différents dans la même hiérarchie.

Informations associées

GetReportBlock_blockname

[page 338]

6.4.4.3 Paramètres de sortie des services BI

Le tableau suivant répertorie les paramètres de sortie renvoyés par un service BI :

Nom table headers footers

Type

TableauT en-têteT pieddepageT

Description

Cellules du tableau

Cellules d'en-tête de tableau

Cellules de pied de tableau

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

343

Nom user documentation documentname lastrefreshdate creationdate creator isScheduled scheduleStartTime scheduleEndTime tableType nbColumns nbLines

Type chaîne chaîne chaîne dateHeure dateHeure chaîne booléen dateHeure dateHeure chaîne int int

Exemple de paramètre de tableau

<table>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Bungalow</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Room</cell>

</row>

...

</table>

Description

Identification utilisée par l'appel du service Web

La description du service Web fournie par le concepteur du service

Nom du document

La date de la dernière actualisation du document

La date de création du service Web

Nom d'utilisateur du créateur du service

Web

Indique si le document est planifié

La date de démarrage prévue si le document est planifié

La date de fin prévue si le document est planifié

Le type de tableau

Le nombre de colonnes dans le tableau de résultat

Le nombre de lignes dans le tableau de résultat

Exemple de paramètre d'en-têtes

<row>

344

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

<cell xsi:type="xsd:string">Country</cell>

<cell xsi:type="xsd:string">Service Line</cell>

<cell xsi:type="xsd:string">Service</cell>

<cell xsi:type="xsd:string">Revenue</cell>

</row>

</headers>

Informations associées

Exemple de renvoi de données de service BI

[page 345]

6.4.4.4 Exemple de renvoi de données de service BI

Les services Web renvoient les données à l'aide de SOAP. L'exemple suivant est un fichier SOAP renvoyé par un service Web :

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance...>

<soap:Body>

<GetReportBlock_Block1BeachResponse xmlns="multidocmultiuniversesmultime">

<table>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Bungalow</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Room</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Suite</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Poolside Bar</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Restaurant</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

345

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Activities</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Excursion</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Sports</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Travels</cell>

</row>

<row>

<cell xsi:type="xsd:string">Australia</cell>

<cell xsi:type="xsd:string">Travels</cell>

<cell xsi:type="xsd:string">Travel Reservation</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Bungalow</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Room</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Suite</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Poolside Bar</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Restaurant</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Activities</cell>

346

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Excursion</cell>

</row>

<row>

<cell xsi:type="xsd:string">France</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Sports</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Bungalow</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Room</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Suite</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Poolside Bar</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Restaurant</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Activities</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Excursion</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Sports</cell>

</row>

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

347

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Travels</cell>

</row>

<row>

<cell xsi:type="xsd:string">Nepal</cell>

<cell xsi:type="xsd:string">Travels</cell>

<cell xsi:type="xsd:string">Travel Reservation</cell>

</row>

<row>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Bungalow</cell>

</row>

<row>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Room</cell>

</row>

<row>

<cell xsi:type="xsd:string">Accommodation</cell>

<cell xsi:type="xsd:string">Hotel Suite</cell>

</row>

<row>

<cell xsi:type="xsd:string">Food & Drinks</cell>

</row>

<row>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Poolside Bar</cell>

</row>

<row>

<cell xsi:type="xsd:string">Food & Drinks</cell>

<cell xsi:type="xsd:string">Restaurant</cell>

</row>

<row>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Activities</cell>

</row>

<row>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Excursion</cell>

</row>

<row>

<cell xsi:type="xsd:string">Recreation</cell>

<cell xsi:type="xsd:string">Sports</cell>

</row>

<row>

348

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

<cell xsi:type="xsd:string">Travels</cell>

</row>

<row>

<cell xsi:type="xsd:string">Travels</cell>

<cell xsi:type="xsd:string">Travel Reservation</cell>

</row>

</table>

<row>

<cell xsi:type="xsd:string">Country</cell>

<cell xsi:type="xsd:string">Service Line</cell>

<cell xsi:type="xsd:string">Service</cell>

<cell xsi:type="xsd:string">Revenue</cell>

</row>

</headers>

<user>Administrator</user>

<documentname>_DaaWSDivers1</documentname>

<creator>Administrator</creator>

<isScheduled>false</isScheduled>

<tableType>Vertical Table</tableType>

</GetReportBlock_Block1BeachResponse>

</soap:Body></soap:Envelope>

6.4.4.5 Définition WSDL du service BI

<?xml version="1.0" encoding="utf-16"?>

<types>

<s:schema elementFormDefault="qualified" targetNamespace="zozo2">

<s:simpleType name="Operator">

<s:restriction base="s:string">

<s:enumeration value="EQUAL" />

<s:enumeration value="GREATER" />

<s:enumeration value="GREATER_OR_EQUAL" />

<s:enumeration value="LESS" />

<s:enumeration value="LESS_OR_EQUAL" />

<s:enumeration value="NOT_EQUAL" />

<s:enumeration value="INLIST" />

<s:enumeration value="NOT_INLIST" />

</s:restriction>

</s:simpleType>

<s:complexType name="FilterCondition">

<s:sequence>

<s:element name="value" type="s:string" />

<s:element name="operator" type="s0:Operator" />

</s:sequence>

</s:complexType>

<s:complexType name="LovValueIndex">

<s:sequence>

<s:element name="valueofPrompt" type="s:string" />

Guide de l'utilisateur de SAP BusinessObjects Web Intelligence Rich Client

Publication, mise en forme et partage de rapports

349

<s:element name="index" type="s:string" />

</s:sequence>

</s:complexType>

<s:complexType name="DrillFilter">

<s:sequence>

<s:element name="dimension" type="s:string" />

<s:element name="value" type="s:string" />

<s:element name="operator" type="s0:Operator" />

</s:sequence>

</s:complexType>

<s:element name="GetReportBlock_Block1">

<s:complexType>

<s:sequence>

<s:element name="login" type="s:string" minOccurs="0" nillable="true" />

<s:element name="password" type="s:string" minOccurs="0" nillable="true" />

<s:element name="Country" type="s0:FilterCondition" />

<s:element name="Resort" type="s0:FilterCondition" minOccurs="0" maxOccurs="unbounded" nillable="true" />

<s:element name="Service_Line" type="s0:FilterCondition" minOccurs="0" maxOccurs="unbounded" nillable="true" />

<s:element name="Revenue" type="s0:FilterCondition" minOccurs="0" maxOccurs="unbounded" nillable="true" />

<s:element name="Enter_value_s__for_Country_" type="s0:LovValueIndex" minOccurs="0" maxOccurs="unbounded" nillable="true" />

<s:element name="resetState" type="s:boolean" minOccurs="0" nillable="true" />

<s:element name="refresh" type="s:boolean" minOccurs="0" nillable="true" />

<s:element name="getFromLatestDocumentInstance" type="s:boolean" minOccurs="0" nillable="true" />

<s:element name="getFromUserInstance" type="s:boolean" minOccurs="0" nillable="true" />

<s:element name="turnOutputToVTable" type="s:boolean" minOccurs="0" nillable="true" />

</s:sequence>

</s:complexType>

</s:element>

<s:element name="GetReportBlock_Block1ff">

<s:complexType>

<s:sequence>

<s:element name="login" type="s:string" minOccurs="0" nillable="true" />

<s:element name="password" type="s:string" minOccurs="0" nillable="true" />

<s:element name="Country" type="s0:FilterCondition" minOccurs="0" maxOccurs="unbounded" nillable="true" />