Numero del documento: differenze tra DocNumber, DocumentNumberAndSerie e DocumentNumberAndSeries

Negli script di Ready Pro sono disponibili diverse proprietà per recuperare il numero di un documento. A seconda della proprietà utilizzata, è possibile ottenere la sola parte numerica, il numero completo dell'eventuale suffisso oppure un identificativo tecnico composto esclusivamente da cifre.

Le tre proprietà disponibili sono:

• Doc.DocNumber: restituisce la sola parte numerica del documento.
• Doc.DocumentNumberAndSerie: restituisce il numero completo, comprensivo dell'eventuale suffisso della numerazione.
• Doc.DocumentNumberAndSeries: restituisce un identificativo numerico composto dall'ID interno della numerazione e dal numero progressivo del documento.

Numeri dei documenti e numerazioni
In Ready Pro, il numero di un documento è composto da una parte numerica progressiva, alla quale può essere aggiunto un suffisso che identifica la numerazione (o sezionale) utilizzata.

Ad esempio, nel caso di un documento di trasporto (DDT) con numero 1234/A:

• 1234 è la parte numerica progressiva.
• /A è il suffisso della numerazione.
• 1234/A è il numero completo del documento.

Per ogni tipo di documento è possibile configurare più numerazioni, ciascuna con il proprio eventuale suffisso, attraverso il menu Util / Impostazioni documenti, selezionando il tipo di documento e accedendo alla scheda Numerazioni.

Differenze tra le tre proprietà

Supponiamo di avere un DDT con numero 1234/A e che la numerazione con suffisso /A sia identificata internamente nel database di Ready Pro con l'ID 15.

Le tre proprietà restituiscono valori differenti.

1) Doc.DocNumber
Restituisce solamente la parte numerica progressiva del documento, senza l'eventuale suffisso.

Response.Write(Doc.DocNumber)

Risultato:

1234

Questa proprietà è utile quando è necessario recuperare solamente il numero progressivo del documento, senza considerare la numerazione utilizzata.

N.B. Documenti appartenenti a numerazioni differenti possono avere lo stesso numero progressivo. Ad esempio, i documenti 1234/A e 1234/B restituiscono entrambi il valore 1234.

2) Doc.DocumentNumberAndSerie
Restituisce una stringa contenente il numero completo del documento, comprensivo dell'eventuale suffisso associato alla numerazione.

Response.Write(Doc.DocumentNumberAndSerie)

Risultato:

1234/A

Questa proprietà è utile quando occorre riportare il numero del documento così come viene normalmente rappresentato in Ready Pro, ad esempio in stampe personalizzate, esportazioni o integrazioni con sistemi esterni.

Se il documento non prevede un suffisso, viene restituita solamente la parte numerica.

3) Doc.DocumentNumberAndSeries
Restituisce una stringa composta esclusivamente da cifre numeriche, ottenuta concatenando:

• L'ID interno della numerazione utilizzata dal documento.
• Il numero progressivo del documento, completato con zeri non significativi a sinistra fino a raggiungere 10 cifre.

Questa proprietà è utilizzata soprattutto nelle integrazioni con sistemi esterni, come i plugin per i corrieri, quando è preferibile utilizzare un identificativo privo di lettere, slash o altri caratteri speciali.

Ad esempio, supponendo che:

• Il documento abbia numero 1234/A.
• La numerazione /A abbia ID interno 15.
• Il numero progressivo 1234 venga completato a 10 cifre, diventando 0000001234.

Lo script:

Response.Write(Doc.DocumentNumberAndSeries)

Restituisce:

150000001234

Il valore è quindi composto da:

15 + 0000001234 = 150000001234

N.B. L'ID interno della numerazione non corrisponde al suffisso visualizzato sul documento. Il valore restituito può quindi essere differente tra archivi Ready Pro diversi, anche quando i documenti hanno lo stesso numero e suffisso.

N.B. Il valore generato non comprende l'anno del documento. Non deve quindi essere considerato necessariamente un identificativo univoco permanente: se il progressivo della stessa numerazione viene riutilizzato in anni differenti, anche il valore restituito potrebbe ripetersi.

Quale proprietà utilizzare?

• Utilizzare Doc.DocNumber quando interessa solamente la parte numerica progressiva del documento.
• Utilizzare Doc.DocumentNumberAndSerie quando è necessario ottenere il numero completo del suffisso, ad esempio 1234/A.
• Utilizzare Doc.DocumentNumberAndSeries quando è necessario ottenere un identificativo composto solamente da cifre, ad esempio per l'invio di dati a corrieri o servizi esterni che non accettano caratteri speciali.

ATTENZIONE

Le proprietà Doc.DocumentNumberAndSerie e Doc.DocumentNumberAndSeries hanno nomi quasi identici, ma restituiscono valori completamente diversi.

La differenza è solamente la lettera s finale:

• DocumentNumberAndSerie (senza s finale) restituisce il numero completo del documento: 1234/A.
• DocumentNumberAndSeries (con s finale) restituisce l'identificativo numerico: 150000001234.

È quindi importante utilizzare la proprietà corretta in base al formato richiesto dalla procedura o dal sistema esterno con cui si desidera interfacciarsi.