Skip to main content

Dienstleistung parametrieren

Anwendungsbeispiel​

Die Firma Hugentobler Metallbau hat einige Mitarbeiter:innen, die oft beim Kunden vor Ort arbeiten. Chef Manfred plant jeweils im Proffix die kommenden Einsätze für seine Angestellten. Dank des watoConnect, dem Schnittstellentool ihres Software-Partners, werden automatisch Termin-Einträge im Outlook-Kalender der Mitarbeiter:innen erstellt, welche alle wichtigen Informationen zum Auftrag und Einsatz enthalten.

Mitarbeiter Janick kann, nachdem er die Arbeit erledigt hat, seine Leistung noch beim Kunden vor Ort auf seinem Smartphone mithilfe der PxApp erfassen. Leider muss Janick den richtigen Auftrag über die Suche finden und auch die Zeit von Hand eintragen, was bei mehreren Aufträgen ziemlich mühsam werden kann.

Dienstleistung parametrieren

Hier kommt nun die Parametrierung ins Spiel.

Zusammen mit allen anderen Informationen wird dank des watoConnect im Outlook-Termin auch eine URL für die PxApp eingetragen. Wenn Janick mit seiner Arbeit fertig ist, klickt er im Outlook-Termin auf den Link. Dadurch öffnet sich die PxApp mit dem passenden Auftrag und trägt zugleich die Zeit automatisch ein.

Janick kann so blitzschnell und ohne den Auftrag suchen zu mĂĽssen seine Leistung erfassen.

Verwendung​

Um Parameter zu ĂĽbergeben, werden Standard URL-Parameter verwendet.

Dazu wird die Seite normal aufgerufen. Diese URL wurde in der Version 3.1.3.0 geändert.

von "/dienstleistung" zu "/leistungen/dienstleistung"

Die Parameter werden in beliebiger Reihenfolge von der URL mit einem ? getrennt angehängt. Zwischen den Parametern wird jeweils ein & gesetzt.

?auftragNummer=14&date=1988-06-24&startTime=08:00:00&endTime=10:30:00

Parameter​

Auftrag​

Parametername: auftragNummer

  • Lädt den ĂĽbergebenen Auftrag anhand der Auftragsnummer.
  • Parameter kundenNummer nicht ĂĽbergeben. Wird automatisch ermittelt.
  • Parameter positionsartNummer muss nicht ĂĽbergeben werden. Wird automatisch ermittelt.

Beispiel

auftragNummer=69

Kunde​

Parametername: kundenNummer

  • Lädt den ĂĽbergebenen Kunden anhand der Adressnummer.
  • Schränkt die Auftragssuche fĂĽr diese Adresse ein.

Beispiel

kundenNummer=4

Positionsart​

Parametername: positionsartNummer

  • Legt die Positionsart fest.
  • Wird wieder ĂĽberschrieben, sobald der Nutzer einen neuen Auftrag lädt.

Beispiel

positionsartNummer=420

Datum​

Parametername: date

  • Legt das Datum fest.
  • Format: yyyy-MM-dd

Beispiel

date=1988-06-24

Startzeit​

Parametername: startTime

  • Legt die Startzeit fest.
  • Format: HH:mm:ss

Beispiel

startTime=08:00:00

Endzeit​

Parametername: endTime

  • Legt die Endzeit fest.
  • Format: HH:mm:ss

Beispiel

endTime=10:30:00

Bemerkungen​

Parametername: bemerkungen

  • Legt die Bemerkungen fest.
  • Der gesamte Inhalt des Parameters muss URL-encodiert sein.

Beispiel

bemerkungen=Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat.
bemerkungen=Lorem%20ipsum%20dolor%20sit%20amet%2C%20consetetur%20sadipscing%20elitr%2C%20sed%20diam%20nonumy%20eirmod%20tempor%20invidunt%20ut%20labore%20et%20dolore%20magna%20aliquyam%20erat.

CRM Aktivitätsnummer​

Parametername: crmAktivitaetId

Setzt die Installation eines Zusatzfeldes voraus.

  • Die ĂĽbergebene CRM-Aktivitätsnummer wird beim Speichern eines neuen Rapports in dieses Zusatzfeld geschrieben.
  • Dies ermöglicht es auf Seite der Datenbank mit einem Trigger zu reagieren und beispielsweise die gewĂĽnschte CRM-Aktivität abzuschliessen.

đź“‚ Zusatzfeld Datei herunterladen

info

Vergessen Sie nicht, nach der Zusatzfeld-Installation die Rest API neu zu starten.

Beispiel

crmAktivitaetId=46

Zusatzfelder durchschleusen​

Parametername: zusatzfelder_pass_through

  • Hier können beliebig viele Zusatzfelder ĂĽbergeben werden.
  • Die Zusatzfelder werden dann beim Speichern des Rapports mit an den Rapport gespeichert.
  • Die Zusatzfelder mĂĽssen in der Form Zusatzfeldname=Wert ĂĽbergeben werden.
    • Mehrere Zusatzfelder werden mit einem Komma Âż getrennt.
    • Der gesamte Inhalt des Parameters muss URL-encodiert sein.
  • Es können auch Zahlen und andere Type ĂĽbergeben werden.
    • Von der App wird keine Validierung durchgefĂĽhrt.
    • Erst beim Speichern wird durch die Rest-API geprĂĽft, ob die ĂĽbergebenen Werte korrekt sind.

Beispiel

zusatzfelder_pass_through=Z_Feld1=Wert1ÂżZ_Feld2=Wert2
zusatzfelder_pass_through=Z_Feld1%3DWert1%C2%BFZ_Feld2%3DWert2