Altova MapForce 2023 Enterprise Edition

Si no resulta aceptable la validación El incompleta (o relajada) de un campo, se puede configurar MapForce para que ejecute una validación completa de ese campo. Una validación incompleta puede como resultado datos no válidos. Por eso recomendamos una validación completa de los campos. Para ello debe añadir archivos .Codelist personalizados a los predeterminados.

 

El papel de estos archivos es proporcionar cualquier valor de código que no esté definido en el estándar EDI y, en consecuencia, no esté presente en los archivos de configuración de MapForce, algo que suele ocurrir con los valores de código definidos en estándares o recomendaciones externos. Un archivo .Codelist personalizado debe incluir todos los valores de código definidos en un archivo externo estándar.

 

Relajar la validación de campos en el elemento de datos EDIFACT/UNO 4405.

En el ejemplo siguiente puede ver cómo ejecutar una validación completa de los campos del elemento de datos EDIFACT/UNO 4405 que puede usar valores de código externos de la recomendación 24 de la ONU/CEPE. El proceso consiste en dos pasos: (i) crear la estructura de un archivo .Codelist personalizado y (ii) hacer referencia al nuevo archivo .Codelist en los archivos de configuración. Puede usar el mismo método para otros estándares EDI.

 

Crear un archivo .Codelist personalizado.

Para crear la estructura de un archivo .Codelist personalizado siga estos pasos:

 

1.Crear una colección EDI personal Aunque se pueden definir listas de código externas editando el archivo .Codelist que viene con MapForce, no es recomendable. Es preferible definir siempre listas de código externas en archivos personalizados y evitar modificar los archivos de configuración de MapForce.

2.En su directorio personal Colecciones EDI encuentre el archivo .Codelist que quiere usar como plantilla. En este ejemplo usamos UNCL.Codelist como plantilla.

3.Copie UNCL.Codelist y cambie el nombre del archivo copiado. Este es un archivo al que harán referencia otros archivos de configuración de MapForce. En este ejemplo el archivo copiado es UNECE24.Codelist.

4.Abra UNECE24.Codelist en un editor (como Altova XMLSpy) y elimine todo el contenido del elemento <Codelist>.

5.Agregue una nueva estructura <Field> para F4405 (imagen siguiente). Puede encontrar el nombre, la longitud y el tipo correctos para cada campo en el archivo .Codelist predeterminado que viene con MapForce (en este ejemplo, UNCL.Codelist).

 

<?xml version="1.0" encoding="UTF-8"?>
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="5" xsi:noNamespaceSchemaLocation="../EDIConfig5.xsd">  
  <Codelist>      
     <Field Name="F4405" Length="3" Type="Alphanumeric">
        <Title>Trade and transport status codes</Title>
        <Description>Code specifying a status.</Description>        
        <Values>

 
        <...>

 

        <Values>
     </Field>
  </Codelist>
</Config>

 

6.Por cada código externo agregue un elemento <Value> como secundario del elemento <Values>. En este ejemplo vamos a añadir los primeros dos códigos definidos en UN/ECE Recommendation 24.

 

<?xml version="1.0" encoding="UTF-8"?>
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="5" xsi:noNamespaceSchemaLocation="../EDIConfig5.xsd">  
  <Codelist>      
     <Field Name="F4405" Length="3" Type="Alphanumeric">
        <Title>Trade and transport status codes</Title>
        <Description>Code specifying a status.</Description>        
        <Values>
           <Value Code="1">
              <Title>Arrival, completed</Title>
              <Description>The goods/consignment/equipment/means of transport has arrived.</Description>
           </Value>
           <Value Code="2">
              <Title>Loading, authorized</Title>
              <Description>Authorization to load has been given.</Description>
           </Value>
        <Values>
     </Field>
  </Codelist>
</Config>

 

Haga referencia al archivo personalizado

En este momento el archivo UNECE24.Codelist personalizado está listo pero todavía no está vinculado a MapForce. Para que MapForce pueda reconocer este archivo siga estos pasos:

 

1.Como ahora el elemento de datos 4405 ya no tiene una validación incompleta, hay que indicarle a MapForce que aplique la validación completa: Concretamente, hay que modificar el atributo Incomplete="1" en el archivo UNCL.Codelist o definir el valor de este atributo a 0. A continuación puede ver la primera opción:

 

<Field Name="F4405" Length="3" Type="Alphanumeric" Incomplete="0">
  <Title>Status description code</Title>
  <Description>Code specifying a status.</Description>
  <Note>1 For transport status, use UN/ECE Recommendation 24.</Note>

  <...>

</Field>

 

2.Haga referencia a UNECE24.Codelist en UNCL.Codelist (resaltado en amarillo más abajo). También puede hacer referencia a su archivo .Codelist personalizado en el archivo Envelope.Config.

 

<?xml version="1.0" encoding="UTF-8"?>
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="5" xsi:noNamespaceSchemaLocation="../EDIConfig5.xsd">
  <Include href="UNECE24.Codelist"/>
  <Codelist>

 

     <...>

 

  </Codelist>

 

Las instrucciones anteriores explican cómo ejecutar una validación global para todos los mensajes en los que se usa el campo F4405. En algunos casos puede que quiera que las listas de código personalizadas se apliquen solamente a ciertos mensajes (p. ej. de forma local). Para más información sobre el método local consulte Definir valores de código a nivel de mensaje.

 

© 2017-2023 Altova GmbH