petoffice Dokumentation

Dokumente erstellen

Dokumente erstellen

Teil der Stammdatenbank in petoffice ist die Möglichkeit, automatisch Dokumente zu erstellen. Hierfür sind einige Vorlagen bereits in petoffice enthalten, alle anderen kannst du selbst anlegen. Mit dieser Funktion kannst du automatisch VK-Bögen, Verträge, Chiplisten und viele weitere Dokumente direkt aus petoffice erstellen, ohne selbst irgendetwas ausfüllen zu müssen.

Eine Beschreibung zu allen Dokumenten, die mit der Vermittlung zu tun haben, findest du im Bereich "Tiervermittlung" dieses Handbuchs.

Was sind Vorlagen?

Dokumente werden in petoffice immer aus Vorlagen erstellt. Eine Vorlage gibt an, wie das Dokument aussieht und welche Daten von Mensch oder Tier an welcher Stelle angezeigt werden müssen. Als Administrator kannst du diese Vorlagen als Word-Dateien hinterlegen und zuordnen, ob es sich hierbei um ein Dokument für Personen, Tiere, Vermittlungen oder Transporte handelt. Nach der Anlage werden diese Vorlagen in den entsprechenden Profilseiten automatisch angezeigt, sodass jeder petoffice-Benutzer Dokumente daraus erstellen kann.

Dokumente erstellen

Du kannst in petoffice auf allen Profilseiten im Menü mit den drei Punkten (oben rechts), Dokumente aus Vorlagen erstellen. Dabei wird die entsprechende Vorlage z.B. mit den Daten des ausgewählten Tieres ergänzt. Anschließend wird dir das Dokument direkt zum Download angeboten.

Dokumente in petoffice erzeugen

Vorlagen anlegen und bearbeiten

In den Einstellungen im Bereich "Dokumentenvorlagen" sind bereits einige Dokumente vorab angelegt. Du kannst aber mit einem Klick auf "Neue Vorlage anlegen" auch deine eigenen Dokumente hinterlegen. Bitte beachte, dass alle Vorlagen die mit petoffice ausgeliefert werden für bestimmte Funktionen der Software benötigt werden und daher nicht gelöscht werden können.

Aus demselben Grund solltest du auch keine bestehenden Vorlagen umbenennen, um diese für einem anderen Zweck zu verwenden. Lege in diesem Fall einfach eine neue Vorlage an.

Vorlagen anpassen

Zum Bearbeiten der Vorlage für ein bestehendes Dokument klickst du auf eine Vorlage in den Einstellungen und kannst dir dann mit dem Link "Download" die bereits hinterlegte Vorlage herunterladen. Hierbei handelt es sich um eine docx-Datei, also ein Word-Dokument, was du mit Microsoft Word, aber auch mit freien Alternativen wie LibreOffice bearbeiten kannst. Wenn du mit der Bearbeitung fertig bist, kannst du die aktualisierte Vorlage wieder hochladen und speichern. Alle danach erstellten Dokumente benutzen dann die neue Vorlage.

Neue Vorlagen erstellen

Beim Anlegen einer neuen Vorlage kannst du auswählen, in welcher Domäne du diese Dokumente erzeugen willst. Zur Auswahl stehen hierbei:

  • Personen
  • Tiere
  • Vermittlungen
  • Transporte

Je nachdem, für welchen Domäne du eine Vorlage anlegst, hast du andere Platzhalter zur Verfügung, die im folgenden aufgelistet werden.

Außerdem kannst du nach dem Hinterlegen einer Word-Datei als Vorlage auswählen, ob das Dokument beim Erstellen wieder als Word-Datei (bearbeitbar) oder als PDF-Datei (nicht veränderbar) erstellt werden soll.

Platzhalter

Die Texte in geschweiften Klammern sind Platzhalter, die im Moment der Erstellung des Dokuments automatisch mit den jeweiligen Informationen des Tieres oder der Person ersetzt werden.

