{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"The general principle of \"duplicating\" an entity in a context different from that of origin is called \"declination\".","type":"text"}]},{"type":"paragraph","content":[{"text":"Translation is the general principle of \"duplicating\" an entity in a different language context than the original one.","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes the different declination principles where language is the only variable.","type":"text"}]},{"type":"paragraph","content":[{"text":"For all variations with regard to the concept of a project, please refer to the section \"Project variations\".","type":"text"}]},{"type":"paragraph","content":[{"text":"The principle of translation respects the following laws:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an entity is translatable if it has the ","type":"text"},{"text":"master","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"lang","type":"text","marks":[{"type":"code"}]},{"text":" fields: the value of the ","type":"text"},{"text":"lang","type":"text","marks":[{"type":"code"}]},{"text":" field is different for each translation","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a user can create and declassify entities only in the languages of which it has rights in contribution: this information is stored at user level on the ","type":"text"},{"text":"contriblangs","type":"text","marks":[{"type":"code"}]},{"text":" fields","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"a user can translate an entity if he has the necessary rights to view it and if he can create it in the target language. It must therefore have access to at least two languages as a contribution","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"within the framework of objects that can be declined by project:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if the source entity belongs to a project, the project must be in the target language: the project must therefore be multilingual","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an entity that can be applied to projects of the same group can only be translated in this specific context. It is not possible to translate an entity and translate it into another project at the same time with this function","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"All the translations of the same instance are presented in a \"translations\" tab accessible from the visualization action.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites for translation","type":"text"}]},{"type":"paragraph","content":[{"text":"To be able to translate content, you must have the following components installed:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an object to be translated 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"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"property ","type":"text"},{"text":"mediagroup","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"}]},{"text":" (not required)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"property ","type":"text"},{"text":"notranslation","type":"text","marks":[{"type":"code"}]},{"text":" (not required)","type":"text"}]}]}]}]},{"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 parameter ","type":"text"},{"text":"isTranslationActive","type":"text","marks":[{"type":"code"}]},{"text":" must be set to ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Do a translation","type":"text"}]},{"type":"paragraph","content":[{"text":"In the back-office, the \"translate\" functionality allows you to easily perform a translation from the visualization of an object:","type":"text"}]},{"type":"paragraph","content":[{"text":"In the toolbar, click on \"Translate\":","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":688,"id":"ce2adb7b-f464-4834-9516-409d2a295ad9","collection":"contentId-11862359","type":"file","height":129}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"then select the language in which your object should be translated.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":315,"id":"c68762d3-37c2-45b5-8d89-6c57295b537d","collection":"contentId-11862359","type":"file","height":204}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Ignoring the principle of translation","type":"text"}]},{"type":"paragraph","content":[{"text":"It is possible to ask the system to ignore the notion of language on an entity. For example, as part of an object storing images, these are not necessarily language-specific (no text displayed) it must therefore be the same body for all languages.","type":"text"}]},{"type":"paragraph","content":[{"text":"In this case, if the object structure has the property ","type":"text"},{"text":"notranslation","type":"text","marks":[{"type":"code"}]},{"text":" and this one is set to ","type":"text"},{"text":"yes","type":"text","marks":[{"type":"strong"}]},{"text":" (value 1), then the object will be considered untranslatable:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the translate button will not appear in the back office","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"an error is raised if you try to translate it with the action ","type":"text"},{"text":"datatranslate","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Caution","type":"text"}]},{"type":"paragraph","content":[{"text":"The value of the ","type":"text"},{"text":"lang","type":"text","marks":[{"type":"code"}]},{"text":" field will always be filled with the value of language of creation. Unlike the media field, the system does not handle objects whose ","type":"text"},{"text":"lang","type":"text","marks":[{"type":"code"}]},{"text":" property is empty.","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":"f08475f4-09f2-42f0-9fd3-ab3cbaa8da8d","collection":"contentId-11862359","type":"file","height":500}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"During the translation action, the system creates a new object for the selected language context by duplicating the source and changing some properties automatically:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the language will be the target language","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"if the object to be translated is linked to other object instances via the attribution concept (child, childmulti) and these objects are also translatable, the system will automatically retrieve equivalent translations to update the property","type":"text"}]}]}]},{"type":"paragraph"},{"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 translation action canceled. (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 don’t do a cascade translation: if you want this kind of behaviour you need to customize it.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Manually configure a property during translation","type":"text"}]},{"type":"paragraph","content":[{"text":"You can manually overload a property during translation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Indeed, creating a translation using the ","type":"text"},{"text":"WmsUtils","type":"text","marks":[{"type":"code"}]},{"text":" module, we pass in parameter a ","type":"text"},{"text":"java.util.HashMap","type":"text","marks":[{"type":"code"}]},{"text":" with the values that will be object as well as a ","type":"text"},{"text":"java.util.HashSet","type":"text","marks":[{"type":"code"}]},{"text":" of the objects in the new object collection not to be duplicated (e.g. paragraphs).","type":"text"}]},{"type":"paragraph","content":[{"text":"The translation action is ","type":"text"},{"text":"datatranslate","type":"text","marks":[{"type":"code"}]},{"text":". When creating a translation, we call the following JSPs:","type":"text"}]},{"type":"paragraph","content":[{"text":"/bov3/datatranslate/initNotCopiedObjects.jsp","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"initializes the ","type":"text"},{"text":"java.util.HashSet","type":"text","marks":[{"type":"code"}]},{"text":" objects not to be copied in cascade.","type":"text"},{"type":"hardBreak"},{"text":"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/datatranslate/initNotCopiedObjects.jsp\n--%>\n<%\njava.util.Set notCopiedObjects = (java.util.HashSet) request.getAttribute(\"notCopiedObjects\");\nif (notCopiedObjects == null) {\nnotCopiedObjects = new java.util.HashSet();\n}\n/*\n collections of' frontlink' type objects are not duplicated during translation;\n*/\nnotCopiedObjects.add(\"frontlink\");\n/*\n we do not duplicate the collections of paragraph objects when translating;\n*/\nnotCopiedObjects.add(\"paragraph\");\n\nrequest.setAttribute(\"notCopiedObjects\", notCopiedObjects);\n%>","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"/bov3/datatranslate/initForcedValues.jsp","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"initializes the ","type":"text"},{"text":"java.HashMap","type":"text","marks":[{"type":"code"}]},{"text":" utility and iter on each object’s properties to overload them when copying.","type":"text"},{"type":"hardBreak"},{"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: 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 ","type":"text"},{"text":"key[object name].property","type":"text","marks":[{"type":"code"}]},{"text":" name or index: 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":[{"text":"Example","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/datatranslate/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 translation, we always want to empty the product's capacity so that\nthe user re-enters the contance in Onces (Oz) or Millilitres (ml) of the product.\n*/\nif (!forcedValues.containsKey(\"capacity\")) {\nforcedValues.put(\"capacity\", \"\");\n}\nrequest.setAttribute(\"forcedValues\", forcedValues);\n%>","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also customize properties by fields by overloading properties in this way:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[objects/[object_name]]/bov3/datatranslate/forcedvalues/properties/[property native type]/[nature]/[property name].jsp","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[objects/[object_name]]/bov3/datatranslate/forcedvalues/properties/[property name].jsp","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[objects/[object_name]]/bov3/datatranslate/forcedvalues/properties/[property native type]/[property type].jsp","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":445,"id":"64d215bf-f5de-4c1b-a6e2-41514d0a34c5","collection":"contentId-11862359","type":"file","height":248}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Within these JSPs, you can work with the following variables:","type":"text"}]},{"type":"paragraph","content":[{"text":"form_object","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"nature of the current object in translation short","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"activeRefererObject","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"reference object under translation","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"itemValue","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"CTObjectField corresponding to the current property","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"colfield","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"name of the current property","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"nature","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"nature of the object pointed out in the context of an attribution relationship","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"forcedValues","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"java.util.HashMap","type":"text","marks":[{"type":"code"}]},{"text":" properties to force properties to force","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Standard errors","type":"text"}]},{"type":"paragraph","content":[{"text":"When translating from dataview, errors are displayed via the standard popup.","type":"text"}]},{"type":"paragraph","content":[{"text":"Here are the error codes you may encounter:","type":"text"}]},{"type":"paragraph","content":[{"text":"not_connected","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Your session has expired, you need to log in again.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"object_not_found","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The object to translate does not exist.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"not_authorized","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"You don’t have the necessary rights to see the instance.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This feature is reserved for variations in the same project: The source project must therefore be accessible since we are going to create an version in this same project.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The destination language must be accessible to the user, check that they have good access to this one.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"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 objectdata domain, check the security rules or override this boolean with a rule specific to your developments.","type":"text"}]}]}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"not_compliant","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"the requested object does not have the necessary properties for the translation function (at least the ","type":"text"},{"text":"master","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"lang","type":"text","marks":[{"type":"code"}]},{"text":" fields)","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"object_no_translation_selected","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"the object has been specified as untranslatable via the ","type":"text"},{"text":"notranslation","type":"text","marks":[{"type":"code"}]},{"text":" property","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"mandatoryFields","type":"text","marks":[{"type":"strong"}]}]},{"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.","type":"text"},{"type":"hardBreak"},{"text":"The value associated with this error is the list of fields that are empty.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"associations must be translated before translating the requested object","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the error is raised by a structural obligation. If this obligation is only functional, you can create a facet to render it mandatory only as a back-office contribution","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Customize the field to manage a default value.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"FAQ","type":"text"}]},{"type":"paragraph","content":[{"text":"Why is the Translate button not available on my item or a message tells me that the feature is not available?","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If the object does have properties listed in the pre-required section check the following points:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Check that the user performing the test has several contribution languages","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Does the object belong to a project (media completed)?","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If yes, then make sure that the project is available in several languages and that there is more than one language in common with the user’s languages. The \"Translate\" button does not appear if the user has no \"destination\" languages for translation.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Why do I always get an error telling me that a field is not filled in when I translate?","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The user tries to translate an object whose structure is defined as a obligatory attribution to another object that can also be translated. However, when translating, the system searches for a match to these documents in the language of destination. Since he finds none, the property will be empty in the translation, which is not allowed.","type":"text"}]},{"type":"paragraph","content":[{"text":"To solve this problem, you have three main solutions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This link is mandatory for a reason (data model, technical, functional needs): the user must translate these other linked objects before translating the object that raises the error.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can customize the property that clears the error to assign a Default value (to be defined in the specifications) in this case.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If binding was mandatory only in a functional setting, you can change your object configuration to make the field mandatory only through one facet (and more in the structure) the obligation will be carried out in the back office forms but this one will not be tested during the translation process.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"Warning

If you apply this solution, the new object will not be functionally valid which can be disturbing for the user.

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Warning","type":"text"}]},{"type":"paragraph","content":[{"text":"If you apply this solution, the new object will not be functionally valid which can be disturbing for the user.","type":"text"}]}]}],"version":1}}}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]}],"version":1}

Browser not supported