Udostępnij przez

Osadzanie podstawowego pulpitu nawigacyjnego

Na tej stronie przedstawiono sposób osadzania pulpitu nawigacyjnego jako elementu iframe w aplikacji zewnętrznej. Osoby przeglądające uzyskują dostęp do pulpitu nawigacyjnego przy użyciu poświadczeń usługi Azure Databricks.

Generowanie kodu osadzania

Aby wygenerować kod osadzania, który można wkleić do aplikacji zewnętrznych:

  1. Otwórz opublikowany pulpit nawigacyjny, który chcesz osadzić. Zobacz Wyświetlanie i organizowanie pulpitów nawigacyjnych , aby dowiedzieć się, jak wyświetlać pulpity nawigacyjne i uzyskiwać do ich dostępu w obszarze roboczym.

  2. Kliknij pozycję Udostępnij w prawym górnym rogu.

  3. Kliknij pozycję Osadź pulpit nawigacyjny w oknie dialogowym Udostępnianie .

  4. Zostanie otwarte okno dialogowe Kopiowanie kodu osadzania . Jeśli istnieje lista dozwolonych domen osadzania, zostaną wyświetlone domeny. Kliknij przycisk Kopiuj, aby skopiować fragment kodu.

    Okno dialogowe Kopiowanie kodu osadzania pokazuje wygenerowany kod iframe i domeny, w których można osadzać opublikowane pulpity nawigacyjne.

  5. Wstaw kod osadzania do dowolnej platformy lub aplikacji obsługującej osadzanie HTML i może renderować zawartość elementu iframe. Zobacz Przykłady.

Uwaga / Notatka

Przykłady

Poniższe przykłady obejmują szczegółowe wskazówki dotyczące osadzania pulpitów nawigacyjnych w aplikacji. Każdy zestaw instrukcji zakłada, że kod osadzania został już skopiowany w poprzedniej sekcji.

Osadzanie w aplikacji Confluence

Wygenerowany kod osadzania wymaga niewielkiego dostosowania w celu spełnienia wymagań platformy Confluence. Aby osadzić pulpit nawigacyjny na stronie Confluence, wykonaj następujące kroki:

  1. Edytuj kod osadzania, aby uwzględnić tylko wygenerowany adres URL, a nie tagi elementu iframe lub dodatkowe wartości znaczników.

    Przed rozpoczęciem edycji kod osadzania zawiera tag HTML elementu iframe, link do pulpitu nawigacyjnego, aby użyć źródła w elemecie iframe oraz dodatkowe specyfikacje dotyczące wysokości, szerokości i obramowania, jak pokazano w poniższym fragmencie kodu. W przypadku pulpitu nawigacyjnego przykładowe symbole <databricks-instance-name> zastępcze i <dashboard-and-workspace-ID> zawierają rzeczywiste wartości skojarzone z obszarem roboczym i pulpitem nawigacyjnym. Są one następujące:

    • Jest <databricks-instance-name> to pierwsza część adresu URL podczas logowania się do obszaru roboczego. Zobacz Pobieranie identyfikatorów dla obiektów obszaru roboczego.
    • Jest <dashboard-and-workspace-ID> to ostatnia część adresu URL, która wskazuje pulpit nawigacyjny. Wygląda to następująco: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.
    <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>

    Edytuj ciąg, tak aby zawierał tylko tekst łącza, jak pokazano w poniższym przykładzie.

    https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>

  2. Wstaw element elementu iframe do strony. Aby dowiedzieć się, jak wstawić element iframe do strony, zobacz dokumentację platformy Confluence.

  3. Wklej edytowany adres URL osadzania w polu tekstowym adresu URL i ustaw szerokość na 100%.

  4. Dostosuj inne ustawienia zgodnie z preferencjami.

Pulpit nawigacyjny osadzony w wersji roboczej strony Confluence.

Osadzanie w usłudze Salesforce Knowledge

