Référence et schéma UDC (Universal Data Connection) v2.0

Article
01/20/2010

Le format de fichier UDC (Universal Data Connection) est utilisé par FrontPage depuis Office 2003 pour stocker les informations de connexion de données utilisées par les composants Web. Le format UDC v1 est décrit dans le document Office 2003: XML Reference Schema (en anglais).

Contrairement au format ODC utilisé par d'autres applications Office, qui stocke les informations sur les connexions de bases de données, les fichiers UDC peuvent stocker des informations sur différents types de connexions de données et peuvent être étendus pour stocker des informations sur des types arbitraires.

Il existe deux versions du format de fichier UDC utilisées par les applications Office 2007. InfoPath utilise le format v2.0 décrit dans ce document.

Exemple UDC v2.0

L'exemple de format UDC v2.0 ci-dessous montre dans quelle mesure la structure de base du fichier UDC est similaire aux versions précédentes.

<?MicrosoftWindowsSharePointServices ContentTypeID=”0x010100B4CBD48E029A4ad8B62CB0E41868F2B0”?>
<udc:DataSource MajorVersion="2" MinorVersion="0" xmlns:udc="https://schemas.microsoft.com/office/infopath/2006/udc">
    <udc:Name>Submit to HTTP</udc:Name>
    <udc:Description>This UDC file describes an HTTP Submit connection for InfoPath</udc:Description>
    <udc:Type MajorVersion="2" MinorVersion="0" Type="XmlSubmit"/>
    <udc:ConnectionInfo Purpose="WriteOnly">
        <udc:UpdateCommand>
          <udc:Submit>http://www.example.com/postTarget.aspx</udc:Submit>
        </udc:UpdateCommand>
        <udc:Authentication />
    </udc:ConnectionInfo>
</udc:DataSource>

Référence du schéma UDC v2.0

Propriétés générales

Extension de fichier : *.udcx ou *.xml

Espace de noms XML : https://schemas.microsoft.com/office/infopath/2006/udc

ID du type de contenu : 0x010100B4CBD48E029A4ad8B62CB0E41868F2B0

Instructions de traitement

Nom	Type	Description
MicrosoftWindowsSharePointServices	Instruction de traitement
MicrosoftWindowsSharePointServices/@ContentTypeID	Attribut	Doit être 0x010100B4CBD48E029A4ad8B62CB0E41868F2B0

Élément DataSource

<udc:DataSource MajorVersion="2" MinorVersion="0" xmlns:udc="https://schemas.microsoft.com/office/infopath/2006/udc">
    <udc:Name/>
    <udc:Description/>
    <udc:Type MajorVersion="2" MinorVersion="0" Type=""/>
<udc:ConnectionInfo/>
</udc:DataSource>

Nom	Type	Description
DataSource	Élément	Élément conteneur
DataSource/@MajorVersion	Attribut	Doit être égal à 2
DataSource/@MinorVersion	Attribut	Doit être égal à 0
Nom	Élément	Nom complet du fichier UDC
Description	Élément	Description du fichier UDC
Type	Élément	Type de connexion
Type/@MajorVersion	Attribut	Facultatif : doit être égal à 2 s'il est utilisé
Type/@MinorVersion	Attribut	Facultatif : doit être égal à 0 (zéro) s'il est utilisé
Type/@Type	Attribut	Type de la connexion de données. Les valeurs possibles sont : SharePointList SharePointLibrary Database XmlQuery XmlSubmit WebService
ConnectionInfo	Élément	Informations spécifiques à la connexion

Élément ConnectionInfo

<udc:ConnectionInfo Purpose="WriteOnly">
    <udc:WsdlUrl/>
    <udc:SelectCommand/>
    <udc:UpdateCommand/>
    <udc:Authentication/>
</udc:ConnectionInfo>

