Producten en vragen importeren: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(→‎Importeren)
(→‎Objecttype: 'Vraag')
 
(29 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:
 
__TOC__
 
__TOC__
 
= Algemeen =
 
= Algemeen =
−
Voordat producten en vragen van Kluwer en SDU geïmporteerd kunnen worden dienen de objecttypen 'Product' en 'Vraag' aanwezig te zijn op de omgeving. Zie onderstaande specificaties.
+
Binnen het zaaksysteem kunnen producten en diensten worden beheerd (PDC). Deze producten kunnen als zelfstandig object worden beheerd binnen het zaaksysteem, maar het is ook mogelijk om producten van andere contentleveranciers te importeren. Dit betekent dat de objecten worden aangemaakt, of worden bijgewerkt aan de hand van de data van een exportbestand. Zo is het bijvoorbeeld mogelijk om producten en diensten te importeren van Kluwer, die veel gebruikt wordt bij gemeenten die een CMS van SIM hebben. In deze pagina wordt toegelicht hoe producten en diensten met een exportbestand (API) van Kluwer te beheren zijn door de functioneel beheerder.
  
 
= Objecttypen =
 
= Objecttypen =
−
Deze objecttypen zijn hetzelfde als andere objecttypen. Voor uitleg over hoe een objecttype wordt aangemaakt, zie: [http://wiki.zaaksysteem.nl/Catalogus#Objecttypen Catalogus: Objecttypen]
+
Zoals in de vorige paragraaf toegelicht, worden producten en diensten als een object gezien in het zaaksysteem. Voordat de producten en diensten geimporteerd kunnen worden, is het nodig om een objecttype '''Product''' aan te maken. Wanneer u gebruik maakt van de basiscatalogus 2.0 is het mogelijk dat dit objecttype 'Product' al aanwezig is binnen uw catalogus. Voor een uitleg over hoe een objecttype kan worden aangemaakt, zie: [[Catalogus_objecttype|Catalogus: Objecttypen]]
  
−
De objecttypen vereisen de onderstaande inrichting:
+
Om de import van externe content goed te laten verlopen, is er een mapping nodig met kenmerken in het zaaksysteem. Deze kenmerken moeten dus aanwezig zijn in het objecttype Product. Controleer dus goed of uw objecttype de juiste verplichte kenmerken bevat. De import vult de waarden van de kenmerken namelijk op naam. Anders gezegd, wanneer u andere namen voor uw kenmerken gebruikt (niet te verwarren met de titel) dan werkt het niet. De verplichte kenmerken in het objecttype product zijn:
  
 
=== Objecttype: 'Product' ===
 
=== Objecttype: 'Product' ===
Regel 14: Regel 14:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
!Naam
+
!style="width:130px"|Naam
−
!Type
+
!style="width:180px"|Magicstring
 +
!style="width:120px"|Type
 
|-
 
|-
 +
|Extern ID
 +
|pdc_external_id
 +
|Tekstveld
 +
|-
 +
|Naam
 
|pdc_name
 
|pdc_name
−
|tekstveld
+
|Tekstveld
 
|-
 
|-
 +
|Omschrijving
 
|pdc_description
 
|pdc_description
−
|Rich text
+
|Groot tekstveld
 
|-
 
|-
 +
|Prijs
 
|pdc_price
 
|pdc_price
−
|Rich text
+
|Groot tekstveld
 
|-
 
|-
 +
|Aanpak
 
|pdc_approach
 
|pdc_approach
−
|Rich text
+
|Groot tekstveld
 
|-
 
|-
 +
|Voorwaarden
 
|pdc_terms
 
|pdc_terms
−
|Rich text
+
|Groot tekstveld
 +
|-
 +
|Bezwaar en beroep
 +
|pdc_appeal
 +
|Groot tekstveld
 +
|-
 +
|Wet- en regelgeving
 +
|pdc_law_rules
 +
|Groot tekstveld
 +
|-
 +
|Contact
 +
|pdc_contact
 +
|Groot tekstveld
 +
|-
 +
|Adressen
 +
|pdc_submission_addresses
 +
|Groot tekstveld
 +
|-
 +
|Doelgroepen
 +
|pdc_audience
 +
|Groot tekstveld
 +
|-
 +
|Werkinstructie
 +
|pdc_work_instruction
 +
|Groot tekstveld
 
|-
 
|-
−
|pdc_external_id
+
|Interne contactpersonen
−
|Tekstveld
+
|pdc_internal_contact_persons
 +
|Groot tekstveld
 
|}
 
|}
 
