Descripción de gráficos: representación gráfico y datos subyacentes

Los gráficos presentan los datos visualmente asignando valores de texto en dos ejes: el horizontal (x) y el vertical (y). En Dynamics 365 for Customer Engagement, el eje x se denomina eje de categoría y el eje y se denomina eje de serie . El eje de categoría puede mostrar valores numéricos y no numéricos, mientras el eje de series solo muestra valores numéricos.

Los gráficos de Dynamics 365 for Customer Engagement se pueden clasificar en lo siguiente:

• Gráficos de una sola serie: gráficos que muestran datos con un valor (y) de serie asignado a un valor de categoría (x).

• Gráficos de varias series: gráficos que muestran datos con valores de varias series asignados a un valor de una categoría. Los gráficos de varias series incluyen gráficos de columnas apiladas, que muestran verticalmente la colaboración de cada serie a un total en las diferentes categorías, y gráficos de columna apiladas al 100%, que comparan el porcentaje que cada serie contribuye a un total en las diferentes categorías. Puede combinar varios tipos de gráficos compatibles en gráficos de varias series, por ejemplo, columna y línea, barra y línea, etc.

Al crear un gráfico en Dynamics 365 for Customer Engagement mediante el SDK, debe tener en cuenta los dos aspectos importantes siguientes:

• Datos subyacentes del gráfico: especificados mediante la cadena XML de descripción de los datos.

• Visualización de datos (apariencia): especificados mediante la cadena XML de la descripción de la visualización.

Use la cadena XML de descripción de datos para especificar datos del gráfico

La cadena XML de descripción de datos define los datos que se mostrarán en el gráfico. El contenido de la cadena XML se valida con el esquema de descripción de los datos de visualización. Para obtener más información acerca del esquema, consulte Esquema de descripción de los datos de visualización.

Puede especificar la cadena XML de descripción de datos mientras crea un gráfico mediante el SavedQueryVisualization.DataDescription atributo o el UserQueryVisualization.DataDescription para el gráfico propiedad de la organización o del usuario, respectivamente.

La cadena XML de descripción de datos contiene los siguientes dos elementos: <FetchCollection> y <CategoryCollection>.

El elemento <FetchCollection>

El elemento <FetchCollection> usa FetchXML para recuperar los datos para el gráfico. La consulta FetchXML especifica información sobre los atributos de entidad, las funciones de agregado y de las cláusulas de agrupación de los datos para mostrar en un gráfico. Todas las funciones agregadas FetchXML son compatibles con los gráficos. Para obtener más información acerca de las funciones de agregado de FetchXML, vea Usar la agregación de FetchXML.

La consulta de FetchXML permite filtrar los datos. Además, los filtros se aplican en gráficos a través de vistas. Por lo tanto, si ya se ha especificado una condición de filtrado en la consulta de FetchXML en el elemento <FetchCollection> y además se aplica un filtro a través de una vista, el gráfico mostrará los datos que se devuelven después de aplicar todos los filtros. Para obtener más información acerca de cómo usar la consulta FetchXML para filtrar datos, vea Crear consultas con FetchXML.

Si el gráfico es un cuadro comparativo, el <FetchCollection> elemento contendrá dos cláusulas group by .

El elemento <CategoryCollection>

El elemento <CategoryCollection> contiene información acerca de los ejes de categoría (horizontal) y de series (vertical) de un gráfico.

• Cada subelemento de <Category> tiene un elemento secundario llamado <MeasureCollection> que se asigna al elemento <Series> en el XML de descripción de la presentación. Un único gráfico de serie dispone de un solo elemento secundario <MeasureCollection>, mientras que un gráfico de varias series tendrá varios elementos secundarios <MeasureCollection>, cada uno asignado al elemento <Series> correspondiente en el XML de descripción de la presentación.

• Cada elemento secundario de <MeasureCollection> tiene un elemento denominado <Measure> que se corresponde al valor del eje de serie (vertical), correspondiente a cada valor del eje de categorías (horizontal).

Ejemplo

A continuación se facilita una cadena XML de descripción de datos de ejemplo:

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

Para obtener más cadenas XML de descripción de los datos de ejemplo, consulte Gráficos de muestra.

Use la cadena XML de descripción de presentación para especificar la representación de datos

La cadena XML de la descripción de la presentación contiene información acerca de la apariencia del gráfico, como el título del gráfico, el color del gráfico, el tipo de gráfico (barra, columna, línea, etc.). No hay ninguna definición de esquema para esta cadena XML. Sin embargo, XML es una serialización de la clase Gráfico en Controles de gráfico de Microsoft. Más información: Controles de gráfico

Puede especificar la cadena XML de descripción de la presentación mientras crea un gráfico mediante el atributo SavedQueryVisualization.PresentationDescription o UserQueryVisualization.PresentationDescription para el gráfico propiedad de la organización o del usuario, respectivamente.

Ejemplo

A continuación se muestra un ejemplo de cadena XML de descripción de presentación:

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

Para obtener más cadenas XML de descripción de los datos de ejemplo, consulte Gráficos de muestra.

Consulte también

Visualizaciones (gráficos)
Acciones en visualizaciones (gráficos)
Crear un gráfico
Creación de consultas con FetchXML
Obtener esquema XML
Esquema de descripción de los datos de visualización
Gráficos de ejemplo
Clase de gráfico (controles de gráficos de Microsoft)