Ampliar la funcionalidad de licencias de control de exportación

Este artículo proporciona información útil para los desarrolladores que están ampliando la funcionalidad de licencia para implementar controles de exportación.

La información de la licencia se almacena en la tabla msdyn_exportcontrollicense . El seguimiento de las licencias se proporciona únicamente en lo que respecta al control de exportaciones. No debe considerarse un subsistema de gestión de licencias de uso general.

Evaluación de licencia

Todas las comprobaciones de licencia se realizan a nivel de línea de documento. Un solo documento puede contener líneas que hagan referencia a varias licencias. Cuando el sistema evalúa una licencia, se realiza la misma evaluación que se utiliza para las reglas de restricción y excepción. La evaluación considera cualquier campo que tenga un valor en la definición de la licencia. Ignora los campos que no tienen un valor. Como es el caso de las reglas, la licencia se considera válida sólo si el valor coincide con la línea que se está procesando.

La fecha del documento se compara con las fechas de inicio y finalización de validez de la licencia, si se proporcionan. Para realizar la verificación basándose en la fecha actual en lugar de la fecha del documento, utilice una regla de Power Fx o pase la fecha actual en el documento que se está analizando. El campo Fecha de exportación prevista de la licencia no tiene ningún impacto y se proporciona solo como referencia. Sin embargo, se puede hacer referencia a él desde las reglas de Power Fx.

Se puede proporcionar una licencia a nivel de documento o a nivel de línea. Se supone que hay una licencia a nivel de documento de forma predeterminada en todas las líneas. Se anula si se proporciona una licencia en una línea específica.

Líneas de licencia y consumo

El Número de Clasificación de Control de Exportaciones (ECCN) de la línea de la licencia debe coincidir con el ECCN de la línea del documento que hace referencia a la licencia. Si ninguna línea de la licencia tiene un ECCN coincidente, la verificación falla y la colección de problemas de licencia contiene una referencia a la licencia faltante.

Las siguientes tres propiedades en la llamada de verificación de control de exportaciones controlan cómo se maneja el consumo de licencias:

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

El consumo se rastrea en la tabla msdyn_exportcontrollicenselineconsumption. Los campos SourceApplication y SourceDocument se utilizan para hacer referencia a qué documento entrante de un sistema externo ha consumido la cantidad o el valor. Si especifica true para msdyn_DecrementLicenseQuantity, las filas se escriben en la tabla msdyn_exportcontrollicenselineconsumption y se bloquearán futuras comprobaciones de licencia si no cantidad o valor permanece para esa línea. Si los mismos valores SourceApplication y SourceDocument se pasan nuevamente con DecrementLicenseQuantity, todas las disminuciones existentes para ese documento se eliminan y luego se vuelven a crear con las cantidades actualizadas y valores. Por lo tanto, si se actualiza un pedido de venta y se debe reservar una cantidad diferente (ya sea mayor o menor), todos los valores existentes se pueden actualizar simplemente enviando el pedido de venta por segunda vez.

La cantidad y el valor consumidos se calculan como campos acumulativos en la línea de licencia. Si no se proporciona ninguna cantidad o valor total, las verificaciones de control de exportaciones no se bloquean para esa línea de licencia. En cambio, la cantidad total consumida y el valor total consumido continúan acumulándose. El valor de la línea es un campo de moneda Dataverse estándar. Para obtener más información sobre los campos de moneda y los tipos de cambio, consulte Usar columnas de moneda.

El consumo de licencia se calcula y actualiza automáticamente en función de las comprobaciones cuando msdyn_DecrementLicenseQuantity se establece en Verdadero. Sin embargo, los usuarios que tienen los permisos adecuados también pueden crear, editar o eliminar líneas de consumo directamente desde la tabla msdyn_exportcontrollicenselineconsumption según sea necesario. El acceso para ver y editar esta y todas las demás tablas se basa en la seguridad estándar Dataverse basada en roles.

Conversión de unidades y divisas

Si se especifica una unidad o moneda tanto en una línea de licencia como en un documento entrante relacionado, el sistema convierte la unidad y la moneda automáticamente. Si el documento que se verifica o la línea de licencia no especifica una unidad o moneda, se supone que el monto proporcionado está en la misma unidad o moneda que la línea de licencia.

Si las soluciones Dynamics 365 Supply Chain Extended y Dynamics 365 Finance Extended de doble escritura están instaladas en su entorno, el sistema convierte unidades y monedas utilizando los valores msdyn_unitofmeasureconversion y msdyn_currencyexchangerate ., respectivamente. Si las soluciones de escritura dual no están instaladas, el sistema aplica las conversiones Dataverse predeterminadas. Si no se encuentra una conversión para la moneda o unidad en los datos existentes, se devuelve un problema de licencia y se bloquea la verificación.