Doc.DocumentNumberAndSeries (property)
Restituisce un identificativo del documento composto esclusivamente da cifre numeriche, ottenuto combinando l'ID interno della numerazione utilizzata e il numero progressivo del documento.
Questa proprietà è particolarmente utile nelle integrazioni con sistemi esterni, ad esempio nei plugin per i corrieri, quando è necessario trasmettere un identificativo privo di caratteri speciali.
I suffissi delle numerazioni possono infatti contenere lettere o altri caratteri, come lo slash (/), che potrebbero non essere accettati da alcuni servizi esterni o richiedere una gestione particolare all'interno di URL, sistemi di tracking o altri flussi di dati.
La proprietà Doc.DocumentNumberAndSeries permette di ottenere un valore composto solamente da cifre, senza utilizzare direttamente il suffisso del documento.
Tipo dati restituito
String
Composizione del valore restituito
Il valore viene generato concatenando:
Supponiamo di avere un documento di trasporto (DDT) con numero 1234/A.
Supponiamo inoltre che la numerazione con suffisso /A sia identificata nel database di Ready Pro con l'ID 15 (questo ID è un progressivo non modificabile)
Il valore restituito viene composto nel seguente modo:
- ID interno della numerazione: 15
- Numero del documento: 1234 completato a 10 cifre: 0000001234
Valore finale: 150000001234
Lo script:
Il numero di 10 cifre si riferisce solamente alla parte numerica del documento. La lunghezza complessiva del valore restituito dipende anche dal numero di cifre dell'ID interno della numerazione.
ATTENZIONE Il valore generato non comprende l'anno del documento. Se una stessa numerazione riparte da 1 ogni anno, documenti di anni differenti con lo stesso progressivo potrebbero generare il medesimo identificativo. Occorre quindi verificare l'effettiva unicità del valore prima di utilizzarlo come chiave univoca permanente in un sistema esterno.
N.B. Il nome della proprietà termina con Series, con la lettera s finale. Non va confusa con Doc.DocumentNumberAndSerie, che restituisce invece il numero del documento completo dell'eventuale suffisso, ad esempio "1234/A".
Per informazioni sulla configurazione delle URL di tracking dei corrieri è possibile consultare anche la pagina Configurazione dellURL di tracking con modelli preconfigurati e tag dinamici
Questa proprietà è particolarmente utile nelle integrazioni con sistemi esterni, ad esempio nei plugin per i corrieri, quando è necessario trasmettere un identificativo privo di caratteri speciali.
I suffissi delle numerazioni possono infatti contenere lettere o altri caratteri, come lo slash (/), che potrebbero non essere accettati da alcuni servizi esterni o richiedere una gestione particolare all'interno di URL, sistemi di tracking o altri flussi di dati.
La proprietà Doc.DocumentNumberAndSeries permette di ottenere un valore composto solamente da cifre, senza utilizzare direttamente il suffisso del documento.
Tipo dati restituito
String
Composizione del valore restituito
Il valore viene generato concatenando:
- ID interno della numerazione: l'identificativo progressivo con cui la numerazione è registrata nel database di Ready Pro.
- Numero progressivo del documento: la parte numerica del documento, completata con zeri non significativi a sinistra fino a raggiungere una lunghezza di 10 cifre.
Supponiamo di avere un documento di trasporto (DDT) con numero 1234/A.
Supponiamo inoltre che la numerazione con suffisso /A sia identificata nel database di Ready Pro con l'ID 15 (questo ID è un progressivo non modificabile)
Il valore restituito viene composto nel seguente modo:
- ID interno della numerazione: 15
- Numero del documento: 1234 completato a 10 cifre: 0000001234
Valore finale: 150000001234
Lo script:
Response.Write(Doc.DocumentNumberAndSeries)restituisce quindi:
150000001234Il numero di 10 cifre si riferisce solamente alla parte numerica del documento. La lunghezza complessiva del valore restituito dipende anche dal numero di cifre dell'ID interno della numerazione.
ATTENZIONE Il valore generato non comprende l'anno del documento. Se una stessa numerazione riparte da 1 ogni anno, documenti di anni differenti con lo stesso progressivo potrebbero generare il medesimo identificativo. Occorre quindi verificare l'effettiva unicità del valore prima di utilizzarlo come chiave univoca permanente in un sistema esterno.
N.B. Il nome della proprietà termina con Series, con la lettera s finale. Non va confusa con Doc.DocumentNumberAndSerie, che restituisce invece il numero del documento completo dell'eventuale suffisso, ad esempio "1234/A".
Per informazioni sulla configurazione delle URL di tracking dei corrieri è possibile consultare anche la pagina Configurazione dellURL di tracking con modelli preconfigurati e tag dinamici