| Information | Content Model - Defining and Deploying | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Support Status | Full Support | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Architecture Information | Platform Architecture | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Description |
Now when you have read the Content Model Introduction it is time to define and deploy a content model. If you have already done this and are looking for information about how to configure the Share UI for a content model, then have a look at this section. To define a new content model means to add an XML file to the repository. This can be done via a bootstrapping procedure or dynamically via the user interface. If you are running an Enterprise edition it is also possible to manage content models from the Admin Console. At the end of this article you will find information about where this XML file should be located in an SDK project and where it should be located in a standard installation. A new custom content model starts with, you guessed it, a
model element definition, which is the container for
all other definitions as follows :
<?xml version="1.0" encoding="UTF-8"?> <model name="acme:contentModel" xmlns="http://www.alfresco.org/model/dictionary/1.0"> <description>Content model for the fictional company ACME</description> <author>Martin Bergljung</author> <version>1.0</version> <published>2015-09-01</published> <imports>...</imports> <namespaces>...</namespaces> <constraints>...</constraints> <types>...</types> <aspects>...</aspects> </model> The order in which these elements are specified is important. It will not work to specify them in any other order than in this example. This is because in the meta model they are defined within a <xs:sequence> element. This is true throughout the model schema so be careful to always use the elements in the right order. The imports definition is the container for import
definitions of other content models referred to by the model being defined:
<imports>
<!-- Import SkyVault Dictionary Definitions -->
<import uri="http://www.alfresco.org/model/dictionary/1.0" prefix="d"/>
<!-- Import SkyVault System Model Definitions -->
<import uri="http://www.alfresco.org/model/system/1.0" prefix="sys"/>
<!-- Import SkyVault Content Domain Model Definitions -->
<import uri="http://www.alfresco.org/model/content/1.0" prefix="cm"/>
</imports>
This
example imports the Data Dictionary model with all the data-type
definitions, such as d:text. It also imports the system model
with types such as base, descriptor,
container, reference, and aspects such as
referenceable and temporary. Finally you
import the generic content model (cm) with types such as content
(files) and folder and aspects such as
versionable and dublincore. As you can
imagine, it is important to get familiar with the out-of-the-box content models so
you do not start defining types and aspects that are already available.The namespaces definition is the container for all new
custom namespace definitions that will be used by this model:
<namespaces> <namespace uri="http://www.acme.org/model/content/1.0" prefix="acme"/> </namespaces>This example defines the namespace for the new content model to http://www.acme.org/model/content/1.0. All definitions done in the model will be prefixed with acme. Any new name (referred to as local name) defined in the model for things like types, aspects, properties, etc. need to be unique. You could also define more than one namespace to be used in the model, such as in the following example: <namespaces> <namespace uri="http://www.acme.org/model/content/1.0" prefix="acmec"/> <namespace uri="http://www.acme.org/model/workflow/1.0" prefix="acmew"/> </namespaces>Here, you have defined one namespace acmec that will be used for document content classification and another namespace acmew that will be used exclusively for workflow-related content. You could have the same local name in both these namespaces, such as acmec:project and acmew:project. A good idea is to use the following format for the URI:
http://<company website address>/model/[content|workflow|...]/1.0 The constraints definition is the container for all new
constraints to be used by the properties defined in the custom model. There are
different types of constraints:
<constraints>
<constraint name="acme:securityClassificationOptions" type="LIST">
<parameter name="allowedValues">
<list>
<value></value> <!-- Empty for default search -->
<value>Public</value>
<value>Client Confidential</value>
<value>Company Confidential</value>
<value>Strictly Confidential</value>
</list>
</parameter>
</constraint>
The following is a LENGTH constraint example:
<constraints>
<constraint name="acme:summary" type="LENGTH">
<parameter name="minLength">
<value>5</value>
</parameter>
<parameter name="maxLength">
<value>100</value>
</parameter>
</constraint>
And here is an example of a MINMAX constraint:
<constraints>
<constraint name="acme:percentage" type="MINMAX">
<parameter name="minValue">
<value>0</value>
</parameter>
<parameter name="maxValue">
<value>100</value>
</parameter>
</constraint>
A regular expression (REGEXP) constraint looks like this:
<constraints>
<constraint name="acme:contractIdFormat" type="REGEX">
<parameter name="expression">
<value><![CDATA[[^C\d{3}$]]></value>
</parameter>
<parameter name="requiresMatch">
<value>true</value>
</parameter>
</constraint>
Finally, you can define custom constraint implementations by supplying a Java
class with the implementation. Here is an example from the out-of-the-box generic
content model (contentModel.xml):
<constraints> <constraint name="cm:userNameConstraint" type="org.alfresco.repo.dictionary.constraint.UserNameConstraint" />Being able to implement your own constraints is useful as it is common to want to set a property from a dynamic list of values, such as a 'project name'. It might not be possible to use a static LIST constraint for project names as new projects might be created frequently. And you do not want users to type in the project name manually as then you might get more than one version of the project name present in the repository, making search unpredictable. These constraints will have an effect on what controls and validation that are generated for the user interface (that is for the Share user interface). The types definition is the container for all new custom type definitions. A type models an object in the specific domain that your are implementing a content management solution for. This could be for example a project, marketing document, engineering drawing, software manual, legal case, book, chapter and so on. Remember also that an item (node) in the repository, such as a file or a folder, can only be assigned one type. Here are a couple of examples of how to define new types:
<types>
<!--
ACME Enterprise-wide Document root type.
All other custom document types should extend this one.
-->
<type name="acme:document">
<title>Base document type</title>
<parent>cm:content</parent>
<properties>
<property name="acme:documentId">
<title>Document Identification Number</title>
<type>d:text</type>
</property>
</properties>
<mandatory-aspects>
<aspect>acme:securityClassified</aspect>
</mandatory-aspects>
</type>
<type name="acme:contract">
<title>Contract document</title>
<parent>acme:document</parent>
<properties>
<property name="acme:contractName">
<title>Contract Name</title>
<type>d:text</type>
<mandatory>true</mandatory>
</property>
<property name="acme:contractId">
<title>Contract Identification Number</title>
<type>d:text</type>
<constraints>
<constraint ref="acme:contractIdFormat" />
</constraints>
</property>
</properties>
</type>
<!-- A folder can have this type applied to represent a project container. -->
<type name="acme:project">
<title>Project folder</title>
<parent>cm:folder</parent>
<properties>
<property name="acme:projectName">
<type>d:text</type>
<mandatory>true</mandatory>
</property>
<property name="acme:projectDescription">
<type>d:text</type>
</property>
<property name="acme:projectStartDate">
<type>d:date</type>
</property>
</properties>
<associations>
<!-- Setup a child-association from the type folder to zero or more members.
Note. peer associations are not indexed and searchable, so using child-association instead.
-->
<child-association name="acme:projectMember">
<source>
<mandatory>false</mandatory>
<many>true</many>
</source>
<target>
<class>cm:person</class>
<mandatory>false</mandatory>
<many>true</many>
</target>
<duplicate>false</duplicate>
<propagateTimestamps>false</propagateTimestamps>
</child-association>
</associations>
<mandatory-aspects>
<aspect>acme:projectIdentifier</aspect>
</mandatory-aspects>
</type>
</types>
Here you have first defined a base document type called
acme:document that all your custom document types should
extend. This is good practice as it allows you to search for all documents
classified in some way as ACME documents, it will for example match the next type
in the model called acme:contract, which extends the
acme:document type. A base document type is also useful for
keeping metadata that is applicable to all documents in the enterprise, such as
some form of document identifier (that is acme:documentId) and
security classification (that is acme:securityClassified).Note how the base type extends the out-of-the-box type cm:content. All types that should be applied to files need to eventually extend this type, and it in turn extends the cm:cmobject type, which has properties such as cm:name (the name of the file or folder), cm:created, cm:creator, cm:modified, and cm:modifier. The last four properties belong to the cm:auditable aspect, which is mandatory on the cm:cmobject type. The auditable properties are managed by the system and when you for example upload a file the created date will be set to now, not to when the file was initially created. Important: If you want the file to have the created date set to when
the file was actually created, then you can use the Bulk Import tool, which
turns off the automatic system management of these properties, and grabs the
file metadata instead.
The last type that is defined is called acme:project and it extends the out-of-the-box type cm:folder, which extends the cm:cmobject type described previously. So you can actually use folders to represent objects such as a project, a legal case, or other "container" objects. Being able to classify folders according to a specific domain is particularly useful as you can then also create "auto-classifying" rules for the folder. These rules would classify any files dropped into the folder according to the folders type and properties. Which means that you get files automatically classified without the end-user having to fill anything in. The following table explains the sub-elements of the type element
(note that they are the same for an aspect):
The type properties, and also the aspect properties as we will see, play a central part of the content model definition as they depict the so called metadata that should be stored together with the file or the folder. Metadata is very important in a content management solution as it will determine what you can search on, create rules around, base policies on etc. The following table describes all the parameters that can be used when defining a new property(metadata) for a type or aspect:
The last thing that is defined in the model are the aspects. The definition of an aspect does not differ much from a type definition. In fact, in the schema they are both based on the same class definition. The main difference between an aspect and a type is that a content node can have multiple aspects applied to it but only one type applied to it. This is important to think about when you decide if you should use an aspect or a type in the model. One way of deciding if a domain object should be modelled as a type or an aspect is to think about if it is a noun or a verb. For example, a Legal document could be modelled as a type and a CAD drawing could be modelled as a type. And it is quite clear that it does not make much sense to apply both the legal document type and the CAD drawing type to the same file content item. Now, both these types of documents could be emailed into the system and if we wanted to model that it would probably be best done with an aspect called for example emailed. You might also want to version both of these types of documents. So it make sense to have a versioned aspect. You could then apply both the versioned and emailed aspects to for example a Legal document. Now, it is necessary to look at dealing with nouns such as client and supplier. If you model them as types you could have problems, as many different file nodes could be related to a client. For example, a Legal document and a CAD drawing could both be related to them same client, so if you modelled client as a type you could not classify a document as both Legal and being associated with a specific client. So in this case client and supplier would be better off modelled as aspects so they can both be applied to a node that already has a type applied. Another implementation difference between types and aspects is that an aspect does not extend another aspect, it is more common for them to be stand alone. Aspects are used to implement cross-cutting concerns independently of the type of node. Note that there are a number of aspects already available out of the box, for example the aspects mentioned above, emailed and versionable are already available out-of-the-box. The following is a list of some of the aspects that comes with SkyVault Content Services out-of-the-box:
It is always preferable to use out-of-the-box aspects where possible. The following is an example of a custom aspect definition: <aspect name="acme:securityClassified">
<title>Security Classified</title>
<description>Content has been security classified</description>
<properties>
<property name="acme:securityClassification">
<type>d:text</type>
<index enabled="true">
<atomic>true</atomic>
<stored>false</stored>
<tokenised>false</tokenised>
<facetable>true</facetable>
</index>
<constraints>
<constraint ref="acme:securityClassificationOptions" />
</constraints>
</property>
</properties>
</aspect>
<aspect name="acme:webPublished">
<title>Web published</title>
<description>Content has been published to website</description>
<properties>
<property name="acme:publishedDate">
<type>d:datetime</type>
<mandatory>true</mandatory>
</property>
</properties>
</aspect>
Here an aspect has been defined to keep track of the security classification for content items. Any ACME document can have a security classification applied and you can then build rules, policies, processing and other entities based on these security classifications. Faceted search has been specifically enabled for best performance and the default tokenized value has also changed to false so you only index the whole value, such as "Company Confidential". There is also a simple webPublished aspect that could be used to indicate if a content item has been published on the web. After completing the aspect definitions you have almost finished the content model implementation. It would now be possible to deploy it (i.e. bootstrap it) and use it. The labels used in the Share UI for aspects and types, such as when creating rules, are by default picked from the title element in the content model. However, in multilingual installations we need to supply localization labels for the types, aspects, properties etc. so it is possible to translate the model into different languages. Also, if the title element is not specified for an aspect or type in the content model, then the i18n resource file with the labels is needed. We can do that by supplying a properties file with property definitions according to certain naming conventions, here is an example for our ACME content model: acme_contentModel.type.acme_document.title=ACME Document acme_contentModel.type.acme_contract.title=ACME Contract acme_contentModel.type.acme_policy.title=ACME Policy acme_contentModel.type.acme_whitePaper.title=ACME White paper acme_contentModel.type.acme_project.title=ACME Project acme_contentModel.aspect.acme_webPublished.title=ACME Web Published acme_contentModel.aspect.acme_securityClassified.title=ACME Security Classified acme_contentModel.aspect.acme_projectIdentifier.title=ACME Project Identifier acme_contentModel.property.acme_documentId.title=Document Id acme_contentModel.property.acme_contractName.title=Contract Name acme_contentModel.property.acme_contractId.title=Contract Id acme_contentModel.property.acme_projectName.title=Project Name acme_contentModel.property.acme_projectDescription.title=Project Description acme_contentModel.property.acme_projectStartDate.title=Project Start Date acme_contentModel.property.acme_projectNumber.title=Project Number acme_contentModel.property.acme_publishedDate.title=Published Date acme_contentModel.property.acme_securityClassification.title=Security Classification acme_contentModel.child-association.acme_projectMember.title=Project Member The naming convention patter for these resource properties are as follows: {content model namespace}_{content model local name}.[type|aspect|property|association|child-association].{content model namespace}_{local name}.[title|description]
The resource properties file can now be bootstrapped into the repository at the same time as the content model XML file. This is done via a Spring bean definition as follows: <bean id="org.alfresco.tutorial.customcontentmodelrepo.dictionaryBootstrap"
parent="dictionaryModelBootstrap"
depends-on="dictionaryBootstrap">
<property name="models">
<list>
<value>alfresco/module/<module-id>/model/content-model.xml</value>
</list>
</property>
<property name="labels">
<list>
<!-- Bootstrap Resource Bundles for data list type and properties -->
<value>alfresco/module/${project.artifactId}/messages/content-model</value>
</list>
</property>
</bean>
The key is to define a Spring bean that extends (sets as parent) the out-of-the-box dictionaryModelBootstrap Spring bean. You also want your custom model to be bootstrapped after the out-of-the-box content models as you use them in your model. This is achieved via the depends-on definition. You specify the models that you want to bootstrap as a list contained in the models property. Important: A model cannot be contained in multiple XML files. The
whole model needs to be deployed in one go, otherwise the next deployment
overwrites the previous one. If your content model is very large then consider
splitting it into multiple namespaces, such as document content model
(acme:contentModel) and workflow content model
(acmew:workflowModel) and deploy with multiple XML
files.
So we now have a content model defined in XML and registered with the repository. It is now possible to use one of the SkyVault Content Services APIs to create a node with a type from this content model, and one or more aspects applied from the model. Doing this via the Java API would look something like this: private void createContractFile() {
String acmeModelURI = "http://www.acme.org/model/content/1.0";
String filename = "ContractA.txt";
NodeRef parentFolderNodeRef =
serviceRegistry.getNodeLocatorService().getNode(CompanyHomeNodeLocator.NAME, null, null);
// Create Node
QName associationType = ContentModel.ASSOC_CONTAINS;
QName associationQName = QName.createQName(NamespaceService.CONTENT_MODEL_1_0_URI,
QName.createValidLocalName(filename));
QName nodeType = ContentModel.TYPE_CONTENT;
Map<QName, Serializable> nodeProperties = new HashMap<QName, Serializable>();
nodeProperties.put(ContentModel.PROP_NAME, filename);
nodeProperties.put(QName.createQName(acmeModelURI, "documentId"), "DOC001");
nodeProperties.put(QName.createQName(acmeModelURI, "securityClassification"), "Company Confidential");
nodeProperties.put(QName.createQName(acmeModelURI, "contractName"), "The first contract");
nodeProperties.put(QName.createQName(acmeModelURI, "contractId"), "C001");
ChildAssociationRef parentChildAssocRef = serviceRegistry.getNodeService().createNode(
parentFolderNodeRef, associationType, associationQName, nodeType, nodeProperties);
NodeRef newFileNodeRef = parentChildAssocRef.getChildRef();
// Set content for node
boolean updateContentPropertyAutomatically = true;
ContentWriter writer = serviceRegistry.getContentService().getWriter(newFileNodeRef, ContentModel.PROP_CONTENT,
updateContentPropertyAutomatically);
writer.setMimetype(MimetypeMap.MIMETYPE_TEXT_PLAIN);
writer.setEncoding("UTF-8");
String fileContent = "Contract A, this contract ...";
writer.putContent(fileContent);
// Add an aspect to the node
Map<QName, Serializable> aspectProperties = new HashMap<QName, Serializable>();
aspectProperties.put(QName.createQName(acmeModelURI, "publishedDate"), new Date());
serviceRegistry.getNodeService().addAspect(newFileNodeRef, QName.createQName(acmeModelURI, "webPublished"), aspectProperties);
}
In this case you are creating an ACME Contract document file. You set the properties for the security classification aspect when you create the Contract node as it is a mandatory aspect on the Contract type. If you want to add other aspects you can do that as shown for the webPublished aspect. Important: It is possible to create custom content models from the SkyVault Share UI without the
need to use XML. These models can then be exported as XML and included in a
build project. See the Model Manager in Share Admin Tools
documentation for further information.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Deployment - App Server |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| More Information | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Sample Code | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Tutorials |
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Developer Blogs |
|
You are here
Content Model - Defining and Deploying
Defining a custom content model involves creating an XML file. The model is then deployed
with a Spring bean. Localized labels for the content model items can also be part of the
deployment.
© 2017 TBS-LLC. All Rights Reserved. Follow @twitter