Udostępnij za pośrednictwem

Ukrywanie lub pokazywanie nagłówków wizualizacji

  • Artykuł

Raporty usługi Power BI osadzone w aplikacjach zawierają wizualizacje, takie jak wykresy, mapy cieplne i mierniki. Te wizualizacje mają nagłówki, które udostępniają użytkownikom akcje. W przypadku korzystania z usługi Power BI możesz ukryć lub pokazać nagłówek każdej wizualizacji w raporcie. Każda wizualizacja ma kartę w sekcji formatowania okienka Wizualizacje o nazwie nagłówek wizualizacji. Możesz użyć tej karty, aby włączyć i wyłączyć nagłówek wizualizacji. Dowiedz się więcej o nagłówkach wizualizacji w nagłówkach Visual.

Przykłady akcji w nagłówkach wizualizacji to:

  • Otwieranie wizualizacji w trybie koncentracji uwagi.
  • Przechodzenie do szczegółów lub w górę.
  • Wyświetlanie, które filtry i fragmentatory są obecnie stosowane do wizualizacji.
  • Otwieranie menu opcji wizualizacji.

Czasami warto ukryć te akcje. Jeśli na przykład dwie wizualizacje nakładają się na siebie, możesz nie chcieć wyświetlić nagłówków obu wizualizacji.

Ten interfejs API umożliwia ukrywanie lub pokazywanie nagłówków wszystkich wizualizacji w raporcie lub tylko określonych. Możesz skonfigurować widoczność ładowania raportu lub wywołać metodę Report updateSettings, aby zmienić widoczność po załadowaniu raportu, zobacz Aktualizowanie ustawień raportu w czasie wykonywania.

Interfejs API można używać w wielu scenariuszach, w tym w następujących przypadkach użycia:

  • Ukrywanie tylko niektórych nagłówków wizualizacji w raporcie.
  • Użyj logiki biznesowej w aplikacji, takiej jak kliknięcie przycisku, aby ukryć lub pokazać nagłówek po załadowaniu raportu.

Jak ukryć lub pokazać nagłówki wizualizacji

Aby ukryć lub pokazać nagłówki wizualizacji w interfejsie API, należy skonfigurować określone parametry w ustawieniach raportu. Aby uzyskać ogólne informacje na temat konfigurowania opcji w raportach osadzonych, zobacz Konfigurowanie ustawień raportu.

Ustawienia nagłówka wizualizacji

W przypadku nagłówków wizualizacji widoczność jest obecnie jedynym ustawieniem, które można skonfigurować. Aby ukryć lub wyświetlić nagłówki, należy podać listę obiektów konfiguracji nagłówka wizualizacji. Każdy z nich zawiera obiekt ustawień i może również zawierać selektor. selektory zidentyfikować wizualizacje, do których są stosowane ustawienia. Dowiedz się więcej o selektorach w selektorach .

Typ obiektu konfiguracji podanego w interfejsie API to IVisualSettings. W dalszej części tego artykułu znajdziesz przykłady, które pokazują, jak używać tego interfejsu w kodzie. modele usługi Power BI wyświetla listę wszystkich definicji interfejsu używanych przez przykłady.

Zwróć uwagę na następujące kwestie:

  • Selektor jest opcjonalny w tych ustawieniach. Jeśli nie wyświetlasz żadnych selektorów, interfejs API stosuje ustawienia do wszystkich wizualizacji w raporcie.
  • W przypadku używania selektorów można określić wizualizacje według nazwy lub typu. Aby uzyskać nazwy i typy wizualizacji na danej stronie, użyj metody Page getVisuals.

Reguły pierwszeństwa

Interfejs API stosuje ustawienia konfiguracji w następującej kolejności:

  • Ustawienia zapisane w raporcie.
  • Ustawienia zdefiniowane w obiekcie konfiguracji osadzania, które interfejs API stosuje podczas ładowania.
  • Ustawienia podane w interfejsie API updateSettings.

Jeśli do wizualizacji można zastosować więcej niż jedno ustawienie, interfejs API używa ostatniego ustawienia, które ma zastosowanie. W Ukryj wszystko, ale jeden nagłówek wizualizacji przykład w następnej sekcji ilustruje ten punkt.

Przykłady

W tych przykładach pokazano różne sposoby używania interfejsu API do ukrywania lub wyświetlania nagłówków wizualizacji.

Ukryj wszystkie nagłówki wizualizacji

Ten prosty scenariusz zapewnia klientom czysty widok raportu, ukrywając wszystkie nagłówki wizualizacji w raporcie:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Ukrywanie nagłówka określonej wizualizacji

W tym przykładzie użyto selektora, aby zastosować ustawienie widoczności do pojedynczej wizualizacji. Ten scenariusz pojawia się, gdy chcesz ukryć funkcje, które nie mają sensu dla wizualizacji. Użyj tego kodu w tym przypadku:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual>  // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Ukryj wszystkie, ale jeden nagłówek wizualizacji

Użyj tego kodu, aby ukryć wszystkie nagłówki wizualizacji w raporcie z wyjątkiem nagłówka określonej wizualizacji:

let embedConfig = {
    ...
    settings: {
        ...
        visualSettings: {
            visualHeaders: [
                {
                    settings: {
                        visible: false
                    }
                    /* No selector is listed. The API hides the headers of all the visuals in the report. */
                },
                {
                    settings: {
                        visible: true
                    },
                    selector: {
                        $schema: "http://powerbi.com/product/schema#visualSelector",
                        visualName: <The name of the visual> // You can retrieve the name by using getVisuals.
                    }
                }
            ]
        }
    }
};
...
let report = powerbi.embed(embedContainer, embedConfig);

Jeśli chcesz uwidocznić więcej niż jeden nagłówek, możesz rozszerzyć ten kod. Skonfiguruj dodatkowe wystąpienia IVisualHeader przy użyciu parametru visible w settings ustawionego na true. Dla każdej wizualizacji, która powinna mieć widoczny nagłówek, dodaj jedno wystąpienie IVisualHeader do listy.

Zagadnienia i ograniczenia

  • Widoczność nagłówków wizualizacji można kontrolować tylko wtedy, gdy osadzony raport jest w trybie wyświetlania.
  • Możesz ukryć lub pokazać tylko cały nagłówek wizualizacji. Nie można skonfigurować widoczności określonych elementów w menu nagłówka.
  • Jeśli używasz selektora do określenia nazwy lub typu wizualizacji, użyj metody Page getVisuals, aby uzyskać nazwę wizualizacji, która jest unikatowym identyfikatorem. Nie konfiguruj selektora z tytułem wizualizacji.
  • Jeśli użytkownik zapisze raport osadzony za pomocą interfejsu API, zdefiniowane ustawienia wizualne zostaną zapisane w raporcie. Można tego uniknąć, konfigurując raport z poziomem uprawnień View zamiast Edit lub Save.

Powiązana zawartość