Sopimuksen tietojen synkronointi

Alueyksiköiden ja hallinta-alueiden osapuoli- ja sopimustietoja voidaan synkronoida Trimble Locus -ohjelmaan. Määritykset tehdään Tekla.GIS.eContractAgentPlugin.dll.config -tiedostoon WebAgentServices\Plugins-hakemistoon.

Palvelu sisäisessä verkossa

Sopimustenhallinta-sovellusta käytetään käyttäjän työasemalla ajettavassa selaimessa ja sopimustietoja hyödynnetään Trimble Locus -ohjelmassa erillisen plugin-komponentin avulla.

Palvelimella sijaitsevat sovellukset hoitavat tietojen käsittelyn, tallennukset ja haut SQL Server -tietokannasta.

Kohteiden ja osapuolten tiedot haetaan Trimble Locus -kannasta erillisellä WebService-rajapinnalla.

Esimerkki

Sopimuksen tietojen synkronointi.

Päivityksessä Trimble Locus -kannan taulujen LprContract, GenOwner ja GenContactInfo -kenttien tiedot korvataan Sopimustenhallinta-palvelusta tuoduilla tiedoilla.

Määriteltävä asia	Määrittely tiedostossa
Ajastettava tehtävä Jos päivitettäviä sopimustyyppejä on useita, on jokaiselle tehtävä oma task.	`<Tekla.GIS.eContractAgentPlugin>` `<Tasks>` `<ContractSyncTask>`
Tehtävän nimi	`<Name>Daily contract sync</Name>`
Päivityksen ajastus Päivittäin tiettyyn kellonaikaan Päivitysväli sekunneissa	`<Schedule>` `<Daily>` `<RunTime>2:00</RunTime>` `</Daily>` `</Schedule>` `<Schedule>` `<Interval>` `<Start>2012-08-19</Start>` `<Interval>86400</Interval>` `</Schedule>`
Päivityksen määrittely	`<SyncSettings>`
Palvelun osoite, endpoint endpoint määritelty tiedoston TeklaWebAgentService.exe.config elementissä `system.serviceModel`	`<EndpointConfigurationName>eContractEndpoint</EndpointConfigurationName>`
Avain rajapintaan Asiakaskohtaisen clientin määrittely ja salasana. Määrittely myös eContract-palvelun web.config -tiedoston lohkoon `appSettings` seuraavasti: `<add key="APIKey[eContractAgentPlugin]" value="TODO_PASSWORD"/>`	`<APIKey>eContractAgentPlugin:TODO_PASSWORD</APIKey>`
Päivitettävä sopimustyyppi Sopimustyypin ID näkyy Hallinta-osiossa Sopimukset-välilehden luettelossa kunkin sopimustyypin edessä.	`<ContractType>TODO_CHANGE - Contract settings id, optional</ContractType>`
Päivitettävät tiedot `Contract` = päivitetään sopimustiedot `Party` = päivitetään osapuolet	`<SyncMode>Contract,Party</SyncMode>`
Päivitettävän osapuolen tyyppi Määrittele mille `ProOwnerType` -koodiston tyypille osapuoli päivitetään. Sopimuksen osapuoli: `eContract.ContractParty` Laskun vastaanottaja: `eContract.ContractInvoiceParty` Ei määriteltyä roolia sopimuksessa: `<Party ownerType="TODO_CHANGE"/>`	`<Parties>` `<Party ownerType="TODO_CHANGE"/>` `<Party ownerType="TODO_CHANGE" role="eContract.ContractParty"/>` `<Party ownerType="TODO_CHANGE" role="eContract.ContractInvoiceParty"/>` `</Parties>` `</SyncSettings>`
XcityQueryService-kanavanimi	`<ChannelName>Kanavanimi</ChannelName>`
Käyttäjän tunnus aineiston latauksessa (Trimble Locus -käyttäjä)	`<ImpersonateUser>gisuser</ImpersonateUser>`
	`</ContractSyncTask>` `</Tasks>` `</Tekla.GIS.eContractAgentPlugin>`

Päivityksessä huomioitavaa

Päivitys onnistuu sopimustyypeille, joiden kohteena on alueyksikkö tai hallinta-alue ja kohteella on vain yksi aktiivinen sopimus.

Osapuolten päivitys poistaa ensin päivitettävän tyyppiset jakamattomat osapuolet ja lisää uudet osapuolet jakamattomina.

Dokumenttiarkisto ja sopimuksen tila

Dokumenttiarkiston selailussa voidaan näyttää sopimuksen tila erillisessä sarakkeessa eli onko sopimus aktiivinen tai passiivinen.

Dokumenttiarkiston määrittelytiedostossa on silloin määriteltävä yhteys dokumenttiarkiston ja Sopimustenhallinta-palvelun välille.

Dokumenttiarkiston konfigurointitiedostossa (esimerkiksi Tekla.Xcity.DocArchiveEPlugin.config) määritellään yhteys dokumenttiarkiston dokumentin ja Sopimustenhallinta-palvelun sopimuksen välille:

<EContractExternalBinding KeyAttributeName="CONTRACT_NUMBER"/>

CONTRACT_NUMBER metadatasta otetaan sopimuksen numero, joka vastaa sopimuksen numeroa Sopimustenhallinta-palvelussa ja sillä tehdään haku palveluun sopimuksen löytämiseksi.

SelectableColumns-määrittelyissä voidaan viitata palvelusta löydetyn sopimuksen attribuuteihin alkuliitteellä XC_ECONTRACT:

<Column AttributeName="XC_ECONTRACT.Status" Label="Sopimuksen tila"/>
<Column AttributeName="XC_ECONTRACT.ValidFrom" Label="Sopimuksen pvm alku"/>
<Column AttributeName="XC_ECONTRACT.ValidTo" Label="Sopimuksen pvm loppu"/>

Lisäksi on mahdollista määritellä koodaus Sopimustenhallinta-palvelusta saataville arvoille, koska esimerkiksi Status-attribuutti voi saada numeeriset arvot 0 ja 1:

<ExternalAttributeCodings>
    <ExternalAttributeCoding AttributeName="XC_ECONTRACT.Status">
      <ExternalAttributeCodeValue CodeValue="1" Label="Aktiivinen"/>
      <ExternalAttributeCodeValue CodeValue="0" Label="Passivinen"/>
    </ExternalAttributeCoding>
  </ExternalAttributeCodings>

Lisäksi on Tekla.Xcity.DocArchiveEPlugin.dll.config-tiedostoon määriteltävä Sopimustenhallinta-palvelun osoite (PublicContract.svc).