Een rapport aanmaken, wijzigen of verwijderen

Het rapport wordt geconfigureerd via een XML-bestand. U moet het volgende bepalen:

• de query op de database van Systancia Identity waarmee de gewenste informatie wordt opgehaald,
• de eigenschappen van elke weer te geven kolom in XML-formaat: objecttype, naam in de SQL-database, weer te geven naam, weergave-index enz.
• de weergaveopties van de grafieken (staafdiagram, cirkeldiagram, gekleurde punten).

Klik op de knop ”New report” om een nieuw rapport aan te maken en te configureren.

Selecteer een rapport en klik op de knop ”Modify” om de configuratie ervan te wijzigen.

Eigenschappen van een rapport

Parameter	Beschrijving	Typen en mogelijke waarden
Name	Weergavenaam van het rapport.	Tekenreeks. Verplicht.
Code	Komt overeen met de ID van het object. De waarde moet uniek zijn over alle rapporten heen.	Tekenreeks , zonder spaties en zonder speciale tekens. Verplicht
Category	Rapportcategorie waarin de lijst met rapporten wordt weergegeven.	Lijst van voorgedefinieerde categorieën.
Description		Tekenreeks.
XML	XML-tags die de SQL-query in de Hpliance-database, de eigenschappen van elke kolom van het rapport en de eigenschappen van de grafische elementen beschrijven.	Tekst in XML-formaat.
Choice of report template	Grafisch sjabloon van het rapport (naast de gegevenstabel).	Without chart, Histogram, Stacked histogram, Pie chart of Color ball by threshold.
With parameters	Maakt het mogelijk variabelen toe te voegen die de gebruiker invoert. U moet de tag aan het XML toevoegen.	Selectievakje.

Het XML van een eenvoudig rapport schrijven

<Config> 

   <!-- If there is a chart, indicate whether to display the chart on the dashboard --> 

   <DisplayGraphicInDashboard>true</DisplayGraphicInDashboard> 

   <!-- If there is a chart, indicate the chart display index on the dashboard --> 

   <DashboardDisplayIndex>0</DashboardDisplayIndex> 

   <!-- Indicates whether data is displayed as soon as the report page is accessed -->

   <DirectDisplay>true</DirectDisplay> 

   <!-- The SQL query used to retrieve the data to be displayed --> 

   <Query></Query> 

   <!-- Definition of the list of columns available to the user. --> 

   <!-- The visibility and display index of the column can be configured by the user when viewing the report.  --> 

   <Columns> 

       <!-- Definition of a column (to be duplicated as many times as necessary) --> 

       <Column> 

           <!-- The Object Type -->  

           <ObjectType></ObjectType> 

           <!-- Name of the column containing the IDs -->  

           <Column_Link_Id></Column_Link_Id> 

           <!-- The name of the field as defined in the query.  --> 

           <Name></Name> 

           <!-- The default name to display to the user.  -->  

           <DisplayName></DisplayName> 

           <!-- Indicates whether this column is visible by default. TRUE or FALSE  -->

           <Visible></Visible> 

           <!-- The default display index.  --> 

           <DisplayIndex></DisplayIndex> 

       </Column> 

   </Columns> 

</Config> 

Voorbeeld: lijst van de gebruikers zonder telefoonnummer

<Config> 

   <DisplayGraphicInDashboard>true</DisplayGraphicInDashboard> 

   <DashboardDisplayIndex>0</DashboardDisplayIndex> 

   <DirectDisplay>true</DirectDisplay> 

   <Query> 

SELECT personne_uid,personne_display_name FROM PERSONNE 

WHERE personne_id NOT IN(SELECT personne_id FROM PERSONNE_MULTIVALUED WHERE personne_schema_attribut_id = 7) 

 AND personne_hidden=0 

</Query> 

   <Columns> 

       <Column> 

           <ObjectType/> 

           <Column_Link_Id/> 

           <Name/> 

           <DisplayName/> 

           <Visible/> 

           <DisplayIndex/> 

       </Column> 

       <Column> 

           <ObjectType/> 

           <Column_Link_Id/> 

           <Name>personne_uid</Name> 

           <DisplayName>UID</DisplayName> 

           <Visible>TRUE</Visible> 

           <DisplayIndex>1</DisplayIndex> 

       </Column> 

       <Column> 

           <Name>personne_display_name</Name> 

           <DisplayName>Nom</DisplayName> 

           <Visible>TRUE</Visible> 

           <DisplayIndex>2</DisplayIndex> 

       </Column> 

   </Columns> 

</Config>

XML-tags die de kolommen van een rapport beschrijven

XML-tag	Definitie	Mogelijke waarden
Name	Naam van het veld zoals die in de SQL-query is bepaald.	Tekenreeks.
Column_Link_Id	Dient voor het aanmaken van kolommen met aanklikbare gegevens. Komt overeen met de naam van de kolom die de ID bevat waarmee de koppeling wordt beheerd.	Tekenreeks. Optioneel
ObjectType	Type doelobject van de aanklikbare koppeling (Identity, structuur).	Identity = 1 => Doorverwijzing naar de pagina userDetails.aspx
		Structure = 2 => Doorverwijzing naar de pagina structure.aspx
		Optioneel
DisplayName	Naam van de kolom die in de interface wordt weergegeven.	Tekenreeks.
Visible	Geeft aan of de kolom wordt weergegeven of verborgen.	'TRUE' of 'FALSE'
DisplayIndex	Index van de kolom (weergavevolgorde).	Geheel getal groter dan 0

Door de gebruiker ingevoerde parameters aan het rapport toevoegen: tag

Vink het selectievakje ”With parameters” aan en voeg de volgende tags aan het XML toe:

  <!-- Definition of the list of parameters expected by the report request.  --> 

   <Parameters> 

       <!-- Definition of a parameter (to be duplicated as many times as necessary) -->  

       <Parameter> 

           <!-- The name of the variable as defined in the query.  -->

           <Variable></Variable> 

           <!-- The label to display to the user.  -->  

           <Label></Label> 

           <!-- An integer indicating the expected data type (see documentation for possible values) -->  

           <DataType></DataType> 

           <!-- Indicates whether the user must specify a value of ‘TRUE’ or ‘FALSE’ --> 

           <Mandatory></Mandatory> 

           <!-- For optional parameters, the default value to be used if not entered by the user.  --> 

           <DefaultValue></DefaultValue> 

       </Parameter> 

   </Parameters> 

Voorbeeld: machtigingen die bijna verlopen

<Query>DECLARE @DateNow AS DATETIME; SELECT @DateNow = GETDATE(); SELECT * FROM vHABILITATIONS_FULL WHERE (date_debut_lien IS NULL OR @DateNow > date_debut_lien) AND date_fin_lien IS NOT NULL AND ((0 = @ApplicationId) OR (application_id = @ApplicationId)) AND DATEADD(dd, @NbJours, @DateNow) > date_fin_lien ORDER BY date_fin_lien ASC</Query> 

 <Parameters> 

      <Parameter> 

           <Variable>ApplicationId</Variable> 

           <DataType>4</DataType> 

           <Mandatory>TRUE</Mandatory> 

           <Label>Selectionnez l'application</Label> 

       </Parameter> 

      <Parameter> 

           <Variable>NbJours</Variable> 

           <DataType>23</DataType> 

           <Mandatory>TRUE</Mandatory> 

           <Label>Sélectionnez le nombre de jour</Label> 

       </Parameter> 

   </Parameters> 

XML-tags in <Parameter> die de door de gebruiker in te voeren parameters beschrijven:

