Ga naar hoofdinhoud

Activiteiten importeren

FlowForth ondersteunt het in bulk importeren van activiteiten vanuit een CSV-bestand. Dit is handig bij het migreren vanuit een ander systeem of bij het in één keer instellen van een groot aantal geplande activiteiten.

info

Activiteiten importeren is alleen beschikbaar voor Master-gebruikers. Als je de importoptie niet ziet, neem dan contact op met je FlowForth-beheerder.

Vereisten​

Voordat je activiteiten importeert, moet je het volgende al hebben geïmporteerd:

  1. Klanten — Zie Klanten importeren.
  2. Locaties — Zie Locaties importeren.

Activiteiten zijn gekoppeld aan locaties via het veld ExternalLocationId, dus de betreffende locaties moeten in FlowForth bestaan voordat je activiteiten importeert.

CSV-bestandsformaat​

Je CSV-bestand moet een komma als scheidingsteken gebruiken en de volgende kolommen bevatten in exact deze volgorde:

KolomVerplichtBeschrijving
ExternalLocationIdJaDe externe ID van de locatie waar deze activiteit plaatsvindt
TitleJaDe naam of beschrijving van de activiteit
DescriptionNeeAanvullende details over de activiteit
ScheduledDateJaDe datum voor de activiteit (M/D/JJJJ-formaat)
StartTimeNeeStarttijd (bijv. 09:00)
EndTimeNeeEindtijd (bijv. 11:00)
PriceNeeDe prijs voor deze activiteit (decimaal getal)
IsRecurringNeeOf dit een terugkerende activiteit is (true of false)
RepeatPatternNeeHerhalingspatroon: Daily, Weekly, BiWeekly, Monthly of Yearly
RepeatAmountNeeHerhalingsinterval (bijv. 1 voor elke week, 2 voor om de week)
EndDateNeeEinddatum voor herhaling (M/D/JJJJ-formaat)

Voorbeeld CSV​

ExternalLocationId,Title,Description,ScheduledDate,StartTime,EndTime,Price,IsRecurring,RepeatPattern,RepeatAmount,EndDate
LOC-001,Weekly Cleaning,Office cleaning service,3/10/2025,09:00,11:00,150.00,true,Weekly,1,12/31/2025
LOC-001,Window Washing,Exterior windows,3/15/2025,13:00,15:00,250.00,false,,,,
LOC-002,Garden Maintenance,Front and back gardens,3/10/2025,08:00,12:00,200.00,true,BiWeekly,1,12/31/2025
tip

De eerste rij van je CSV-bestand wordt behandeld als koprij en wordt automatisch overgeslagen tijdens het importeren.

Importeren​

  1. Navigeer naar de pagina Activiteiten importeren.
  2. Selecteer de organisatie waarvoor je activiteiten wilt importeren uit het dropdownmenu.
  3. Klik op Bestand kiezen en selecteer je CSV-bestand.
  4. Klik op Activiteiten importeren om het proces te starten.

Pagina activiteiten importeren met geselecteerd bestand

Pagina activiteiten importeren met geselecteerd bestand

Het importeren kan even duren, afhankelijk van het aantal rijen.

Importresultaten​

Na het importeren zie je een samenvatting met:

  • Totaal aantal rijen — Aantal verwerkte gegevensrijen.
  • Aangemaakt — Aantal nieuwe activiteiten dat is toegevoegd.
  • Terugkerende instanties aangemaakt — Aantal extra instanties gegenereerd uit terugkerende activiteiten.
  • Fouten — Aantal rijen dat is mislukt.

Samenvatting importresultaten

Samenvatting importresultaten

Terugkerende activiteiten importeren​

Wanneer je een activiteit importeert met IsRecurring ingesteld op true, zal FlowForth:

  1. De eerste activiteit aanmaken op de opgegeven ScheduledDate.
  2. Automatisch terugkerende instanties genereren tot de EndDate op basis van het RepeatPattern en RepeatAmount.
  3. Elke gegenereerde instantie neemt de titel, beschrijving, prijs en tijdinstellingen over van de bovenliggende activiteit.

Het aantal Terugkerende instanties aangemaakt in de resultaten toont hoeveel extra instanties er zijn gegenereerd.

Foutafhandeling​

Als er rijen niet geïmporteerd kunnen worden, wordt de foutlijst weergegeven onder de resultatensamenvatting. Veelvoorkomende fouten zijn:

  • Ontbrekende verplichte velden — ExternalLocationId, Title en ScheduledDate zijn verplicht voor elke rij.
  • Verkeerd aantal kolommen — Elke rij moet exact 11 velden bevatten (gebruik lege waarden voor optionele velden).
  • Ongeldig datumformaat — Datums moeten het M/D/JJJJ-formaat gebruiken (bijv. 3/10/2025).
  • Onbekende locatie — De ExternalLocationId komt niet overeen met een locatie in de organisatie.
  • Ongeldige herhalingsinstellingen — Als IsRecurring true is, moet een geldig RepeatPattern worden opgegeven.
waarschuwing

Rijen met ontbrekende verplichte velden (ExternalLocationId, Title of ScheduledDate) worden volledig overgeslagen. Zorg ervoor dat elke rij minstens deze velden ingevuld heeft.

CSV-tips​

  • Komma's in waarden — Zet velden met komma's tussen dubbele aanhalingstekens: "Dieptereiniging, volledige service"
  • Aanhalingstekens in waarden — Gebruik dubbele aanhalingstekens om te escapen: "Installeer ""Premium"" Pakket"
  • Lege optionele velden — Laat ze leeg maar bewaar de komma's: LOC-001,Schoonmaak,,3/10/2025,,,,,,,
  • Codering — Sla je bestand op in UTF-8-codering om te zorgen dat speciale tekens behouden blijven.
  • Datumformaat — Gebruik het M/D/JJJJ-formaat (maand/dag/jaar), bijv. 3/10/2025 voor 10 maart 2025.

Zie ook​

Was this page helpful?