# bx:document

Mittels des Tags `document` kann in der Verwaltung ein Dokument zugeordnet werden. Als Ausgabe ist ein Downloadlink oder nur die URL zu diesem Dokument möglich.

Dieses Tag kann sich in der Verwaltung darstellen.

```xml
<bx:document.{titel} [type="(url | path | link | id | name | filename | size | description)"] [unit="(b | k | kb | m | mb | auto)"] [pattern=""] [locale=""] [disposition="attachment|inline|none"]/>
```

### url
Ausgabe der URL zum Dokument

### path
Ausgabe des Pfades zum Dokument

### link
Ausgabe als Link

### id
Ausgabe der Dokumenten-ID

### name
Ausgabe des Original-Dateiname

### filename
Ausgabe des Dateiname auf dem Server

### size
Ausgabe der Dokument-Größe

### description
Ausgabe der Description (Feld "Beschreibung" in der Dokumentenverwaltung)

### unit
**(nur bei size-Angabe)** Ausgabe in Byte (b), Kilobyte (kb oder k) oder Megabyte (mb oder m) bei auto: Angabe von pattern und locale möglich, Standard: `unit="b"`

### pattern
**(nur wenn bei size=auto angegeben wurde) **Ausgabemuster festlegen, Standard:` pattern="#,##0"`

### locale
**(nur wenn bei size=auto angegeben wurde) **Sprache festlegen, Standard:` locale="de_DE"`

### disposition
siehe Beispiel2

### Beispiele

**einfache Verwendung**

```xml
Bewerbungsunterlagen als PDF: <bx:document.Bewerbungsunterlagen/>
```
**Ausgabe innerhalb eines a-Tags**

```xml
<a href="<bx:document.Protokoll type="path"/>">
  <bx:document.Protokoll type="name"/> | Größe: <bx:document.Protokoll type="size" unit="auto" pattern="#,###0.00" locale="en"/>
</a>
```
Ausgabe mit Nachkommastellen in englischer Schreibweise (Tausendertrenner ist Komma, Dezimaltrenner ist Punkt)

### Beispiele attachment

```xml
<bx:recordfield.Dokument disposition="inline"/>

```
Ausgabe: `http://domain/files/{Batix-ID}/{Dateiname}`setzt content-disposition:inline; filename=“{Dateiname}“, wird als Standard genommen, wenn nichts angegeben wird

```xml
<bx:recordfield.Dokument disposition="attachment"/>
```
Ausgabe:`http://domain/files/download/{Batix-ID}/{Dateiname} `
bewirkt bei PDFs einen Zwangsdownload anstatt eine Anzeige im Browser-Plugin, dasselbe auch durch `http://domain/files/{Batix-ID}/{Dateiname}?dl=true`

```xml
<bx:recordfield.Dokument disposition="none"/>

```
Ausgabe: `http://domain/files/media/{Batix-ID}/{Dateiname}`bewirkt bei MP4-Videos, die in Apple-Mobilgeräten abgespielt werden sollen, daß das funktioniert, weil der Header nicht geschrieben wird (scheint nur Apple-Geräte zu betreffen)
Verweise auf diese Seite:

Keine Verweise gefunden.