|[[bestand:objecttype product.png|thumb|Inrichting product]]
 
|[[bestand:objecttype product.png|thumb|Inrichting product]]
 
|}
 
|}
 +
 +
Let op: De kenmerken mogen niet als verplicht aangeduid geworden.
  
 
=== Objecttype: 'Vraag' ===
 
=== Objecttype: 'Vraag' ===
Regel 44: Regel 81:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
!Naam
+
!style="width:130px"|Naam
−
!Type
+
!style="width:180px"|Magicstring
 +
!style="width:120px"|Type
 
|-
 
|-
 +
|Extern ID
 +
|pdc_external_id
 +
|Tekstveld
 +
|-
 +
|Titel
 +
|faq_title
 +
|Tekstveld
 +
|-
 +
|Vraag
 
|faq_question
 
|faq_question
−
|Rich text
+
|Groot tekstveld
 
|-
 
|-
 +
|Antwoord
 
|faq_answer
 
|faq_answer
−
|Rich text
+
|Groot tekstveld
−
|-
 
−
|pdc_external_id
 
−
|Tekstveld
 
 
|}
 
|}
 
|[[bestand:objecttype vraag.png|thumb|Inrichting vraag]]
 
|[[bestand:objecttype vraag.png|thumb|Inrichting vraag]]
 
|}
 
|}
 +
 +
Let op: De kenmerken mogen niet als verplicht aangeduid geworden.
  
 
= Importeren =
 
