Momenteel in ontwikkeling: Objecten V2
Laatste updates:
- Objectacties: In het zaaktype krijg je nu vanaf fase 2 de mogelijkheid om ook objectacties toe te voegen. Het object V2 wordt via een relatiekenmerk aangemaakt en biedt nu ook mogelijkheden tot 'aanmaken bij faseovergang' functionaliteiten die we al kennen met email- en document sjablonen en deelzaken. Deze functionaliteit gaat mee in de release van 2022.4 (10 mei). De actie mogelijkheden zullen zijn: Aanmaken en wijzigen.
- Mapping datumkenmerk: Wanneer de magic string [[bomen_datum]] is dan wordt de juiste manier van mappen [[bomen_datum | isodate]]. In het geval van b.v.b. een datum kenmerk, wordt [[datumkenmerk]] dus [[datumkenmerk | isodate]
Ga direct naar het aanmaken van een Object V2
Ga direct naar 'Veelgestelde vragen'
Ga direct naar 'Omzetten Objecten V1 naar V2'
Conceptueel hetzelfde als objecten v1, echter:
-
- Nieuwe features en helemaal nieuw ontwikkeld (beter geschreven)
- Maar! Sommige dingen kunnen nog wel in V1 en niet in V2 (Waardes kunnen niet teruggekoppeld worden naar de zaak, objecten kunnen nog niet aan elkaar gerelateerd worden)
- Nu nog zoeken van Objecten V2 mogelijk maken. (Momenteel nog niet mogelijk, eind Q2 verwacht zie de roadmap)
- Nieuwe features en helemaal nieuw ontwikkeld (beter geschreven)
Wat kunnen Objecten V2?
-
-
- Opbouw is anders gemaakt (look en feel)
- We introduceren twee nieuw kenmerktypes: Het Relatiekenmerk en Adres V2
- Hele kaart is een kenmerk.
- Lijnen zetten, vierkanten blokken maken, je kunt omgevingen afbakenen
-
| Feature | Object V1 | Object V2 |
|
Aanmaken van een object vanuit een zaak |
√ | √ |
|
Het verwijderen van een object vanuit een zaak |
√ | √ |
|
Het verwijderen vanuit de API |
X | √ |
| Het aanmaken van uit de API | x | √ |
| Bewerken van een object vanuit een zaak | √ | √ |
|
Bewerken van een object vanuit het API |
√ | √ |
|
Objecten relateren aan een contactdossier |
X | √ |
|
Geo-informatie opslaan |
X | √ |
|
Kenmerktype gerelateerd contact opslaan |
X | √ |
|
Objecten relateren via API |
X | √ |
|
Zaak aan object koppelen via ZS interface |
√ | √ |
|
Zaak aan object koppelen via API |
X | √ |
|
Objecten vinden in relatietabblad van gerelateerde zaak |
√ | √ |
|
Objecten vinden bij gerelateerd contact of gerelateerde zaak (en daar bewerken) |
X | √ |
|
Objecten uit ZS trekken via API |
X | √ |
Veel voorkomende vragen
Overzicht
-
Wanneer ik het relatiekenmerk gebruik voor een persoon, krijgt deze dan automatisch rechten?
-
Ik wil het object updaten d.m.v. een kenmerk aan te passen in de zaak, kan dit?
-
Kunnen objecten v2 geïmporteerd worden naar andere omgevingen?
-
We hebben veel objecten V1 aangemaakt, kunnen we deze in blijven zien de komende tijd?
-
Ik wil een kenmerk mappen in het object, hoe vertaal ik de magic string naar de juiste mapping?
1. Welke kenmerktypes worden ondersteund ?
- Geo
- Relatie
- Rekeningnummer
- Datum
- Document
- Geocoordinaten (lat/lon)
- Afbeelding (URL)
- Numeriek
- Enkelvoudige keuze
- Keuzelijst
- Betrokkene
- Tekstveld
- Tekstveld (HOOFDLETTERS)
- Groot tekstveld
- Rich text
- Webadres
- Valuta
Let op! Meervoudige keuzekenmerken worden momenteel nog niet ondersteund door objecten V2.
2. Kan iedereen zo maar een object V2 bewerken?
Nee, Objecten V2 werken op basis van rollen / rechten inrichting. Wanneer iemand geen rechten heeft tot een object bewerken, dan kan hij/zij dit ook niet.
Let op! Wanneer er een object aangemaakt wordt in de zaak, zorg ervoor dat de behandelaar van de zaak wel de rechten heeft voor het object, mits hij/zij het object ook moet kunnen inzien.
3. Kan iedereen zo maar een object V2 verwijderen?
Nee, alleen de Admin of medewerker met beheerrechten in het object kan het object verwijderen. Dit gebeurt in het object zelf.
4. Wanneer ik het relatiekenmerk gebruik voor een persoon, krijgt deze dan automatisch rechten?
Nee, momenteel is het via het relatiekenmerk alleen mogelijk om personen op te vragen en te betrekken bij de zaak o.b.v. de rollen en rechten die zij voor de zaak hebben. Hebben zij dus geen rechten om de zaak te kunnen inzien / raadplegen / behandelen, dan kunnen zij dit nog altijd niet. Wil je wel iemand als betrokkene toevoegen met specifieke rechten, gebruik dan voor nu nog het relatie tab in de zaak en voeg via hier een betrokkene toe aan de zaak.
Let op, wanneer je een persoon opvraagt via het relatiekenmerk dan zal deze alleen een mailnotificatie krijgen. Het belletje in Zaaksysteem wordt nog niet getriggerd.
5. Ik wil het object gebruiken om in nieuwe zaken informatie automatisch in te laten vullen wanneer ik het object opvraag, kan dit?
Momenteel is het nog niet mogelijk om dit te doen. Het staat echter wel op de planning om ervoor te zorgen dat objecten V2 met regels gemuteerd kunnen worden. Het objecttype moet in dit geval wel geconfigureerd worden.
6. Ik wil het object updaten d.m.v. een kenmerk aan te passen in de zaak, kan dit?
Ja, het updaten van een Object kan straks via de zaak. Dit gaat dan via object acties. Het is straks mogelijk om Objecten aan te maken en te muteren via regels. Met zo'n regel kun je dan ook een kenmerk wijzigenen in de zaak, mits ze ook gemapt zijn in het Object zelf.
7. Kunnen objecten v2 geïmporteerd worden naar andere omgevingen?
Nee, objecten moeten handmatig aangemaakt worden op elke individuele omgeving. Het relatiekenmerk wordt wel meegenomen met de import.
8. We hebben veel objecten V1 aangemaakt, kunnen we deze in blijven zien de komende tijd?
Ja, omdat veel klanten objecten V1 gebruikt hebben worden bugs die het werkproces verstoren nog altijd opgepakt en blijven objecten V1 inzichtelijk voor de eerstkomende tijd. Let wel op, we gaan objecten v1 niet meer updaten en op termijn uitfaseren.
9. Kunnen zaken vanuit het Object V2 aangemaakt worden?
Nee, dit is wel iets dat nog op de planning staat. Echter wordt de focus eerst op de zoekfunctionaliteit gelegd.
10. Kan ik documenten vanuit de zaak linken aan een Object V2?
Nee, helaas is het niet mogelijk om een document vanuit het documententab te linken aan een object. M.a.v. een documentveld in de zaak komt niet mee in het Object V2. Wat wel mogelijk is, is om d.m.v. een Relatiekenmerk "Document" een document te uploaden in een Object V2 zelf.
Note! Het is bij development bekend dat de documenten in een Object V2 niet geopend kunnen worden, dit is als bug geregistreerd en wordt naar gekeken.
11. Ik wil een kenmerk mappen in het object, hoe vertaal ik de magic string naar de juiste mapping?
Wanneer de magic string [[bomen_datum]] is, dan wordt de juiste manier van mappen [[bomen_datum | isodate]]. In het geval van b.v.b. een datum kenmerk, wordt [[datumkenmerk]] dus [[datumkenmerk | isodate]
Objecten V2 Visueel
Aanmaken in de catalogus
Maak in de catalogus een Object V2 aan door op de blauwe plusknop te drukken.
Klik vervolgens op Objecttype (beta)
Stap 1 Tab Algemeen:
Vul de volgende gegevens in:
- Objecttype: Nodig om de zaak op te vragen in het relatiekenmerk
- Objecttitel: Hier zoek je het object straks op terug
Vul de objecttitel op de volgende manier in, Let op! Dikgedrukt is dus de magicstring waar je op wil kunnen zoeken:
[[ j("$.attributes.custom_fields.ztc_onderwerp.value") ]] -
[[ j("$.attributes.custom_fields.dso_projectomschrijving.value") ]]
- Object subtitel: Hier kan je een subtitel samenstellen voor de objecten van dit type
- Externe referentie (optioneel)
Stap 2 Tab Kenmerken
Vul hier de nodige kenmerken toe: Klik op ‘zoek en voeg toe'.
Op het moment dat je het kenmerk intypt, zal het Object zelf suggesties geven.
Staat jouw kenmerk ertussen, klik er dan op.
Let op!
Bij de volgende invoertype zul je bij ‘afronden’ een foutmelding krijgen:
- Document
Kenmerken die wel ondersteund worden:
- Geo
- Relatie
- Rekeningnummer
- Datum
- Document
- Geocoordinaten (lat/lon)
- Afbeelding (URL)
- Numeriek
- Enkelvoudige keuze
- Keuzelijst
- Betrokkene
- Tekstveld
- Tekstveld (HOOFDLETTERS)
- Groot tekstveld
- Rich text
- Webadres
- Valuta
Voeg een onderwerp toe en klik vervolgens op ‘instellen’:
- Let op: Net zoals bij kenmerken, regels en sjablonen voeg je ook in het Object een titel toe aan het kenmerk. In de meeste gevallen zal deze hetzelfde zijn als het kenmerk in het zaaktype
-> 
Stap 3 Tab Relaties
Voeg hier eventueel een relatie toe. Niet verplicht.
Stap 4 Tab Rechten
Voeg de rechten toe:
- Net zoals bij een zaaktype en Object V1, is het belangrijk dat de rechten goed zijn ingericht.
- Deze voeg je toe door op ‘Rol en afdeling toevoegen’ te klikken.
- Let op, je kunt maar 1 type recht aanvinken.
- Selecteer hier de afdeling en de rol.
Stap 5 Tab Afronden
Rond het aanmaken van het Object af:
- Net zoals bij een zaaktype en Object V1, is het verplicht de wijzigingen door te geven.
- Helaas het tekstveld ook.
Vind nu je Object V2 terug in de map waarin je hem zojuist aangemaakt hebt.
- Wanneer je hierop klikt zul je hem kunnen bewerken.
Aanmaken in de zaak : Het Relatie kenmerk
Het relatie kenmerk:
- Invoertype: Relatie
- 4 relatietypen:
- Zaak
- Document
- Object
- Contact
D.m.v. het relatiekenmerk worden objecten nu aangemaakt in de zaak
-
- Meerdere waarden = objecten relateren. (makkelijker kopiëren/relateren van objecten)
- De optie bij vervolgzaak “gerelateerde objecten kopiëren” komt hierdoor te vervallen.
Relatie: Object
- Hier zet je het object in dat je in de zaak wil gebruiken. Denk aan opvragen of aanmaken.
Wanneer je het Relatie kenmerk aangemaakt hebt, kun je deze in het betreffende zaaktype zetten.
Nu het Object V2 in jouw zaaktype gezet is, moet je de volgende stappen na:
- Klik op het potloodje aan de rechterzijde
- Let op! De kenmerken met een hexagon als icoon zijn de verouderde versies van de objecten. In het voorbeeld hieronder is "JIN Relatie" het nieuwe kenmerk om een object mee op te vragen / aan te maken.
Nu je het Object V2 in jouw zaaktype gezet hebt, wil je hem ook aan kunnen maken:
- Vink “Object (test) aanmaken” aan (zie voorbeeld)
- Geef het aanmaak label en naam en check of alle kenmerken erin zitten.
- Sla het Object V2 op en publiceer de zaak om hem op de voorkant te testen.
Nu je het Object V2 gepubliceerd hebt:
- Open de zaak op de voorkant
- Test het Object V2 door op Test aanmaken’ te klikken.
- Loop na of de waardes worden meegenomen en maak het object ter controle aan.
- Wordt er nu een object gegenereerd?
Omzetten objecten V1 naar V2
Note: Let erop dat de zoekfunctie momenteel nog niet werkt! Verwachting is eind Q2. Hou voor updates over dit onderwerp deze beheerderspagina in de gaten of de community.
Bijgevoegd aan dit artikel vind je een .ZTB bestand.
Dit zaaktype kan gebruikt worden als template voor het overzetten van objecten V1 naar V2.
Let er hier wel op dat je de volgende stappen genomen hebt voordat je het zaaktype importeert:
- Zorg ervoor dat je op de ontwikkelomgeving werkt gedurende het testen van dit zaaktype. Het advies is om eerst een nieuw mapje aan te maken, specifiek voor objecten.
- Het object V2 kan de gegevens direct overnemen van het object V1. Voorwaarden zijn wel dat de kenmerk velden in beide objecten overeen komen. Anders moet je in het zaaktype gaan werken met 'mapping'.
- Het object V2 wordt, zoals hierboven uitgelegd, aangemaakt d.m.v. een relatiekenmerk. Zorg ervoor dat je deze ook aangemaakt hebt wanneer je de handeling wil uitvoeren.
- Note: Dit zaaktype bestand is een template! Oftewel, elke klant zal deze op haar eigen manier verder moeten uitwerken. Denk hierbij aan regels toevoegen e.d..
Objecten V1 blijven nu- en in de toekomst gewoon inzichtelijk en bruikbaar, echter is het belangrijk om te benoemen dat we dus niet meer gaan doorontwikkelen op objecten V1. Concreet houdt dit in dat wensen en kleine bugs niet meer meegenomen worden in de sprints. Objecten V1 wordt dus langzaam uitgefaseert. Uiteraard zullen we bugs die ervoor zorgen dat er niet meer gewerkt kan worden met objecten V1 nog wel oppakken.
Wanneer omzetten?
Bij processen zoals de kennisbank, waar veel gebruik gemaakt wordt van objecten geldt het volgende advies:
- Kies een rustige periode waar je het aangepaste zaaktype, met het nieuwe object v2 kenmerk (relatiekenmerk) op de productie omgeving zet.
- Zorg ervoor dat medewerkers nog wel objecten v1 kunnen opvragen in de zaak, maak niet meer aan kunnen maken (alleen relateren en bewerken). Objecten V1 en V2 kunnen naast elkaar staan in één fase. Idealiter zou je de medewerkers dus de optie geven om Objecten V2 te kunnen aanmaken, opvragen en bewerken- maar Objecten V1 alleen te kunnen opvragen en verwijderen.
- Let er dus wel op dat de kenmerken van het object v1 en v2 met elkaar overeenkomen.
Processen waarbij er sporadisch objecten aangemaakt worden geldt het volgende advies:
- Gebruik het template om de bestaande objecten over te zetten.
- Vervang het object V1 met het relatiekenmerk waar het nieuwe object V2 aan gelinkt is.