Handleiding voor de applicatiebeheerder Cane Webservices.nl Integratie

Handleiding voor de applicatiebeheerder ‘Cane Webservices.nl Integratie’

Versie 1.1 Cane Webservices.nl Integratie – Handleiding voor de Applicatiebeheerder

|1

Inhoud INHOUD ........................................................................................................................................................... 2 1.

INTRODUCTIE ........................................................................................................................................... 3 DOELSTELLING DOCUMENT......................................................................................................................................... 3 GERELATEERDE DOCUMENTEN .................................................................................................................................... 3 GEBRUIK VAN HET DOCUMENT .................................................................................................................................... 3 LEZERS DOELGROEP .................................................................................................................................................. 3

2.

INRICHTING WEBSERVICES.NL KOPPELING ............................................................................................... 4 INSTELLINGEN EXACT SYNERGY ENTERPRISE ................................................................................................................... 4 CONTROLE WERKING WEBSERVICES.NL MODULE ............................................................................................................ 4

3.

BACKGROUNDJOB VOOR BINNENHALEN INDICATIE VAN WIJZIGING........................................................ 5 DE URL ................................................................................................................................................................. 5

4.

DE MAATWERKTABELLEN ......................................................................................................................... 6 CSCANEWEBNLCICMPY ........................................................................................................................................... 6 CSCANEWEBNLLEGALFORMS .................................................................................................................................... 6 CSCANEWEBNLSBILEVEL1 ....................................................................................................................................... 6 CSCANEWEBNLSBILEVEL2 ....................................................................................................................................... 6 CSCANEWEBNLSBILEVEL3 ....................................................................................................................................... 6 CSCANEWEBNLSBILEVEL4 ....................................................................................................................................... 6 CSCANEWEBNLSBISECTIONS .................................................................................................................................... 6 CSCANEWEBNLCOMPANYSIZE .................................................................................................................................. 7

5.

BEKENDE (FOUT)MELDINGEN ................................................................................................................... 8 AUTHENTICATIE PROBLEEM. CONTROLEER DE WEBSERVICES.NL GEBRUIKERSNAAM EN WACHTWOORD ..................................... 8 WEBSERVICES.NL IS ONBEREIKBAAR. CONTROLEER DE INTERNETVERBINDING OP DE SERVER .................................................... 8 ONVERWACHTE EN ONBEKENDE FOUT OPGETREDEN ........................................................................................................ 8 GEEN RESULTAAT NA HET INGEVEN VAN EEN ZOEKACTIE ................................................................................................... 8 ONVOLDOENDE SALDO OM DEZE ACTIE UIT TE VOEREN..................................................................................................... 8 BIJ HET AANMAKEN VAN EEN NIEUWE RELATIE KOM IK NIET EERST IN HET ZOEKSCHERM, MAAR GA IK GELIJK NAAR HET AANMAKEN: RELATIE SCHERM ...................................................................................................................................................... 8

BIJLAGE A EXTRA INFORMATIE MAATWERKTABELLEN ..................................................................................... 9 BIJLAGE A.1 CSCANEWEBNLCICMPY .......................................................................................................................... 9 BIJLAGE A.2 CSCANEWEBNLLEGALFORMS ................................................................................................................ 11 BIJLAGE A.3 CSCANEWEBNLSBILEVEL1.................................................................................................................... 11 BIJLAGE A.4 CSCANEWEBNLSBILEVEL2.................................................................................................................... 11 BIJLAGE A.5 CSCANEWEBNLSBILEVEL3.................................................................................................................... 11 BIJLAGE A.6 CSCANEWEBNLSBILEVEL4.................................................................................................................... 11 BIJLAGE A.7 CSCANEWEBNLSBISECTIONS ................................................................................................................ 12 BIJLAGE A.8 CSCANEWEBNLCOMPANYSIZE ............................................................................................................... 12


|2

1. Introductie In dit document komen wat achtergrond zaken aan bod, waarmee de applicatiebeheerder meer informatie krijgt over de werking van de Cane Webservices.nl Integratie module. Vanaf nu wordt de module Cane Webservices.nl Integratie module ‘Webservices.nl’ module genoemd. Doelstelling document Na het lezen van dit document kan een applicatiebeheerder of een beheerder van de Exact Software de gebruikers van de Webservices.nl module ondersteunen. Daarnaast kan de lezer eventueel oplossingen definiëren of de juiste gegevens aan de helpdesk van Cane doorsturen. Gerelateerde documenten De volgende documenten zijn een aanvulling op de informatie rondom de Webservices.nl module: Documentnaam Gebruikers handleiding Cane Webservices.nl Integratie Installatie handleiding Cane Webservices.nl Integratie