XML-tag	Definitie	Mogelijke waarden
Variable	Naam van de variabele die in de SQL-query wordt gebruikt (zonder de @).	Tekenreeks.
Data Type	Het objecttype van Systancia Identity dat met de parameter overeenkomt. Als het niet om een eenvoudig objecttype gaat (datum, tekenreeks, geheel getal enz.), is de parameter een vervolgkeuzelijst met de mogelijke waarden.	Structure=2; Authorization Rule=3; Application=4; Repository=5; Right=8; StructureType=11; Tree=12; AdminProfile=18; PersonType=19; String=22; Integer=23; Boolean=24; Date=25.
Label	Label dat aan de gebruiker wordt weergegeven.	Tekenreeks.
AttributeCode	PSA-attribuutcode.	Tekenreeks die overeenkomt met een PSA-code.
Mandatory	Geeft aan of de gebruiker verplicht een waarde moet opgeven.	'TRUE' of 'FALSE
DefaultValue	Bij optionele parameters is dit de standaardwaarde die wordt ingevuld als de gebruiker niets invoert.	Tekenreeks.

De parameters van de grafieken bepalen

Selecteer het grafische sjabloon in de vervolgkeuzelijst en voeg de volgende tags aan het XML toe:

<GraphicConfig> 

       <!-- The type of graph (1=Histogram, 2=Stacked histogram, 3=Pie chart, 4=Colored ball per threshold -->  

       <GraphicType>1</GraphicType> 

       <!-- Graph title (if not specified, the report name will be used -->  

       <Title></Title> 

       <!-- The query to use to retrieve the data that will be used to generate the graph -->

       <Query></Query> 

       <!-- The name of the query field that will serve as the x-axis --> 

       <ColumnX></ColumnX> 

       <!-- The name of the query field that will serve as the y-axis -->  

       <ColumnY></ColumnY> 

       <!-- The label of the x-axis -->  

       <LabelX>Label of column X</LabelX> 

       <!-- The label of the y-axis --> 

       <LabelY>Label of column Y</LabelY> 

       <!-- Indicates whether the graph is in 3 dimensions --> 

       <ThreeDimension>false</ThreeDimension> 

   </GraphicConfig>

Stacked histogram

Voeg de volgende tags in de tag in:

 <!-- 0 = each compiled block corresponds to a column of data (default value) --> 

       <!-- 1 = each compiled block corresponds to a grouping of data from a single column of data --> 

       <StackColumnMode></StackColumnMode> 

       <!-- Definition of the list of columns to stack. --> 

       <StackedColumns> 

           <!-- Definition of a column (to be duplicated as many times as necessary) -->  

           <StackedColumn> 

               <!--  StackColumnMode = 0: The name of the field that contains the data as defined in the query.  --> 

               <!--  StackColumnMode = 1: The name of the field that allows you to create stackable blocks. (YColumn contains the data) --> 

               <DataField></DataField> 

               <!-- The name to display to the user.  --> 

               <DisplayName></DisplayName> 

               <!-- Defines the color of the stacked block (HTML code or color name) --> 

               <Color></Color> 

           </StackedColumn> 

       </StackedColumns>

Gekleurde cirkel per drempel

Voeg de volgende tags in de tag in:

<!-- Definition of thresholds -->

       <Intervals> 

           <!-- Definition of a threshold (to be duplicated as many times as necessary) --> 

           <Interval> 

               <!-- Minimum threshold included --> 

               <Min></Min> 

               <!-- Maximum threshold excluded --> 

               <Max></Max> 

               <!-- Color of the ball for the defined threshold (HTML code or color name) -->

               <Color></Color> 

           </Interval> 

       </Intervals>

De namen van de kolommen van een rapport vertalen

De kolommen en waarden die in de resultaten van een rapport zijn opgenomen, kunnen in meerdere talen worden vertaald.

Hieronder een voorbeeld van een rapport waarvan de kolommen zijn vertaald:

<Config> 

   <DisplayGraphicInDashboard>True</DisplayGraphicInDashboard> 

   <DashboardDisplayIndex>5</DashboardDisplayIndex> 

   <GraphicConfig> 

       <GraphicType>1</GraphicType> 

       <Title>Nombre de personnes par application et type de compte</Title> 

       <Query>SELECT APPLICATION.application_nom + ' - ' + compte_type_nom as Administrateur, T_PERSONNE_APPLICATION_GROUPED.total FROM (SELECT application_id, compte_type_id, COUNT(*) AS total FROM (SELECT DISTINCT personne_id, vPERSONNE_COMPTE_DROIT.application_id, compte_type_id FROM vPERSONNE_COMPTE_DROIT INNER JOIN DROIT ON DROIT.droit_id = vPERSONNE_COMPTE_DROIT.droit_id) T_PERSONNE_APPLICATION GROUP BY application_id, compte_type_id) T_PERSONNE_APPLICATION_GROUPED INNER JOIN APPLICATION ON APPLICATION.application_id = T_PERSONNE_APPLICATION_GROUPED.application_id INNER JOIN COMPTE_TYPE ON COMPTE_TYPE.compte_type_id = T_PERSONNE_APPLICATION_GROUPED.compte_type_id ORDER BY total DESC</Query> 

       <ColumnX>Administrateur</ColumnX> 

       <LabelX>Nom de l'administrateur</LabelX> 

       <ColumnY>total</ColumnY> 

       <LabelY>Nombre de compte</LabelY> 

       <ThreeDimension>false</ThreeDimension> 

   </GraphicConfig> 

   <Query>SELECT APPLICATION.application_culture, APPLICATION.application_nom, compte_type.compte_type_nom, compte_type.compte_type_culture, T_PERSONNE_APPLICATION_GROUPED.total FROM (SELECT application_id, compte_type_id, COUNT(*) AS total FROM (SELECT DISTINCT personne_id, vPERSONNE_COMPTE_DROIT.application_id,  

compte_type_id FROM vPERSONNE_COMPTE_DROIT INNER JOIN DROIT ON DROIT.droit_id = vPERSONNE_COMPTE_DROIT.droit_id)  T_PERSONNE_APPLICATION GROUP BY application_id, compte_type_id) T_PERSONNE_APPLICATION_GROUPED  INNER JOIN APPLICATION ON APPLICATION.application_id = T_PERSONNE_APPLICATION_GROUPED.application_id INNER JOIN COMPTE_TYPE ON COMPTE_TYPE.compte_type_id = T_PERSONNE_APPLICATION_GROUPED.compte_type_id ORDER BY total DESC</Query> 

   <Columns> 

       <Column> 

           <Name>application_nom</Name> 

           <DisplayName>Application</DisplayName> 

           <Visible>True</Visible> 

           <DisplayIndex>1</DisplayIndex> 

           <Internationaldisplayname Lang="FR">Application_FR</internationaldisplayname> 

           <Internationaldisplayname Lang="EN">Application_EN</internationaldisplayname> 

           <CultureColumnName Prop="Name">application_culture</CultureColumnName>  

       </Column> 

      <Column> 

           <Name>compte_type_nom</Name> 

           <DisplayName>Compte type</DisplayName> 

           <Visible>True</Visible> 

           <DisplayIndex>2</DisplayIndex> 

          <Internationaldisplayname Lang="FR">Compte type</internationaldisplayname> 

           <Internationaldisplayname Lang="EN">Account type</internationaldisplayname> 

           <CultureColumnName Prop="Name">compte_type_culture</CultureColumnName>  

       </Column> 

       <Column> 

           <Name>total</Name> 

           <DisplayName>Nombre</DisplayName> 

           <Visible>True</Visible> 

           <DisplayIndex>3</DisplayIndex> 

           <internationaldisplayname Lang="FR">Nombre</internationaldisplayname> 

           <internationaldisplayname Lang="EN">Number</internationaldisplayname> 

       </Column> 

   </Columns> 

</Config>

XML-tag

• Internationaldisplayname:
  • Definitie: tag waarmee de namen van de kolommen die het rapport teruggeeft worden vertaald. Deze tag moet zo vaak voorkomen als er talen in Systancia Identity zijn geconfigureerd.
  • Attribuut: Lang=”<\language_code>” waarbij <\language_code> staat voor de taalcode die is bepaald in de taalinstellingen op het tabblad General > Application Settings.
  • Mogelijke waarde: tekenreeks. De naam van de kolom die in het rapport voor die taal wordt weergegeven.
• CultureColumnName:
  • Definitie: definitie van het culture-XML waarmee de inhoud van de door het rapport gegenereerde tabel wordt vertaald.
  • Attribuut: Prop=”<\XML_Attribute>” waarbij <\XML_Attribute> staat voor het attribuut van de XML-eigenschap dat overeenkomt met de verschillende waarden van de kolom.
  • Mogelijke waarde: tekenreeks. Culture-kolom van de SQL-query.

Een rapport weergeven op basis van de gebruikerscontext

In versie 4000 van Hpliance is het mogelijk aan een rapport een onzichtbare parameter toe te voegen die wordt bepaald op basis van de persoon die het rapport uitvoert. De waarden van het rapport worden dan weergegeven op basis van de waarden van een gebruikersattribuut. Zo ziet die persoon bijvoorbeeld alleen de resultaten van haar eigen organisatie.

Voorbeeld van een rapport: alle machtigingen opsommen die aan de identiteiten van een bepaalde structuur zijn toegekend. De achternamen, voornamen, machtigingen en applicaties weergeven van alle identiteiten waarvan het structuurattribuut "Responsibility" overeenkomt met het structuurattribuut van de aangemelde gebruiker.

<Config> 

   <DirectDisplay>true</DirectDisplay> 

   <Query>select P.personne_id,P.personne_nom, P.personne_prenom, D.droit_nom, A.application_nom 

from vHABILITATIONS_ALL  AS VHA 

inner join LIEN_PERSONNE_STRUCTURE AS LPS ON LPS.personne_id = VHA.personne_id 

inner join DROIT AS D ON D.droit_id = VHA.droit_id 

inner join PERSONNE AS P ON P.personne_id = VHA.personne_id 

inner join APPLICATION AS A ON A.application_id = D.application_id 

where structure_id  in  

 (select * from dbo.fctSplitString(dbo.fctGetAttributeValueByPersonneIdAndPersonneSchemaAttributCode(@personneId, 'responsabilite'), '|')) 

 </Query> 

   <Columns> 

       <Column> 

           <Name>personne_id</Name> 

           <DisplayName>ID</DisplayName> 

           <Visible>False</Visible> 

           <DisplayIndex>1</DisplayIndex> 

       </Column> 

       <Column> 

           <Name>personne_nom</Name> 

           <DisplayName>Nom</DisplayName> 

           <Visible>True</Visible> 

           <DisplayIndex>2</DisplayIndex> 

           <ObjectType>1</ObjectType> 

           <Column_Link_Id>personne_id</Column_Link_Id> 

       </Column> 

       <Column> 

           <Name>personne_prenom</Name> 

           <DisplayName>Prénom</DisplayName> 

           <Visible>True</Visible> 

           <DisplayIndex>2</DisplayIndex> 

           <ObjectType>1</ObjectType> 

           <Column_Link_Id>personne_id</Column_Link_Id> 

       </Column> 

       <Column> 

           <Name>droit_nom</Name> 

           <DisplayName>Droit</DisplayName> 

           <Visible>True</Visible> 

           <DisplayIndex>3</DisplayIndex> 

       </Column> 

       <Column> 

           <Name>application_nom</Name> 

           <DisplayName>Application</DisplayName> 

           <Visible>True</Visible> 

           <DisplayIndex>4</DisplayIndex> 

       </Column> 

   </Columns> 

  <Parameters> 

       <Parameter> 

           <Variable>personneId</Variable> 

           <AttributUserConnected>True</AttributUserConnected> 

           <AttributeCode>personne_id</AttributeCode> 

      </Parameter> 

   </Parameters> 

</Config>

XML-tags die de parameters op basis van de gebruikerscontext beschrijven.

• Variable:
  • Definitie: naam van de variabele die in de SQL-query wordt gebruikt (zonder de @).
  • Mogelijke waarde: tekenreeks.
• AttributUserConnected:
  • Definitie: geeft aan of de parameter wordt bepaald op basis van de context van de huidige gebruiker, dan wel handmatig via de interface moet worden ingevoerd.
  • Mogelijke waarde:
    • True: gebruikerscontext
    • False: handmatige invoer
• AttributeCode:
  • Definitie: PSA-attribuutcode.
  • Mogelijke waarde: tekenreeks die overeenkomt met de PSA-code.