If you plan to publish from a source system whose schema differs from the default schema defined by the Content Integration Platform, you will have to update the flex family corresponding to the source system and possibly mappings.xml
, depending on how the schema differ.
This chapter contains the following sections:
A commonly made schema change is adding a new attribute or attributes. For remapping procedures for adding a new attribute, see Section 58.2.1, "File Systems" or Section 58.2.2, "Microsoft SharePoint Systems" as necessary.
Note:
Procedures in the rest of this chapter call for updates to the defaultmappings.xml
file and the default flex families, both supplied as part of the Content Integration Platform. If you wish to create your own flex family, see the Oracle Fusion Middleware WebCenter Sites Developer's Guide for instructions. When creating your own flex family, keep in mind the source system's default flex family as a model. Basic procedures for remapping to a custom flex family remain the same (except for the names you choose for the family and its members).If you create flex filters (for either a default flex family or a custom flex family), makes sure to add the corresponding jar
files to both the WebCenter Sites and the Sites Agent Services applications.This section contains the following topics:
If you create new attributes for documents of type Document
and wish to propagate the attributes to WebCenter Sites, you must update the FileSystem
flex family with the new attributes. You must also update mappings.xml
if the new attributes will be named differently on the WebCenter Sites side. (A list of default attributes and document types is available in Chapter 60, "File Systems: Default Mapping Specifications."
To update the flex family and mappings.xml
Stop the Content Integration Agent.
Follow the remapping procedures in Table 58-1, "Remapping File System Schema". For descriptions of tags and parameters, see Table 58-2, "Mapping File System Data to Oracle WebCenter Sites".
Test your changes by running a publishing session. For instructions, see Chapter 56, "Publishing."
Table 58-1 Remapping File System Schema
File System | WebCenter Sites | Content Integration Agent: mappings.xml |
---|---|---|
If you add a new attribute. |
Create a FileSystem Attribute asset. Create the attribute in the |
Map the new attribute in |
For example, |
Example |
In this example, the
|
Tags and Parameters for Mapping File System Data to Oracle WebCenter Sites
<assettype-mappingsourceid="FileType" targetid="ChildAssetType|ParentAssetType; ChildDefinitionInstance|ParentDefinitionInstance" id="assettypeMappingID"> <descriptor-mappingsourceid="FileSystemAttribute" targetid="CSAttribute"/> </assettype-mapping>
Table 58-2 Mapping File System Data to Oracle WebCenter Sites
Tag | Parameter | Parameter Description |
---|---|---|
|
|
Specifies the type of document that will be published. Legal values: |
|
|
WebCenter Sites' counterpart to For document objects, targetid takes the following value:
Default value:
Default value: fs_document Sample value: pdfDoc Example: If that is, the (child) asset type named Note: If you were to map a folder type,
Default value: FileSystem_Folder
Default value: fs For more information about the |
|
|
Unique value that identifies the asset type mapping. |
|
|
Attribute's name in the file system. |
|
|
Attribute's name in WebCenter Sites. |
If you add new attributes and/or document types for the documents you will publish, you must update the SharePoint
flex family accordingly. You may also have to update mappings.xml
, as explained in this section. (A list of default attributes and document types is available in Chapter 60, "File Systems: Default Mapping Specifications."
To modify the flex family and mappings.xml
Stop the Content Integration Agent.
Follow the remapping procedures in Table 58-3, "Remapping Microsoft SharePoint Schema". For descriptions of tags and parameters, see Table 58-4, "Mapping Microsoft SharePoint Data to Oracle WebCenter Sites"
Test your changes by running a publishing session. For instructions, see Chapter 56, "Publishing."
Table 58-3 Remapping Microsoft SharePoint Schema
MS SharePoint | WebCenter Sites | Content Integration Agent: mappings.xml |
---|---|---|
If you add a new attribute. |
Create a SharePoint Attribute asset.Create the attribute in the For instructions, see Section 59.1, "Adding a New Attribute" and take note of the Value fields in step 5. |
Map the new attribute in |
For example, |
|
In this example, the
|
If you add a new document type. |
Create a SharePoint Child Definition asset.For instructions on creating child definition assets, see Chapter 59, "Adding Assets to a Flex Family." |
Map the new document type in |
For example, |
|
|
If you add a new attribute and new document type. |
|
|
For example, Attribute:
New Document type:
|
Attribute:
New Document type:
|
|
If you add a new picture type. |
Mapping a new picture type is analogous to mapping a document type. The
|
<assettype-mappingsourceid="SharePointContentType" targetid="ChildAssetType|ParentAssetType; ChildDefinitionInstance|ParentDefinitionInstance" id="assettypeMappingID" extends="sp_item"> <descriptor-mappingsourceid="SharePointAttribute" targetid="CSAttribute"/> </assettype-mapping>
Table 58-4 Mapping Microsoft SharePoint Data to Oracle WebCenter Sites
Tag | Parameter | Parameter Description |
---|---|---|
|
|
Specifies the type of content that will be published. Default value: |
|
|
WebCenter Sites' counterpart to For document and picture objects,
Default value:
Asset of type Defines the type of document (or picture) that will be stored in Default value: Sample values: Example: If that is, the (child) asset type named Note: If you were to map a folder type,
Default value:
Asset of type Defines the type of folder that will be stored in Default value: For more information about the SharePoint flex family, see Chapter 60, "File Systems: Default Mapping Specifications." |
|
|
Unique value that identifies the asset type mapping. By default,
The |
|
|
Attribute's name in the Microsoft SharePoint system. |
|
|
Attribute's name in WebCenter Sites. |