1.4 Plik definicji odbiorców

Typowo plik danych (patrz rozdział 1.3) zawiera informacje na poziomie indywidualnym, raporty zaś generowane są w podziale na pewne podzbiorowości (np. wydziały, kierunki, lata studiów, itp.). Plik definicji odbiorców przechowuje wszystkie dane niezbędne do:

• wygenerowania raportów dla poszczególnych podzbiorowości, a niezawarte w pliku danych (np. nazwę wydziału czy kierunku, itp.);
• odfiltrowania w pliku danych tylko tych rekordów, które należą do danej podzbiorowości (np. identyfikator wydziału czy kierunku używany w pliku danych).

Uwaga! Przy automatycznym generowaniu raportów dla wielu odbiorców (patrz rozdział 1.6) pierwsza zmienna (kolumna) w pliku odbiorców zostanie użyta jako nazwy plików dla generowanych raportów.

Formaty danych

Obsługiwane są dokładnie takie same formaty danych, jak w wypadku pliku danych (patrz rozdział 1.3), obowiązują również te same ograniczenia nazw zmiennych (patrz rozdział 1.3).

Wczytywanie pliku danych odbiorcy w szablonie raportu

Najłatwiejszym sposobem wczytania danych konkretnego odbiorcy w szablonie raportu (patrz rozdział 1.5) jest wywołanie w umieszczonej na samym początku szablonu raportu wstawce R funkcji wczytajOdbiorce(), np.:

---
title: "Mój raport"
output:
  pdf_document
---
```{r}
library(MLAK)
wczytajOdbiorce(‘mójPlikOdbiorcow.csv’, ‘mójPlikDanych.csv’)
```

W ten sposób utworzone zostaną zmienne o nazwach identycznych, jak nazwy zmiennych (kolumn) w pliku definicji odbiorców i wartościach takich, jak wartości dla pierwszego odbiorcy zdefiniowanego w pliku.

Istnieje również możliwość wczytania danych dowolnego odbiorcy – w takim wypadku należy skorzystać z opcjonalnego trzeciego argumentu funkcji wczytajOdbiorce(), w którym przekazać można numer odbiorcy do załadowania. Np. chcąc wczytać 5 odbiorcę z pliku:

---
title: "Mój raport"
output:
  pdf_document
---
```{r}
library(MLAK)
wczytajOdbiorce(‘mójPlikOdbiorcow.csv’, ‘mójPlikDanych.csv’, 5)
```

Wyświetlanie w raporcie wartości z pliku definicji odbiorców

Umieszczenie w raporcie personalizowanych danych odbiorców przechowywanych w zmiennych (kolumnach) pliku definicji odbiorców możliwe jest poprzez użycie w szablonie raportu (patrz rozdział 1.5) tzw. wstawek R. Wstawka taka ma postać r nazwaZmiennejZplikuDefinicjiOdbiorców. Np. chcąc uzyskać nagłówek raportu parametryzowany celownikiem nazwy odbiorcy i dysponując plikiem definicji odbiorców postaci:

NazwaOdbiorcy	IdOdbiorcy	NazwaOdbiorcyCel

odbiorca X |          1 |       odbiorcy X
odbiorca Y |          2 |       odbiorcy Y

szablon raportu powinien wyglądać następująco:

---
title: "Mój raport"
output:
  pdf_document
---
```{r}
library(MLAK)
wczytajOdbiorce(‘mójPlikOdbiorcow.csv’, ‘mójPlikDanych.csv’, 5)
```
# Raport dla odbiorcy `r NazwaOdbiorcyCel`

Dalsza część raportu…

Uwaga! Aby odwoływanie się do zmiennych z pliku definicji odbiorców działało w opisany powyżej sposób szablon raportu musi rozpoczynać się od wstawki R, która wywołuje funkcję wczytajOdbiorce(), tak jak w przykładzie powyżej i jak opisano powyżej w punkcie wczytywanie pliku danych odbiorcy w szablonie raportu.