Omschrijving Gebruikershandleiding waarin de werking van de Cane Webservices.nl Integratie module worden besproken. Installatie handleiding waarin de installatie van de Cane Webservices.nl Integratie module worden besproken.

Gebruik van het document Gebruik dit document als ondersteuning bij het beheren van de Webservices.nl module applicatie. Lezers doelgroep Het document is bestemd voor de volgende doelgroepen:

Doelgroep Applicatiebeheerders Systeembeheerders

Omschrijving Applicatiebeheerders die vanuit hun opdracht de software voor de Cane Webservices.nl Integratie moeten onderhouden. Persoon verantwoordelijk voor het onderhoud en inrichten van het Exact Synergy Enterprise systeem.


|3

2. Inrichting Webservices.nl koppeling Nadat de software geïnstalleerd is, dient de koppeling naar Webservices.nl te leggen. Instellingen Exact Synergy Enterprise Voor een correcte werking van het Webservices.nl module dient u de volgende instelling in te vullen 1. Webservices.nl>Inrichting>Algemeen>Instellingen. 2. Vul de volgende gegevens bij de sectie ‘Inloggegevens’; Gebruikersnaam bij Webservices.nl Wachtwoord van Webservices.nl 3. In de sectie ‘Standaardwaarde’ is het mogelijk een standaard ‘bron’ op te geven voor relaties aangemaakt via de Webservices.nl module. Dit is niet een verplicht veld. Controle werking Webservices.nl module Bij het aanmaken van een nieuwe relatie zal het ‘Bedrijven: Zoeken’ geopend worden.

Figuur 1: Bedrijven: Zoeken scherm

Zoek een willekeurig bedrijf. Indien de koppeling juist werkt, zal een resultaat teruggegeven worden.


|4

3. Backgroundjob voor binnenhalen indicatie van wijziging Het binnenhalen van indicaties van wijzigingen kan functioneel via Webservices.nl, Overzichten, Bijwerken, Haal gewijzigde relaties op. Echter kan dit ook via een ‘backgroundjob’ opgehaald worden. De URL De te gebruiken jobnaam is: CSCaneWebNL.Jobs De te gebruiken class is: GetUpdatedDossiers De url ziet er als volgt uit: “*BestandenPadSynergy*\bin\Exact.Process.exe" /DBCONFIG:*VIRTUALDirectory van Synergy* /ASSEMBLY:CSCaneWebNL.Jobs /CLASS:GetUpdatedDossiers Voorbeeld: "C:\Exact\Synergy Enterprise\bin\Exact.Process.exe" /DBCONFIG:Synergy /ASSEMBLY:CSCaneWebNL.Jobs /CLASS:GetUpdatedDossiers Deze url is te gebruiken in een Windows Taak of via de SQL Server Agent. Let op: bij het inrichten van de background job via SQL Server Agent is het van belang dat het account waaronder de SQL Server Agent draait toegang heeft (Professional Licentierol + Administrator rol) tot Synergy.


|5

4. De maatwerktabellen De Webservices.nl module heeft de volgende maatwerktabellen. • CSCaneWebNLCicmpy • CSCaneWebNLLegalForms • CSCaneWebNLSBILevel1 • CSCaneWebNLSBILevel2 • CSCaneWebNLSBILevel3 • CSCaneWebNLSBILevel4 • CSCaneWebNLSBISections • CSCaneWebNLCompanySize CSCaneWebNLCicmpy In deze tabel wordt de link gelegd met de relatie tabel (cicmpy). Informatie over het dossiernummer en laatst bijgewerkte datum (bij Kvk) worden vastgelegd in deze tabel. Ook de update indicatie staat weg geschreven in deze tabel. Zie bijlage A.1 voor de tabelvelden en extra uitleg. CSCaneWebNLLegalForms In deze tabel worden de beschikbare rechtsvormen vastgelegd. Deze worden met de installatie van de Webservices.nl module meegeleverd. Zie bijlage A.2 voor de tabelvelden en extra uitleg. CSCaneWebNLSBILevel1 In deze tabel worden de beschikbare sectorcodes (2 cijferig) vastgelegd. Deze worden met de installatie van Webserces.nl module meegeleverd. Zie bijlage A.3 voor de tabelvelden en extra uitleg.

