Altova MapForce 2025 Enterprise Edition

Una vez haya generado código a partir del esquema de ejemplo se crea una aplicación C# de prueba, junto con varias bibliotecas de Altova de apoyo. Recuerde que el esquema de ejemplo (Main.xsd) tiene varias declaraciones de espacios de nombres. En consecuencia, el código generado incluye espacios de nombres que corresponden a alias de espacios de nombres (prefijos) del esquema, que son: Main::ord, Main::pur, Main::cmn y Main::cust.

 

Por lo general, para controlar espacios de nombres y prefijos XML con ayuda de las bibliotecas contenedoras de esquemas, debe contar con estos métodos:

 

DeclareAllNamespacesFromSchema(): llame a este método si quiere declarar los mismos espacios de nombres en su instancia XML que en el esquema. En cambio, si necesita distintos espacios de nombres, como en este ejemplo, entonces use DeclareNamespace(). El método DeclareAllNamespacesFromSchema() no se usa en este ejemplo porque lo que queremos es crear elementos XML con prefijos que sean ligeramente distintos a los que se declaran en el esquema.

DeclareNamespace(): llame a este método para crear o sobrescribir el atributo del prefijo del espacio de nombres de un elemento. Para ello primero debe crear ese elemento, bien con el método Append() o con AppendWithPrefix(), como explicamos a continuación.

AppendWithPrefix(): use este método para anexar un elemento de instancia con un prefijo concreto. Para crear la instancia XML de este ejemplo bastó con llamar a este método solamente para el elemento raíz. Todos los demás elementos se anexaron usando simplemente Append() y sus prefijos se añadieron automáticamente basándose en los espacios de nombres a los que pertenece el nombre del elemento.

 

El extracto de código siguiente muestra cómo crear un documento XML con varias declaraciones de espacios de nombres y nombres de elementos prefijados. Más concretamente, genera una instancia de orden de compra, como se puede ver en el Ejemplo: orden de compra. Es importante tener en cuenta que por motivos ilustrativos en el ejemplo algunos prefijos se han sobrescrito en la instancia XML (es decir, no son exactamente los mismos que los que se declaran en el esquema).

 

protected static void Example()
{
  // Create the XML document and append the root element
  pur.Main2 doc = pur.Main2.CreateDocument();
  pur.PurchaseType purchase = doc.Purchase.AppendWithPrefix("p");
 
  // Set schema location
  doc.SetSchemaLocation(@"Main.xsd");
 
  // Declare namespaces on root element
  purchase.DeclareNamespace("o", "http://NamespaceTest.com/OrderTypes");
  purchase.DeclareNamespace("c", "http://NamespaceTest.com/CustomerTypes");
  purchase.DeclareNamespace("cmn", "http://NamespaceTest.com/CommonTypes");
 
  // Append the OrderDetail element
  ord.OrderType order = purchase.OrderDetail.Append();
  ord.ItemType item = order.Item.Append();
  item.ProductName.Append().Value = "Lawnmower";
  item.Quantity.Append().Value = 1;
  item.UnitPrice.Append().Value = 148.42M;
 
  // Append the PaymentMethod element
  cmn.PaymentMethodTypeType paymentMethod = purchase.PaymentMethod.Append();
  paymentMethod.EnumerationValue = cmn.PaymentMethodTypeType.EnumValues.eVISA;
 
  // Append the CustomerDetails element
  cust.CustomerType customer = purchase.CustomerDetails.Append();
  customer.Name.Append().Value = "Alice Smith";
  cmn.AddressType deliveryAddress = customer.DeliveryAddress.Append();
  deliveryAddress.Line1.Append().Value = "123 Maple Street";
  deliveryAddress.Line2.Append().Value = "Mill Valley";
  cmn.AddressType billingAddress = customer.BillingAddress.Append();
  billingAddress.Line1.Append().Value = "8 Oak Avenue";
  billingAddress.Line2.Append().Value = "Old Town";
 
  // Save to file
  doc.SaveToFile("PurchaseOrder.xml", true);  
}

© 2018-2024 Altova GmbH