Estendere la funzionalità delle licenze per i controlli esportazione

Questo articolo fornisce informazioni utili per gli sviluppatori che stanno estendendo la funzionalità delle licenze per implementare i controlli delle esportazioni.

Le informazioni sulle licenze sono archiviate nella tabella msdyn_exportcontrollicense. Il monitoraggio delle licenze viene fornito solo per quanto riguarda il controllo delle esportazioni. Non deve essere considerato un sottosistema di gestione delle licenze per scopi generici.

Valutazione delle licenze

Tutti le verifiche delle licenze vengono eseguite a livello di riga del documento. Un singolo documento può contenere righe che fanno riferimento a più licenze. Quando il sistema valuta una licenza, viene eseguita la stessa valutazione utilizzata per le regole di restrizione ed eccezione. La valutazione considera qualsiasi campo che abbia un valore nella definizione di licenza. Ignora i campi che non hanno un valore. Come avviene per le regole, la licenza è considerata valida solo se il valore corrisponde alla riga in elaborazione.

La data del documento viene confrontata con le date di inizio e di fine della validità della licenza, se fornite. Per eseguire la verifica in base alla data corrente anziché alla data del documento, utilizza una regola Power Fx o passa la data corrente nel documento che viene analizzato. Il campo Data di esportazione prevista della licenza non ha alcun impatto ed è fornito solo come riferimento. Tuttavia, è possibile farvi riferimento dalle regole Power Fx.

Una licenza può essere fornita a livello di documento o di riga. Il presupposto è che una licenza a livello di documento sia su tutte le righe per impostazione predefinita. Viene sovrascritto se viene fornita una licenza su una riga specifica.

Righe della licenza e consumo

Il numero di classificazione del controllo delle esportazioni (ECCN) della riga della licenza deve corrispondere all'ECCN della riga del documento che fa riferimento alla licenza. Se nessuna riga nella licenza ha un ECCN corrispondente, la verifica non riesce e la raccolta dei problemi di licenza contiene un riferimento alla licenza mancante.

Le seguenti tre proprietà della chiamata di verifica del controllo delle esportazioni controllano il modo in cui viene gestito il consumo della licenza:

• "msdyn_ExportControlSourceApplication": "Supply Chain"
• "msdyn_ExportControlSourceDocument": "SO1347134"
• "msdyn_DecrementLicenseQuantity": true

Il consumo è monitorato nella tabella msdyn_exportcontrollicenselineconsumption. I campi SourceApplication e SourceDocument sono utilizzati per fare riferimento al documento in entrata da un sistema esterno che ha consumato la quantità o il valore. Se specifichi true per msdyn_DecrementLicenseQuantity, le righe vengono scritte nella tabella msdyn_exportcontrollicenselineconsumption e le future verifiche della licenza verranno bloccate se per quella riga non rimane alcuna quantità o valore. Se gli stessi valori SourceApplication e SourceDocument vengono passati nuovamente con DecrementLicenseQuantity, tutti i decrementi esistenti per quel documento vengono eliminati e quindi ricreati con le quantità e i valori aggiornati. Pertanto, se un ordine cliente viene aggiornato e deve essere prenotata una quantità diversa (maggiore o minore), tutti i valori esistenti possono essere aggiornati semplicemente inviando l'ordine cliente una seconda volta.

La quantità e il valore consumati vengono calcolati come campi di rollup nella riga della licenza. Se non viene fornita alcuna quantità o valore totale, le verifiche del controllo delle esportazioni non vengono bloccate per quella riga della licenza. Invece, la quantità totale consumata e il valore totale consumato continuano ad accumularsi. Il valore della riga è un campo valuta Dataverse standard. Per ulteriori informazioni sui campi valuta e sui tassi di cambio, consulta Utilizzo delle colonne valuta.

Il consumo della licenza viene calcolato e aggiornato automaticamente in base alle verifiche quando msdyn_DecrementLicenseQuantity è impostato su True. Tuttavia, gli utenti che dispongono delle autorizzazioni appropriate possono anche creare, modificare o eliminare le righe di consumo direttamente dalla tabella msdyn_exportcontrollicenselineconsumption come richiesto. L'accesso per visualizzare e modificare questa e tutte le altre tabelle si basa sulla sicurezza basata sui ruoli Dataverse standard.

Conversione dell'unità e della valuta

Se un'unità o una valuta è specificata sia in una riga di licenza che in un documento in entrata correlato, il sistema converte automaticamente l'unità e la valuta. Se il documento da verificare o la riga della licenza non specifica un'unità o una valuta, si presuppone che l'importo fornito sia nella stessa unità o valuta della riga della licenza.

Se nell'ambiente sono installate le soluzioni a doppia scrittura Dynamics 365 Supply Chain Extended e Dynamics 365 Finance Extended, il sistema converte le unità e le valute che utilizzano rispettivamente i valori msdyn_unitofmeasureconversion e msdyn_currencyexchangerate. Se le soluzioni a doppia scrittura non sono installate, il sistema applica le conversioni Dataverse predefinite. Se non viene trovata una conversione per la valuta o l'unità nei dati esistenti, viene restituito un problema di licenza e la verifica viene bloccata.