CSCaneWebNLSBILevel2 In deze tabel worden de beschikbare sectorcodes (3 cijferig) vastgelegd. Deze tabel wordt gevuld met de door Webservices.nl opgehaalde gegevens. Zie bijlage A.4 voor de tabelvelden en extra uitleg.

CSCaneWebNLSBILevel3 In deze tabel worden de beschikbare sectorcodes (4 cijferig) vastgelegd. Deze tabel wordt gevuld met de door Webservices.nl opgehaalde gegevens. Zie bijlage A.5 voor de tabelvelden en extra uitleg.

CSCaneWebNLSBILevel4 In deze tabel worden de beschikbare sectorcodes (5 cijferig) vastgelegd. Deze tabel wordt gevuld met de door Webservices.nl opgehaalde gegevens. Zie bijlage A.6 voor de tabelvelden en extra uitleg. CSCaneWebNLSBISections In deze tabel worden de beschikbare sectorcodes (letters) vastgelegd. Deze worden met de installatie van de Webservices.nl module meegeleverd. Zie bijlage A.7 voor de tabelvelden en extra uitleg.


|6

CSCaneWebNLCompanySize In deze meelooptabel (met standaard tabel CiSize) worden de ‘vanaf aantal medewerkers’ en ‘t/m aantal medewerkers’ vastgelegd van bedrijfsgroottes. Zie bijlage A.8 voor de tabelvelden en extra uitleg. (beschikbaar vanaf versie 2014.12)


|7

5. Bekende (fout)meldingen In dit hoofdstuk worden de bekende (fout)meldingen weergegeven. Authenticatie probleem. Controleer de Webservices.nl gebruikersnaam en wachtwoord Indien de login gegevens incorrect zijn, zal de Webservices.nl module de volgende melding teruggeven:

Figuur 2: Authenticatie probleem. Controleer de Webservices.nl gebruikersnaam en wachtwoord.

Webservices.nl is onbereikbaar. Controleer de internetverbinding op de server Indien een probleem met de internetverbinding zich voordoet, dan zal de volgende melding getoond worden:

Figuur 3: Webservices.nl is onbereikbaar. Controleer de internetverbinding op de server

Controleer de internetverbinding van de webserver (‘Synergy’ server). Onverwachte en onbekende fout opgetreden Neem contact op met de systeembeheerder. Er heeft zich een fout voorgedaan op de webserver. Geen resultaat na het ingeven van een zoekactie Krijgt u bij het zoeken geen foutmelding, maar ook geen resultaat terug? Neem dan contact op met Webservices.nl, het kan zijn dat het ‘tegoed’ bij Webservices.nl op is. Onvoldoende saldo om deze actie uit te voeren Neem dan contact op met Webservices.nl, het ‘tegoed’ bij Webservices.nl is op. Bij het aanmaken van een nieuwe relatie kom ik niet eerst in het zoekscherm, maar ga ik gelijk naar het aanmaken: relatie scherm Indien u een natuurlijk persoon aan het aanmaken ben, dan klopt dit. Hierop kunt u niet in het KvK zoeken. Indien u een relatie wilt aanmaken dan dient u te controleren of u beschikt over een ‘Enable add-on’ licentie rol in combinatie met OF een professional licentie rol OF een CRM rol. Indien u hierover niet beschikt, dan kunt u inderdaad geen gebruik maken van het aanmaken van relaties via de Webservices.nl Module. Heeft u de benodigde licentie rollen wel, dan dient u de login gegevens van Webservices te (laten) controleren. Deze vindt u terug onder Webservices.nl/ Inrichting/ Algemeen/ Instellingen. Indien deze NIET gevuld staan, dan zal u bij het aanmaken van relaties altijd uitkomen in het ‘aanmaken relatie’ scherm.


|8

Bijlage A Extra informatie maatwerktabellen In deze bijlage vindt u extra uitleg over de maatwerktabellen

Bijlage A.1 CSCaneWebNLCicmpy Tabelveld LinkID DossierNumber

EstablishmentNumber MainEstablishmentNumber IndicationMainEstablishment TradeNameFull RSINnumber LegalFormCode IndicationOrganisationCode

Extra informatie Koppeling naar de cmp_wwn veld in tabel cicmpy KvK nummer en dossiernummer bij Webservices.nl. Op basis van dit gegeven wordt bekeken of een update van gegevens beschikbaar is. Vestigingsnummer. Niet functioneel zichtbaar. Hoofdvestigingsnummer. Niet functioneel zichtbaar. Indicatie hoofdvestiging. Niet functioneel zichtbaar. Volledige handelsnaam. RSIN nummer (Rechtspersonen Samenwerkingsverbanden Informatie Nummer). Rechtsvorm code. Koppeling met het code veld in tabel CSCaneWebNLLegalForms. Soort organisatie. Vast gedefinieerd. Volgende mogelijkheden zijn er: O – Onderneming V – Vereniging S – Stichting K – Kerkgenootschap

IndicationEconomicallyActive IndicationBankruptcy

IndicationDIP DateLastUpdate NeedsUpdate

NeedsUpdateLegalform

NeedsUpdateName

NeedsUpdateEstablishmentAddress

Indicatie Economisch actief. ( 0=geen vinkje, 1=vinkje) Indicatie Failliet. ( 0=geen vinkje, 1=vinkje) Indien waarde = 1, dan zal op de relatiekaart (bewerken modus) in rode dik gedrukte letters het veld Failliet worden weergegeven. Dit is in de ‘bewerken’ modus niet zichtbaar. Indicatie Surseance. ( 0=geen vinkje, 1=vinkje) Datum gegevens laatst bijgewerkt in het KvK. Update aanwezig. (0= geen update benodigd, 1=update van gegevens beschikbaar). Als dit veld op 1 staat, dan is de button “Webservices.nl: Bijwerken” beschikbaar op de relatiekaart en komt de relatie naar voren in het menupad Webservices.nl, Overzichten, Bijwerken, Bij te werken Relaties. Update aanwezig voor Rechtsvorm. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat het veld ‘rechtsvorm’ gewijzigd is. Update aanwezig voor Bedrijfsnaam. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat het veld ‘Bedrijfsnaam’ gewijzigd is. Update aanwezig voor Vestigingsadres. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat het Vestigingsadres gewijzigd is.


|9

NeedsUpdateCorrespondenceAddress

NeedsUpdateContact

NeedsUpdateActivity

NeedsUpdateFinancialStatus

NeedsUpdateStatus

NeedsUpdateEstablishment

NeedsUpdateRSIN

SBISector

SBILevel1

SBILevel2

SBILevel3

SBILevel4

Update aanwezig voor Correspondentieadres. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat het veld Correspondentie gewijzigd is. Update aanwezig voor Contactpersoon. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat de contactpersoon gewijzigd is. Update aanwezig voor het veld ‘Sector/ SBI sectie’. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat het veld ‘Sector/ SBI sectie’ gewijzigd is. Update aanwezig voor de velden ‘Failliet’ en/of ‘In surseance’. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat de velden ‘Failliet ‘ en/of ‘in surseance’ gewijzigd is. Update aanwezig voor het veld ‘Economisch Actief’. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat het veld ‘Economisch Actief’ gewijzigd is. Update aanwezig voor het database veld ‘Vestigingsnummer’. (0= geen update aanwezig, 1= update aanwezig). Dit veld wordt alleen op de achtergrond gebruikt. Update aanwezig voor het veld ‘RSIN nummer’. (0= geen update aanwezig, 1= update aanwezig). Indien dit veld op ‘1’ staat, dan wordt in het overzicht Webservices.nl, Overzichten, Bijwerken, Bij te werken relaties naast de kolom “Bijwerken” onder de ‘i’ icoon getoond dat het veld ‘RSIN nummer’ gewijzigd is. Veld ‘Standaard Bedrijfs Indeling: Sectie’. Veld is niet functioneel te wijzigen en alleen in de ‘bekijken’ modus van een relatiekaart zichtbaar. Koppeling naar het code veld in tabel CSCaneWebNLSBISections. Veld ‘Standaard Bedrijfs Indeling: Niveau 1’. Veld is niet functioneel te wijzigen en alleen in de ‘bekijken’ modus van een relatiekaart zichtbaar. Koppeling naar het code veld in tabel CSCaneWebNLSBILevel1. Veld ‘Standaard Bedrijfs Indeling: Niveau 2’. Veld is niet functioneel te wijzigen en alleen in de ‘bekijken’ modus van een relatiekaart zichtbaar. Koppeling naar het code veld in tabel CSCaneWebNLSBILevel2. Veld ‘Standaard Bedrijfs Indeling: Niveau 3’. Veld is niet functioneel te wijzigen en alleen in de ‘bekijken’ modus van een relatiekaart zichtbaar. Koppeling naar het code veld in tabel CSCaneWebNLSBILevel3. Veld ‘Standaard Bedrijfs Indeling: Niveau 4’. Veld is niet functioneel te wijzigen en alleen in de ‘bekijken’ modus van een relatiekaart zichtbaar. Koppeling naar het code veld in tabel CSCaneWebNLSBILevel4.


|10

Bijlage A.2 CSCaneWebNLLegalForms Tabelveld Extra informatie Code Code. Deze code wordt weggeschreven in het veld LegalFormCode in tabel CSCaneWebNLCicmpy Description Omschrijving van de Rechtsvorm. Dit wordt daadwerkelijk weergegeven op de relatiekaart.

Bijlage A.3 CSCaneWebNLSBILevel1 Tabelveld Extra informatie Section SBI Sectie. Koppeling met het code veld van tabel CSCaneWebNLSBISections Code Code van de SBI Level 1. Koppeling met veld ‘SBILevel1’ in tabel ‘CSCaneWebNLCicmpy’ en met het veld ‘Level’ in tabel ‘CSCaneWebNLSBILevel2’ DescriptionNL Nederlandstalige omschrijving van de sector. Getoond indien voorkeurstaal op ‘NL’ staat. DescriptionEN Engelstalige omschrijving van de sector. Getoond indien voorkeurstaal andere taal dan ‘NL’ staat.

Bijlage A.4 CSCaneWebNLSBILevel2 Tabelveld Extra informatie Level Code van de bijbehorende SBI Level 1. Koppeling met het veld ‘Code’ in tabel ‘CSCaneWebNLSBILevel1’ Code Code van de SBI Level 2. Koppeling met veld ‘SBILevel2’ in tabel ‘CSCaneWebNLCicmpy’ en met het veld ‘Level’ in tabel ‘CSCaneWebNLSBILevel3’ DescriptionNL Nederlandstalige omschrijving van de sector. Getoond indien voorkeurstaal op ‘NL’ staat. DescriptionEN Engelstalige omschrijving van de sector. Getoond indien voorkeurstaal andere taal dan ‘NL’ staat.

Bijlage A.5 CSCaneWebNLSBILevel3 Tabelveld Extra informatie Level Code van de bijbehorende SBI Level 2. Koppeling met het veld ‘Code’ in tabel ‘CSCaneWebNLSBILevel2’ Code Code van de SBI Level 3. Koppeling met veld ‘SBILevel3’ in tabel ‘CSCaneWebNLCicmpy’ en met het veld ‘Level’ in tabel ‘CSCaneWebNLSBILevel4’ DescriptionNL Nederlandstalige omschrijving van de sector. Getoond indien voorkeurstaal op ‘NL’ staat. DescriptionEN Engelstalige omschrijving van de sector. Getoond indien voorkeurstaal andere taal dan ‘NL’ staat.

Bijlage A.6 CSCaneWebNLSBILevel4 Tabelveld Extra informatie Level Code van de bijbehorende SBI Level 3. Koppeling met het veld ‘Code’ in tabel ‘CSCaneWebNLSBILevel3’ Code Code van de SBI Level 4. Koppeling met veld ‘SBILevel4’ in tabel ‘CSCaneWebNLCicmpy’ DescriptionNL Nederlandstalige omschrijving van de sector. Getoond indien voorkeurstaal op ‘NL’ staat. DescriptionEN Engelstalige omschrijving van de sector. Getoond indien voorkeurstaal andere taal dan ‘NL’ staat. Versie 1.1 Cane Webservices.nl Integratie – Handleiding voor de Applicatiebeheerder

|11

Bijlage A.7 CSCaneWebNLSBISections Tabelveld Extra informatie Code Code van de SBISector. Koppeling met veld ‘SBISector’ in tabel ‘CSCaneWebNLCicmpy’ en veld ‘Section’ in tabel ‘CSCaneWebNLSBILevel1’ DescriptionNL Nederlandstalige omschrijving van de sector. Getoond indien voorkeurstaal op ‘NL’ staat. DescriptionEN Engelstalige omschrijving van de sector. Getoond indien voorkeurstaal andere taal dan ‘NL’ staat.

Bijlage A.8 CSCaneWebNLCompanySize Tabelveld Extra informatie FromEmployees Vanaf aantal medewerkers UntilEmployees T/m aantal medewerkers LinkID Code bedrijfsgrootte. Koppeling met het ‘siz_code’ veld in tabel cisize. Dit is de standaard tabel voor het vastleggen van ‘groottes’ codes.


|12

Handleiding voor de applicatiebeheerder Cane Webservices.nl Integratie

Recommend Documents