Merge pull request #625 from flow-mn/sadespresso/import-bulk-txns-20251228

Bulk import, Custom transaction entry flow

Author: sadespresso

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## Next
+
+### New features
+
+* Now you can configure transaction entry flows
+* Added more fields to programmable object.
+* Now you can import multiple transactions at once with [programmable URL](./README.md#adding-multiple-transactions)
+* Now there's a concept of primary accounts, closes [#624](https://github.com/flow-mn/flow/issues/624)
+
 ## 0.16.6
 
 ### New features

README.md

@@ -33,6 +33,63 @@ seamlessly across platforms.
   * Export CSV, PDFs
   * Periodic auto-backups to iCloud
 * Absolutely free ([please donate 🥺](#support-flow))
+* [URI-based automation](#uri-based-automation)
+
+## URI-based automation
+
+You can add one or more transactions using `flow-mn` schema uris.
+
+Check out the supported [JSON Schema file in schemas folder](./schemas/programmable-object.json).
+
+Currencies are based on the account, so there's no way to specify it at the moment.
+
+### Adding single transaction
+
+When adding single transactions, properties must be provided as query params.
+
+```json
+{
+  "title": "Tous les jours",
+  "amount": 42000.00
+}
+```
+
+turns into:
+
+```plain
+flow-mn:///transaction/new?title=Tous+les+jours&amount=42000.00
+```
+
+### Adding multiple transactions
+
+When adding multiple transactions, you must provide stringified version of the following as "json" query param.
+
+```json
+{
+  "t": [
+    {
+      "title": "Fresh blueberry piece",
+      "amount": "13000.00",
+      "transactionDate": "2011-12-05",
+      "category": "Food",
+      "tags": "My fave cafe",
+      "accountUuid": "faa6d523-277f-46af-9493-67768e5b48ab",
+    },
+    {
+      "title": "Caffe Mocha ice",
+      "amount": "10000.00",
+      "transactionDate": "2011-12-05",
+      "category": "Drinks"
+    }
+  ]
+}
+```
+
+turns into
+
+```plain
+flow-mn:///transaction/new?json=%7B%22t%22%3A%5B%7B%22title%22%3A%22Fresh%20blueberry%20piece%22%2C%22amount%22%3A%2213000.00%22%2C%22transactionDate%22%3A%222011-12-05%22%2C%22category%22%3A%22Food%22%7D%2C%7B%22title%22%3A%22Caffe%20Mocha%20ice%22%2C%22amount%22%3A%2210000.00%22%2C%22transactionDate%22%3A%222011-12-05%22%2C%22category%22%3A%22Drinks%22%7D%5D%7D
+```
 
 ## Development
 

assets/l10n/ar.json

@@ -16,6 +16,11 @@
   "account.new": "إضافة حساب",
   "account.noAccounts": "ليس لديك أي حسابات!",
   "account.postTransactionBalance": "الرصيد بعد هذه المعاملة",
+  "account.primaryAccount": "الحساب الأساسي",
+  "account.primaryAccount.changeDescription": "يمكنك تعيين حساب آخر كحساب أساسي عبر الانتقال إلى صفحة تحرير ذلك الحساب.",
+  "account.primaryAccount.description": "يُستخدم الحساب الأساسي كالحساب الافتراضي للمعاملات الجديدة والميزات الأخرى.",
+  "account.primaryAccount.notPrimary": "ليس حسابًا أساسيًا",
+  "account.primaryAccount.set": "تعيين كالحساب الأساسي",
   "account.thisMonth": "هذا الشهر",
   "account.transactions": "المعاملات",
   "account.transactions.title": "المعاملات لـ \"{account}\"",
@@ -134,6 +139,7 @@
   "enum.TransactionEntryAction@inputTitle": "أدخل العنوان",
   "enum.TransactionEntryAction@selectAccount": "اختر الحساب",
   "enum.TransactionEntryAction@selectCategoryOrTransferAccount": "اختر الفئة أو حساب التحويل",
+  "enum.TransactionEntryAction@selectPrimaryAccount": "اختر الحساب الأساسي",
   "enum.TransactionEntryAction@selectTags": "اختر الوسوم",
   "enum.TransactionFilterRangePreset@allTime": "كل الوقت",
   "enum.TransactionFilterRangePreset@last30Days": "آخر 30 يومًا",
@@ -321,7 +327,9 @@
   "preferences.transactionEntryFlow.abandonUponCancelForm": "إيقاف سير العملية عند إلغاء أي نموذج",
   "preferences.transactionEntryFlow.actions": "قائمة الإجراءات",
   "preferences.transactionEntryFlow.actions.description": "يمكنك السحب لإعادة ترتيبها",
-  "preferences.transactionEntryFlow.description": "لتوفير الوقت، يساعدك Flow على فتح بعض النماذج تلقائيًا عند إنشاء معاملة.",
+  "preferences.transactionEntryFlow.actions.lastItem": "يجب أن يكون العنصر الأخير",
+  "preferences.transactionEntryFlow.description": "لتوفير الوقت، يساعدك Flow بفتح بعض النماذج تلقائيًا عند إنشاء معاملة. يمكنك تعطيل كل هذه الإدخالات إذا فضّلت فتح كل نموذج يدويًا.",
+  "preferences.transactionEntryFlow.skipSelectedFields": "تخطي الحقول المحددة بالفعل",
   "preferences.transactions": "المعاملات",
   "preferences.transactions.geo": "موقع المعاملة",
   "preferences.transactions.geo.auto.description": "إرفاق موقعك الحالي تلقائيًا مع المعاملات الجديدة. حتى لو قمت بإيقاف هذه الخاصية، يمكنك اختيار موقع على الخريطة لإرفاقه.",
@@ -662,6 +670,12 @@
   "transactionFilterPreset.saveAsNew.guide": "لحفظ إعداد جديد، قم بتغيير الفلاتر ثم عد إلى هنا",
   "transactionFilterPreset.saveAsNew.name": "اسم الإعداد",
   "transactions.all": "كل المعاملات",
+  "transactions.batch.assignAccountForAll": "تعيين حساب لجميع المعاملات",
+  "transactions.batch.assignAccountIndividually": "تعيين حساب لكل معاملة على حدة",
+  "transactions.batch.import": "استيراد دفعي",
+  "transactions.batch.import.success": "تم استيراد {n} من المعاملات بنجاح",
+  "transactions.batch.importN": "استيراد {n} من المعاملات",
+  "transactions.batch.review": "يرجى مراجعة المعاملات",
   "transactions.count": "{} معاملة",
   "transactions.pending": "المعاملات المعلقة",
   "transactions.query.clearAll": "مسح الفلاتر",

assets/l10n/cs_CZ.json

@@ -16,6 +16,11 @@
   "account.new": "Nový účet",
   "account.noAccounts": "Nemáte žádné účty!",
   "account.postTransactionBalance": "Zůstatek po transakci",
+  "account.primaryAccount": "Hlavní účet",
+  "account.primaryAccount.changeDescription": "Jako hlavní účet můžete nastavit jiný účet na stránce úprav daného účtu.",
+  "account.primaryAccount.description": "Hlavní účet se používá jako výchozí účet pro nové transakce a další funkce.",
+  "account.primaryAccount.notPrimary": "Není hlavní účet",
+  "account.primaryAccount.set": "Nastavit jako hlavní účet",
   "account.thisMonth": "Tento měsíc",
   "account.transactions": "Transakce",
   "account.transactions.title": "Transakce účtu \"{account}\"",
@@ -134,6 +139,7 @@
   "enum.TransactionEntryAction@inputTitle": "Zadat název",
   "enum.TransactionEntryAction@selectAccount": "Vybrat účet",
   "enum.TransactionEntryAction@selectCategoryOrTransferAccount": "Vybrat kategorii / účet pro převod",
+  "enum.TransactionEntryAction@selectPrimaryAccount": "Vybrat primární účet",
   "enum.TransactionEntryAction@selectTags": "Vybrat štítky",
   "enum.TransactionFilterRangePreset@allTime": "Vše",
   "enum.TransactionFilterRangePreset@last30Days": "Posledních 30 dní",
@@ -321,7 +327,9 @@
   "preferences.transactionEntryFlow.abandonUponCancelForm": "Zrušit celý postup při zrušení jakéhokoli kroku",
   "preferences.transactionEntryFlow.actions": "Seznam akcí",
   "preferences.transactionEntryFlow.actions.description": "Pořadí můžete změnit přetažením.",
-  "preferences.transactionEntryFlow.description": "Pro úsporu času vám Flow pomáhá automatickým otevíráním formulářů při vytváření transakce.",
+  "preferences.transactionEntryFlow.actions.lastItem": "Musí být poslední",
+  "preferences.transactionEntryFlow.description": "Pro úsporu času vám Flow pomáhá tím, že při vytváření transakce automaticky otevírá některé formuláře. Pokud dáváte přednost ručnímu otevírání každého formuláře, můžete všechna automatická otevření vypnout.",
+  "preferences.transactionEntryFlow.skipSelectedFields": "Přeskočit již vybraná pole",
   "preferences.transactions": "Transakce",
   "preferences.transactions.geo": "Poloha transakce",
   "preferences.transactions.geo.auto.description": "Automaticky připojit vaši aktuální polohu k novým transakcím. I když je tato možnost vypnutá, stále můžete ručně vybrat místo na mapě.",
@@ -662,6 +670,12 @@
   "transactionFilterPreset.saveAsNew.guide": "Chcete-li uložit novou předvolbu, změňte filtry a vraťte se sem.",
   "transactionFilterPreset.saveAsNew.name": "Název předvolby",
   "transactions.all": "Všechny transakce",
+  "transactions.batch.assignAccountForAll": "Přiřadit účet všem",
+  "transactions.batch.assignAccountIndividually": "Přiřadit účty jednotlivě",
+  "transactions.batch.import": "Hromadný import",
+  "transactions.batch.import.success": "Úspěšně importováno {n} transakcí",
+  "transactions.batch.importN": "Importovat {n} transakcí",
+  "transactions.batch.review": "Prosím zkontrolujte transakce",
   "transactions.count": "{count} transakcí",
   "transactions.pending": "Čekající transakce",
   "transactions.query.clearAll": "Vymazat filtry",

assets/l10n/de_DE.json

@@ -16,6 +16,11 @@
   "account.new": "Konto hinzufügen",
   "account.noAccounts": "Du hast keine Konten!",
   "account.postTransactionBalance": "Kontostand nach dieser Buchung",
+  "account.primaryAccount": "Hauptkonto",
+  "account.primaryAccount.changeDescription": "Sie können ein anderes Konto als Hauptkonto festlegen, indem Sie zur Bearbeitungsseite dieses Kontos gehen.",
+  "account.primaryAccount.description": "Das Hauptkonto wird als Standardkonto für neue Transaktionen und andere Funktionen verwendet.",
+  "account.primaryAccount.notPrimary": "Nicht primäres Konto",
+  "account.primaryAccount.set": "Als Hauptkonto festlegen",
   "account.thisMonth": "Dieser Monat",
   "account.transactions": "Buchungen",
   "account.transactions.title": "Buchungen von „{account}“",
@@ -134,6 +139,7 @@
   "enum.TransactionEntryAction@inputTitle": "Titel eingeben",
   "enum.TransactionEntryAction@selectAccount": "Konto auswählen",
   "enum.TransactionEntryAction@selectCategoryOrTransferAccount": "Kategorie/Transferkonto auswählen",
+  "enum.TransactionEntryAction@selectPrimaryAccount": "Primärkonto auswählen",
   "enum.TransactionEntryAction@selectTags": "Tags auswählen",
   "enum.TransactionFilterRangePreset@allTime": "Gesamter Zeitraum",
   "enum.TransactionFilterRangePreset@last30Days": "Letzte 30 Tage",
@@ -321,7 +327,9 @@
   "preferences.transactionEntryFlow.abandonUponCancelForm": "Ablauf beenden, wenn eines der Formulare abgebrochen wird",
   "preferences.transactionEntryFlow.actions": "Liste der Aktionen",
   "preferences.transactionEntryFlow.actions.description": "Du kannst sie durch Ziehen neu anordnen",
-  "preferences.transactionEntryFlow.description": "Um Zeit zu sparen, öffnet Flow beim Erstellen einer Transaktion automatisch einige Formulare.",
+  "preferences.transactionEntryFlow.actions.lastItem": "Muss das letzte Element sein",
+  "preferences.transactionEntryFlow.description": "Um Zeit zu sparen öffnet Flow beim Erstellen einer Transaktion automatisch einige Formulare. Sie können alle automatischen Einträge deaktivieren, wenn Sie die Formulare lieber manuell öffnen möchten.",
+  "preferences.transactionEntryFlow.skipSelectedFields": "Bereits ausgewählte Felder überspringen",
   "preferences.transactions": "Buchungen",
   "preferences.transactions.geo": "Standort der Buchung",
   "preferences.transactions.geo.auto.description": "Dein aktueller Standort wird automatisch zu neuen Buchungen hinzugefügt. Auch wenn das ausgeschaltet ist, kannst du immer noch einen Ort auf der Karte auswählen und hinzufügen.",
@@ -662,6 +670,12 @@
   "transactionFilterPreset.saveAsNew.guide": "Um eine neue Voreinstellung zu speichern, ändere die Filter und komm hierher zurück.",
   "transactionFilterPreset.saveAsNew.name": "Name der Voreinstellung",
   "transactions.all": "Alle Buchungen",
+  "transactions.batch.assignAccountForAll": "Konten für alle zuweisen",
+  "transactions.batch.assignAccountIndividually": "Konten einzeln zuweisen",
+  "transactions.batch.import": "Stapelimport",
+  "transactions.batch.import.success": "Erfolgreich {n} Transaktionen importiert",
+  "transactions.batch.importN": "{n} Transaktionen importieren",
+  "transactions.batch.review": "Bitte überprüfen Sie die Transaktionen",
   "transactions.count": "{} Buchungen",
   "transactions.pending": "Ausstehende Buchungen",
   "transactions.query.clearAll": "Filter löschen",

assets/l10n/en.json

@@ -16,6 +16,11 @@
   "account.new": "Add an account",
   "account.noAccounts": "You don't have any accounts!",
   "account.postTransactionBalance": "Balance after this transaction",
+  "account.primaryAccount": "Primary Account",
+  "account.primaryAccount.changeDescription": "You can set another account as primary by going to that account's edit page.",
+  "account.primaryAccount.description": "The primary account is used as the default account for new transactions and other features.",
+  "account.primaryAccount.notPrimary": "Not Primary Account",
+  "account.primaryAccount.set": "Set as Primary Account",
   "account.thisMonth": "This month",
   "account.transactions": "Transactions",
   "account.transactions.title": "\"{account}\" transactions",
@@ -134,6 +139,7 @@
   "enum.TransactionEntryAction@inputTitle": "Enter title",
   "enum.TransactionEntryAction@selectAccount": "Select account",
   "enum.TransactionEntryAction@selectCategoryOrTransferAccount": "Select category/transfer account",
+  "enum.TransactionEntryAction@selectPrimaryAccount": "Select primary account",
   "enum.TransactionEntryAction@selectTags": "Select tags",
   "enum.TransactionFilterRangePreset@allTime": "All time",
   "enum.TransactionFilterRangePreset@last30Days": "Last 30 days",
@@ -321,7 +327,9 @@
   "preferences.transactionEntryFlow.abandonUponCancelForm": "Stop flow when any one of the forms is dismissed",
   "preferences.transactionEntryFlow.actions": "List of actions",
   "preferences.transactionEntryFlow.actions.description": "You can drag to reorder them",
-  "preferences.transactionEntryFlow.description": "To save time, Flow helps you by automatically opening some of the forms when creating a transaction.",
+  "preferences.transactionEntryFlow.actions.lastItem": "Must be last",
+  "preferences.transactionEntryFlow.description": "To save time, Flow helps you by automatically opening some of the forms when creating a transaction. You can disable all of the entries if you prefer to manually open each form.",
+  "preferences.transactionEntryFlow.skipSelectedFields": "Skip already selected fields",
   "preferences.transactions": "Transactions",
   "preferences.transactions.geo": "Transaction location",
   "preferences.transactions.geo.auto.description": "Automatically attach your current location to new transactions. Even if you have this turned off, you can still choose a location on a map to attach it.",
@@ -662,6 +670,12 @@
   "transactionFilterPreset.saveAsNew.guide": "To save a new preset, change the filters, and come back here",
   "transactionFilterPreset.saveAsNew.name": "Preset name",
   "transactions.all": "All transactions",
+  "transactions.batch.assignAccountForAll": "Assign accounts for all",
+  "transactions.batch.assignAccountIndividually": "Assign accounts individually",
+  "transactions.batch.import": "Batch import",
+  "transactions.batch.import.success": "Successfully imported {n} transactions",
+  "transactions.batch.importN": "Import {n} transactions",
+  "transactions.batch.review": "Please review the transactions",
   "transactions.count": "{} transactions",
   "transactions.pending": "Pending transactions",
   "transactions.query.clearAll": "Clear filters",

assets/l10n/es_ES.json

@@ -16,6 +16,11 @@
   "account.new": "Añadir una cuenta",
   "account.noAccounts": "¡No tienes ninguna cuenta!",
   "account.postTransactionBalance": "Saldo después de esta transacción",
+  "account.primaryAccount": "Cuenta principal",
+  "account.primaryAccount.changeDescription": "Puedes establecer otra cuenta como principal yendo a la página de edición de esa cuenta.",
+  "account.primaryAccount.description": "La cuenta principal se utiliza como cuenta predeterminada para nuevas transacciones y otras funciones.",
+  "account.primaryAccount.notPrimary": "No es la cuenta principal",
+  "account.primaryAccount.set": "Establecer como cuenta principal",
   "account.thisMonth": "Este mes",
   "account.transactions": "Transacciones",
   "account.transactions.title": "Transacciones de \"{account}\"",
@@ -134,6 +139,7 @@
   "enum.TransactionEntryAction@inputTitle": "Introducir título",
   "enum.TransactionEntryAction@selectAccount": "Seleccionar cuenta",
   "enum.TransactionEntryAction@selectCategoryOrTransferAccount": "Seleccionar categoría o cuenta de transferencia",
+  "enum.TransactionEntryAction@selectPrimaryAccount": "Seleccionar cuenta principal",
   "enum.TransactionEntryAction@selectTags": "Seleccionar etiquetas",
   "enum.TransactionFilterRangePreset@allTime": "Desde siempre",
   "enum.TransactionFilterRangePreset@last30Days": "Últimos 30 días",
@@ -321,7 +327,9 @@
   "preferences.transactionEntryFlow.abandonUponCancelForm": "Detener el flujo si se cierra cualquiera de los formularios",
   "preferences.transactionEntryFlow.actions": "Lista de acciones",
   "preferences.transactionEntryFlow.actions.description": "Puedes arrastrarlas para reordenarlas",
-  "preferences.transactionEntryFlow.description": "Para ahorrar tiempo, Flow te ayuda abriendo automáticamente algunos formularios al crear una transacción.",
+  "preferences.transactionEntryFlow.actions.lastItem": "Debe ser el último",
+  "preferences.transactionEntryFlow.description": "Para ahorrar tiempo, Flow te ayuda abriendo automáticamente algunos formularios al crear una transacción. Puedes desactivar todas las entradas si prefieres abrir manualmente cada formulario.",
+  "preferences.transactionEntryFlow.skipSelectedFields": "Omitir campos ya seleccionados",
   "preferences.transactions": "Transacciones",
   "preferences.transactions.geo": "Ubicación de la transacción",
   "preferences.transactions.geo.auto.description": "Adjuntar automáticamente tu ubicación actual a nuevas transacciones. Incluso si lo tienes desactivado, puedes elegir una ubicación en un mapa para adjuntarla.",
@@ -662,6 +670,12 @@
   "transactionFilterPreset.saveAsNew.guide": "Para guardar un nuevo preajuste, cambia los filtros y vuelve aquí",
   "transactionFilterPreset.saveAsNew.name": "Nombre del preajuste",
   "transactions.all": "Todas las transacciones",
+  "transactions.batch.assignAccountForAll": "Asignar cuentas para todas las transacciones",
+  "transactions.batch.assignAccountIndividually": "Asignar cuentas individualmente",
+  "transactions.batch.import": "Importación masiva",
+  "transactions.batch.import.success": "Se han importado correctamente {n} transacciones",
+  "transactions.batch.importN": "Importar {n} transacciones",
+  "transactions.batch.review": "Por favor, revise las transacciones",
   "transactions.count": "{} transacciones",
   "transactions.pending": "Transacciones pendientes",
   "transactions.query.clearAll": "Borrar filtros",