Nom	Type	Description
ConnectionInfo	Élément	Élément conteneur
ConnectionInfo/@Purpose	Attribut	Détermine si la connexion est une requête ou un envoi. Valeurs possibles : ReadOnly WriteOnly ReadWrite
WsdlUrl	Élément	URL complète du WSDL d'un service Web
SelectCommand	Élément	Détails de la connexion de requête
UpdateCommand	Élément	Détails de la connexion d'envoi
Authentication	Élément	Informations d'authentification spécifiques au serveur

Élément SelectCommand

<udc:SelectCommand>
<udc:ListId/>
    <udc:WebUrl/>
    <udc:ConnectionString/>
    <udc:OperationName/>
    <udc:ServiceUrl UseFormsServiceProxy=""/>
    <udc:SoapAction/>
<udc:Query/>
</udc:SelectCommand>

Nom	Type	Description
SelectCommand	Élément	Élément conteneur
ListId	Élément	GUID d'une connexion de liste SharePoint
WebUrl	Élément	URL du site Web contenant la liste SharePoint
ConnectionString	Élément	Chaîne de connexion de base de données
ServiceUrl	Élément	URL du service Web
ServiceUrl/@UseFormsServiceProxy	Attribut	Détermine si la connexion au service Web doit utiliser le proxy de Forms Service
SoapAction	Élément	SoapAction du service Web
Query	Élément	Requête ou URL spécifique, utilisée par plusieurs types de connexion

Élément UpdateCommand

<udc:UpdateCommand>
<udc:OperationName/>
    <udc:ServiceUrl/>
    <udc:SoapAction/>
    <udc:Submit/>
    <udc:FileName/>
<udc:FolderName AllowOverwrite="1"/>
</udc:UpdateCommand>

Nom	Type	Description
UpdateCommand	Élément	Élément conteneur
OperationName	Élément	Nom de l'opération du service Web.
ServiceUrl	Élément	URL du service Web.
ServiceUrl/@UseFormsServiceProxy	Attribut	Détermine si la connexion au service Web doit utiliser le proxy de Forms Service.
SoapAction	Élément	SoapAction du service Web.
Submit	Élément	Requête ou URL spécifique, utilisée par plusieurs types de connexion.
FileName	Élément	Nom du fichier par défaut d'un envoi de bibliothèque SharePoint.
FolderName	Élément	URL de la bibliothèque SharePoint de destination.
FolderName/@AllowOverwrite	Attribut	Détermine si un fichier d'une bibliothèque SharePoint doit être écrasé s'il existe déjà.

Élément Authentication

<udc:Authentication>
    <udc:UseExplicit CredentialType="">
        <udc:UserId/>
        <udc:Password/>
    </udc:UseExplicit>
    <udc:SSO AppId="" CredentialType=""/>
</udc:Authentication>

Nom	Type	Description
Authentication	Élément	Élément conteneur.
UseExplicit	Élément	Contient un nom d'utilisateur et un mot de passe en texte clair à utiliser sur le serveur pour l'authentification.
UseExplicit/@CredentialType	Attribut	Décrit le mode d'utilisation des données d'identification contenues. Valeurs possibles : Sql NTLM Kerberos CD Basic Digest
UserId	Élément	ID utilisateur à utiliser pour l'authentification.
Password	Élément	Mot de passe en texte clair à utiliser pour l'authentification.
SSO	Élément	Spécifie une définition d'application d'authentification unique Office à utiliser pour l'authentification.
SSO/@AppId	Attribut	Nom de l'application provenant de l'authentification unique.
SSO/@CredentialType	Attribut	Décrit le mode d'utilisation des données d'identification contenues. Valeurs possibles : Sql NTLM Kerberos CD Basic Digest

Valeurs de CredentialType

Valeur	Description
Sql	Les informations d'identification sont intégrées dans une chaîne de connexion de base de données pour l'authentification auprès d'un serveur SQL.
NTLM	Les informations d'identification sont utilisées pour emprunter l'identité d'un utilisateur Windows.
Kerberos	Les informations d'identification sont utilisées pour emprunter l'identité d'un utilisateur Windows à l'aide de Kerberos.
CD	Le nom d'utilisateur est utilisé pour emprunter l'identité d'un utilisateur Windows à l'aide de la délégation contrainte.
Basic	Les informations d'identification sont utilisées pour réaliser une authentification HTTP de base.
Digest	Les informations d'identification sont utilisées pour réaliser une authentification HTTP de type Digest.

Propriétés requises par type de connexion

Service Web

Propriété	Valeur
DataSource/Type/@Type	WebService
ConnectionInfo/@Purpose	ReadOnly L'élément SelectCommand contient les paramètres de requête du service Web. WriteOnly L'élément UpdateCommand contient les paramètres d'envoi du service Web. ReadWrite Les éléments SelectCommand et UpdateCommand sont tous deux présents.
ConnectionInfo/WsdlUrl	URL complète du WSDL du service Web
ServiceUrl	URL du service Web
ServiceUrl/@UseFormsServiceProxy	Détermine si la connexion au service Web doit utiliser le proxy de Forms Service
SoapAction	SoapAction du service Web

Base de données

Propriété	Valeur
DataSource/Type/@Type	Base de données
ConnectionInfo/@Purpose	ReadOnly InfoPath détermine lors de la conception si une connexion de base de données peut prendre en charge les envois.
SelectCommand/ConnectionString	Chaîne de connexion de base de données
SelectCommand/Query	Requête SQL à exécuter

Liste SharePoint

Propriété	Valeur
DataSource/Type/@Type	SharePointList
ConnectionInfo/@Purpose	ReadOnly
ListId	GUID de la liste SharePoint
WebUrl	URL vers le site contenant la liste

Envoi de bibliothèque SharePoint

Propriété	Valeur
DataSource/Type/@Type	SharePointLibrary
ConnectionInfo/@Purpose	WriteOnly
FileName	Nom du fichier par défaut d'un envoi de bibliothèque SharePoint.
FolderName	URL de la bibliothèque SharePoint de destination.
FolderName/@AllowOverwrite	Détermine si un fichier d'une bibliothèque SharePoint doit être écrasé s'il existe déjà.

HTTP Post

Propriété	Valeur
DataSource/Type/@Type	XmlSubmit
ConnectionInfo/@Purpose	WriteOnly
UpdateCommand/Submit	URL qui indique la cible de la publication.

Fichier XML

Propriété	Valeur
DataSource/Type/@Type	XmlQuery
ConnectionInfo/@Purpose	ReadOnly
SelectCommand/Query	URL de la source XML à interroger.

Schéma UDC v2.0