= Importeren =
−
Het importeren gaat op de zelfde manier als de [http://wiki.zaaksysteem.nl/Catalogus#Zaaktypen_importeren zaaktype import]:
+
{| width="100%"
 +
|- style="vertical-align:top;"
 +
|Het importeren van producten gebeurt om een soortgelijke manier als met zaaktypen. Het importbestand wordt eerst ingeladen, waarna u een overzicht ziet van alle producten dien als nieuw worden geimporteerd, of die gewijzigd worden omdat de inhoud gewijzigd is.
 +
 
 
<ul>
 
<ul>
 
<li>Ga naar een map in de catalogus</li>
 
<li>Ga naar een map in de catalogus</li>
Regel 70: Regel 120:
 
</ul>
 
</ul>
  
−
Let op: Ondanks dat de import nog gestart wordt vanuit de catalogus komen objecten niet in de catalogus. Ze zijn terug te vinden via ObjectZoeken met de objecttypefilter ingsteld op 'Product' of 'Vraag'.
+
Bij het importeren van producten zullen automatisch de relaties met de bestaande vragen gelegd worden, en andersom. Het is daarom belangrijk één van beide nogmaals te importeren (bij voorkeur het kleinste bestand), bijvoorbeeld:
 +
<ol>
 +
<li>Importeer de producten</li>
 +
<li>Importeer de vragen, waarbij deze relaties leggen met de bestaande producten</li>
 +
<li>Importeer de producten nogmaals, waarbij deze relaties leggen met de bestaande vragen</li>
 +
</ol>
 +
 
 +
Let op: Ondanks dat de import gestart wordt vanuit de catalogus komen objecten niet in de catalogus. Ze zijn terug te vinden via 'Uitgebreid zoeken' met de objecttypefilter ingsteld op 'Product' of 'Vraag'.
 +
|[[Bestand:PDC_import.png|thumb|Importeren producten]]
 +
|}

Huidige versie van 4 jul 2017 om 16:52

Algemeen

Binnen het zaaksysteem kunnen producten en diensten worden beheerd (PDC). Deze producten kunnen als zelfstandig object worden beheerd binnen het zaaksysteem, maar het is ook mogelijk om producten van andere contentleveranciers te importeren. Dit betekent dat de objecten worden aangemaakt, of worden bijgewerkt aan de hand van de data van een exportbestand. Zo is het bijvoorbeeld mogelijk om producten en diensten te importeren van Kluwer, die veel gebruikt wordt bij gemeenten die een CMS van SIM hebben. In deze pagina wordt toegelicht hoe producten en diensten met een exportbestand (API) van Kluwer te beheren zijn door de functioneel beheerder.

Objecttypen

Zoals in de vorige paragraaf toegelicht, worden producten en diensten als een object gezien in het zaaksysteem. Voordat de producten en diensten geimporteerd kunnen worden, is het nodig om een objecttype Product aan te maken. Wanneer u gebruik maakt van de basiscatalogus 2.0 is het mogelijk dat dit objecttype 'Product' al aanwezig is binnen uw catalogus. Voor een uitleg over hoe een objecttype kan worden aangemaakt, zie: Catalogus: Objecttypen

Om de import van externe content goed te laten verlopen, is er een mapping nodig met kenmerken in het zaaksysteem. Deze kenmerken moeten dus aanwezig zijn in het objecttype Product. Controleer dus goed of uw objecttype de juiste verplichte kenmerken bevat. De import vult de waarden van de kenmerken namelijk op naam. Anders gezegd, wanneer u andere namen voor uw kenmerken gebruikt (niet te verwarren met de titel) dan werkt het niet. De verplichte kenmerken in het objecttype product zijn:

Objecttype: 'Product'

Vereiste kenmerken:
Naam Magicstring Type
Extern ID pdc_external_id Tekstveld
Naam pdc_name Tekstveld
Omschrijving pdc_description Groot tekstveld
Prijs pdc_price Groot tekstveld
Aanpak pdc_approach Groot tekstveld
Voorwaarden pdc_terms Groot tekstveld
Bezwaar en beroep pdc_appeal Groot tekstveld
Wet- en regelgeving pdc_law_rules Groot tekstveld
Contact pdc_contact Groot tekstveld
Adressen pdc_submission_addresses Groot tekstveld
Doelgroepen pdc_audience Groot tekstveld
Werkinstructie pdc_work_instruction Groot tekstveld
Interne contactpersonen pdc_internal_contact_persons Groot tekstveld
Inrichting product

Let op: De kenmerken mogen niet als verplicht aangeduid geworden.

Objecttype: 'Vraag'

Vereiste kenmerken:
Naam Magicstring Type
Extern ID pdc_external_id Tekstveld
Titel faq_title Tekstveld
Vraag faq_question Groot tekstveld
Antwoord faq_answer Groot tekstveld
Inrichting vraag

Let op: De kenmerken mogen niet als verplicht aangeduid geworden.

Importeren

Het importeren van producten gebeurt om een soortgelijke manier als met zaaktypen. Het importbestand wordt eerst ingeladen, waarna u een overzicht ziet van alle producten dien als nieuw worden geimporteerd, of die gewijzigd worden omdat de inhoud gewijzigd is.
  • Ga naar een map in de catalogus
  • Kies onder de plusknop de optie 'importeren'
  • Selecteer de optie 'Producten en diensten' of 'Vragen en antwoorden'
  • Selecteer de optie 'Kluwer (SIM)' of 'SDU'
  • Upload het bestand en doe 'volgende'
  • Wanneer alle items op 'Groen' staan kan de import gestart worden

Bij het importeren van producten zullen automatisch de relaties met de bestaande vragen gelegd worden, en andersom. Het is daarom belangrijk één van beide nogmaals te importeren (bij voorkeur het kleinste bestand), bijvoorbeeld:

  1. Importeer de producten
  2. Importeer de vragen, waarbij deze relaties leggen met de bestaande producten
  3. Importeer de producten nogmaals, waarbij deze relaties leggen met de bestaande vragen

Let op: Ondanks dat de import gestart wordt vanuit de catalogus komen objecten niet in de catalogus. Ze zijn terug te vinden via 'Uitgebreid zoeken' met de objecttypefilter ingsteld op 'Product' of 'Vraag'.

Importeren producten
Overgenomen van "http://wiki.zaaksysteem.nl/index.php?title=Producten_en_vragen_importeren&oldid=9819"