Dodawanie elementu pliku włączanego

Element pliku włączanego w szablonie umożliwia przyłączenie plików zewnętrznych lub utworzenie połączenia z nimi z poziomu raportu.

O tym zadaniu

Możliwe jest utworzenie odsyłacza do pliku lub fizyczne osadzenie go w dokumencie wyjściowym. Sposób obsługi elementów pliku włączanego zależy jednak od formatu wyjściowego oraz od miejsca, z którego plik jest pobierany.

Fizyczne osadzanie plików

O tym zadaniu

W przypadku wybierania plików z miejsca lokalnego lub zdalnego:
  • W przypadku dokumentów wyjściowych w formacie Wcześniejszy PDF, HTML i XSL-FO pliki włączane są zawsze odsyłaczami hipertekstowymi.
  • W przypadku dokumentów wyjściowych w formacie PDF plik włączany jest importowany i wyświetlana jest pełna treść dokumentu.
  • W przypadku danych wyjściowych programu Microsoft Word produkt Rational Publishing Engine automatycznie aktualizuje pola programu Microsoft Word podczas generowania dokumentów. Jeśli pole INCLUDE TEXT zostało wygenerowane, makro nie zostanie uruchomione, a zadanie importowania pliku zostanie delegowane na program Microsoft Word. Plik włączany nie jest widoczny w dokumencie wyjściowym, dopóki wszystkie pola nie zostaną zaktualizowane. Aby zaktualizować pola, należy skorzystać z opcji aktualizacji pól programu Microsoft Word lub użyć makr zawartych w arkuszu stylów %RPE_HOME%\utils\word\rpe.dot.
    Wskazówka: Dokument programu Microsoft Word połączony z innymi plikami nie jest autonomiczny. Przeniesienie dokumentu na inny komputer uniemożliwi wizualizację treści dołączonych dokumentów. Jeśli wymagana jest wizualizacja, w programie Microsoft Word należy użyć opcji Przerwij łącza, która jest wywoływana przez naciśnięcie kombinacji klawiszy Alt+E+K w pakiecie Microsoft Office 2007, aby dołączyć treść połączonego pliku.
W przypadku wybierania plików z komponentu Centralne zarządzanie i ich fizycznego osadzania:
  • W przypadku dokumentów wyjściowych w formacie HTML i XSL-FO plik jest umieszczany w folderze ref, a w raporcie znajduje się odsyłacz do pliku.
  • W przypadku dokumentów wyjściowych w formacie programu Microsoft Word lub PDF plik jest importowany do raportu w swoim oryginalnym formacie.
  • W przypadku dokumentów wyjściowych w formacie Wcześniejszy PDF plik nie może być fizycznie osadzony. Wybierz inny typ dokumentu wyjściowego lub dynamiczne odwołanie do pliku.

Procedura

  1. Przeciągnij element Ikona Plik włączany Plik włączany do edytora treści szablonu. Zostanie otwarte okno Wybór pliku.
  2. Wybierz plik .doc, .docx, .txt lub .rtf do dołączenia:
    • W komponencie Centralne zarządzanie:
      1. Wybierz kartę Ładowanie z biblioteki.
      2. Rozwiń nazwę biblioteki.
      3. Wybierz plik.
    • Z miejsca lokalnego lub zdalnego:
      1. Wybierz kartę Otwieranie zasobu lokalnego lub zdalnego.
      2. Kliknij przycisk Przeglądaj.
      3. Wybierz plik.
    Wskazówka: Jeśli podczas wybierania pliku zwykle używana jest ta sama karta, należy wybrać opcję Stosuj domyślnie ten widok podczas pracy z plikami. Okno Wybór pliku będzie zawsze otwierane na tej karcie.
  3. Kliknij przycisk OK.
  4. W edytorze treści szablonu wybierz element pliku włączanego.
  5. W widoku Właściwości kliknij kartę Konkretne.
  6. W polu Typ dołączania wybierz wartość Osadzanie fizyczne, aby zaimportować dokument do raportu podczas generowania dokumentu.
  7. Opcjonalne: W polu Komenda wpisz komendę, która ma zostać wykonana podczas generowania dokumentu.
  8. Kliknij ikonę Zapisz, aby zapisać zmiany.

Dynamiczne przywoływanie plików

Zanim rozpoczniesz

Ważne: W następujących przypadkach zamiast dynamicznego przywoływania należy używać fizycznego osadzania:
  • Szablon lub fragment kodu zaprojektowano do wyodrębniania informacji ze źródła danych.
  • Szablon lub fragment kodu zawiera odwołanie dynamiczne.

O tym zadaniu

W przypadku wybierania plików i ich dynamicznego przywoływania:
  • W przypadku dokumentów wyjściowych w formacie HTML, XSL-FO, PDF i Wcześniejszy PDF tworzony jest odsyłacz do pliku w komponencie Centralne zarządzanie. Po kliknięciu odsyłacza w raporcie użytkownik musi przeprowadzić uwierzytelnianie w komponencie Centralne zarządzanie.
  • W przypadku danych wyjściowych programu Microsoft Word produkt Rational Publishing Engine automatycznie aktualizuje pola programu Microsoft Word podczas generowania dokumentów. Jeśli pole INCLUDE TEXT zostało wygenerowane, makro nie zostanie uruchomione, a zadanie importowania pliku zostanie delegowane na program Microsoft Word. Plik włączany nie jest widoczny w dokumencie wyjściowym, dopóki wszystkie pola nie zostaną zaktualizowane. Aby zaktualizować pola, należy skorzystać z właściwości Aktualizacja pól w specyfikacji dokumentu, opcji aktualizacji pól programu Microsoft Word lub makr zawartych w arkuszu stylów %RPE_HOME%\utils\word\rpe.dot.
    Ważne:
    • Właściwości Aktualizuj pola nie należy używać podczas generowania wyjątkowo dużych dokumentów. Ustawienie tej właściwości może uniemożliwić generowanie dużych dokumentów i powodować występowanie błędów braku pamięci.
    • W przypadku przywoływania dokumentów znajdujących się w położeniu zabezpieczonym nie należy uruchamiać makra w celu zaktualizowania pól. Proces uwierzytelniania nie będzie mógł zostać zakończony i spowoduje zawieszenie makra.

Procedura

  1. Przeciągnij element Ikona Plik włączany Plik włączany do edytora treści szablonu. Zostanie otwarte okno Wybór pliku.
  2. Wybierz plik .doc, .docx, .txt lub .rtf do dołączenia:
    • W komponencie Centralne zarządzanie:
      1. Wybierz kartę Ładowanie z biblioteki.
      2. Rozwiń nazwę biblioteki.
      3. Wybierz plik.
    • Z miejsca lokalnego lub zdalnego:
      1. Wybierz kartę Otwieranie zasobu lokalnego lub zdalnego.
      2. Kliknij przycisk Przeglądaj.
      3. Wybierz plik.
    Wskazówka: Jeśli podczas wybierania pliku zwykle używana jest ta sama karta, należy wybrać opcję Stosuj domyślnie ten widok podczas pracy z plikami. Okno Wybór pliku będzie zawsze otwierane na tej karcie.
  3. Kliknij przycisk OK.
  4. W edytorze treści szablonu wybierz element pliku włączanego.
  5. W widoku Właściwości kliknij kartę Konkretne.
  6. W polu Typ dołączania wybierz wartość Odsyłacz dynamiczny, aby utworzyć odsyłacz do dokumentu w jego bieżącym położeniu.
  7. Opcjonalne: W polu Komenda wpisz komendę, która ma zostać wykonana podczas generowania dokumentu.
  8. Kliknij ikonę Zapisz, aby zapisać zmiany.

Opinia