Conoscere i grafici: rappresentazione del grafico e dei dati sottostanti

Data di pubblicazione: gennaio 2017

Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

I grafici mostrano visivamente i dati mappando i valori testuali su due assi: orizzontale (x) e verticale (y). In Microsoft Dynamics 365, l'asse x viene chiamata asse delle categorie, mentre l'asse y viene chiamata asse delle serie. Nell'asse delle categorie è possibile visualizzare valori numerici e non numerici mentre nell'asse delle serie vengono visualizzati solo valori numerici.

I grafici in Microsoft Dynamics 365 possono essere ulteriormente classificati nel modo seguente:

• Grafici con una serie: sono i grafici che visualizzano i dati con un valore di serie (y) mappato a un valore di categoria (x).

• Grafici con più serie: sono i grafici che visualizzano i dati con più valori di serie mappati a un valore di categoria singolo. Nei grafici con più serie sono inclusi gli istogrammi in pila, che visualizzano verticalmente il contributo di ogni serie al totale nelle categorie e gli istogrammi in pila 100% che confrontano la percentuale in cui contribuisce ogni serie nel totale all'interno delle categorie. È possibile combinare diversi tipi di grafico compatibili in grafici con più serie, ad esempio, le colonne e le righe, le barre e le righe e così via.

Mentre si crea un grafico in Microsoft Dynamics 365 utilizzando SDK, è necessario prendere in considerazione i seguenti due aspetti importanti:

• Dati sottostanti per il grafico: specificati con la stringa XML di descrizione dati.

• Rappresentazione dei dati (aspetto): specificati con la stringa XML descrizione presentazione.

Utilizzare la stringa XML di descrizione dei dati per specificare i dati del grafico

La stringa XML di descrizione dei dati definisce i dati che verranno visualizzati nel grafico. Il contenuto della stringa di XML viene convalidato nello schema di descrizione dei dati di visualizzazione. Per ulteriori informazioni sullo schema, vedere Visualization data description schema.

È possibile specificare la stringa XML di descrizione dei dati mentre si crea un grafico mediante l'attributo SavedQueryVisualization.DataDescription o UserQueryVisualization.DataDescription per il grafico di proprietà dell'organizzazione o dell'utente rispettivamente.

La stringa XML di descrizione dei dati contiene i due elementi seguenti: <FetchCollection> e <CategoryCollection>.

L'elemento <FetchCollection>

L'elemento <FetchCollection> utilizza FetchXML per recuperare i dati per il grafico. La query FetchXML specifica le informazioni sugli attributi di entità, le funzioni di aggregazione e il gruppo per clausole per i dati da visualizzare in un grafico. Tutte le funzionalità di aggregazione FetchXML sono supportate per i grafici. Per ulteriori informazioni sulle funzioni di aggregazione FetchXML, vedere Utilizzare l'aggregazione FetchXML.

La query FetchXML consente di filtrare i dati. Inoltre, i filtri vengono applicati ai grafici tramite le visualizzazioni. Se dunque una condizione di filtro viene già specificata nella query FetchXML nell'elemento <FetchCollection> e inoltre viene applicato un filtro tramite una visualizzazione, nel grafico verranno visualizzati i dati che vengono restituiti dopo aver applicato tutti i filtri. Per ulteriori informazioni su come utilizzare la query FetchXML per filtrare i dati, vedere Creare query con FetchXML.

Se il grafico è un grafico di confronto, l'elemento <FetchCollection> conterrà due clausole di raggruppamento.

L'elemento <CategoryCollection>

L'elemento <CategoryCollection> contiene informazioni sull'asse della categoria (orizzontale) e delle serie (verticale) in un grafico.

• Ogni sottoelemento <Category> dispone di un elemento figlio denominato <MeasureCollection> mappato all'elemento <Series> nell'XML di descrizione della presentazione. Un singolo grafico di serie dispone di un elemento figlio <MeasureCollection> singolo mentre un grafico con più serie disporrà di più elementi figlio <MeasureCollection>, ognuno mappato all'elemento <Series> rispettivo nell'XML di descrizione della presentazione.

