Proprietà avanzate dell'oggetto di business
Le proprietà avanzate utilizzate per scopi di serializzazione vengono create automaticamente con i valori appropriati quando si crea un oggetto di business o si importa un file WSDL con oggetti di business. Si consiglia di lasciare questi valori di serializzazione così come sono. Modificare un valore solo se si è un utente avanzato che ha la necessità di sovrascrivere un valore. È necessario avere una conoscenza approfondita di tutti gli elementi XML standard definiti dallo Schema XMLdi W3C. È inoltre necessario aver letto l'argomento di compatibilità dei servizi Web e il pattern di generazione XSD per l'argomento degli oggetti di business a cui si è collegati alla fine di questo argomento. Questi argomenti specificano le limitazioni che si applicano agli schemi XML che interagiscono con questo prodotto e all'interno di questo prodotto.
Una modifica interesserà solo questo particolare oggetto di business. Se si dispone di un'applicazione del processo con 100 oggetti di business e si desidera sovrascrivere un elemento come lo spazio dei nomi di destinazione nella rappresentazione XML per tutti gli oggetti di business, è necessario apportare 100 modifiche.
Qualsiasi modifica ai valori di serializzazione deve essere verificata. Se si utilizza l'oggetto di business nei servizi Web in entrata o in uscita, ad esempio, ciò significa verificare tali servizi Web dopo la modifica.
Proprietà avanzate | Proprietà parametro avanzate |
---|---|
Tipo elenco anonimo
Questa proprietà imposta se il tipo di wrapper è denominato o anonimo. Il valore predefinito è false (tipo denominato). Questa proprietà è disponibile solo quando il parametro è un elenco e la proprietà dell'elenco di wrap è true.
Tipo anonimo
Gli schemi possono essere creati con serie di tipi denominati, ad esempio un InvoiceType. Quindi, è possibile dichiarare elementi come invoiceCanadian che fanno riferimento a questi tipi. Tuttavia, se è necessario fare riferimento a un tipo una sola volta, si verifica un notevole sovraccarico di codifica. Un tipo anonimo viene utilizzato per questi casi di un singolo riferimento.
Per specificare il valore per un tipo anonimo, selezionare Tipo anonimo e selezionare true o false. Il valore predefinito è false. Se è stato letto il pattern di generazione XSD per l'argomento degli oggetti di business, si saprà anche che il valore reale non viene rispettato dal generatore. Salvare il lavoro. Fare clic su Visualizza schema XML. L'output deve essere simile al seguente esempio.
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://EH" targetNamespace=http://EH"
elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="employee">
<xs:complexType>
<xs:sequence>
<xs:element name="employeeNumber" nillable="false" type="xs:string" minOccurs="0" maxOccurs="1" />
<xs:element name="firstName" nillable="false" type="xs:string" minOccurs="0" maxOccurs="1" />
<xs:element name="lastName" nillable="false" type="xs:string" minOccurs="0" maxOccurs="1" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Nome elemento
Se la proprietà del tipo anonimo è impostata su true, questa proprietà posiziona il tipo anonimo sotto un elemento con il nome specificato.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Spazio dei nomi elemento
Questa proprietà imposta lo spazio dei nomi dell'elemento contenitore.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Escludi da XML
Nella maggior parte dei casi, si lascia questa impostazione nel suo valore predefinito false, che includerà il proprio oggetto di business o parametro nella rappresentazione XML. Tuttavia, un tipo potrebbe definire alcuni campi istanza che non si desidera serializzare in una rappresentazione XML. Ad esempio, un campo dell'istanza che non ha un equivalente in XML come si riferisce a un processo interno in esecuzione. Si potrebbe anche non voler serializzare molti dati quando si sa che il servizio Web potrebbe prendere alcuni dei dati e calcolare i valori stessi, migliorando le prestazioni riducendo i dati trasferiti.
Per escludere un oggetto di business o un parametro dalla rappresentazione XML, selezionare Escludi da XML e selezionare true. Salvare il lavoro. Fare clic su Visualizza schema XML.
employeeNumber
, l'output è simile al seguente:<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tns="http://EH" targetNamespace=http://EH"
elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:element name="employee">
<xs:complexType>
<xs:sequence>
<xs:element name="firstName" nillable="false" type="xs:string" minOccurs="0" maxOccurs="1" />
<xs:element name="lastName" nillable="false" type="xs:string" minOccurs="0" maxOccurs="1" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
Nome elemento elenco
Questa proprietà imposta il nome per una voce dell'elenco a capo. Questa proprietà è disponibile solo quando il parametro è un elenco e la proprietà dell'elenco di wrap è true.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica. Il valore predefinito è il nome del tipo di elementi dell'elenco.
Nome tipo elenco
Questa proprietà imposta il nome del tipo complesso che incapsula un elenco a capo. La proprietà è quindi valida solo per un elenco con wrapping non anonimo.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Numero massimo di ricorrenze
Questa proprietà imposta il numero massimo di volte in cui si verifica il parametro. Il valore predefinito è 1. Questa proprietà corrisponde a maxOccurs
nello schema XML.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Numero minimo di ricorrenze
Questa proprietà imposta il numero minimo di volte in cui si verifica il parametro. Il valore predefinito è 0. Questa proprietà corrisponde a minOccurs
nello schema XML.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Nome
Questa proprietà sovrascrive il nome del parametro serializzato con il nome specificato. Il valore predefinito è il nome del parametro. Questa proprietà corrisponde all'attributo name
nello schema XML.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Spazio dei nomi
Se si imposta lo spazio dei nomi per l'oggetto di business, questa proprietà modifica lo spazio dei nomi di destinazione. Lo spazio dei nomi di destinazione definisce esplicitamente gli elementi che appartengono a questa istanza dello spazio dei nomi. È possibile modificare lo spazio dei nomi di destinazione se è stato importato un file WSDL e lo spazio dei nomi di destinazione per il proprio oggetto di business è stato modificato durante l'importazione. Se si imposta la proprietà per un parametro, questo sovrascrive lo spazio dei nomi dell'elemento serializzato per quel parametro.
Per rinominare lo spazio dei nomi di destinazione, selezionare Spazio dei nomi e immettere lo spazio dei nomi di destinazione desiderato. Ad esempio: http://www.mycorporation.com/employees. Salvare il lavoro. Fare clic su Visualizza schema XML. L'output deve essere simile al seguente esempio.
<xs:schema targetNamespace="http://www.mycorporation.com/employees"
elementFormDefault="qualified" attributeFormDefault="unqualified">
<xs:complexType name="employee">
<xs:sequence>
<xs:element name="employeeNumber" type="xs:int" minOccurs="0"
maxOccurs="1" nillable="false" />
<xs:element name="firstName" type="xs:string" minOccurs="0"
maxOccurs="1" nillable="false" />
<xs:element name="lastName" type="xs:string" minOccurs="0"
maxOccurs="1" nillable="false" />
</xs:sequence>
</xs:complexType>
<xs:element name="employee" type="tns:employee" />
</xs:schema>
http://www.w3.org/2001/XMLSchema
.Nullo
Questa proprietà determina se il parametro può avere un valore null.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Tipo nodo
I nodi in un documento XML possono essere definiti come elementi o attributi. Nella maggior parte dei casi, viene utilizzato un tipo di elemento che è quello predefinito, quindi non è necessario impostarlo esplicitamente. Tuttavia, è possibile impostarlo per utilizzare un attributo.
Per modificare il tipo in un attributo, selezionare Tipo nodo e selezionare Attributo. Salvare il lavoro. Fare clic su Visualizza schema XML. L'output deve essere simile al seguente esempio.
<xs:schema targetNamespace="http://EH" elementFormDefault="qualified"
attributeFormDefault="unqualified">
<xs:complexType name="employee">
<xs:sequence>
<xs:element name="firstName" type="xs:string" minOccurs="0"
maxOccurs="1" nillable="false" />
<xs:element name="lastName" type="xs:string" minOccurs="0"
maxOccurs="1" nillable="false" />
</xs:sequence>
<xs:attribute name="employeeNumber" type="xs:int" />
</xs:complexType>
<xs:element name="employee" type="tns:employee" />
</xs:schema>
Ordina
Order imposta esplicitamente l'ordine degli elementi del tipo complesso. Di solito si lascia l'ordine nella rappresentazione XML dell'oggetto di business esattamente come è nell'editor dell'oggetto di business. Tuttavia, è possibile modificare l'ordine se il servizio Web esterno è stato modificato e gli elementi devono essere presentati in un modo specifico.
Per cambiare l'ordine degli elementi di tipo complesso, selezionare ciascun elemento e aggiungere un numero al campo Ordine per specificare l'ordine desiderato nella rappresentazione XML. Ad esempio, supponiamo che l'ordine di un tipo complesso di dipendente sia employeeNumber, firstName e lastName e che sia necessario modificarlo per adattarlo a un servizio web con lastName, firstName e poi employeeNumber. Impostare employeeNumber su 2, firstName su 1 e lastName su 0. Salvare il lavoro. Fare clic su Visualizza schema XML. L'output deve essere simile al seguente esempio.
<xs:schema targetNamespace="http://EH" elementFormDefault="qualified"
attributeFormDefault="unqualified">
<xs:complexType name="employee">
<xs:sequence>
<xs:element name="lastName" type="xs:string" minOccurs="0"
maxOccurs="1" nillable="false" />
<xs:element name="firstName" type="xs:string" minOccurs="0"
maxOccurs="1" nillable="false" />
<xs:element name="employeeNumber" type="xs:int" minOccurs="0"
maxOccurs="1" nillable="false" />
</xs:sequence>
</xs:complexType>
<xs:element name="employee" type="tns:employee" />
</xs:schema>
Fuso orario
Questa proprietà imposta il fuso orario da utilizzare durante la serializzazione di un parametro data. La proprietà non viene utilizzata nella generazione WSDL o nella creazione dello schema, ma viene utilizzata per visualizzare i valori di data e ora. Il valore predefinito è CLIENT. Gli altri valori validi sono SERVER e UTC.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Nome tipo
Questa proprietà imposta il nome completo del tipo per l'oggetto di business o il parametro.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Immetti spazio dei nomi
Questa proprietà sovrascrive lo spazio dei nomi del tipo XSD serializzato con lo spazio dei nomi specificato.
Utilizzare il valore predefinito a meno che non sia strettamente necessario apportare una modifica.
Elenco wrap
Questa proprietà determina se creare un tipo di wrapper di array che contenga un elenco. Il valore predefinito è false, il che significa che l'elenco non viene riportato a capo. Un elenco è un array e viene specificato quando Elenco viene selezionato come attributo. È possibile utilizzare questo campo se si desidera incapsulare l'array. Un tipo di wrapper può essere anonimo e il nome degli elementi dell'elenco può essere sovrascritto. Se non è stato selezionato Elenco per una variabile, questo campo e gli altri campi con l'elenco nel nome sono disabilitati.