Importing XML Schemas
You can import an XML schema from a Web server or a file system to a
CentraSite
Registry and Repository.
The following
Supporting Documents and Resources and
Assets and Registry Objects are created by the import of an XML schema:
The schema file is copied to a subfolder of projects/WSDL in the repository. The name of the subfolder is determined by the namespace defined in the schema. For example, if the namespace is http://www.MyOrganization.com/MySchemas/schema1, the schema is copied to projects/WSDL/www.MyOrganization.com/MySchemas/schema1.
If the schema file contains references to other schema files, these are also imported, including all the schema files that are referenced.
For each imported schema file, a registry object of the XML Schema type is created. An external link is created for the object which points to the schema file in the repository.
Note:
When you delete an
External Links in the registry that points to a schema file in the repository, the schema file in the repository is also deleted. However, any schema entries in the registry and repository that are referenced by the schema being deleted remain untouched.
If the importer detects an equivalent schema file within
CentraSite during the import of a schema, the import dialog will prompt you to specify either Overwrite latest version or Create new version. If you decide to create a new version, the importing schema will be applied to the new version.
You can also choose the option Interactive resolution of Import/Includes, which will allow you to specify how an already existing imported/included file is handled. For each of the imported/included files you have one of these options:
Overwrite the importing file with new content.
Create a new version of the file with the new content (if, for example, you want to modify a schema but want to retain its previous version).
Reuse any version of the file (if, for example, an intermediate version of a schema is currently referenced by a WSDL, you can redirect it to the newest version).
To import an XML schema
1. On the Select page of the Import wizard, select Schema in the CentraSite folder and click Next to define the import parameters.
2. On the Import Schema page of the Import wizard, specify the following parameters:
Select the organization to which the XML schema is to be assigned.
Specify a version identifier for the new service. The version identifier you enter here is the service's public, user-assigned version identifier. You can enter any string in the Initial version field, i.e. the version identifier does not need to be numeric. You can also leave this field blank.
If you want to import the schema from a Web server, choose the Import from Web server option and specify the schema's URL in the URL field.
If you want to import the schema from the file system of your computer, choose the Import from file system option and specify the schema's path and name in the File field. Use the Browse button to select the file in the file system of your computer.
If you have specified a URL, and the site you want to access via the URL requires user authentication, enable the URL Authentication check box. This opens a sub-dialog in which you can enter a username and password for authentication at the URL site.
Check Interactive resolution of Import/Includes to determine how referenced schemas are handled when the schema that is referenced already exists in the registry. When this option is enabled, you will be prompted during import to specify whether you want to reuse any schema files referenced in the main file or upload new files.
Click OK.
What Happens When You Import a New Schema File?
CentraSite retrieves the specified file and creates the XML schema. If you have specified Interactive resolution of Import/Includes, you will also be prompted to specify whether you wish to reuse any of the schema files that might be referenced in the main schema file via IMPORT or INCLUDE statements or upload new files.
What Happens When You Import an Existing Schema File?
If the importer detects that the schema you are trying to import already exists within CentraSite, the import dialog will prompt you to specify whether you want to Overwrite latest version or Create new version. If you have specified Interactive resolution of Import/Includes, you will also be prompted to specify whether you wish to reuse any of the schema files that might be referenced in the main schema file via IMPORT or INCLUDE statements or upload new files.