Leggere in inglese

Condividi tramite


Schemi proprietà

In Microsoft BizTalk Server, le proprietà alzate di livello consentono a vari componenti di BizTalk Server di accedere agli elementi chiave dei dati, noti in questo contesto come campi distinti e campi di proprietà che arrivano all'interno di un messaggio di istanza senza dover sapere come cercarli all'interno del messaggio stesso. Per diversi tipi di messaggio è possibile determinare quali dati devono essere innalzati a un livello più visibile. A seconda di come si sceglie di alzare di livello tali campi, può essere necessario creare e definire uno schema di proprietà associato.

Nota

Le proprietà innalzate di livello sono limitate a elementi e attributi non ripetuti.

I campi differenzianti sono accessibili solo all'interno delle orchestrazioni e per essi non è necessario creare un corrispondente schema di proprietà. Se è solo necessario accedere a dati di messaggi alzati di livello dall'interno di un'orchestrazione, è possibile alzare di livello i dati a uno o più campi differenzianti.

Ai campi di proprietà è possibile accedere da vari componenti di BizTalk Server, incluse pipeline e orchestrazioni. I campi di proprietà possono essere utilizzati anche per il routing dei messaggi. Se è necessario accedere a dati di messaggio innalzati di livello da contesti diversi dalle orchestrazioni, è necessario creare uno o più schemi di proprietà per descrivere i dati da innalzare di livello.

Uno schema di proprietà è uno schema speciale che viene associato a uno schema di messaggio. Viene utilizzato per alzare di livello valori specifici dall'interno di un messaggio di istanza nel contesto del messaggio. L'innalzamento di livello delle proprietà offre un meccanismo centralizzato per il pull di informazioni, definite dall'utente, da un messaggio di istanza, consentendo ai componenti di BizTalk Server che gestiscono il messaggio in BizTalk Server di accedere a tali informazioni più facilmente.

Panoramica della creazione dello schema delle proprietà

È possibile creare automaticamente uno schema proprietà predefinito utilizzando la funzionalità Promozione rapida di BizTalk Server. Questo è il modo più semplice per creare lo schema di proprietà necessario per alzare di livello i campi delle proprietà. Per altre informazioni su come eseguire promozioni rapide, vedere How to Copy Data to the Message Context as Property Fields.For more information about how to perform quick promotions, see How to Copy Data to the Message Context as Property Fields.

È anche possibile creare un nuovo schema di proprietà. Quando un progetto BizTalk è aperto, selezionare il progetto BizTalk, fare clic con il pulsante destro del mouse e scegliere Aggiungi, fare clic su Nuovo elemento e quindi scegliere Schema.

Nota

  • Se uno schema di proprietà viene associato a uno schema di messaggio, i due schemi devono trovarsi nello stesso progetto BizTalk. Non è possibile che lo schema di proprietà e lo schema di messaggio ad esso associato siano inclusi in progetti BizTalk diversi.

  • Se si dispone di due schemi di proprietà con lo stesso spazio dei nomi, nonostante siano definiti in assembly diversi non verranno risolti correttamente durante il runtime e verrà generato un errore di routing.

Campi distinti e campi delle proprietà

Esistono due tipi di promozione delle proprietà: campi distinti e campi delle proprietà. Il secondo tipo utilizza gli schemi di proprietà. Nell'editor BizTalk è possibile gestire entrambi questi tipi di innalzamento di livello delle proprietà tramite la finestra di dialogo Alza di livello proprietà a cui si accede utilizzando la proprietà Promote Properties del nodo Schema .

Nota

  • Esistono alcune limitazioni relative ai valori che è possibile alzare di livello. Per altre informazioni, vedere la tabella in Promozione delle proprietà.

  • I campi differenzianti non compaiono nelle espressioni filtro. Nelle espressioni filtro compaiono solo i campi delle proprietà.

Gli schemi di proprietà sono semplici se confrontati con gli schemi di messaggio. Nell'albero dello schema è consentito inserire solo nodi Elemento campo come nodi figlio immediati del nodo Schema , creando una struttura che è a due livelli profondi. Nella maggior parte dei casi, si impostano le proprietà dei nodi Elemento campo come si farebbe per i nodi Elemento campo visualizzati in uno schema di messaggio. È possibile utilizzare solo tipi semplici XSD.

Importante

Evitare di rinominare uno schema che viene utilizzato da un altro schema. Si intendono anche gli schemi di proprietà per cui sono stati definiti innalzamenti di livello. Se si rinominano questi schemi, lo schema che li utilizza non sarà più in grado di trovare l'altro schema, perché il nome in esso contenuto non è più corretto.

La proprietà Property Schema Base è univoca per i nodi Dell'elemento Field , così come vengono visualizzati negli schemi delle proprietà. Questa proprietà è vuota per impostazione predefinita, ma può essere impostata su MessageDataPropertyBase o MessageContextPropertyBase, con conseguente aggiunta di un attributo propSchFieldBase all'elemento di annotazione fieldInfo con uno o l'altro di questi valori.

Quando l'attributo propSchFieldBase è impostato su MessageDataPropertyBase, significa che il valore della proprietà alzata di livello corrisponde ai dati nel messaggio, ad esempio il valore di un campo. Quando l'attributo propSchFieldBase è impostato su MessageContextPropertyBase, significa che il valore della proprietà alzata di livello può provenire da un'altra posizione, ad esempio una busta o che può essere impostato da un componente della pipeline.

I nodi Elemento campo negli schemi delle proprietà hanno anche una proprietà denominata Informazioni riservate, che, se impostata su , manterrà visibile il valore corrispondente dall'interno di BizTalk Explorer e dal rilevamento dell'evento del messaggio e dell'istanza del servizio, preservandone la natura sensibile. Per altri dettagli, vedere Informazioni riservate nelle linee guida sull'interfaccia utente e informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori .

La seguente rappresentazione XSD (XML Schema Definition) di uno schema di proprietà contiene un'annotazione associata all'elemento schema che identifica questo schema come schema di proprietà (schema_type="property"). Contiene anche tre nodi elemento campo sotto il nodo Schema . Il primo nodo Elemento campo , denominato PromProp1, non ha un valore definito per la proprietà Base dello schema delle proprietà, ma le ultime due nodi Elemento campo hanno tale proprietà impostata rispettivamente su MessageDataPropertyBase e MessageContextPropertyBase.

<?xml version="1.0" encoding="utf-16" ?>   
<xs:schema xmlns="http://BizTalk_Server_Project1.PropertySchema1"  
           xmlns:b="http://schemas.microsoft.com/BizTalk/2003"  
           targetNamespace="http://BizTalk_Server_Project1.PropertySchema1"  
           xmlns:xs="http://www.w3.org/2001/XMLSchema">  
    <xs:annotation>  
       <xs:appinfo>  
  
        </xs:appinfo>  
    </xs:annotation>  
    <xs:element name="" type="xs:string">  
        <xs:annotation>  
            <xs:appinfo>  
  
            </xs:appinfo>  
        </xs:annotation>  
    </xs:element>  
    <xs:element name="" type="xs:string">  
        <xs:annotation>  
            <xs:appinfo>  
  
            </xs:appinfo>  
        </xs:annotation>  
    </xs:element>  
    <xs:element name="" type="xs:string">  
        <xs:annotation>  
            <xs:appinfo>  
  
            </xs:appinfo>  
        </xs:annotation>  
    </xs:element>  
</xs:schema>  
  

Vedere anche

Tipi diversi di schemi BizTalk