Vertec

Owned by Daniela Zimmermann
Last updated: Jul 10, 2024 by Simon Küttel
5 min read

Dieser Provider ist ab Vertec Version 6.7 nicht mehr funktionsfähig, da die Authentifizierung sind in Vertec geändert hat.

Vertec 6.7

Dieser AddressProvider funktioniert ab Version 6.7 nicht mehr.
Als Alternative kann der HttpProvider des AddressService genutzt werden.

Wichtigstes Unterscheidungsmerkmal: Die Authentifizierung ging bisher über die eingegenen Benutzerdaten. Mit dem HttpProvider muss ein Service Account im Vertec erstellt werden und von diesem Service Account wird der API Token benötigt.

Die Nachfolgende Konfiguration zeigt den Zugriff auf Vertec, angepasst werden muss:

  • <https://KUNDE.vertec-mobile.com/xml> mit der Vertec URL

  • Bearer ... mit Bearer [API TOKEN des Service Accounts]

  • Hinweis: %{searchTerm}% war in der alten Konfiguration %{0}% . Beim Übernehmen der SQL-Query bzw. OCL aus dem bestehenden Konfiguration, muss dies angepasst werden.

<!-- Vertec via AddressService --> <!-- Vertec address provider - neue Konfiguration ab Vertec 6.7 --> <AddressProvider id="E10A8313-A92D-4CB2-A12B-9AEB58F39207" order="1" active="true"> <!-- Vertec, Server --> <AddressProvider id="09C886F1-4B5A-4372-8CB4-4AA6D2F7A47B" Title="Vertec"> <!-- Vertec, Applikation --> <Icon>iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAIASURBVDhPfVLbahNBGJ6d2c02BxsTU2qibSqNJ4hiqIiIXgleeOuFeOU7+Bo+iFfeV7Gl0BuVGiEgZouSDbHbbEqSTTbLHmfGfw8EVsWPn53Zb77/OCO83kchBMT81rT3itMVhHhE/Rs4WZf4nzgE9hgC8ynyaMf1AyegDnz9wA1oIkFwyryA8iiWoJ61oZ4QHFOnghAR4JcjLwjeHrSnlk0wfvH4LnBv9o8YQ+K30/eRA4fqnfEOo+LGevn+7euTmWk6LkQUCd6srpXOFdpKv6MOSfPZB90C29Nmn4+P7ym/5qWc1GxsKn3tU7cvSwTKW5iLZmND1UaqPsUSRqERlCFbsiRmRHyjXoOMPW1EcJhaIvj7YGRatuv5AhJSU+Kc52Xp8noloLR3OoZigGScF3Mr0LE+NUWcdqCMV0uFUrEADQyNBbQLJIxou1axXfdkYuKYWoIydrG8CuRoYkDpyfA4v3Ot/nMwjJmUA2TPyRnYzBd2PHXbC3a2L104v3rY+SGLIjApB+hyZtmwyWVliGc6Xq1cePqw9bGjDA0rnkHotIRESHdwpo+NW1e3nj+aCwJu3byi9E7efVGymURJnryMVgFxVnWMB64vqJq+Vsw36rV8Vj782t096kIx4fXHwr9fa8AopRyuLH5OskgiRYJUDzFEjEENTYP0DzVC6DclJP5kwEd/SAAAAABJRU5ErkJggg==</Icon> <SearchParameters> <SearchParameter Name="searchTerm" Label="Suchbegriff" Type="String" Length="100" Sort="1" /> </SearchParameters> <Debug>true</Debug> <Configuration> <Step> <Request Method="Post" Url="<https://KUNDE.vertec-mobile.com/xml>"> <!-- API Token --> <Header Name="Authorization" Value="Bearer ..." /> <!-- Zum Testen: Mit Browser <https://KUNDE.vertec-mobile.com/xml/query> besuchen, dann das ganze "<Body>"-Element dort reinkopieren. «'%{0}%'» ersetzen mit Test-Suchbegriff. --> <Body><![CDATA[<Envelope> <Body> <Query> <Selection> <ocl>Adresseintrag</ocl> <sqlwhere> aktiv = 1 and ( (alias like '%{searchTerm}%') or (name like '%{searchTerm}%') or (nameA like '%{searchTerm}%') or (nameB like '%{searchTerm}%') or (standardadresse like '%{searchTerm}%') or (standardPLZ like '%{searchTerm}%') or (standardOrt like '%{searchTerm}%') or (firma in (select bold_id from adresseintrag where (name like '%{searchTerm}%') or (alias like '%{searchTerm}%') or (standardadresse like '%{searchTerm}%') or (standardPLZ like '%{searchTerm}%') or (standardOrt like '%{searchTerm}%'))) ) </sqlwhere> </Selection> <Resultdef> <member>Personenkonto</member> <member>Alias</member> <member>LieferantenNr</member> <member>Standardadresse</member> <member>Stellung</member> <member>Zusatz</member> <member>StandardKanton</member> <member>StandardTelefon</member> <member>Bankverbindung</member> <member>StandardMobile</member> <member>Geburtsdatum</member> <member>StandardHomepage</member> <member>StandardLand</member> <member>MWSTNR</member> <member>StandardFax</member> <member>Briefanrede</member> <member>IsMale</member> <member>Grussformel</member> <expression> <alias>Grussformel</alias> <ocl> if self.oclistypeof(Person) then self.oclastype(Person).grussformel else if self.oclistypeof(Kontakt) then if self.oclastype(Kontakt).person->notempty then self.oclastype(Kontakt).person.grussformel else self.oclastype(Kontakt).grussformel endif else if self.oclistypeof(Firma) then self.oclastype(Firma).grussformel else if sprache.asstring = 'DE' then 'Freundliche Grüsse' else 'Greetings,' endif endif endif endif </ocl> </expression> <member>StandardEMail</member> <member>Titel</member> <member>StandardOrt</member> <member>Name</member> <member>Anrede</member> <member>StandardPLZ</member> <expression> <alias>Sprache</alias> <ocl>sprache.asstring</ocl> </expression> <member>KundenNR</member> <expression> <alias>firmenname</alias> <ocl> if self.oclistypeof(Firma) then self.oclastype(Firma).name else if self.oclistypeof(Kontakt) and self.oclastype(Kontakt).firma->notempty then self.oclastype(Kontakt).firma.name else '' endif endif </ocl> </expression> <expression> <alias>kontaktname</alias> <ocl> if self.oclistypeof(Person) then self.oclastype(Person).name else if self.oclistypeof(Kontakt) then if self.oclastype(Kontakt).person->notempty then self.oclastype(Kontakt).person.name else self.oclastype(Kontakt).name endif else <!-- Paar-Adressen --> if self.oclistypeof(Paar) then if self.oclastype(Paar).personA.notNull and self.oclastype(Paar).personB.notNull then self.oclastype(Paar).personA.vorname + ' ' + self.oclastype(Paar).personA.name + ', ' + self.oclastype(Paar).personB.vorname + ' ' + self.oclastype(Paar).personB.name else if self.oclastype(Paar).personA.notNull and self.oclastype(Paar).personB.isNull then self.oclastype(Paar).personA.vorname + ' ' + self.oclastype(Paar).personA.name + ', ' + self.oclastype(Paar).vornameB + ' ' + self.oclastype(Paar).nameB else if self.oclastype(Paar).personA.isNull and self.oclastype(Paar).personB.notNull then self.oclastype(Paar).vornameA + ' ' + self.oclastype(Paar).nameA + ', ' + self.oclastype(Paar).personB.vorname + ' ' + self.oclastype(Paar).personB.name else self.oclastype(Paar).vornameA + ' ' + self.oclastype(Paar).nameA + ', ' + self.oclastype(Paar).vornameB + ' ' + self.oclastype(Paar).nameB endif endif endif else '' endif endif endif </ocl> </expression> <expression> <alias>kontaktvorname</alias> <ocl> if self.oclistypeof(Person) then self.oclastype(Person).vorname else if self.oclistypeof(Kontakt) then if self.oclastype(Kontakt).person->notempty then self.oclastype(Kontakt).person.vorname else self.oclastype(Kontakt).vorname endif else '' endif endif </ocl> </expression> <member>adresstext</member> <expression> <alias>Kuerzel</alias> <ocl> if self.oclistypeof(Kontakt) then self.oclastype(Kontakt).abteilung else '' endif </ocl> </expression> <expression> <alias>Abteilung</alias> <ocl> if self.oclistypeof(Kontakt) then zusatzfeldasstring('abteilung') else '' endif </ocl> </expression> <!-- TestNameA: Zeigt, wie man bei Paaren auf den Nachnamen kommt (es gibt nämlich 2 Arten von Paaren) --> <!-- <expression> <alias>TestNameA</alias> <ocl> if self.oclistypeof(Paar) then if self.oclastype(Paar).personA.notNull then self.oclastype(Paar).personA.name else self.oclastype(Paar).nameA endif else 'Blub' endif </ocl> </expression> --> </Resultdef> </Query> </Body> </Envelope> ]]></Body> </Request> <Response> <Contacts XPath="/Envelope/Body/QueryResponse/Kontakt | /Envelope/Body/QueryResponse/Firma | /Envelope/Body/QueryResponse/Person | /Envelope/Body/QueryResponse/Paar "> <Mapping> <!-- Company --> <Map Source="standardOrt" Target="Company_City" /> <Map Source="standardLand" Target="Company_Country" /> <Map SourceValue="CH" Target="Company_CountryShortCode" /> <Map Source="Abteilung" Target="Company_Department" /> <Map Source="standardEMail" Target="Company_EmailCentral" /> <Map Source="standardEMail" Target="Company_EmailDirect" /> <Map Source="standardFax" Target="Company_FaxCentral" /> <Map Source="standardFax" Target="Company_FaxDirect" /> <Map Source="standardHomepage" Target="Company_Homepage" /> <Map Source="firmenname" Target="Company_Name" /> <Map Source="standardTelefon" Target="Company_PhoneCentral" /> <Map Source="standardTelefon" Target="Company_PhoneDirect" /> <!-- Company_PostOfficeBox ToDo --> <Map Source="standardAdresse" Target="Company_Street" /> <Map Source="standardPLZ" Target="Company_ZipCode" /> <!-- Person --> <Map Source="geburtsdatum" Target="Person_BirthDate" /> <Map Source="standardLand" Target="Person_Country" /> <Map SourceValue="CH" Target="Person_CountryShortCode" /> <Map Source="standardOrt" Target="Person_City" /> <Map Source="standardEMail" Target="Person_EmailDirect" /> <Map Source="standardOrt" Target="Person_City" /> <Map Source="standardFax" Target="Person_FaxDirect" /> <Map Source="kontaktvorname" Target="Person_FirstName" /> <Map Source="standardHomepage" Target="Person_Homepage" /> <Map Source="kontaktname" Target="Person_LastName" /> <Map Source="standardTelefon" Target="Person_PhoneDirect" /> <Map Source="stellung" Target="Person_Position" /> <!-- Person_PostOfficeBox ToDo --> <Map Source="standardAdresse" Target="Person_Street" /> <Map Source="titel" Target="Person_Title" /> <Map Source="standardPLZ" Target="Person_ZipCode" /> <!-- Common --> <Map Source="ID" Target="AddressProviderData_Id" /> <Map Source="anschrift" Target="AddressProviderData_Label_FormattedString" /> <Map Source="briefanrede" Target="Person_Salutation" /> <Map Source="Grussformel" Target="Person_Greeting" /> </Mapping> </Contacts> </Response> </Step> </Configuration> </AddressProvider> </AddressProvider>

