# 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.