Copiez le schéma XML suivant et collez-le dans un éditeur de texte comme Notepad. Enregistrez ensuite le fichier sous le nom UDC20.xsd afin d'utiliser le schéma pour la génération, le référencement et la validation personnalisée des fichiers UDC. Dans Visual Studio 2005, ce schéma peut fournir une fonction de saisie automatique Intellisense si vous le copiez dans le cache de schémas Visual Studio, généralement situé dans <lecteur>:\Program Files\Microsoft Visual Studio 8\Xml\Schemas.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<xsd:schema targetNamespace="https://schemas.microsoft.com/office/infopath/2006/udc" xmlns:udc="https://schemas.microsoft.com/office/infopath/2006/udc" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <xsd:element name="DataSource">
        <xsd:complexType>
            <xsd:all>
                <xsd:element ref="udc:Name" minOccurs="0" />
                <xsd:element ref="udc:Description" minOccurs="0"/>
                <xsd:element ref="udc:Type" minOccurs="0"/>
                <xsd:element ref="udc:ConnectionInfo" minOccurs="0"/>
            </xsd:all>
            <xsd:attribute name="MajorVersion" type="xsd:integer"/>
            <xsd:attribute name="MinorVersion" type="xsd:integer" />
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="Name" type="xsd:string"/>
    <xsd:element name="Description" type="xsd:string"/>
    <xsd:element name="Type">
        <xsd:complexType>
            <xsd:attribute name="MajorVersion" type="xsd:integer"/>
            <xsd:attribute name="MinorVersion" type="xsd:integer"/>
            <xsd:attribute name="Type" type="xsd:string"/>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="ConnectionInfo">
        <xsd:complexType>
            <xsd:all>
                <xsd:element ref="udc:WsdlUrl" minOccurs="0"/>
                <xsd:element ref="udc:SelectCommand" minOccurs="0"/>
                <xsd:element ref="udc:UpdateCommand" minOccurs="0"/>
                <xsd:element ref="udc:Authentication" minOccurs="0"/>
            </xsd:all>
            <xsd:attribute name="Purpose" type="xsd:string"/>
            <xsd:attribute name="AltDataSource" type="xsd:string"/>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="WsdlUrl" type="xsd:string"/>
    <xsd:element name="FileName" type="xsd:string"/>
    <xsd:element name="FolderName">
        <xsd:complexType>
            <xsd:simpleContent>
                <xsd:extension base="xsd:string">
                    <xsd:attribute name="AllowOverwrite" type="xsd:boolean"/>
                </xsd:extension>
            </xsd:simpleContent>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="SelectCommand">
        <xsd:complexType>
            <xsd:all>
                <xsd:element ref="udc:ListId" minOccurs="0"/>
                <xsd:element ref="udc:WebUrl" minOccurs="0"/>
                <xsd:element ref="udc:ConnectionString" minOccurs="0"/>
                <xsd:element ref="udc:ServiceUrl" minOccurs="0"/>
                <xsd:element ref="udc:SoapAction" minOccurs="0"/>
                <xsd:element ref="udc:Query" minOccurs="0"/>
            </xsd:all>
            <xsd:attribute name="Type" type="xsd:string"/>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="ListId" type="xsd:string"/>
    <xsd:element name="WebUrl" type="xsd:string"/>
    <xsd:element name="ConnectionString" type="xsd:string"/>
    <xsd:element name="ServiceUrl">
        <xsd:complexType>
            <xsd:simpleContent>
                <xsd:extension base="xsd:string">
                    <xsd:attribute name="UseFormsServiceProxy" type="xsd:boolean"/>
                </xsd:extension>
            </xsd:simpleContent>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="SoapAction" type="xsd:string"/>
    <xsd:element name="Query" type="xsd:string"/>
    <xsd:element name="Submit" type="xsd:string"/>
    <xsd:element name="UpdateCommand">
        <xsd:complexType>
            <xsd:all>
                <xsd:element ref="udc:ServiceUrl" minOccurs="0"/>
                <xsd:element ref="udc:SoapAction" minOccurs="0"/>
                <xsd:element ref="udc:Submit" minOccurs="0"/>
                <xsd:element ref="udc:FileName" minOccurs="0"/>
                <xsd:element ref="udc:FolderName" minOccurs="0"/>
            </xsd:all>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="Authentication">
        <xsd:complexType>
            <xsd:all>
                <xsd:element ref="udc:UseExplicit" minOccurs="0"/>
                <xsd:element ref="udc:SSO" minOccurs="0"/>
            </xsd:all>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="UseExplicit">
        <xsd:complexType>
            <xsd:all>
                <xsd:element ref="udc:UserId" minOccurs="0"/>
                <xsd:element ref="udc:Password" minOccurs="0"/>
            </xsd:all>
            <xsd:attribute name="CredentialType" type="xsd:string"/>
        </xsd:complexType>
    </xsd:element>
    <xsd:element name="UserId" type="xsd:string"/>
    <xsd:element name="Password" type="xsd:string"/>
    <xsd:element name="SSO">
        <xsd:complexType>
            <xsd:simpleContent>
                <xsd:extension base="xsd:string">
                    <xsd:attribute name="AppId" type="xsd:string"/>
                    <xsd:attribute name="CredentialType" type="xsd:string"/>
                </xsd:extension>
            </xsd:simpleContent>
        </xsd:complexType>
    </xsd:element>
</xsd:schema>

Voir aussi

Autres ressources

Procédure : créer et utiliser une bibliothèque de connexions de données
À propos de la connexion de données, de l'authentification et du mappage des accès de substitution

Partager via