Ältere Vertec Versionen

Die Adressschnittstelle für Vertec kann neu auch über Token angesprochen werden. Dazu muss die Konfiguration wie folgt geändert werden:

<!-- ↓ Alte Konfiguration ↓ --> <BasicAuth> <Name></Name> <Password></Password> </BasicAuth> <!-- ↓ Neue Konfiguration ↓ --> <BasicAuth> <Token></Token> </BasicAuth>

 

WICHTIG
Das Token-Tag muss leer sein. Weitere Informationen bezüglich der Kompatibilität finden Sie unter diesem Link.

Beim ersten Aufruf des Empfängerdialogs öffnet sich das Anmeldefenster, in welchem man die Anmeldedaten vom Vertec eingibt. Dies wird nur beim ersten Mal verlangt, die Anmeldedaten werden gespeichert. Zudem besteht die Möglichkeit, den Benutzer zu wechseln.

<!-- Vertec AddressProvider --> <AddressProvider id="0861976E-318F-41A1-AE45-6D894A7E7292" order="12" active="false" hiddenIfNotAvailable="true"> <Uri>http://{host}/xml</Uri> <Timeout>10000</Timeout> <ContactMapping> <ContactItemXPath>//Kontakt</ContactItemXPath> <ContactItemXPath>//Firma</ContactItemXPath> <ContactItemXPath>//Person</ContactItemXPath> <Namespaces /> <ContactElement id="Company_City">Firma/standardOrt</ContactElement> <ContactElement id="Company_City">Kontakt/standardOrt</ContactElement> <ContactElement id="Company_Country">Firma/standardLand</ContactElement> <ContactElement id="Company_Country">Kontakt/standardLand</ContactElement> <!-- CountryShortCode is only mapped when Country also exists. Best practise: Map the country short code into Country and CountryShortCode. --> <ContactElement id="Company_CountryShortCode">Kontakt/standardLand</ContactElement> <ContactElement id="Company_Department">Kontakt/Abteilung</ContactElement> <ContactElement id="Company_EmailCentral">Firma/standardEMail</ContactElement> <ContactElement id="Company_EmailDirect">Kontakt/standardEMail</ContactElement> <ContactElement id="Company_FaxCentral">Firma/standardFax</ContactElement> <ContactElement id="Company_FaxDirect">Kontakt/standardFax</ContactElement> <ContactElement id="Company_Homepage">Firma/standardHomepage</ContactElement> <ContactElement id="Company_Homepage">Kontakt/standardHomepage</ContactElement> <ContactElement id="Company_Mobile"></ContactElement> <ContactElement id="Company_Name">firmenname</ContactElement> <ContactElement id="Company_PhoneCentral">Firma/standardTelefon</ContactElement> <ContactElement id="Company_PhoneDirect">Kontakt/standardTelefon</ContactElement> <ContactElement id="Company_PostOfficeBox" fReplace="Postfach,PostfachPostfach" fSubstringAfter="Postfach"></ContactElement> <ContactElement id="Company_PostOfficeBox" fReplace="Postfach,PostfachPostfach" fSubstringAfter="Postfach"></ContactElement> <ContactElement id="Company_PostOfficeBoxCity"></ContactElement> <ContactElement id="Company_Street">Firma/standardAdresse</ContactElement> <ContactElement id="Company_Street">Kontakt/standardAdresse</ContactElement> <ContactElement id="Company_Supplement"></ContactElement> <ContactElement id="Company_ZipCode">Firma/standardPLZ</ContactElement> <ContactElement id="Company_ZipCode">Kontakt/standardPLZ</ContactElement> <ContactElement id="Greeting">grussformel</ContactElement> <ContactElement id="ID">objid</ContactElement> <ContactElement id="Language"></ContactElement> <ContactElement id="Person_BirthDate">Kontakt/geburtsdatum</ContactElement> <ContactElement id="Person_BirthDate">Person/geburtsdatum</ContactElement> <ContactElement id="Person_Country">Person/standardLand</ContactElement> <!-- CountryShortCode is only mapped when Country also exists. Best practise: Map the country short code into Country and CountryShortCode. --> <ContactElement id="Person_CountryShortCode">Person/standardLand</ContactElement> <ContactElement id="Person_City">Person/standardOrt</ContactElement> <ContactElement id="Person_Email">Person/standardEMail</ContactElement> <ContactElement id="Person_Fax">Person/standardFax</ContactElement> <ContactElement id="Person_FirstName">Kontakt/kontaktvorname</ContactElement> <ContactElement id="Person_FirstName">Person/kontaktvorname</ContactElement> <ContactElement id="Person_Homepage">Person/standardHomepage</ContactElement> <ContactElement id="Person_LastName">Kontakt/kontaktname</ContactElement> <ContactElement id="Person_LastName">Person/kontaktname</ContactElement> <ContactElement id="Person_Mobile"></ContactElement> <ContactElement id="Person_NickName"></ContactElement> <ContactElement id="Person_Phone">Person/standardTelefon</ContactElement> <ContactElement id="Person_Position">Kontakt/stellung</ContactElement> <ContactElement id="Person_Position">Person/stellung</ContactElement> <ContactElement id="Person_PostOfficeBox" fReplace="Postfach,PostfachPostfach" fSubstringAfter="Postfach"></ContactElement> <ContactElement id="Person_PostOfficeBoxCity"></ContactElement> <ContactElement id="Person_Profession"></ContactElement> <ContactElement id="Person_SecondName"></ContactElement> <ContactElement id="Person_Street">Person/standardAdresse</ContactElement> <ContactElement id="Person_Title">Kontakt/titel</ContactElement> <ContactElement id="Person_Title">Person/titel</ContactElement> <ContactElement id="Person_ZipCode">Person/standardPLZ</ContactElement> <ContactElement id="Provider_AddressLabel">anschrift</ContactElement> <ContactElement id="Salutation">briefanrede</ContactElement> <ContactElement id="SalutationShort">anrede</ContactElement> </ContactMapping> <RequestConfiguration> <Envelope> <Header> <!-- ↓ Alte Konfiguration ↓ --> <BasicAuth> <Name></Name> <Password></Password> </BasicAuth> <!-- ↓ Neue Konfiguration ↓ --> <BasicAuth> <Token></Token> </BasicAuth> </Header> <Body> <Query> <Selection> <ocl>Adresseintrag</ocl> <sqlwhere> aktiv = 1 and ( (alias like '%{0}%') or (standardadresse like '%{0}%') or (standardPLZ like '%{0}%') or (standardOrt like '%{0}%') or (firma in (select bold_id from adresseintrag where (name like '%{0}%') or (alias like '%{0}%') or (standardadresse like '%{0}%') or (standardPLZ like '%{0}%') or (standardOrt like '%{0}%'))) ) </sqlwhere> </Selection> <Resultdef> <member>Personenkonto</member> <member>Alias</member> <member>LieferantenNr</member> <member>Standardadresse</member> <member>Stellung</member> <member>Zusatz</member> <member>StandardKanton</member> <member>StandardTelefon</member> <member>Bankverbindung</member> <member>StandardMobile</member> <member>Geburtsdatum</member> <member>StandardHomepage</member> <member>StandardLand</member> <member>MWSTNR</member> <member>StandardFax</member> <member>Briefanrede</member> <member>IsMale</member> <member>Grussformel</member> <member>StandardEMail</member> <member>Titel</member> <member>StandardOrt</member> <member>Name</member> <member>Anrede</member> <member>StandardPLZ</member> <expression> <alias>Sprache</alias> <ocl>sprache.asstring</ocl> </expression> <member>KundenNR</member> <expression> <alias>firmenname</alias> <ocl> if self.oclistypeof(Firma) then self.oclastype(Firma).name else if self.oclistypeof(Kontakt) and self.oclastype(Kontakt).firma-&gt;notempty then self.oclastype(Kontakt).firma.name else '' endif endif </ocl> </expression> <expression> <alias>kontaktname</alias> <ocl> if self.oclistypeof(Person) then self.oclastype(Person).name else if self.oclistypeof(Kontakt) then if self.oclastype(Kontakt).person-&gt;notempty then self.oclastype(Kontakt).person.name else self.oclastype(Kontakt).name endif else '' endif endif </ocl> </expression> <expression> <alias>kontaktvorname</alias> <ocl> if self.oclistypeof(Person) then self.oclastype(Person).vorname else if self.oclistypeof(Kontakt) then if self.oclastype(Kontakt).person-&gt;notempty then self.oclastype(Kontakt).person.vorname else self.oclastype(Kontakt).vorname endif else '' endif endif </ocl> </expression> <member>adresstext</member> <expression> <alias>Kuerzel</alias> <ocl> if self.oclistypeof(Kontakt) then self.oclastype(Kontakt).abteilung else '' endif </ocl> </expression> <expression> <alias>Abteilung</alias> <ocl> if self.oclistypeof(Kontakt) then zusatzfeldasstring('abteilung') else '' endif </ocl> </expression> </Resultdef> </Query> </Body> </Envelope> </RequestConfiguration> </AddressProvider>

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland