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, 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. W widoku Paleta wybierz element Ikona Plik włączany Plik włączany i przeciągnij go 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 użyć właściwości Aktualizuj pola 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. W widoku Paleta wybierz element Ikona Plik włączany Plik włączany i przeciągnij go 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