Przejdź do treści

Podgląd plików

Sente S4

Co trzeba wiedzieć

  • Aby dać użytkownikowi możliwość podglądu pliku w systemie mamy zasadniczo dwie opcje:
  • Możemy plik przetransferować na jego komputer i użyć programu zarejestrowanego w systemie operacyjnym do jego otwarcia
  • Możemy osadzić w oknie naszej aplikacji kontrolkę przeglądarki i w niej pokazać zawartość pliku

Co trzeba skonfigurować

Przykłady

Przykład 1 - podgląd pliku

  1. Musimy znać lokalizację pliku na serwerze, czyli w jakim jest repozytorium i jaka jest jego względna ścieżka w tym repozytorium
  2. Transferujemy plik do klienta zwykle do lokalizacji tymczasowej
  3. Po udanym przesyle używamy API.ShellExecute aby otworzyć plik w systemie operacyjnym:
var filename = this.SCIEZKA_W_REPO;
var ti = API.CreateFileTransfer("PREZENTACJA", filename);
ti.Direction = TransferDirection.DownloadFromServer;
ti.OnError = (tinfo) => {
    API.ShowMessageBox(tinfo.Exception.Message, "Błąd");
};
ti.OnSuccess = (tinfo) => {
  API.ShellExecute(ti.LocalFile,"");//Otworzy plik w programie skojarzonym z danym rozszerzeniem
};
ti.StartAsync();

Przykład 2 - osadzenie podglądu pliku

  1. Musimy znać lokalizację pliku na serwerze, czyli w jakim jest repozytorium i jaka jest jego względna ścieżka w tym repozytorium
  2. Na formę neosową wyciągamy kontrolkę Webbrowser
  3. Dodajemy do niej metodę na url:
var filename = this.SCIEZKA_W_REPO;
var url = API.GetRepositoryFileUrl("PREZENTACJA", filename);
return url;

Uwaga!

Ze względów bezpieczeństwa linki zwracane przez GetRepositoryFileUrl domyślnie nie renderują plików HTML.

Aby umożliwić osadzenie pliku HTML, można ustawić tryb bezpieczeństwa (SecurityMode = "1").
W tym trybie zawartość HTML zostaje automatycznie oczyszczona z potencjalnie niebezpiecznego kodu (np. JavaScript).

    var url = API.GetRepositoryFileUrl("PREZENTACJA", filename, q => q[Constants.CSecurityMode] = "1");
Mechanizm obowiązuje również w kliencie desktop, aby zapewnić spójne i bezpieczne działanie w przypadku, gdyby link został użyty w kliencie web lub po prostu wyświetlony w kontekscie domeny serwera.

Wideo

https://www.youtube.com/watch?v=Z6_RFollyBM

Neos WEB

Co trzeba wiedzieć

  • Bardzo podobnie jak w S4, aby dać użytkownikowi możliwość podglądu pliku w systemie mamy zasadniczo dwie opcje:
  • Możemy pokazać plik w nowej karcie przeglądarki o ile umie ona go wyświetlić
  • Możemy osadzić w oknie naszej aplikacji kontrolkę przeglądarki i w niej pokazać zawartość pliku

Co trzeba skonfigurować

Przykłady

Przykład 1 - podgląd pliku

  1. Musimy znać lokalizację pliku na serwerze, czyli w jakim jest repozytorium i jaka jest jego względna ścieżka w tym repozytorium
  2. Używamy funkcji API aby wygenerować link pod którym znajduje się nasz dokument, a następnie wykonujemy tą samą funkcję ShellExecute:
var filename = this.SCIEZKA_W_REPO;
var url = API.GetRepositoryFileUrl("PREZENTACJA", filename);
API.ShellExecute(url,""); //otworzy plik w nowym oknie przeglądarki

Przykład 2 - osadzenie podglądu pliku

Jak przykład 2 dla S4

Wideo

https://www.youtube.com/watch?v=ZpWspRxhxeU