DocuWare Control

Domanda:
Che cos'è DocuWare Control e come può essere utilizzato?

Soluzioni:
DocuWare Control consente di gestire l'elaborazione dei documenti utilizzando comandi speciali. Consultare la guida per la configurazione di DocuWare Control;

DocuWare Control con DocuWare Printer
Ogni istruzione di DocuWare Control deve iniziare con <dwControl :.

• Assicurarsi che tutti i comandi siano scritti con il font "DWControl.ttf" per essere riconosciuti come comandi validi.
  Il fontDWControl.ttf viene installato con DocuWare Printer. In alternativa, è possibile trovarlo in "...DocuWare Desktop" e "DWControl.ttf".
• Non è importante il colore o la dimensione dei comandi, ad esempio è possibile utilizzare comandi bianchi su sfondo bianco.
• Tutti i comandi verranno rimossi dal documento dopo la loro elaborazione.

• Comando DWControl per DW Printer:
  <dwControl:Field dbName="EMPLOYEE" type="Text" value="Mark Smith"/>
• Comando DWControl per DW Import:
  <Campo dbName="EMPLOYEE" tipo="Text" valore="Mark Smith"/>
• Tutti i comandi devono essere specificati in un file .dwcontrol, in una sezione<Page>.
• Prestare attenzione all'uso delle maiuscole e delle minuscole.
• Ogni file .dwcontrol deve iniziare con la seguente riga
  <ControlStatements xmlns="http://dev.docuware.com/Jobs/Control" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">.
• Per ulteriori informazioni ed esempi,vedere KBA-36502.

• Valori di testo/memoria
  <dwControl:Field dbName="EMPLOYEE" type="Text" value="Mark Smith"/>
  <dwControl:Field dbName="MEMO" type="Memo" value="Text"/>
• Valori delle parole chiave
  <dwControl:Field dbName="Remark" type="Keyword" value="one"/>
  <dwControl:Field dbName="Remark" type="Keyword" value="two"/>
  Nota: Quando si memorizzano più valori in un singolo campo parola chiave, sono necessari più comandi di controllo.
• Valori numerici
  In culture diverse, i due punti o i punti e altri caratteri sono interpretati in modo diverso, quindi è necessario fornire la cultura per interpretare correttamente il valore. Ad esempio, 3.000 in Germania viene interpretato come 3000, ma come 3 in Inghilterra. Nell'esempio fornito, il valore sarà salvato come 31,20.
  <dwControl:Field dbName="SALARY" type="Numeric" value="31,2" culture="de-CH" decimalPlaces="2" />
  Quando si memorizza un documento in un cestino, a causa di una restrizione arcaica di DocuWare, è necessario conoscere il numero di cifre decimali del valore che deve essere memorizzato nel cestino. Nell'esempio fornito, il valore viene salvato automaticamente nel cestino come 3120, quando decimalPlaces è 2. Salvando manualmente il documento dal cestino all'archivio, si otterrebbe di nuovo 31,20 . Se decimalValues non è specificato, l'impostazione predefinita è 2.
• Valori della data
  <dwControl:Field dbName="EMPLOYMENTDATE" type="Date" value="2010-04-03" culture="en-US" format="yyyy-MM-dd" />
  <dwControl:Field dbName="EMPLOYMENTDATE" type="Date" value="03 April 2010" culture="en-US" format="dd MMMM yyyy" />
  <dwControl:Field dbName="DATUM" type="Date" value="03. 04.2010" culture="deyy-MM-dd" /> <dwControl:Field dbName="DATUM" type="Date" value="03.04.2010" culture="de-DE" format="dd.MM.yyyy" />
  <dwControl:Field dbName="DATUMZEIT" type="DateTime" value="2010-04-03 7:43P" culture="en-US" format="yyyy-MM-dd h:mmt" />

Forms
Se si creano documenti senza intestazione, è possibile aggiungerli utilizzando il comando Form. Il comando è legato solo alla pagina in cui si trova. Se in una pagina si trovano più comandi Form, verrà utilizzato il primo.
Come modulo o carta intestata, è necessario utilizzare un file pdf. Questo file può trovarsi in una risorsa locale, definita dal parametro percorso, oppure può far parte della Configurazione della stampante.

Esempio di utilizzo di una risorsa locale.
<dwControl:Form path="C:\forms\letterhead.pdf" />

Utilizzo di una Configurazione stampante come repository di moduli
In ogni Configurazione stampante è possibile impostare i moduli per la prima pagina o per tutte le altre. I parametri configName e configId fanno riferimento a tale configurazione. Il parametro configForm può avere il valore 1 per la prima pagina o 2 per tutte le altre pagine, per selezionare uno dei moduli della configurazione di riferimento. Per questa configurazione, sono richiesti i diritti d'uso.

Ad esempio, se si dispone di una configurazione "Lettere", in cui è definita una testata di lettera per la prima pagina, è possibile utilizzarla con questo comando.
<dwControl:Form configName="Lettere" configForm="1"/>

Stampa
Se si desidera reindirizzare il documento a un'altra stampante, è possibile utilizzare il comando Stampa. Il nome della stampante può essere specificato nell'attributo device. Vengono utilizzate le impostazioni predefinite di questa stampante. Se occorre un'impostazione specifica, creare un'istanza aggiuntiva della stampante con un altro nome e definire lì l'impostazione necessaria.
Inoltre, se si utilizza il comando Form, è possibile scegliere se la stampa dovrà essere con o senza form. Si può inserire true nel valore di withoutForm, se non si vuole stampare il modulo definito, o false in caso contrario.
<dwControl:Print device="la mia stampante" withoutForm="true" />
Se non viene definito, withoutForm viene impostato su false.

Stampa sulla stampante predefinita:
<dwControl:Print />

È possibile stampare documenti aggiuntivi, come ad esempio le condizioni generali di contratto alla fine del documento. Il file deve essere in formato pdf.
<dwControl:Print device="la mia stampante" additionalFilePath="C:\terms\conditions.pdf" />

Utilizzo della Configurazione della stampante come deposito di file aggiuntivo
Analogamente al comando Form, è possibile utilizzare le Configurazioni stampante per distribuire i file necessari all'esecutore dei comandi di DocuWare Control.

Il nome del file aggiuntivo fa riferimento alle configurazioni della stampante in cui deve essere definito un file di stampa aggiuntivo. Per questa configurazione sono necessari i diritti di utilizzo:
<dwControl:Print device="la mia stampante di fatture" additionalFileConfigName="Fatture" />

Firma
Se si desidera firmare elettronicamente il documento, è possibile utilizzare il comando Firma. Analogamente al comando Form, è possibile utilizzare le Configurazioni della stampante per caricare le informazioni necessarie, in questo caso un certificato.
Il nome del certificato fa riferimento alle Configurazioni della stampante in cui deve essere configurata la firma. Per questa configurazione sono necessari i diritti di utilizzo.
<dwControl:Sign certificateConfigName="Firma pdf" />

Caratteri speciali
Un valore deve essere circondato da virgolette singole "esempio" o da virgolette doppie "esempio".
Utilizzando DWControl con DW Printer non è necessario eseguire l'escape dei caratteri speciali, mentre utilizzando DWControl con DW Import i caratteri speciali devono essere eseguiti correttamente.

Per informazioni su DocuWare Control con i caratteri speciali, consultare i seguenti KBA:

• Come utilizzare i caratteri speciali nei metadati .dwcontrol? -KBA-35321
• Come incorporare gli umlaut in un file DWControl? - KBA-35278

Stringhe vietate nei valori dei parametri
Evitare di utilizzare queste stringhe nei parametri di DocuWare Control:
Non utilizzare le stringhe di DW Control "<dwControl:...":
<dwControl:Field dbName="REMARK" type="Text" value="<dwControl:NewDocument/>"/>

All'interno delle virgolette singole, qualsiasi carattere di virgoletta singola è vietato.
<dwControl:Field dbName="REMARK" type="Text" value='Say:'Hello''/>

All'interno di virgolette doppie, tutte le virgolette doppie sono vietate.
<dwControl:Field dbName="REMARK" type="Text" value="Say: "Ciao""/>

Il KBA è applicabile alle organizzazioni cloud e on-premise.

Si prega di notare: Questo articolo è una traduzione dall'inglese. Le informazioni contenute in questo articolo si basano sulla versione originale in inglese del/i prodotto/i. Potrebbero esserci piccoli errori, ad esempio nella grammatica utilizzata nella versione tradotta dei nostri articoli. Sebbene non possiamo garantire la completa accuratezza della traduzione, nella maggior parte dei casi la troverete sufficientemente informativa. In caso di dubbi, si prega di fare riferimento alla versione inglese di questo articolo.