Parse the Metadata from an SAP OData V2 Service

Parses the metadata XML describing an SAP OData V2 service and generates two Rust modules: one for the Service Document and one for the metadata document.

The code generated by this crate is designed to work in conjunction with the crate parse-sap-atom-feed.

Generated Modules

OData Service Document Module

• The metadata description of the OData service is used to declare for all the structs and enums needed to interact with your chosen OData service.

• For each OData Collection, a Rust struct is generated to represent a row of that collection, then the entire collection is represented as a Vec of that generated struct.

  • Edm.DateTime fields are transformed into chrono::NaiveDateTime using a custom deserializer.

  • Edm.Decimal fields transformed into rust_decimal::Decimal

    However, this transformation can only account for the declared number of decimal places (defined by the Scale property). The number of decimal digits (defined by the Precision property) is ignored as rust_decimal::Decimal values use a hard-coded precision of 64.

• The generated module declares external crate dependencies on quick_xml and serde and possibly also on chrono, rust_decimal and uuid depending on whether Edm.DateTime, Edm.Decimal or Edm.Guid properties are encountered.

OData Service Metadata Module

• For each EntityType occurring in the metadata:

  • A struct is created using the EntityType's name followed by Metadata. E.G. <EntityType Name="BusinessPartner"> generates pub struct BusinessPartnerMetadata
  • An implementation is created containing a key() function and getter function for each struct property that returns an instance of a Property object.

• The Name property of each <Association> metadata tag is stripped of the Assoc_ prefix and added as a member to the Associations enum.

• The Name property of each <AssociationSet> metadata tag is stripped of the Assoc_ prefix and the _AssocSet suffix and added as a member to the AssociationSets enum.

• For each <Association> or <AssociationSet> enum, there is an implementation containing a getter function for each Association(Set).

• The generated module declares an external crate dependency on parse_sap_atom_feed.

Table of Contents

• Usage
• OData Complex Types
• Metadata Module
• EntitySets Enum
• Limitations and Issues

Change Log