Aruande loomine/muutmine/kustutamine

Aruanne konfigureeritakse XML-faili abil. Määrata tuleb järgmine:

• päring CyberElements Identity andmebaasile soovitud teabe toomiseks,
• iga kuvatava veeru omadused XML-vormingus: objekti tüüp, nimi SQL-andmebaasis, kuvatav nimi, kuvaindeks jne.
• graafikute kuvamissuvandid (tulpdiagramm, sektordiagramm, värvilised punktid).

Uue aruande loomiseks ja konfigureerimiseks klõpsake nuppu „New report“.

Valige aruanne ja klõpsake selle konfiguratsiooni muutmiseks nuppu „Modify“.

Aruande omadused

Parameeter	Kirjeldus	Tüübid ja võimalikud väärtused
Name	Aruande kuvanimi.	Märgistring. Kohustuslik.
Code	Vastab objekti ID-le. Selle väärtus peab olema kõigi aruannete hulgas kordumatu.	Märgistring, ilma tühikute ja erimärkideta. Kohustuslik
Category	Aruandekategooria, milles aruannete loend kuvatakse.	Eelmääratud kategooriate loend.
Description		Märgistring.
XML	XML-sildid, mis kirjeldavad SQL-päringut Hpliance andmebaasis, aruande iga veeru omadusi ja graafiliste elementide omadusi.	XML-vormingus tekst.
Choice of report template	Aruande graafiline mall (lisaks andmetabelile).	Without chart, Histogram, Stacked histogram, Pie chart või Color ball by threshold.
With parameters	Võimaldab lisada kasutaja sisestatud muutujaid. XML-i tuleb lisada silt .	Märkeruut.

Lihtsa aruande XML-i kirjutamine

<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> 

Näide: telefoninumbrita kasutajate loend

<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>

Aruande veerge kirjeldavad XML-sildid

XML-silt	Definitsioon	Võimalikud väärtused
Name	Välja nimi, nagu see on määratud SQL-päringus.	Märgistring.
Column_Link_Id	Kasutatakse klõpsatavaid andmeid sisaldavate veergude loomiseks. Vastab selle veeru nimele, mis sisaldab lingi haldamiseks kasutatavat ID-d.	Märgistring. Valikuline
ObjectType	Klõpsatava lingi sihtobjekti tüüp (Identity, struktuur).	Identity = 1 => ümbersuunamine lehele userDetails.aspx
		Structure = 2 => ümbersuunamine lehele structure.aspx
		Valikuline
DisplayName	Liideses kuvatava veeru nimi.	Märgistring.
Visible	Näitab, kas veerg on kuvatud või peidetud.	'TRUE' või 'FALSE'
DisplayIndex	Veeru indeks (kuvamisjärjestus).	Täisarv, mis on suurem kui 0

Kasutaja sisestatud parameetrite lisamine aruandesse: silt

Märkige ruut „With parameters“ ja lisage XML-i järgmised sildid:

  <!-- 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> 

Näide: peagi aeguvad load

<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> 

Kasutaja sisestatavaid parameetreid kirjeldavad XML-sildid sildis <Parameter>:

XML-silt	Definitsioon	Võimalikud väärtused
Variable	SQL-päringus kasutatava muutuja nimi (ilma märgita @).	Märgistring.
Data Type	Parameetrile vastav CyberElements Identity objektitüüp. Kui see pole põhiline objektitüüp (kuupäev, string, täisarv jne), on parameeter ripploend, mis sisaldab võimalikke väärtusi.	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	Kasutajale kuvatav nimetus.	Märgistring.
AttributeCode	PSA-atribuudi kood.	PSA-koodile vastav märgistring.
Mandatory	Näitab, kas kasutaja peab väärtuse määrama.	'TRUE' või 'FALSE
DefaultValue	Valikuliste parameetrite puhul vaikeväärtus, mis sisestatakse, kui kasutaja midagi ei sisesta.	Märgistring.

Graafikute parameetrite määramine

Valige ripploendist graafiline mall ja lisage XML-i järgmised sildid:

<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

Lisage sildi sisse järgmised sildid:

 <!-- 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>

Värviline ring läve järgi

Lisage sildi sisse järgmised sildid:

<!-- 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>

Aruande veergude nimede tõlkimine

Aruande tulemustes sisalduvaid veerge ja väärtusi saab tõlkida mitmesse keelde.

Järgmine on näide aruandest, mille veerud on tõlgitud:

<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-silt

• Internationaldisplayname:
  • Definitsioon: silt, mida kasutatakse aruande tagastatud veergude nimede tõlkimiseks. Seda silti peab olema nii mitu eksemplari, kui palju keeli on CyberElements Identity lahenduses konfigureeritud.
  • Atribuut: Lang=„<\language_code>“, kus <\language_code> tähistab keelekoodi, mis on määratud vahekaardi General > Application Settings keelesätetes.
  • Võimalik väärtus: märgistring. Aruandes selle keele jaoks kuvatav veeru nimi.
• CultureColumnName:
  • Definitsioon: culture-XML-i definitsioon, mida kasutatakse aruande loodud tabeli sisu tõlkimiseks.
  • Atribuut: Prop=„<\XML_Attribute>“, kus <\XML_Attribute> tähistab veeru eri väärtustele vastava XML-omaduse atribuuti.
  • Võimalik väärtus: märgistring. SQL-päringu culture-veerg.

Aruande kuvamine kasutajakonteksti alusel

Hpliance versioonis 4000 saab aruandele lisada nähtamatu parameetri, mis määratakse aruande käivitaja järgi. Aruande väärtused kuvatakse kasutaja atribuudi väärtuste järgi. Näiteks näeb kasutaja ainult oma organisatsiooni tulemusi.

Aruande näide: loetlege kõik load, mis on määratud antud struktuuri identiteetidele. Kuvage kõigi nende identiteetide perekonnanimed, eesnimed, load ja rakendused, mille struktuuriatribuut „Responsibility“ vastab sisseloginud kasutaja struktuuriatribuudile.

<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-sildid, mis kirjeldavad kasutaja kontekstil põhinevaid parameetreid.

• Variable:
  • Definitsioon: SQL-päringus kasutatava muutuja nimi (ilma märgita @).
  • Võimalik väärtus: märgistring.
• AttributUserConnected:
  • Definitsioon: määrab, kas parameeter määratakse praeguse kasutaja konteksti alusel või tuleb see liideses käsitsi sisestada.
  • Võimalik väärtus:
    • True: kasutajakontekst
    • False: käsitsi sisestamine
• AttributeCode:
  • Definitsioon: PSA-atribuudi kood.
  • Võimalik väärtus: PSA-koodile vastav märgistring.