Nombres

Identifican y distinguen, de forma exclusiva, una instancia de un objeto en un esquema de identificación de los demás objetos en el mismo esquema. Por ejemplo, PersonIdentifierType, OrganizationIdentifierType, CatalogExternalIdentifierType

Tipos que no son específicos de dominio. Por ejemplo, DescriptionType, LanguageType, CurrencyType, CharType y UserDataType.

Tipos específicos de dominio que los componentes comparten. Incluya CommonTypes.xsd si desea utilizar los tipos definidos en IdentifierTypes.xsd y BaseTypes.xsd.

Incluye IdentifierTypes.xsd y BaseTypes.xsd

• Modele nombres de forma que muchos servicios puedan interactuar con un solo nombre. Un objeto de negocio que parece una lista de parámetros de mandato de controlador de HCL Commerce no está bien definido.
• Mejore la eficacia de los objetos de negocio como una vista lógica de su negocio. Un modelo lógico bien diseñado debe ser comprensible para los usuarios de empresa, mientras que un esquema de base de datos debe estar optimizado para el almacenamiento y la recuperación de datos.
• No utilice abreviaturas, excepto para formas cortas bien conocidas y acrónimos estándar de la industria. Por ejemplo, ID y SKU son acrónimos aceptable, pero Grp no.
• Utilice nombres explícitos. No utilice símbolos ni nombres.
• Añada anotaciones al esquema para describir elementos. En particular, añádalas a elementos en los que los valores tienen un significado específico. Por ejemplo, añada anotaciones al esquema ProcessNoun para describir las acciones posibles del verbo del proceso.
• Incluya información específica de la tienda en el nombre, o parte del nombre, cuando el objeto de negocio tenga un contexto específico de la tienda. Considere el ejemplo siguiente, un sitio contiene varias tiendas que venden la misma mercancía. En este caso, una entrada de catálogo no es específica de la tienda. Cada tienda tiene su propio catálogo; por tanto, el catálogo es específico de la tienda.
• Modele el objeto de negocio de forma que éste incluya datos de otros nombres, cuando sea apropiado. Por ejemplo, el precio de una entrada de catálogo varía en función del cliente, los descuentos, el segmento de clientes, etc., y para mayor simplicidad, el nombre CatalogEntry no incluye información sobre el precio. La información sobre el precio está en un nombre PriceList.
• Cree nombres personalizados que hagan referencia a nombres de HCL Commerce. Por ejemplo, para crear un nombre que haga referencia a una entrada de catálogo, incluya CatalogEntryIdentifierType, el tipo de identificador de entrada de catálogo, en su nombre. Esta asociación permite al servicio solicitar más información. El nombre Order hace referencia al tipo StoreIdentifier utilizando este método.

• Empiece con una mayúscula; a continuación, utilice la bicapitalización.
• Finalice el nombre con Type. Esto distingue los objetos de tipo definidos y los elementos que son de ese tipo.
• Incluya un elemento UserData en todos los tipos complejos. El elemento UserData permite la personalización.
• Defina tipos enumerados en el esquema. Empiece con una mayúscula; a continuación, utilice la bicapitalización. Por ejemplo, defina un tipo enumerado para valores de dirección como Home, Office y Cottage. No utilice los valores de bit internos para definir tipos enumerados; asegúrese de que los valores tienen sentido para el usuario.
• Utilice normalizedString para la enumeración. Los valores de enumeración empiezan con una mayúscula; a continuación, utilice la bicapitalización.
• Utilice la unión con EnumerationExtensionType (definido en IdentifierTypes.xsd) para dar soporte a la extensión. EnumerationExtensionType tiene un valor de patrón de x[0-9A-Za-z][0-9A-Za-z_.]*.

  
   <simpleType name="AddressUsageEnumerationType">
        <annotation>
            <documentation>Indicates how usage of the address:
       Shipping:  Shipping address
       Billing:  Billing address
       ShippingAndBilling: Shipping and Billing address
     </documentation>
    </annotation>
    <restriction base="normalizedString">
               <enumeration value="Shipping"/>
               <enumeration value="Billing"/>
               <enumeration value="ShippingAndBilling"/>
    </restriction>
   </simpleType>
   
   <simpleType name="AddressUsageType">
        <annotation>
            <documentation>Allows extension to the default address usage types.
     </documentation>
    </annotation>
    <union memberTypes="wcf:AddressUsageEnumerationType
                        wcf:EnumerationExtensionType"/>
   </simpleType>
  

• Incluya un tipo complejo de identificador, éste consta de clave interna (clave primaria) e identificador externo. Este tipo de identificador lo utilizan los otros tipos para hacer referencia a este objeto. IdentifierType contiene:

  UniqueID

  Serie necesaria, UniqueID, que normalmente se correlaciona con la clave primaria. Para identificar un objeto se puede utilizar una clave interna o un identificador externo, sin embargo, en la respuesta siempre se devuelve la clave interna.

  Identificadores externos

  Los identificadores externos son opcionales. Para hacer referencia a otro objeto (clave foránea), utilice una clave interna o un identificador externo. Si se utiliza el identificador externo, el identificador no se puede cambiar una vez que el objeto se ha guardado.

  <complexType name="PersonIdentifierType">
       <sequence>
           <element maxOccurs="1" minOccurs="0" name="UniqueID" type="string"></element>
           <element maxOccurs="1" minOccurs="0" name="DistinguishedName" type="string"></element>
      </sequence>
  </complexType>
  

• Empiece con una mayúscula; a continuación, utilice la bicapitalización.
• No utilice caracteres de subrayado en nombres de elementos.
• Utilice un nombre coherente con el tipo correspondiente, pero no añada Type.
• Si el elemento es un identificador de tipo simple, añada ID al final. Por ejemplo, SomeObjectNameID.

• Empiece con una minúscula; a continuación, utilice la bicapitalización.
• No utilice caracteres de subrayado en nombres de atributos.
• Se deben utilizar atributos para delimitar valores de elementos, elementos para el contenido principal. Los tipos complejos deben tener como mínimo un elemento.

Un espacio de nombres consta de tres partes:

domain name

El nombre de dominio de la empresa.

/xmlns/prod/commerce/9

Indica un objeto relacionado con HCL Commerce basado en el sobre de proceso OAGIS 9.

business-service identifier

Clasifica un grupo de nombres.

Los valores predeterminados para los atributos de espacio de nombres son elementFormDefault="qualified" y attributeFormDefault="unqualified" .