Ninox

Diese Seite ist noch im Aufbau. Weitere Informationen folgen.

Quickstart

Hier eine Liste von Aktionen um die Integration mit Ninox schnell und einfach durchzuführen.

Stelle sicher dass du dich im richtigen Workspace befindest oder erstelle dir einen für dein Automationsvorhaben. 1.) Verbinde ein Konto mit Kontoflux. Am einfachsten geht das über Bankkonten > Bankkonten hinzufügen Zu Testzwecken kannst du das finAPI Test Konto verwenden (Findet sich unter Stichwort: "Demo") 2.) Wechsel zu Automationen > Integration > Integration hinzufügen 3.) Wähle Ninox 4.) Folge den Schritten der Erstkonfiguration 4.1.) Füge deinen API-Key aus Ninox hinzu. In Ninox findest du Ihn unter Integrationen. Denk im Falle der Private-Cloud an deine geänderte API Url. 4.2) Wähle das Ninox-Team und die Ninox-Datenbank. Es empfiehlt sich beides vorher anzulegen. 4.3) Wähle mind. eine Ninox-Tabelle. Kontoflux.io kann dir die Transaktionen und/oder Bankkonten zu Ninox übertragen. Auch hier empfiehlt es sich das Tabellen-Layout vorher anzulegen. Du kannst auch dem Beispiel auf der Konfigurations-Seite folgen. Solltest du Änderungen in Ninox während der Konfiguration gemacht haben, kannst dein aktuelles Tabellen-Layout unter mit dem Button "Tabellen neuladen" aktualisieren. 4.4) Wähle nun welche Ninox-Felder wie von Kontoflux.io zu befüllen sind. Auf der linken Seite findest Du deine Ninox-Felder, auf der rechten Seite wie Kontoflux.io diese zu befüllen hat. Initial schlägt Kontoflux die Felder KI-basiert vor. Wähle "Do nothing/Tue nichts" für Felder, die nicht auszufüllen sind. 4.5) Du hast die Konfiguration abgeschlossen! 5.) Teste deine Integration: Du findest unten einen Button "Testdaten senden". Mit diesem wird eine Fake-Transaktion geschickt, bei der du auch alle Parameter anpassen kannst. Praktisch, um gewisse IBAN oder Verwendungszwecke zu testen. 6.) Prüfe ob alle Felder korrekt in Ninox ankamen. Fahre fort, sobald das sicher gestellt ist. 7.) Wähle dein gewünschtes Interval, solltest Du automatisch die Transaktionen zu Ninox geschickt bekommen wollen. 8.) Für manuelle Syncronisationen rufe den Quick-Sync-Link in einem neuen Fenster auf oder hinterlege Ihn in einem Button in deiner Ninox Instanz.

Fertig! Nun solltest du deine Transaktionen deiner Bankkonten nach deinen Präferenzen in Ninox vorfinden.

Die erste Synchronisation beinhaltet alle Transaktionen, die noch nicht zu Ninox übertragen wurden. Erfahrungsgemäß ist das ein gutes Jahr Historie deines Kontos. Wundere dich nicht, das daher der erste Sync so viele Transaktionen beinhaltet.

Es gibt noch weitere Möglichkeiten Kontoflux.io noch tiefer in Ninox zu Integrieren, auf dieser Seite findest du weitere Beispiele.

Snippets

Ninox-Button: Script zum anstoßen des JSON-Endpunkts mit Feedback

Mit dem JSON Sync könnt Ihr direkt hinter einem Ninox-Button die Synchronisation der Ninox Integration ausführen und erhaltet für alle Szenarien im JSON eine Antwort. Vorteil: Hierfür muss sich der Nutzer nicht anmelden und alles passiert direkt in Ninox.

Tipp: Kopier dir deine URL zum JSON-Endpunkt direkt von deiner Ninox Integration aus Kontoflux herraus.

Mehr zum JSON-Sync Endpunkt.

let url := "https://sys-api.kontoflux.io/v1/WorkspaceID/integrations/IntegrationsID/sync/json?token=GeheimerToken";
let response := http("POST", url, {
		'content-type': "application/json"
	}, {});
if response.result.finished then
	if response.result.status = "success" then
		if response.result.items > 0 then
			alert("Transaktionen synchronisiert! Es wurden " + response.result.items +
			" Transaktionen übertragen.")
		else
			alert("Es gab keine neuen Transaktionen zu übertragen.")
		end
	else
		alert("Es gab einen Fehler beim Versuch neue Transaktionen zu übertragen. Bitte wende dich an deinen Administrator.")
	end
else
	alert("Synchronisation wurde gestartet und benötigt noch ca. " +
	response.result.estimation +
	"Minuten.")
end

Ninox-Button: Konto im Pop-Up-Style einbinden (Paypal-Feeling)

Kontoanbinden als Pop-Up

Diese Variante sorgt für ein mehr Integriertes Feeling der Kontoflux.io Integration. Der Nutzer muss logischer Weise immer noch eingeloggt sein. Falls der Nutzer das nicht ist, wird er zum Login aufgefordert und an entsprechende Stelle weitergeleitet.

*** WorkspaceID ist im Script nach window.open in die URL einzutragen ! ***

Außerdem können die Ninox-Felder IBAN, BIC oder Name mit übertragen werden, damit die Bank direkt gefunden werden kann. Wenn nicht verwendet, kann die Parameter aus der URL entfernt werden.

html(---
<div style="width: 100%;
    height: 100%;
    left: 0px;
    top: 0px;
    display: flex;
    justify-content: center;
    align-items: center;" onclick="let l = screen.width/2 - 560/2; let h = screen.height/2 - 700/2; window.open('https://app.bankflux.io/**WorkspaceID**/quick-connect?iban={ IBAN }&BIC={ BIC }&name={ Name }','targetWindow',
                                   `toolbar=no,
                                    location=no,
                                    status=no,
                                    menubar=no,
                                    scrollbars=yes,
                                    resizable=yes,
				    left=`+l+`
				    top=`+h+`
                                    width=560,
                                    height=700`);
 return false;">Konto Verbinden</div>
---)