Panel Analytics en objetos visuales de Power BI

El panel Análisis permite agregar líneas de referencia dinámicas (como mínimo, máximo o promedio) a los objetos visuales. Estas líneas pueden ayudarle a acercar tendencias o conclusiones importantes. En este artículo se describe cómo crear objetos visuales de Power BI que pueden presentar y administrar líneas de referencia dinámicas en el panel Análisis.

Nota:

El panel Análisis está disponible en la versión 2.5.0 de la API. Para averiguar qué versión usa, compruebe apiVersion en el archivo pbiviz.json.

Administración del panel Analytics

La administración de propiedades en el panel Análisis es similar a la administración de propiedades en el panel Formato. Se define un objeto en el archivo capabilities.json del objeto visual.

En el panel Análisis, el objeto se define de la siguiente manera:

API 5.1+

En la definición del objeto, agregue solo el nombre del objeto, el nombre de propiedad y el tipo, como se explica aquí. Ejemplo:

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

API anteriores (antes de la versión 5.1)

1. En la definición del objeto, agregue displayName y un campo objectCategory con un valor de 2.

   Nota

   El campo objectCategory define el aspecto del objeto visual que controla el objeto (1 = formato, 2 = análisis). Formatting se usa para elementos como la apariencia, los colores, los ejes y las etiquetas. Analytics se usa para elementos como previsiones, líneas de referencia y formas.

   Si no se especifica el valor objectCategory, el valor predeterminado es Formatting.

2. Agregue las dos propiedades siguientes al objeto:

   • show de tipo bool con un valor predeterminado de true.
   • displayName de tipo text con un valor predeterminado de true.

{
  "objects": {
    "YourAnalyticsPropertiesCard": {
      "displayName": "Your analytics properties card's name",
      "objectCategory": 2,
      "properties": {
        "show": {
          "type": {
            "bool": true
          }
        },
        "displayName": {
          "type": {
            "text": true
          }
        },
      ... //any other properties for your Analytics card
      }
    }
  ...
  }
}

En la tarjeta de configuración de formato, especifique que esta tarjeta pertenece al panel de análisis estableciendo el set card analyticsPane parámetro en true. De forma predeterminada, el parámetro analyticsPane es falso y la tarjeta se agregará al panel de formato. Consulte las siguientes implementaciones:

Mediante utilidades FormattingModel

class YourAnalyticsCardSettings extends FormattingSettingsCard {
    show = new formattingSettings.ToggleSwitch({
        name: "show",
        displayName: undefined,
        value: false,
        topLevelToggle: true
    });

    displayNameProperty = new formattingSettings.TextInput({
        displayName: "displayName",
        name: "displayName",
        placeholder: "",
        value: "Analytics Instance",
    });

    name: string = "YourAnalyticsPropertiesCard";
    displayName: string = "Your analytics properties card's name";
    analyticsPane: boolean = true; // <===  Add and set analyticsPane variable to true 
    slices = [this.show, this.displayNameProperty];
}

Sin utilidades FormattingModel

      const show: powerbi.visuals.EnabledSlice = {
          uid: "enableAxisCard_topLevelToggle_show_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.ToggleSwitch,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "show"
                  },
                  value: false
              }
          }
      }
        
      const displayNameProperty: powerbi.visuals.FormattingSlice = {
          uid: "enableAxisCard_displayName_uid",
          suppressDisplayName: true,
          control: {
              type: powerbi.visuals.FormattingComponent.TextInput,
              properties: {
                  descriptor: {
                      objectName: "YourAnalyticsPropertiesCard",
                      propertyName: "displayName"
                  },
                  value: "Analytics Instance",
                  placeholder: ""
              }
          }
      }

      const averageLineCard: powerbi.visuals.FormattingCard = {
          displayName: "Your analytics properties card's name",
          uid: "yourAnalyticsCard_uid",
          analyticsPane: true, // <===  Add and set analyticsPane variable to true 
          topLevelToggle: show,
          groups: [{
              displayName: undefined,
              uid: "yourAnalyticsCard_group_uid",
              slices: [displayNameProperty],
          }]
      };

Defina otras propiedades de la misma manera que para los objetos Formato y enumere los objetos igual que en el panel Formato.

Nota

• Use el panel Analytics solo para los objetos que agreguen nueva información o proporcionen nuevas perspectivas sobre la información presentada (por ejemplo, líneas de referencia dinámicas que muestren tendencias importantes).
• Cualquier opción que controle la apariencia del objeto visual (es decir, el formato) debe limitarse en el panel Formato.

Consideraciones y limitaciones

• El panel Analytics aún no es compatible con varias instancias. El único selector que puede tener un objeto es static (es decir, selector: null) y los objetos visuales de Power BI no pueden tener varias instancias de una tarjeta definida por el usuario.
• Las propiedades del tipo integer no se muestran correctamente. Como solución alternativa, use el tipo numeric en su lugar.

Pasos siguientes

Adición de formato condicional