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 mitgegeben 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.
- Steuern per QR-Code: Ein DeepLink kann in einen QR-Code gepackt werden. Sobald der Benutzer den QR - Code scannt öffnet pfx automatisch das App an der entsprechenden Stelle (Bedingung: entsprechendes pfx App ist installiert)
- Steuern per NFC (Near Field Communication): Ein DeepLink wird auf einem NFC - Tag gespeichert. Beim Lesen wird automatisch das entsprechende App auf der entsprechenden Stelle geöffnet.
- Auftragsblätter: Anstelle Auftragsblätter / Listen auszudrucken können z.B. auf einem QR - Code ein Link auf https://liste.pfx.ch/liste/1234?AUF_Dokumente.AuftragNrPRO=2023384 mitgegeben werden. Scannt der Benutzer den QR - Code, öffnet sich das App automatisch, lädt die Selektionen und generiert (wenn Parameter run gesetzt ist) die Liste vollautomatisch
Ü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 |
| Zeit | https://zeit.pfx.ch/autostempeln | Stempelt den Benutzer vollautomatisch ein oder aus |
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-erstellen | Erstellt einen neuen Rapport (Siehe Parameter) |
| 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 |
Für den DeepLink rapport-erstellen sind folgende zusätzlichen Parameter möglich:
| Query-Parameter | Name | Hinweis |
|---|---|---|
| mitnr | Mitarbeiter-Nr | Optional; wird automatisch aus Benutzer ermittelt |
| std | Anzahl Stunden | |
| auftrag | Auftrags-Nr | |
| projekt | Projekt-Nr | |
| teil | Teilleistungs-Nr | |
| artikel | Artikel-Nr | |
| sauftrag | Serviceauftrags-Nr | |
| menge | Menge | Nur benötigt bei Artikel |
| posart | Positionsart | |
| bemerkungen | Bemerkungen | |
| run | Automatisches Speichern | Versucht den Rapport automatisch zu speichern |
Listen / Reports
Diese Links werden in pfx Zeit geöffnet
| Modul | Link | Funktion |
|---|---|---|
| Liste | https://liste.pfx.ch/listen | Zeigt alle Listen an |
| Liste | https://liste.pfx.ch/liste/{ListeNr} | Zeigt Listendetail an |
- Listen können per API automatisch generiert werden (Queryparameter run==true analog zu Rapport erstellen)
- Selektionen der Listen können per API vorbefüllt werden. Die Parameter sind identisch mit den Proffix Parametern z.B.:
- AUF_Dokumente.AuftragNrPRO=2023384&AUF_Dokumente.AdressNrADR=12&run=true
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.