Używanie wizualizatora błędów rysunku usługi Azure Mapy z twórcą

  • Artykuł

Wizualizator błędów rysunku to autonomiczna aplikacja internetowa, która wyświetla ostrzeżenia i błędy pakietu rysunku wykryte podczas procesu konwersji. Aplikacja internetowa wizualizatora błędów składa się ze statycznej strony, której można użyć bez nawiązywania połączenia z Internetem. Możesz użyć wizualizatora błędów, aby naprawić błędy i ostrzeżenia zgodnie z wymaganiami dotyczącymi pakietu rysunku. Interfejs API konwersji usługi Azure Mapy zwraca odpowiedź z linkiem do wizualizatora błędów tylko wtedy, gdy zostanie wykryty błąd.

Wymagania wstępne

W tym samouczku jest używana aplikacja Postman , ale możesz wybrać inne środowisko deweloperskie interfejsu API.

Pobierz

  1. Wykonaj kroki opisane w artykule How to create data registry (Jak utworzyć rejestr danych), aby przekazać pakiet rysunkowy na konto usługi Azure Storage, a następnie zarejestrować go na koncie usługi Azure Mapy.

    Ważne

    Pamiętaj, aby zanotować wartość unikatowego identyfikatora (udid), która będzie potrzebna. W udid ten sposób odwołujesz się do pakietu rysunkowego przekazanego na konto usługi Azure Storage z kodu źródłowego i żądań HTTP.

  2. Teraz, po przekazaniu pakietu rysunkowego, użyj udid polecenia dla przekazanego pakietu, aby przekonwertować pakiet na dane mapy. Aby uzyskać instrukcje dotyczące konwertowania pakietu, zobacz Konwertowanie pakietu rysunkowego.

    Uwaga

    Jeśli proces konwersji zakończy się pomyślnie, nie otrzymasz linku do narzędzia Wizualizator błędów.

  3. Na karcie Nagłówki odpowiedzi w aplikacji Postman wyszukaj diagnosticPackageLocation właściwość zwróconą przez interfejs API konwersji. Odpowiedź powinna wyglądać podobnie do następującego kodu JSON:

    {
    "operationId": "77dc9262-d3b8-4e32-b65d-74d785b53504",
    "created": "2020-04-22T19:39:54.9518496+00:00",
    "status": "Failed",
    "properties": {
        "diagnosticPackageLocation": "https://us.atlas.microsoft.com/mapData/ce61c3c1-faa8-75b7-349f-d863f6523748?api-version=2.0"
    }
}

  4. Pobierz wizualizator błędów pakietu rysunkowego, wysyłając HTTP-GET żądanie w adresie diagnosticPackageLocation URL.

Konfiguracja

Pobrany spakowany pakiet z linku diagnosticPackageLocation zawiera następujące dwa pliki.

  • VisualizationTool.zip: zawiera kod źródłowy, nośnik i stronę internetową dla wizualizatora błędów rysunku.
  • ConversionWarningsAndErrors.json: zawiera sformatowaną listę ostrzeżeń, błędów i innych szczegółów używanych przez wizualizator błędów rysunku.

Rozpakuj folder VisualizationTool.zip . Zawiera on następujące elementy:

  • Folder zasobów: zawiera obrazy i pliki multimedialne
  • folder statyczny : kod źródłowy
  • plik index.html : aplikacja internetowa.

Otwórz plik index.html przy użyciu dowolnej z poniższych przeglądarek z odpowiednim numerem wersji. Możesz użyć innej wersji, jeśli wersja oferuje równie zgodne zachowanie jako wymienioną wersję.

  • Microsoft Edge 80
  • Safari 13
  • Chrome 80
  • Firefox 74

Korzystanie z narzędzia Wizualizator błędów rysunku

Po uruchomieniu narzędzia Wizualizator błędów rysunku zostanie wyświetlona strona przekazywania. Strona przekazywania zawiera pole przeciągania i upuszczania. Pole przeciągania i upuszczania działa również jako przycisk, który uruchamia okno dialogowe Eksplorator plików.

Drawing Error Visualizer App - Start Page

Plik ConversionWarningsAndErrors.json został umieszczony w katalogu głównym pobranego katalogu. Aby załadować plik ConversionWarningsAndErrors.json, przeciągnij i upuść plik w polu . Możesz też zaznaczyć pole, znaleźć plik w File Explorer dialoguepliku i przekazać go.

Drawing Error Visualizer App - Drag and drop to load data

Plik ConversionWarningsAndErrors.json zawiera listę błędów i ostrzeżeń pakietu rysunkowego. Aby wyświetlić szczegółowe informacje o błędzie lub ostrzeżeniu, wybierz link Szczegóły . Poniżej listy zostanie wyświetlona sekcja intractable. Teraz możesz przejść do każdego błędu, aby dowiedzieć się więcej na temat sposobu rozwiązywania błędu.

Drawing Error Visualizer App - Errors and Warnings

Następne kroki

Dowiedz się więcej, czytając:

Co to jest usługa Azure Mapy Creator?

Twórca map wnętrz