Aby osadzić pulpit nawigacyjny na stronie wiedzy usługi Salesforce, wykonaj następujące kroki:

  1. Utwórz stronę usługi Visualforce. Aby uzyskać instrukcje, zobacz dokumentację usługi Salesforce.

  2. Na ekranie Edycja strony przenieś kursor do edytora znaczników visualforce .

  3. Wklej kod osadzania skopiowany między dwoma <apex:page></apex:page> tagami.

  4. Dodaj dwa tagi akapitu (<p></p>) wokół kodu osadzania.

    W poniższym przykładzie użyto symbolu zastępczego <dashboard-embed-code> , aby zademonstrować wygląd znaczników usługi Visualforce. Twoje wystąpienie powinno zawierać skopiowany pełny kod osadzania.

    <apex:page >
<p><dashboard-embed-code></p>
</apex:page>

  5. Kliknij przycisk Zapisz , aby zapisać zmiany.

  6. Kliknij pozycję Podgląd i potwierdź, że pulpit nawigacyjny jest renderowany.

  7. Skopiuj adres URL podglądu składnika i utwórz nowy składnik elementu iframe. Powinien on wyglądać podobnie do poniższego fragmentu kodu. Symbol zastępczy <your-salesforce-domain> powinien zostać zastąpiony domeną usługi Salesforce.

    <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>

  8. Przejdź do strony Wiedza, na której chcesz osadzić pulpit nawigacyjny.

  9. Kliknij pozycję Edytuj > dodaj składnik multimedialny.

  10. Wklej kod elementu iframe z poprzedniego kroku w polu Tekst osadzania .

Osadzanie w programie SharePoint

Aby osadzić pulpit nawigacyjny w programie SharePoint, może być konieczne dodanie adresu URL usługi Azure Databricks do listy dozwolonych witryn dla osadzonej zawartości w programie SharePoint. Aby uzyskać instrukcje, zobacz dokumentację firmy Microsoft. Następnie wykonaj następujące kroki:

  1. Przejdź do strony programu SharePoint, na której chcesz hostować osadzony pulpit nawigacyjny.
  2. Dodaj element Embed do strony.
  3. Wklej pełny kod osadzania w polu Adres witryny internetowej lub kod osadzania po prawej stronie ekranu.
  4. Kliknij, aby potwierdzić.

Pulpit nawigacyjny osadzony na roboczej stronie programu SharePoint

Osadzanie pojedynczego widżetu

Aby osadzić pojedynczy widżet z pulpitu nawigacyjnego, potrzebny jest kod osadzania pulpitu nawigacyjnego i unikatowy identyfikator widżetu, który chcesz wyświetlić.

Kopiowanie unikatowego identyfikatora

Identyfikator pojedynczego widżetu jest kombinacją wartości strony name i wartości widżetu name rozdzielanej tyldą (~).

Uwaga / Notatka

Klucz name jest wyświetlany w serializowanym pliku, który definiuje pulpit nawigacyjny i nie jest dostępny z poziomu interfejsu użytkownika usługi Azure Databricks. Jest ona oddzielona od displayName wartości, która definiuje nazwę strony wyświetlaną w interfejsie użytkownika. Zobacz Edytowanie pliku pulpitu nawigacyjnego.

Aby skopiować unikatowy identyfikator:

  1. Otwórz opublikowany pulpit nawigacyjny w obszarze roboczym usługi Azure Databricks.

  2. Kliknij ikonę menu Kebab. menu kebab dla widżetu, który chcesz osadzić.

  3. Kliknij pozycję Wyświetl pełny ekran lub Kopiuj link do widżetu. Adres URL zawiera odpowiednie wartości strony i widżetu name .

  4. Skopiuj parametr fullscreenWidget wyszukiwania i wszystko po znaku równości (=).

    Poniższy przykład przedstawia ostatnią część adresu URL dla widżetu pełnoekranowego:

    fullscreenWidget=53eadf26~3490f286

Dostosowywanie wygenerowanego kodu osadzania

  1. Zobacz Generowanie kodu osadzania , aby znaleźć kroki generowania kodu osadzania pulpitu nawigacyjnego.
  2. Dodaj &fullscreenWidget=<ID> do adresu URL osadzania, zastępując ciąg <ID> wartością połączoną <page-name>~<widget-name> .

Jeśli na przykład podstawowy adres URL osadzania jest następujący:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

Zaktualizowany adres URL osadzania z unikatowym identyfikatorem powinien wyglądać następująco:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

Wyświetlanie osadzonego pulpitu nawigacyjnego

Osadzone pulpity nawigacyjne oferują bezpieczny sposób uzyskiwania dostępu do danych pulpitu nawigacyjnego poza usługą Azure Databricks. Wszystkie istniejące ustawienia udostępniania mają zastosowanie. Osoby przeglądające muszą mieć dostęp do pulpitu nawigacyjnego. Zobacz Kto może uzyskać dostęp do pulpitu nawigacyjnego?. Podczas uzyskiwania dostępu do osadzonego pulpitu nawigacyjnego osoby przeglądające są monitowane o zalogowanie się do usługi Azure Databricks, chyba że mają aktywną sesję z ostatniego logowania do tego samego obszaru roboczego.

Aby wyświetlić osadzony pulpit nawigacyjny:

  • Przejdź do strony, na której został osadzony pulpit nawigacyjny.
  • W razie potrzeby zaloguj się przy użyciu poświadczeń usługi Azure Databricks.

Zapytaj Genie w osadzonych pulpitach nawigacyjnych

Podczas wyświetlania osadzonego pulpitu nawigacyjnego, który został opublikowany ze skojarzoną przestrzenią Genie, osoby przeglądające mogą uzyskać dostęp do przycisku Ask Genie, aby eksplorować dane za pomocą pytań w języku naturalnym.

Aby użyć usługi Genie na osadzonym pulpicie nawigacyjnym:

  1. Przejdź do osadzonej strony pulpitu nawigacyjnego.
  2. W razie potrzeby zaloguj się przy użyciu poświadczeń usługi Databricks.
  3. Kliknij pozycję Zapytaj Genie w interfejsie pulpitu nawigacyjnego.
  4. Wpisz pytania dotyczące języka naturalnego dotyczące danych pulpitu nawigacyjnego.

Usługa Genie używa tych samych uprawnień i dostępu do danych co opublikowany pulpit nawigacyjny. Aby uzyskać więcej informacji na temat konfigurowania i używania usługi Genie z pulpitami nawigacyjnymi, zobacz Genie spaces with dashboards (Miejsca genie z pulpitami nawigacyjnymi ).

Przykładowy ekran logowania z osadzonego pulpitu nawigacyjnego

Uwaga / Notatka

Jeśli zarejestrowany użytkownik, któremu nie udzielono dostępu do pulpitu nawigacyjnego, spróbuje go wyświetlić, zostanie wyświetlony błąd informujący, że pulpit nawigacyjny jest niedostępny. Zobacz Udostępnianie opublikowanego pulpitu nawigacyjnego , aby dowiedzieć się, jak dostosować ustawienia udostępniania.

Odświeżanie osadzonego pulpitu nawigacyjnego

Wszyscy użytkownicy osadzonego pulpitu nawigacyjnego mogą ręcznie odświeżać pulpity nawigacyjne na żądanie. Możesz również okresowo konfigurować harmonogram odświeżania pulpitów nawigacyjnych.

Zobacz Zarządzanie zaplanowanymi aktualizacjami pulpitu nawigacyjnego i subskrypcjami.

Rozwiązywanie problemów z osadzonymi pulpitami nawigacyjnymi

Aby zapoznać się z typowymi problemami i rozwiązaniami podczas pracy z osadzonymi pulpitami nawigacyjnymi, w tym z problemami z wyświetlaniem motywu i pustymi iframe, zobacz Rozwiązywanie problemów z osadzonymi pulpitami nawigacyjnymi.

Dalsze kroki

  • Last updated on