ACCESS DDF File
4/8/2010
This topic shows the Device Description Framework (DDF) file for the ACCESS Configuration Service Provider.
Open Mobile Alliance Device Management (OMA DM) DDF files and the example in this topic are used only for OMA DM provisioning. For more information, see OMA Device Management.
Note
The first line of the DDF is the namespace reference for Microsoft custom properties. For more information, see Managing Microsoft Custom Properties (OMA DM).
<MgmtTree xmlns:MSFT="https://schemas.microsoft.com/MobileDevice/DM">
<VerDTD>1.2</VerDTD>
<Node>
<NodeName>ACCESS</NodeName>
<Path>./Vendor/MSFT</Path>
<DFProperties>
<AccessType>
<Get />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Permanent />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>An ACCESS object defines both the name of the destination network and sources that map to it (URLs, port numbers, and network adaptors or dialup connections).
For example, you would use ACCESS to define a network ("The Internet"), the means of getting there (one or more GPRS/1xRTT/dialup connections), and URLs or port numbers that should map to the network.
Connection Manager uses this information to determine which path/resources to use when a client requests a network connection.</Description>
</DFProperties>
<Node>
<NodeName></NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Delete />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<ZeroOrMore />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>The value of this node should be a network name. An example would be "The%20Internet" (without the quotes).
Need to specify all mandatory subnodes (fields whose occurrence is at least 1). In particular (though each is optional), you must specify one or more of ConRefs, Domains, or Ports that map to the destination network.
The addition, update, and deletion of this sub-tree of nodes have to be specified in a single atomic transaction.</Description>
</DFProperties>
<Node>
<NodeName>ConRefs</NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Delete />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<ZeroOrOne />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>Contains a list of one or more ConRefs (that is, names of network connections that should be mapped to this destination network).
ConRef is synonymous with NapId (see: NAP).</Description>
</DFProperties>
<Node>
<NodeName></NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Delete />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<OneOrMore />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>The value of x should be "ConRef0", "ConRef1", etc. (without the quotes).</Description>
</DFProperties>
<Node>
<NodeName>ConRef</NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>The value of this field should be a network access point name (see: NAP). An example would be "My%20GPRS" (without the quotes).</Description>
</DFProperties>
</Node>
</Node>
</Node>
<Node>
<NodeName>Domains</NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Delete />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<ZeroOrOne />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>Contains a list of one or more Domains (that is, URL patterns) that should be mapped to this destination network.</Description>
</DFProperties>
<Node>
<NodeName></NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Delete />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<OneOrMore />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>The name of this node must be composed of numeric characters only. The value is used to enforce the order of Domain and Port mappings.
E.G. Domains/0/ will take precedence over Ports/1/ when Connection Manager attempts to map a URL or Port to a destination network.</Description>
</DFProperties>
<Node>
<NodeName>DomainName</NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Replace />
</AccessType>
<DFFormat>
<chr />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>The value of this field should be a URL pattern. An example would be "*://*.woodgrovebank.com/*" (without the quotes).</Description>
</DFProperties>
</Node>
</Node>
</Node>
<Node>
<NodeName>Ports</NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Delete />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<ZeroOrOne />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>Contains a list of one or more Port numbers that should be mapped to this destination network.</Description>
</DFProperties>
<Node>
<NodeName></NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Delete />
</AccessType>
<DFFormat>
<node />
</DFFormat>
<Occurrence>
<OneOrMore />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<MSFT:MinValue></MSFT:MinValue>
<MSFT:MaxValue></MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>The name of this node must be composed of numeric characters only. The value is used to enforce the order of Domain and Port mappings.
E.G. Domains/0/ will take precedence over Ports/1/ when Connection Manager attempts to map a URL or Port to a destination network.</Description>
</DFProperties>
<Node>
<NodeName>PortNbr</NodeName>
<DFProperties>
<AccessType>
<Add />
<Get />
<Replace />
</AccessType>
<DFFormat>
<int />
</DFFormat>
<Occurrence>
<One />
</Occurrence>
<Scope>
<Dynamic />
</Scope>
<MSFT:RWAccess>3</MSFT:RWAccess>
<DFType>
<MIME>text/plain</MIME>
</DFType>
<MSFT:MinValue>0</MSFT:MinValue>
<MSFT:MaxValue>65535</MSFT:MaxValue>
<MSFT:MaxLength></MSFT:MaxLength>
<Description>The value of this field should be a port number.</Description>
</DFProperties>
</Node>
</Node>
</Node>
</Node>
</Node>
</MgmtTree>