Questa è una vecchia versione del documento!
Abilitazione dell'Albo Pretorio
CONFIGURAZIONE DI DOCWAY
-creare un archivio xdocwaydoc-albo vuoto (utilizzare il conf di xdocwaydoc) -nell' xw.ini creare gli alias dcw e dcw-albo che puntino rispettivamente a xdocwaydoc e xdocwaydoc-albo -in xway/base/acl/diritti modificare il file docway.xml duplicando la sezione dei diritti per xdocwaydoc: creare la sezione xdocwaydoc-albo con codice DOCA -occorre avere installati i web services di extraway in modalità protetta. -modificare il tomcat-users inserendo per l'utente che si desidera utilizzare i seguenti role: dcw, dcw-albo e jwsadmin -accedere all'ACL assegnando all'utente desiderato i diritti sui repertori Albo Arrivo e Albo Partenza. Assegnare a tale utente i diritti di visione globale dei documenti dell'archivio xdocwaydoc-albo
CONFIGURAZIONE DEL PUBBLICATORE
-installare ThePublisher.war . -creare in mysql 3 schema con i seguenti nomi: publisher_core, publisher_history, publisher_users. -eseguire lo script ThePublisher/Documentation/creaTabellaUtenti.sql -inserire un utente in publisher_users.user_rolee e publisher_users_users con ruolo publisherAdmin. In seguito utilizzare tale username e password per accedere ai web services del pubblicatore -Prestare attenzione a configurare correttamente i seguenti parametri:
- Nel file ThePublisher.xml (file di context della webapp dentro conf/catalina/localhost) impostare con un utente mysql che abbia i diritti di amministrazione del db del pubblicatore
i parametri connectionName e connectionPassword
- Nei file ThePublisher/WEB-INF/classes/hibernate*.xml impostare username e password come al punto precedente
- in ThePublisher/WEB-INF/classes/it.highwaytech.publisher.properties impostare publisher.consumer.restperiod con il valore 3000
-Per usare tramite soapUI i web services del pubblicatore occorre impostare l'autenticazione BASIC utilizzando l'utente precedentemente inserito nel db mysql -tramite soapUI invocare i web services del pubblicatore creando prima i datasource e poi il ruleset. Di seguito gli xml di esempio. Modificarli inserendo i parametri corretti (in particolare AuthUser e AuthPwd)
datasource per xdocwaydoc
<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:web=“http://webservices.publisher.tredi.it/”>
<soapenv:Header/>
<soapenv:Body>
<web:addDataSource>
<!--Optional:-->
<arg0>
<![CDATA[ <DataSource class=“it.tredi.publisher.XwDataSource”>
<Name>Docway_albo_localhost</Name> <Description>Docway localhost</Description> <Host>localhost</Host> <Port>4859</Port> <Db>dcw</Db> <User>lettore</User> <Password>reader</Password>
<!-- Parametri specifici di XWDataSource --> <ServiceURL>http://localhost:8080/3diws/services/eXtraWay</ServiceURL> <Encoding>UTF-8</Encoding> <TitlePageSize>10</TitlePageSize> <IndexPageSize>10</IndexPageSize> <AuthUser>user</AuthUser> <AuthPwd>password</AuthPwd>
</DataSource> ]]> </arg0>
</web:addDataSource> </soapenv:Body>
</soapenv:Envelope>
datasource per xdocwaydoc
<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:web=“http://webservices.publisher.tredi.it/”>
<soapenv:Header/>
<soapenv:Body>
<web:addDataSource>
<!--Optional:-->
<arg0>
<![CDATA[ <DataSource class=“it.tredi.publisher.XwDataSource”>
<Name>Docway_albo_localhost</Name> <Description>Docway Albo Pretorio localhost</Description> <Host>localhost</Host> <Port>4859</Port> <Db>dcw-albo</Db> <User>lettore</User> <Password>reader</Password>
<!-- Parametri specifici di XWDataSource --> <ServiceURL>http://localhost:8080/3diws/services/eXtraWay</ServiceURL> <Encoding>UTF-8</Encoding> <TitlePageSize>10</TitlePageSize> <IndexPageSize>10</IndexPageSize> <AuthUser>user</AuthUser> <AuthPwd>password</AuthPwd>
</DataSource> ]]> </arg0>
</web:addDataSource> </soapenv:Body>
</soapenv:Envelope>
ruleset (per la configurazione utilizzare gli id dei datasource appena cretati)
<soapenv:Envelope xmlns:soapenv=“http://schemas.xmlsoap.org/soap/envelope/” xmlns:web=“http://webservices.publisher.tredi.it/”>
<soapenv:Header/>
<soapenv:Body>
<web:addRuleset>
<!--Optional:-->
<arg0>
<![CDATA[ <RuleSet>
<Name>Pubblica_in_albo_pretorio1caeb007-1ae8-42fb-91b3-d8562e453641</Name>
<Description>Pubblicazione nell'Albo Pretorio</Description>
<SourceDS>Docway_localhost79a14ad0-395c-4eba-837c-c2050e847235</SourceDS>
<TargetDS>Docway_albo_localhostfd696b97-8365-477b-8830-dfe42195b07f</TargetDS>
<B2FRule></B2FRule>
<BackHistoryXPath>/doc/extra/albo_pretorio/pubblicazione</BackHistoryXPath>
<Blacklist></Blacklist>
<Rules>
<Rule type="it.tredi.publisher.rules.AddXPath">
<Arg name="xpathsource">/doc/*[name()!='repertorio']</Arg>
<Arg name="xpathtarget">/doc</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.AddXPath">
<Arg name="xpathsource">/doc/@*</Arg>
<Arg name="xpathtarget">/doc</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.AddText">
<Arg name="textsource">/doc/repertorio/@numero</Arg>
<Arg name="xpathtarget">/doc/riferimenti</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.AddText">
<Arg name="textsource">/doc/repertorio</Arg>
<Arg name="xpathtarget">/doc/note</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.AddText">
<Arg name="textsource">'Albo Pretorio'</Arg>
<Arg name="xpathtarget">/doc/repertorio</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.AddText">
<Arg name="textsource">'ALBO'</Arg>
<Arg name="xpathtarget">/doc/repertorio/@cod</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.AddText">
<Arg name="textsource">'ALBO^3DINBOL-§{YEAR}.'</Arg>
<Arg name="xpathtarget">/doc/repertorio/@numero</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.RemoveXPath">
<Arg name="xpath">/doc/rif_interni/rif/@cod_fasc</Arg>
</Rule>
<Rule type="it.tredi.publisher.rules.RemoveXPath">
<Arg name="xpath">/doc/link_interno</Arg>
</Rule>
</Rules>
</RuleSet> ]]> </arg0>
</web:addRuleset> </soapenv:Body>
</soapenv:Envelope>
-utilizzare l'id del ruleset restituito per impostare il corrispondente parametro di xway/WEB-INF/classes/it.highwaytech.apps.xdocway.properties -L'utente da impostare deve essere l'utente esistente nel db del pubblicatore (già utilizzato per richiamare i servizi tramite soapUI) #Attiva la pubblicazione di un documento nell'Albo Pretorio ('Si', 'No' - Default = 'No') abilitaAlboPretorio=Si alboPretorioPublisherUser=publisherAdmin alboPretorioPublisherPassword=publisherAdmin alboPretorioPublisherRuleset=Pubblica_in_albo_pretorioxxxxxxxxxxxxxxx
TEST DELLA PUBBLICAZIONE -per testare il funzionamento del software da docway posizionarsi su un documento protocollato in arrivo o partenza (no bozza oppure annullato) e premere il pulsante pubblica -assicurarsi che al completamento dell'operazione non sia più presente il pulsante pubblica -accedere a docway sull'archivio xdocwaydoc-albo assicurandosi di vedere il documento pubblicato