Steht also etwa in der Vorlage {{person.firstName}} {{person.lastName}} so wird daraus bei der Erstellung etwa “Max Mustermann”. Diese Funktion ist vergleichbar mit der Serienbrief-Funktion in gängigen Textverarbeitungs-Programmen.

Sie sind in Englisch formuliert und spiegeln die interne Datenstruktur in petoffice wieder. Somit steht jedes neu hinzugefügte Feld automatisch in allen Dokumenten zur Verfügung. Dies gilt auch für Zusatzfelder.

Solltest du eigene Platzhalter hinterlegen wollen, so achte bitte darauf dass immer zwei öffnende und zwei schließende geschweifte Klammern ({{}}) benutzt werden und dazwischen nur genau der bezeichnet des Feldes steht. Hierfür kannst du dich an bereits bestehenden Platzhaltern in der zu bearbeitenden Vorlage orientieren.

Liste aller Platzhalter

Person

Die Daten der Person (z.B. bei der Domäne "Person" oder bei einer Vermittlung) kann mit folgenden Platzhaltern abgerufen werden.

PlatzhalterBeschreibungAnzeigeart
{{person.firstName}}VornameText
{{person.lastName}}NachnameText
{{person.companyName}}FirmennameText
{{person.fullName}}Firmenname oder Vor- & NachnameText
{{person.street}}StraßeText
{{person.streetNo}}HausnummerText
{{person.zip}}PLZText
{{person.city}}OrtText
{{person.country}}LandText
{{person.email}}E-MailText
{{person.phone}}TelefonnummerText
{{person.mobile}}MobilnummerText
{{person.identityCardNumber}}PersonalausweisnummerText
{{formatDate(person.birthday)}}GeburtsdatumDatum
{{yesno(person.fosterHome)}}Pflegestelle-RolleJa/Nein
{{checkbox(person.fosterHome)}}Pflegestelle-RolleCheckbox
{{yesno(person.transport)}}Transporteur-RolleJa/Nein
{{checkbox(person.transport)}}Transporteur-RolleCheckbox
{{yesno(person.inspector)}}Kontrolleur-RolleJa/Nein
{{checkbox(person.inspector)}}Kontrolleur-RolleCheckbox
{{yesno(person.inspector)}}Kontrolleur-RolleJa/Nein
{{checkbox(person.inspector)}}Kontrolleur-RolleCheckbox
{{yesno(person.sponsor)}}Pate-RolleJa/Nein
{{checkbox(person.sponsor)}}Pate-RolleCheckbox
{{checkbox(person.animalProtectionOrganization)}}Tierschutzorga-RolleCheckbox
{{formatDate(person.animalProtectionOrganization)}}Tierschutzorga-RolleDatum
{{yesno(person.inspectionSuccessful)}}Vorkontrolle erfolgreich?Ja/Nein
{{checkbox(person.inspectionSuccessful)}}Vorkontrolle erfolgreich?Checkbox
{{formatDate(person.inspectionDate)}}VorkontrollterminDatum
Vorkontrolleur

Um die Daten des Vorkontrolleurs der entsprechenden Person abzurufen können folgenden Platzhalter verwendet werden.

PlatzhalterBeschreibungAnzeigeart
{{person.inspectingPerson.firstName}}VornameText
{{person.inspectingPerson.lastName}}NachnameText
{{person.inspectingPerson.companyName}}FirmennameText
{{person.inspectingPerson.fullName}}Firmenname oder Vor- & NachnameText
{{person.inspectingPerson.street}}StraßeText
{{person.inspectingPerson.streetNo}}HausnummerText
{{person.inspectingPerson.zip}}PLZText
{{person.inspectingPerson.city}}OrtText
{{person.inspectingPerson.country}}LandText
{{person.inspectingPerson.email}}E-MailText
{{person.inspectingPerson.phone}}TelefonnummerText
{{person.inspectingPerson.mobile}}MobilnummerText
{{person.inspectingPerson.identityCardNumber}}PersonalausweisnummerText
{{formatDate(person.inspectingPerson.birthday)}}GeburtsdatumDatum

Tier

Mit folgenden Platzhaltern können Daten des Tieres (Domäne "Tier" oder bei einer Vermittlung) abgerufen werden.

PlatzhalterBeschreibungAnzeigeart
{{pet.uniqueNumber}}TiernummerText
{{pet.uniqueLedgerNumber}}BestandsbuchnummerText
{{pet.species}}Tierart (Hund/Katze/etc.)Text
{{pet.name}}NameText
{{pet.newName}}Neuer NameText
{{pet.displayName}}Anzeigename (Neuer Name oder Name)Text
{{pet.race}}RasseText
{{pet.recordDate}}AufnahmedatumText
{{pet.sex}}GeschlechtText
{{pet.characteristics}}Unveränderliche KennzeichenText
{{pet.immunizationCardId}}ImpfpassnummerText
{{pet.treatments}}Ärztliche BehandlungText
{{pet.sponsorNames}}Namen der TierpatenText
{{orNone(pet.treatments)}}Ärztliche Behandlung oder Text "keine"Text
{{formatDate(pet.mediationDate)}}VermittlungsdatumDatum
{{pet.originCountry}}HerkunftslandText
{{pet.originCountryWithCity}}Herkunftsland mit StadtText
{{pet.currentCountry}}AufenthaltslandText
{{pet.chipNo}}TranspondernummerText
{{formatDate(pet.birthday)}}GeburtsdatumText
{{formatDate(pet.castrationDueDate)}}Kastrationsdatum (Geburtsdatum + 6 Monate)Datum
{{yesno(pet.isMale)}}Tier MännlichJa/Nein
{{checkbox(pet.isMale)}}Tier MännlichCheckbox
{{yesno(pet.isFemale)}}Tier WeiblichJa/Nein
{{checkbox(pet.isFemale)}}Tier WeiblichCheckbox
{{yesno(pet.castrated)}}KastriertJa/Nein
{{checkbox(pet.castrated)}}KastriertCheckbox
{{yesno(pet.tasso)}}TASSOJa/Nein
{{checkbox(pet.tasso)}}TASSOCheckbox
{{yesno(pet.traces)}}TracesJa/Nein
{{checkbox(pet.traces)}}TracesCheckbox
{{pet.tracesNumber}}Traces-NummerText
{{pet.fosterHome}}Notizen für PflegestelleText
{{yesno(pet.deceased)}}VerstorbenJa/Nein
{{checkbox(pet.deceased)}}VerstorbenCheckbox
{{pet.miscDiseases}}Weitere KrankheitenText
{{orNone(pet.miscDiseases)}}Weitere Krankheiten oder Text "keine"Text
{{pet.miscInformation}}"Sonstiges"Text
{{pet.diseaseList}}Liste bekannter KrankheitenText
{{orNone(pet.diseaseList)}}Liste bekannter Krankheiten oder Text "keine"Text
{{yesno(pet.hasDiseasesChecked)}}Krankheiten getestetJa/Nein
{{checkbox(pet.hasDiseasesChecked)}}Krankheiten getestetCheckbox
{{yesno(pet.hasDiseases)}}ErkranktJa/Nein
{{checkbox(pet.hasDiseases)}}ErkranktCheckbox
{{yesno(pet.catDiseasesChecked)}}Katze: Krankheiten getestetJa/Nein
{{checkbox(pet.catDiseasesChecked)}}Katze: Krankheiten getestetCheckbox
{{yesno(pet.catFivFelvChecked)}}Katze: FIV/FeLV getestetJa/Nein
{{checkbox(pet.catFivFelvChecked)}}Katze: FIV/FeLV getestetCheckbox
{{yesno(pet.catFivPositive)}}Katze: FIV positivJa/Nein
{{checkbox(pet.catFivPositive)}}Katze: FIV positivCheckbox
{{yesno(pet.catFelvPositive)}}Katze: FeLV positivJa/Nein
{{checkbox(pet.catFelvPositive)}}Katze: FeLV positivCheckbox
{{yesno(pet.dogLeishmaniose)}}Hund: Leishmaniose getestetJa/Nein
{{checkbox(pet.dogLeishmaniose)}}Hund: Leishmaniose getestetCheckbox
{{yesno(pet.dogEhrlichiose)}}Hund: Ehrlichiose getestetJa/Nein
{{checkbox(pet.dogEhrlichiose)}}Hund: Ehrlichiose getestetCheckbox
{{yesno(pet.dogBabesiose)}}Hund: Babesiose getestetJa/Nein
{{checkbox(pet.dogBabesiose)}}Hund: Babesiose getestetCheckbox
{{yesno(pet.dogFilaria)}}Hund: Filaria getestetJa/Nein
{{checkbox(pet.dogFilaria)}}Hund: Filaria getestetCheckbox
{{yesno(pet.dogAnaplasmose)}}Hund: Anaplasmose getestetJa/Nein
{{checkbox(pet.dogAnaplasmose)}}Hund: Anaplasmose getestetCheckbox
{{yesno(pet.dogLeishmaniosePositive)}}Hund: Leishmaniose positivJa/Nein
{{checkbox(pet.dogLeishmaniosePositive)}}Hund: Leishmaniose positivCheckbox
{{yesno(pet.dogEhrlichiosePositive)}}Hund: Ehrlichiose positivJa/Nein
{{checkbox(pet.dogEhrlichiosePositive)}}Hund: Ehrlichiose positivCheckbox
{{yesno(pet.dogBabesiosePositive)}}Hund: Babesiose positivJa/Nein
{{checkbox(pet.dogBabesiosePositive)}}Hund: Babesiose positivCheckbox
{{yesno(pet.dogFilariaPositive)}}Hund: Filaria positivJa/Nein
{{checkbox(pet.dogFilariaPositive)}}Hund: Filaria positivCheckbox
{{yesno(pet.dogAnaplasmosePositive)}}Hund: Anaplasmose positivJa/Nein
{{checkbox(pet.dogAnaplasmosePositive)}}Hund: Anaplasmose positivCheckbox
{{IMAGE petImage(pet)}}Bild des Tieres (quadratisch)Bild
{{vaccinationDate(pet, "rabies")}}Datum Impfung TollwutDatum
Zuständiges Mitglied

Ist für das Tier ein zuständiges Mitglied hinterlegt, können mit folgenden Platzhaltern dessen Daten ausgelesen werden.

PlatzhalterBeschreibungAnzeigeart
{{pet.liableMember.firstName}}VornameText
{{pet.liableMember.lastName}}NachnameText
{{pet.liableMember.companyName}}FirmennameText
{{pet.liableMember.fullName}}Firmenname oder Vor- & NachnameText
{{pet.liableMember.street}}StraßeText
{{pet.liableMember.streetNo}}HausnummerText
{{pet.liableMember.zip}}PLZText
{{pet.liableMember.city}}OrtText
{{pet.liableMember.country}}LandText
{{pet.liableMember.email}}E-MailText
{{pet.liableMember.phone}}TelefonnummerText
{{pet.liableMember.mobile}}MobilnummerText
{{pet.liableMember.identityCardNumber}}PersonalausweisnummerText
{{formatDate(pet.liableMember.birthday)}}GeburtsdatumDatum
Adoptant

Ist für das Tier ein Adoptant hinterlegt, können mit folgenden Platzhaltern dessen Daten ausgelesen werden. Dies funktioniert nur für bereits abgeschlossene Vermittlungen und nicht z.B. für die aktuelle Vermittlung, da für das Tier der Adoptant noch nicht hinterlegt ist.

PlatzhalterBeschreibungAnzeigeart
{{pet.adoptant.firstName}}VornameText
{{pet.adoptant.lastName}}NachnameText
{{pet.adoptant.companyName}}FirmennameText
{{pet.adoptant.fullName}}Firmenname oder Vor- & NachnameText
{{pet.adoptant.street}}StraßeText
{{pet.adoptant.streetNo}}HausnummerText
{{pet.adoptant.zip}}PLZText
{{pet.adoptant.city}}OrtText
{{pet.adoptant.country}}LandText
{{pet.adoptant.email}}E-MailText
{{pet.adoptant.phone}}TelefonnummerText
{{pet.adoptant.mobile}}MobilnummerText
{{pet.adoptant.identityCardNumber}}PersonalausweisnummerText
{{formatDate(pet.adoptant.birthday)}}GeburtsdatumDatum
Abgebender Verein

Ist für das Tier ein abgebender Verein hinterlegt, können mit folgenden Platzhaltern dessen Daten ausgelesen werden.

PlatzhalterBeschreibungAnzeigeart
{{pet.providingOrganization.firstName}}VornameText
{{pet.providingOrganization.lastName}}NachnameText
{{pet.providingOrganization.companyName}}FirmennameText
{{pet.providingOrganization.fullName}}Firmenname oder Vor- & NachnameText
{{pet.providingOrganization.street}}StraßeText
{{pet.providingOrganization.streetNo}}HausnummerText
{{pet.providingOrganization.zip}}PLZText
{{pet.providingOrganization.city}}OrtText
{{pet.providingOrganization.country}}LandText
{{pet.providingOrganization.email}}E-MailText
{{pet.providingOrganization.phone}}TelefonnummerText
{{pet.providingOrganization.mobile}}MobilnummerText
{{pet.providingOrganization.identityCardNumber}}PersonalausweisnummerText
{{formatDate(pet.providingOrganization.birthday)}}GeburtsdatumDatum

Vermittlung

Handelt es sich um eine Dokumentenvorlage für Vermittlungen, kannst du mit folgenden Platzhaltern die passenden Daten abrufen.

PlatzhalterBeschreibungAnzeigeart
{{mediation.title}}Name der zu vermittelnden TiereText
{{mediation.protectiveChargeForPet}}Schutzgebühr in EuroText
{{formatDate(mediation.started)}}Start der VermittlungDatum
{{formatDate(mediation.started)}}Start der VermittlungDatum
{{mediation.placeOfArrival}}AnkunftsortText
{{formatDate(mediation.travelDate)}}ReisedatumDatum
{{formatDate(mediation.arrivalDate)}}AnkunftsdatumDatum
{{yesno(mediation.protectiveChargeReceived)}}Schutzgebühr eingegangenJa/Nein
{{checkbox(mediation.protectiveChargeReceived)}}Schutzgebühr eingegangenCheckbox
{{formatDate(mediation.protectiveChargeReceivedDate)}}Eingangsdatum SchutzgebührDatum
{{formatDate(mediation.calculatedMediationDate)}}VermittlungsdatumDatum

Transport

Transportdokumente haben einen etwas komplizierteren Aufbau als alle anderen Dokumente, da hier in einem Dokument die Daten mehrere Tiere hinterlegt werden müssen. Hierzu muss der Teil des Dokumentes, der für jedes Tier wiederholt werden soll, mit den Direktiven {{FOR pet IN pets}} und {{END-FOR pet}} umschlossen werden. Jeglicher Inhalt zwischen diesen zwei Direktiven wird einmal für jedes Tier ausgegeben.

Danach kannst du die Platzhalter von weiter oben in diesem Dokument ("Tier") verwenden, allerdings müssen sämtliche Platzhalter anstatt mit {{pet. nun mit {{$pet. beginnen, um klar zu machen, dass es sich um das aktuell ausgewählte Tier handelt. Die Platzhalter ändern sich also von z.B. von {{pet.adoptant.fullName}} zu {{$pet.adoptant.fullName}}.

Zusätzlich stehen für Transportlisten ein einige weitere Platzhalter zur Verfügung:

PlatzhalterBeschreibungAnzeigeart
{{$pet.index}}Aufsteigende Nummer in der TransportlisteText
{{$pet.genderShort}}"F" für Weiblich oder "M" für männlichText
{{$pet.mediationType}}"Pflegestelle" oder "Endstelle"Text
{{$pet.mediationTypeShort}}"PS" oder "ES"Text
{{$pet.placeOfArrival}}AnkunftsortText
{{$pet.mediationDate}}VermittlungsdatumText
{{formatDate(today)}}Aktuelles DatumText
{{formatDate(arrivalDate)}}Ankunftsdatum TransportText
{{formatDate(travelDate)}}Reisedatum TransportText
{{IMAGE petImage($pet)}}Bild des Tieres (quadratisch)Bild
{{vaccinationDate($pet, "rabies")}}Datum Impfung TollwutDatum

Verwendung von Zusatzfeldern

Auch Zusatzfelder kannst du in Dokumenten verwenden. Den dafür benötigten Platzhalter findest du, wenn du als Administrator in den Einstellungen auf das betreffende Zusatzfeld klickst. Dort ist der Feldname hinterlegt und darunter findest du einen Informationstext, in dem der Platzhalter erwähnt wird:

"Bspw. kann bei Tieren der Platzhalter {{pet.extra.pet_basics_gewicht}} verwendet werden"

Bitte beachte, dass im obigen Beispiel der Platzhalter {{pet.extra.pet_basics_gewicht}} den Text immer genau so ausgibt, wie du ihn in das Zusatzfeld eingegeben hast. Würde es sich um ein Datumsfeld handeln, könntest du das Datum im deutschen Standard-Format ausgeben, indem du den Platzhalter {{formatDate(pet.extra.pet_basics_gewicht)}} benutzt.

Genau so könntest du im Falle eines Schieberegler-Feldes mit {{yesno(pet.extra.pet_basics_gewicht)}} das Ergebnis als "Ja/Nein"-Text oder im Falle von {{checkbox(pet.extra.pet_basics_gewicht)}} als Checkbox ausgeben.

Prüfen der Dokumente

Du kannst neue oder angepasste Vorlagen in petoffice bereits vor dem Speichern testen, um sicherzustellen, dass der Betrieb jederzeit fehlerfrei möglich ist. Hierzu kannst du die angepasste Vorlage in den Einstellungen wie oben beschrieben hochladen und vor einem Klick auf "Speichern" mit der Funktion "Vorlage testen" bereits eine Vorab-Prüfung vornehmen lassen. Sollten irgendwelche Platzhalter falsch verwendet werden, bekommst du direkt eine entsprechende Fehlermeldung angezeigt. War der Test erfolgreich, wird der Button grün und zeigt einen entsprechenden Text an. Du solltest die Vorlage erst dann speichern, wenn du die sie erfolgreich getestet hast.

Um sicherzustellen, dass auch alles aussieht, wie du es dir vorstellst, empfiehlt es sich direkt nach der Anpassung einmal ein Dokument aus der Vorlage zu erstellen. Es ist immer besser mögliche Fehler selbst bei einem Versuch festzustellen, als wenn es später auffällt und du dich bereits darauf verlässt, dass alles funktioniert.

Häufige Fragen

Das Bild des Tieres ist quadratisch, ist das normal?
Das ist derzeit eine Beschränkung in der Bildanzeige des Tieres und hängt damit zusammen, wie Bilder in Word-Dateien eingebunden werden. Zukünftig werden wir dir eine passendere Ansicht dafür bereitstellen können.
Ich bekomme einen unbekannten Fehler wenn ich meine Vorlage benutze. Woran hängt das?
Kein Dateiformat ist perfekt - auch Word-Dateien nicht. In aller Regel versucht dir petoffice die bestmögliche Fehlermeldung anzuzeigen, sodass du ein Problem in der Vorlage schnell lokalisieren kannst. Wenn eine Vorlage aber über lange Zeit z.B. über verschiedene Versionen von Word portiert wurde, oder etwas exotischere Formatierungsfunktionen verwendet werden, kann es sein, dass das Dokument von petoffice nicht gelesen werden kann. Wenn gar nichts anderes hilft und du das Problem nicht lokalisieren kannst, ist es das einfachste, wenn du eine neue Vorlage anlegst - erst mal mit sehr rudimentärer Formatierung. Wenn das Erstellen der Vorlagen daraus funktioniert, kannst du Stück für Stück weitere Anpassungen vornehmen. Stelle bei jeder Änderung sicher, dass aus der Vorlage ein Dokument erstellt werden kann.