• Ogni elemento figlio <MeasureCollection> dispone di un elemento chiamato <Measure> corrispondente al valore dell'asse delle serie (verticale) che corrisponde a sua volta a ogni valore nell'asse delle categorie (orizzontale).

Esempio

Viene di seguito riportata una stringa XML di descrizione dei dati di esempio:

<datadefinition>
  <fetchcollection>
    <fetch mapping="logical" count="10">
      <entity name="opportunity">
        <attribute name="estimatedvalue" />
        <order attribute="estimatedvalue" descending="true" />
      </entity>
    </fetch>
  </fetchcollection>
  <categorycollection>
    <category>
      <measurecollection>
        <measure alias="estimatedvalue" />
      </measurecollection>
    </category>
  </categorycollection></datadefinition>

Per altre stringhe XML di descrizione dei dati di esempio, vedere Grafici di esempio.

Utilizzare la stringa XML di descrizione della presentazione per specificare la rappresentazione dei dati

La stringa XML di descrizione della presentazione contiene informazioni sull'aspetto del grafico ad esempio il titolo del grafico, il colore e il tipo di grafico (a barre, istogramma, a linee, e così via). Non esiste una definizione di schema per questa stringa XML. Tuttavia, XML è una serializzazione della classe Grafico in Microsoft Chart Controls.Ulteriori informazioni:Controlli Chart

È possibile specificare la stringa XML di descrizione della presentazione mentre si crea un grafico mediante l'attributo SavedQueryVisualization.PresentationDescription o UserQueryVisualization.PresentationDescription per il grafico di proprietà dell'organizzazione o dell'utente rispettivamente.

Esempio

Viene di seguito riportata una stringa XML di descrizione della presentazione di esempio:

<Chart Palette="BrightPastel">
  <Series>
    <Series _Template_="All" Color="153, 204, 255" BorderColor="164, 164, 164" BorderDashStyle="Solid" BorderWidth="1" ShadowColor="128, 128, 128, 128" ShadowOffset="1" IsValueShownAsLabel="true" Font="{0}, 6.75pt" BackGradientStyle="TopBottom" BackSecondaryColor="0, 102, 153" LabelForeColor="100, 100, 100" ChartType="Column">
      <SmartLabelStyle Enabled="True" />
      <Points />
    </Series>
  </Series>
  <ChartAreas>
    <ChartArea _Template_="All" BackColor="White" BorderColor="26, 59, 105" BorderWidth="0" BorderDashStyle="Solid">      <AxisY LineColor="204, 204, 204" TitleFont="{0}, 8pt, GdiCharSet=0" TitleForeColor="100, 100, 100" LabelAutoFitMaxFontSize="7" LabelAutoFitMinFontSize="7">
        <MajorTickMark LineColor="Gray" />
        <MajorGrid Enabled="false" />
        <LabelStyle Font="{0}, 6.75pt, GdiCharSet=0" ForeColor="100, 100, 100" />
      </AxisY>
      <AxisX LineColor="204, 204, 204" TitleFont="{0}, 8pt, GdiCharSet=0" TitleForeColor="100, 100, 100" LabelAutoFitMaxFontSize="7" LabelAutoFitMinFontSize="7">        <MajorTickMark LineColor="Gray" />        <MajorGrid Enabled="false" />
        <LabelStyle Font="{0}, 6.75pt, GdiCharSet=0" ForeColor="100, 100, 100" />
      </AxisX>
    </ChartArea>
  </ChartAreas>
  <Titles>
    <Title _Template_="All" Font="{0}, 9pt, style=Bold, GdiCharSet=0" ForeColor="100, 100, 100"></Title>
  </Titles>
  <BorderSkin PageColor="Control" BackColor="CornflowerBlue" BackSecondaryColor="CornflowerBlue" />
</Chart>

Per altre stringhe XML di descrizione della presentazione di esempio, vedere Grafici di esempio.

Vedere anche

Visualizzare dati con visualizzazioni (grafici)
Azioni su visualizzazioni (grafici)
Creare una visualizzazione (grafico)
Creare query con FetchXML
FetchXML schema
Visualization data description schema
Grafici di esempio
Classe di grafici (Microsoft Chart Controls)

Microsoft Dynamics 365

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright