Klonen eines visuellen Elements

Die Clone Visual API klont ein bestimmtes visuelles Element auf der aktiven Seite eines Power BI-Berichts. Sie können ein visuelles Element von einer beliebigen Seite im Bericht in die aktive Seite klonen. Durch das Klonen eines visuellen Elements können Sie Kopien mit unterschiedlichen Layouts oder Filtern aus dem ursprünglichen visuellen Element erstellen.

So klonen Sie ein visuelles Element

Der Power BI-Client VisualDescriptor Klasse definiert die clone-Methode wie:

clone(request: models.ICloneVisualRequest = {}): Promise<ICloneVisualResponse>

In der ICloneVisualRequest Schnittstelle:

  • IFilter- beschreibt die Filter, die auf das geklonte visuelle Element angewendet werden sollen.
  • IVisualLayout definiert die Größe und Position des geklonten visuellen Elements.
  • Die autoFocus-Eigenschaft bestimmt, ob sie sich nach der Erstellung auf das geklonte visuelle Element konzentrieren soll.

Die ICloneVisualResponse Schnittstelle gibt den neuen geklonten visuellen Namen oder eindeutigen Bezeichner zurück.

interface ICloneVisualRequest {
  // The filters to apply to the new visual. Default: source visual filters.
  filters?: IFilter[];

  // The layout to apply to the new visual.
  // Default: a best effort to put the new visual in an empty space on the canvas.
  layout?: IVisualLayout;

  // Focus on the new visual after creation.
  // If autoFocus is set to false, no scrolling will occur.
  // Default: true.
  autoFocus?: boolean;
}

interface ICloneVisualResponse {
  // New visual name.
  visualName: string;
}

Um eine Liste aller visuellen Elemente in einem Bericht abzurufen, verwenden Sie die getVisuals Methode der Page Klasse.

Beispiele

Im ersten Codebeispiel wird ein visuelles Element mit Standardeinstellungen geklont. Die Position und Größe des neuen visuellen Elements stellen einen optimalen Aufwand dar, um ein visuelles Element in einen leeren Bereich auf der Canvas zu setzen. Verwenden Sie das zweite Beispiel, um Position und Größe anzugeben.

    let clonedVisual = await visual.clone();
    console.log(clonedVisual.name);

Im zweiten Beispiel wird ein neues Visuelles mit einem bestimmten Layout geklont und sich nicht auf das neue visuelle Element nach der Erstellung konzentriert.

    let cloneRequest = {
        layout: { 
            height: 300, 
            width: 600,
            x: 150, 
            y: 250 
        },
        autoFocus: false
    };

    let clonedVisual = await visual.clone(cloneRequest);
    console.log(clonedVisual.name);

Im dritten Codebeispiel wird ein neues visuelles Element mit einem bestimmten Layout und neuen Filtern geklont.

    const basicFilter = {
      $schema: "http://powerbi.com/product/schema#basic",
      target: {
        table: "Store",
        column: "Count"
      },
      operator: "In",
      values: [1, 2, 3, 4],
      filterType: models.FilterType.BasicFilter
    };

    let cloneRequest = {
        layout: { x: 150, y: 250 },
        filters: [basicFilter]
    };

    let clonedVisual = await visual.clone(cloneRequest);
    console.log(clonedVisual.name);

Überlegungen und Einschränkungen

Sie können ein visuelles Element nur klonen, wenn der Bericht vollständig gerendert wird. Warten Sie also auf das ereignis rendered, bevor Sie die Clone Visual API aufrufen.

Verwandte Inhalte

  • Last updated on