{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The general principle of ","type":"text"},{"text":"duplicate","type":"text","marks":[{"type":"strong"}]},{"text":" is called an ","type":"text"},{"text":"entity declination","type":"text","marks":[{"type":"code"}]},{"text":", a content entity in a different context than the original one.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Principles","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes the different principles of declination where the project is the only variable.","type":"text"}]},{"type":"paragraph","content":[{"text":"For all variations in relation to the notion of language, please refer to section ","type":"text"},{"text":"translation","type":"text","marks":[{"type":"link","attrs":{"href":"https://crossmedia.atlassian.net/wiki/spaces/WD/pages/11862359/400+Contents+Translation"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"An object can be declined in projects and groups if it has the ","type":"text"},{"text":"master","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"group","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"media","type":"text","marks":[{"type":"code"}]},{"text":" fields:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"group","type":"text","marks":[{"type":"code"}]},{"text":" property must be determined, an object containing this one will always be linked to a group","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"media","type":"text","marks":[{"type":"code"}]},{"text":" property is not necessarily determined:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If it is completed, the object belongs to the project and will be accessible and usable only from the project.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If it is empty, the object belongs to the group only.","type":"text"},{"type":"hardBreak"},{"text":"Generally speaking, objects in this category are objects that we want to distribute within the group where they will be declined. The projects of the group, according to the configuration of the application will be free to exploit them or not.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"There are several functional methods for decaying an object in a group according to the project variables but, technically, they use all these fields to work.","type":"text"}]},{"type":"paragraph","content":[{"text":"However, they may use other properties to provide other functions.","type":"text"}]},{"type":"paragraph","content":[{"text":"All the project variations of the same instance are presented in an tab ","type":"text"},{"text":"other projects","type":"text","marks":[{"type":"code"}]},{"text":" accessible from the visualization action.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Technical prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"To be able to copy content to another project, you must have installed the following components:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an object to be copied must inherit from the object ","type":"text"},{"text":"contentobject","type":"text","marks":[{"type":"code"}]},{"text":" at least the following information:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"property ","type":"text"},{"text":"master","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"property ","type":"text"},{"text":"lang","type":"text","marks":[{"type":"code"}]},{"text":" (not required)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"property ","type":"text"},{"text":"media","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"property ","type":"text"},{"text":"mediagroup","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The product plugin ","type":"text"},{"text":"WXM_Mediacore","type":"text","marks":[{"type":"code"}]},{"text":" must be enabled and the ","type":"text"},{"text":"isPushContentActive","type":"text","marks":[{"type":"code"}]},{"text":" parameter must be set to ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Security must allow users to create objects (domain ","type":"text"},{"text":"objectdata","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"insert","type":"text","marks":[{"type":"code"}]},{"text":" action)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Execute a declination in a project","type":"text"}]},{"type":"paragraph","content":[{"text":"In the back-office, the ","type":"text"},{"text":"copying to another project","type":"text","marks":[{"type":"code"}]},{"text":" functionality allows you to easily perform a declination from the visualization of an object:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"in the toolbar, click the' copy to another project' button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":60.0},"content":[{"type":"media","attrs":{"width":758,"id":"3427ac2f-4a94-4da4-b7f2-9c133f1f5f7f","collection":"contentId-10849166","type":"file","height":234}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a window will open where you can select up to three actions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"make a single copy","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"propose the content (see content proposal)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"impose content (see content imposition)","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":842,"id":"cab1e1cc-19dc-4d24-ad03-e6f2e90fa3f4","collection":"contentId-10849166","type":"file","height":327}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the content destinations","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Setting up the new objects (optional step see setting up the new objects)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm the action to be performed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A result page shows the objects created","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Tip","type":"text"}]},{"type":"paragraph","content":[{"text":"The project selection list only shows projects where the user can create content and where there is not yet a declination of that content. It is therefore possible that the list presented may be empty in some cases.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Easily set up the steps","type":"text"}]},{"type":"paragraph","content":[{"text":"You can simply intervene on the declination stepboard simply via labels:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Action selection","type":"text"}]},{"type":"paragraph","content":[{"text":"The selection of the action depends on several criteria specific to each of these actions. The declination of an object to another project will always be available, go to the \"imposition\" and \"proposal\" sections for more information on their activation.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Project selection","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"smalllist","type":"text","marks":[{"type":"code"}]},{"text":" showing destination projects uses fields with the label ","type":"text"},{"text":"wxm_datapushcontent_field","type":"text","marks":[{"type":"code"}]},{"text":" by default. If no field has it, the standard operation applies.","type":"text"}]},{"type":"paragraph","content":[{"text":"The list of displayed projects is the one where the current object is not declined. For objects configured as \"content objects\" (see settings and object configuration), you can apply an automatic filter to hide layout-driven projects and prevent, for example, users from manually pushing an object into a DTP project. This filter is not active by default. To enable it, you must change the value of the ","type":"text"},{"text":"pushContentShowLayoutDrivenProjects","type":"text","marks":[{"type":"code"}]},{"text":" parameter of the ","type":"text"},{"text":"WXM_MediaCore","type":"text","marks":[{"type":"code"}]},{"text":" plugin.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"List of results","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"smalllist","type":"text","marks":[{"type":"code"}]},{"text":" presenting newly created objects uses by default fields labeled ","type":"text"},{"text":"wxm_datapushcontent_field","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"If no fields are shown on this label then the standard operation will apply.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Updating of allocations","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":750,"id":"db9f22bc-9e99-4ae8-8a00-7066d3ae76b5","collection":"contentId-10849166","type":"file","height":500}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"During the declination action, the system creates a new object for the selected project context by duplicating the source and changing some properties automatically:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the media will be the one of destination","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If the object is linked to other object instances via the attribution notion (child, childmulti) and these objects are also declineable, the system will automatically retrieve equivalent versions to update the property.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Caution","type":"text"}]},{"type":"paragraph","content":[{"text":"If no matching object is found in the desired context, the property will be empty. This implies that if the property is required by its structure configuration, an error will be removed and the declination action cancelled for this project. (see article on standard errors).","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Caution","type":"text"}]},{"type":"paragraph","content":[{"text":"We do not make a cascade declination: if you want this type of behavior you must customize it.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Manually configure a property during declination","type":"text"}]},{"type":"paragraph","content":[{"text":"You can manually override a property when declining. Indeed, the creation of a declination using the module ","type":"text"},{"text":"WmsUtils","type":"text","marks":[{"type":"code"}]},{"text":", forced in the new object as well as a ","type":"text"},{"text":"java.util.HashSet","type":"text","marks":[{"type":"code"}]},{"text":" we pass in parameter a ","type":"text"},{"text":"java.util.HashMap","type":"text","marks":[{"type":"code"}]},{"text":" with the values which will be objects of collection not to duplicate (for example paragraphs).","type":"text"}]},{"type":"paragraph","content":[{"text":"The project declination action is ","type":"text"},{"text":"datapushcontent","type":"text","marks":[{"type":"code"}]},{"text":". When creating, we call the following JSPs:","type":"text"}]},{"type":"paragraph","content":[{"text":"/bov3/datapushcontent/initNotCopiedObjects.jsp","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"initializes java.util.hashSet objects not to be copied cascade. You can customize this JSP in your SAN this way:","type":"text"}]},{"type":"codeBlock","content":[{"text":"<%@page pageEncoding=\"ISO-8859-15\"%>\n<%@taglib prefix=\"noheto\" uri=\"/WEB-INF/noheto.tld\" %>\n<%@taglib prefix=\"c\" uri=\"/WEB-INF/c.tld\" %>\n<%--\n/san/bov3/datapushcontent/initNotCopiedObjects.jsp\n--%>\n<%\njava.util.Set notCopiedObjects = (java.util.HashSet) request.getAttribute(\"notCopiedObjects\");\nif (notCopiedObjects == null) {\nnotCopiedObjects = new java.util.HashSet();\n}\n// collections of' frontlink' type objects are not duplicated\nnotCopiedObjects.add(\"frontlink\");\nrequest.setAttribute(\"notCopiedObjects\", notCopiedObjects);\n%>\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"/bov3/datapushcontent/initForcedValues.jsp","type":"text"}]},{"type":"paragraph","content":[{"text":"initializes the java. HashMap utility and iter on each object’s properties to overload them when copying.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can customize a field in two ways:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if you specify the name or position of the property as a key:","type":"text"},{"type":"hardBreak"},{"text":"you will overload the property globally, i. e. it will be applied regardless of the nature of the object.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if you specify as key[object name].property name or index]:","type":"text"},{"type":"hardBreak"},{"text":"you will overload the property in a fine way, i.e. it will be applied only for the nature of the specified object.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"codeBlock","content":[{"text":"<%@page pageEncoding=\"ISO-8859-15\"%>\n<%@taglib prefix=\"noheto\" uri=\"/WEB-INF/noheto.tld\" %>\n<%@taglib prefix=\"c\" uri=\"/WEB-INF/c.tld\" %>\n<%--\n/san/bov3/datapushcontent/initForcedValues.jsp\n--%>\n<%\njava.util.Map forcedValues = (java.util.Map) request.getAttribute(\"forcedValues\");\nif (forcedValues == null) {\nforcedValues = new java.util.HashMap();\n}\n/*\nDuring a declination, we always want to empty the' tag' field of the product so that\nthe user re-enters the tag assossiations with project-specific information.\ndestination\n*/\nif (!forcedValues.containsKey(\"tag\")) {\nforcedValues.put(\"tag\", \"\");\n}\nrequest.setAttribute(\"forcedValues\", forcedValues);","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"You can also customize properties by fields by overloading the properties in this way:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[objects/[object name]]/bov3/datapushcontent/forcedvalues/properties/[property native type]/[property nature]/[property name].jsp","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[objects/[object name]]/bov3/datapushcontent/forcedvalues/properties/[property name].jsp","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[objects/[object name]]/bov3/datapushcontent/forcedvalues/properties/[property native type]/[property type].jsp","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":445,"id":"8f863e5b-2710-4933-8443-728173aa4326","collection":"contentId-10849166","type":"file","height":248}}]},{"type":"paragraph","content":[{"text":"Within these JSPs, you can work with the following variables:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[168.0]},"content":[{"type":"paragraph","content":[{"text":"form_object","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[591.0]},"content":[{"type":"paragraph","content":[{"text":"nature of the current object in short declination","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[168.0]},"content":[{"type":"paragraph","content":[{"text":"activeRefererObject","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[591.0]},"content":[{"type":"paragraph","content":[{"text":"reference object in declination","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[168.0]},"content":[{"type":"paragraph","content":[{"text":"itemValue","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[591.0]},"content":[{"type":"paragraph","content":[{"text":"CTObjectField","type":"text","marks":[{"type":"code"}]},{"text":" corresponding to the current property","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[168.0]},"content":[{"type":"paragraph","content":[{"text":"colfield","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[591.0]},"content":[{"type":"paragraph","content":[{"text":"name of the current property","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[168.0]},"content":[{"type":"paragraph","content":[{"text":"nature","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[591.0]},"content":[{"type":"paragraph","content":[{"text":"nature of the object pointed out in the context of an attribution relationship","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[168.0]},"content":[{"type":"paragraph","content":[{"text":"forcedValues","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[591.0]},"content":[{"type":"paragraph","content":[{"text":"java.util.HashMap","type":"text","marks":[{"type":"code"}]},{"text":" properties to force","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Standard errors","type":"text"}]},{"type":"paragraph","content":[{"text":"During a project declination, errors are displayed in the results list.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are the error codes you may encounter:","type":"text"}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"not_connected","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"Your session has expired, you need to log in again.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"function_not_activates","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"The project declination function is disabled. You must refer to your administrator.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"object_not_found","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"The object to translate does not exist.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"not_authorized","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"You don’t have the necessary rights to see the instance. The destination project must be accessible to the user, make sure that he has access to it.","type":"text"},{"type":"hardBreak"},{"text":"Security is tested in the init of the ","type":"text"},{"text":"datatranslate","type":"text","marks":[{"type":"code"}]},{"text":" action, by default we test the action view of the ","type":"text"},{"text":"objectdata","type":"text","marks":[{"type":"code"}]},{"text":" domain, check the security rules or overload this boolean with a rule specific to your developments.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"not_compliant","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"The requested object does not have the necessary properties for the declination function (see technical prerequisites).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#deebff","rowspan":1,"colwidth":[193.0]},"content":[{"type":"paragraph","content":[{"text":"mandatoryFields","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[567.0]},"content":[{"type":"paragraph","content":[{"text":"The object could not be created because some mandatory fields are empty. This error is often solved because a match could not be found on an association. The value associated with this error is the list of fields that are empty.","type":"text"},{"type":"hardBreak"},{"text":"Decline the associations before declassifying the requested object.","type":"text"},{"type":"hardBreak"},{"text":"The error is removed by a structural obligation. If this obligation is only functional, you can create a facet to make it mandatory only as a back-office contribution.","type":"text"},{"type":"hardBreak"},{"text":"Customize the field to manage a default value.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported