pfx AppsAppearance
API / Integration
pfx Apps können mit anderen Apps und Proffix Zusatzentwicklungen - ganz im Sinne eines Ökosystems - plattformunabhängig verbunden werden.
App Link / Universal Link
Was ist das ?
Wenn auf einem Gerät, auf welchem ein pfx App installiert ist, ein sogenannter App Link (Android) oder Universal Link (iOS) aufgerufen wird, öffnet sich das entsprechende pfx App automatisch an der entsprechenden Stelle.
Es können aber auch komplexere Parameter mitgegbeben werden. Die Funktion von geteilten Filtern via DeepLink ist ein Beispiel dafür.
Wichtig: Im Unterschied zu einer Webseite oder einem Progressiven Webapp wird der Link in pfx vor dem Webbrowser geparst. Das heisst es braucht dafür prinzipiell auch keine Internetverbindung und funktioniert aus jeder installierten Anwendung auf dem Gerät (WhatsApp, SMS, Email, Dokumente, Fremdapps, etc.)
Konkrete Anwendungsbeispiele
- Externes App für Serviceverwaltung: Anstelle alle Adressdaten, Notizen und Kontakte zu synchronisieren kann einfach ein Link (siehe unten) mitgegeben werden. Klickt der Benutzer darauf ist er direkt bei der korrekten Adresse in pfx
- Individualentwicklung: Anstelle die Adressverwaltung noch einmal zu bauen kann einfach direkt aus dem individuellen App auf die Adresse / Kontakt in pfx verwiesen werden.
- Auftragszuweisung: Anstelle einem Mitarbeiter im Aussendienst PDFs o.ä. zu senden, reicht es im z.B. den Link https://adresse.pfx.ch/adresse/232 oder z.B. https://leistung.pfx.ch/auftrag/TESTAUFTRAG zu senden.
Übersicht
Folgende Links sind zurzeit verfügbar:
Adressen / Kontakte / Dokumente
Diese Links werden in pfx Adressen geöffnet
| Modul | Link | Funktion |
|---|---|---|
| Adressen | https://adresse.pfx.ch/adressen | Zeigt alle Adressen an |
| Adressen | https://adresse.pfx.ch/adresse/{AdressNr} | Zeigt Adressdetails an |
| Adressen | https://adresse.pfx.ch/kontakte | Zeigt alle Kontakte an |
| Adressen | https://adresse.pfx.ch/kontakt/{KontaktNr} | Zeigt Kontaktdetails an |
| Adressen | https://adresse.pfx.ch/notizen | Zeigt alle Adressnotizen an |
| Adressen | https://adresse.pfx.ch/notiz/{NotizNr} | Zeigt Adressnotizdetail an |
| Adressen | https://adresse.pfx.ch/dokumente | Zeigt alle Dokumente an |
| Adressen | https://adresse.pfx.ch/dokument/{DokumentNr} | Zeigt Dokumentdetails an |
Zeit / Stunden
Diese Links werden in pfx Zeit geöffnet
| Modul | Link | Funktion |
|---|---|---|
| Zeit | https://zeit.pfx.ch/stunden | Zeigt alle Stunden an |
| Zeit | https://zeit.pfx.ch/stunde/{StundeNr} | Zeigt Stundendetail an |
| Zeit | https://zeit.pfx.ch/stundenferieninfo | Zeigt Stunden / Ferieninfo an |
| Zeit | https://zeit.pfx.ch/stunden-erfassen | Ermöglicht eine neue Stunde zu erfassen |
Leistungen / Aufträge / Projekte
Diese Links werden in pfx Leistung geöffnet
| Modul | Link | Funktion |
|---|---|---|
| Leistung | https://leistung.pfx.ch/rapporte | Zeigt alle Rapporte an |
| Leistung | https://leistung.pfx.ch/rapport/{RapportNr} | Zeigt Rapportdetail an |
| Leistung | https://leistung.pfx.ch/auftraege | Zeigt alle Aufträge an |
| Leistung | https://leistung.pfx.ch/auftrag/{AuftragNr} | Zeigt Auftragdetails an |
| Leistung | https://leistung.pfx.ch/projekte | Zeigt alle Projekte an |
| Leistung | https://leistung.pfx.ch/projekt/{ProjektNr} | Zeigt Projektdetails an |
| Leistung | https://leistung.pfx.ch/rapportdokumente | Zeigt alle Rapportdokumente an |
| Leistung | https://leistung.pfx.ch/rapportdokument/{RapportDokumentNr} | Zeigt Rapportdokumentdetail an |
Automatische Auswahl des Mandanten
Aufgrund der Multimandanten - Fähigkeit von pfx können je nach Situation zusätzliche Infos in Form von Queryparameter zum gewünschten Mandanten angegeben werden.
INFO
pfx prüft nimmt automatisch den Mandanten mit den am meisten zutreffenden Kriterien.
Es liegt in der Verantwortung des Linkerstellers abzuschätzen welche Queryparameter benötigt werden. Werden keine zusätzlichen Informationen mitgegeben, wird der zuletzt in pfx verwendete Mandant verwendet.
| Parameter | Beispiel | Bemerkung |
|---|---|---|
| pxuser | Gast | Der Benutzername des Proffix - Benutzers |
| pxdatabase | DEMODB | Der Datenbankname des Proffix Mandanten |
| pxurl | remote.proffix.net:11222 | Die Url der Proffix Rest-API |
Beispiele:
- https://adresse.pfx.ch/adresse/221?pxuser=Gast&pxdatabase=DEMODB&pxurl=remote.proffix.net:11222
- https://adresse.pfx.ch/adresse/221?pxuser=Gast&pxdatabase=DEMODB
- https://adresse.pfx.ch/adresse/221?pxdatabase=DEMODB
- https://adresse.pfx.ch/kontakte
- https://adresse.pfx.ch/kontakt/12
Wünsche oder Ideen ?
Die Möglichkeiten mit DeepLinks sind fast grenzenlos. Ist genau dieser DeepLink den du brauchst nicht dabei ?
Gerne erstellen wir auch sinnvolle Anpassungen für andere Entwickler oder Benutzer. Einzige Bedingung - die Anpassung wird hier für alle dokumentiert, damit auch andere davon profitieren können. Ein kurzes Mail an [email protected] genügt.