Properties that tune service contract output
- Last Updated: December 7, 2022
- 2 minute read
- Corticon
- Documentation
The following properties are settings for generating service contracts that you
can apply to your Corticon installations by adding the properties and appropriate
values as lines in their brms.properties file.
-------------------------------------------------------------------------------
Controls whether minOccurs="0"
or "1" for Attributes that are marked as mandatory
inside the Vocabulary. By default, all mandatory Attributes have minOccurs="1".
com.corticon.deployment.schema.attribute.mandatory.minOccurs=1
-------------------------------------------------------------------------------
Controls whether nillable="true" or
"false" for Attributes that are marked as mandatory
inside the Vocabulary. By default, all Attributes are set to nillable="true".
com.corticon.deployment.schema.attribute.mandatory.nillable=true
-------------------------------------------------------------------------------
Controls whether <choice> or
<sequence> tags are used for the <WorkDocuments> section of the generated
XSD/WSDL. When useChoice is set to true, <choice> tags
are used which results in more flexibility in the order in which entity instances appear
in the XML/SOAP message. When useChoice is set to
false,
<sequence> tags are used which requires that entity instances appear
in the same order as they appear in the <WorkDocuments> section of the XSD/WSDL. Some Web Services platforms
do not properly support <choice> tags. For these
platforms, this property should be set to false.
Default value is true.
com.corticon.deployment.schema.useChoice=true
-------------------------------------------------------------------------------
Add default namespace declaration to the XSD Generation
Default value is true.
com.corticon.schemagenerator.addDefaultNamespace=true
-------------------------------------------------------------------------------
Specifies whether the XSD and WSDL generators adds the usage attribute
on the CorticonRequest and CorticonResponse definition. The "usage" is deprecated, and no longer used.
However, to be backward compatible with customers that have already generated proxies
from older Schemas or WSDLs, the user has the option to add the usage to the generated
.xsd or .wsdl
Default value is false.
com.corticon.servicecontracts.append.usagelabel=false
-------------------------------------------------------------------------------
Specifies whether the XSD and WSDL generators appends the word "Type"
at the end of each complexType in the related XSD or
WSDL file. This was the standard in earlier versions of the generators.
Default value is false.
com.corticon.servicecontracts.append.typelabel=false
-------------------------------------------------------------------------------
The property ensureComplianceWithDotNET determines whether generated service contracts
(WSDL/XSD) are compliant with Microsoft .NET requirements. This property must be set to
true when the Corticon Server is deployed inside a
Microsoft WCF container.
Default value is false
com.corticon.servicecontracts.ensureComplianceWithDotNET_WCF=false
-------------------------------------------------------------------------------
Controlling date and time format masks in the CSV files
You can specify date and time formats that you prefer in a generated CSV
service contract by setting properties in the brms.properties file. The default values are:
com.corticon.serviceContract.date.masking=MM/dd/yy
com.corticon.serviceContract.dateTime.masking=MM/dd/yy h:mm:ss a
com.corticon.serviceContract.time.masking=h:mm:ss a
Choose one or more masking properties you want to set, and then provide an appropriate mask value. See Formats for Date Time and DateTime properties For example:
com.corticon.serviceContract.date.masking=MM-dd-yyyy
com.corticon.serviceContract.dateTime.masking=MM/dd/yyyy h:mm:ss a
com.corticon.serviceContract.time.masking=h:mm:ss a z
Add the lines you define to the brms.properties file on Corticon Studio instances and Corticon Servers
(when using the corticonManagement utility.)