{"type":"doc","content":[{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"About"},"_parentId":{"value":"3112306498"},"_referencedContentId":{"value":"3112329762"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"0c50bb6c-5ae7-48b0-a51b-ee439b1f3145"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"241e72e3-f1f8-4a9c-85c8-9984dc612660"}},{"type":"hardBreak"},{"text":"Applies to QESTField","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This article details the configuration for the QESTField product","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Contents","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"3112306498"},"exclude":{"value":"Contents"}},"macroMetadata":{"macroId":{"value":"79042eda-38cc-4475-8dd8-eea5f9dd0ee0"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"434884d9-bae4-43b4-8d7b-cf5512a2e74d"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuration guide","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Web.config","type":"text"}]},{"type":"paragraph","content":[{"text":"Web.config","type":"text","marks":[{"type":"strong"}]},{"text":" is the primary configuration file for the QESTField ASP.NET web application. It resides in the root physical path of the web site. The file is an XML format file and can be edited by any standard text or XML editor.","type":"text"}]},{"type":"paragraph","content":[{"text":"The initial config file contains several major sections as shown below.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n ...\n ...\n ...\n ...\n ...\n ...\n ...\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"configSections","type":"text"}]},{"type":"paragraph","content":[{"text":"Defines additional configuration sections used by QESTField.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n

\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Do not change this section unless advised to do so by Spectra QEST.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"qestfield","type":"text"}]},{"type":"paragraph","content":[{"text":"This section contains settings used by QESTField to load workflows and understand communication with QESTNet.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n ...\n \n \n \n ...\n \n \n \n ...\n \n","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"contractModules","type":"text","marks":[{"type":"strong"}]},{"text":" A list of assemblies containing types that shared by QESTNet and QESTField for communication. If there are any custom workflows, their contracts assemblies must be defined here. Known configurations that require custom assemblies are published with QESTField.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"viewModules","type":"text","marks":[{"type":"strong"}]},{"text":" A list of assemblies containing QESTField workflow display code. If there are any custom workflows, their QESTField View assemblies must be defined here. Known configurations that require custom assemblies are published with QESTField.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"viewLocations","type":"text","marks":[{"type":"strong"}]},{"text":" A list of locations used by QESTField to locate its templates. A full list of these is provided in a sample configuration file with QESTField. If there are any custom workflows, their view templates must be defined here. Known configurations with custom view templates are publishsed with QESTField.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Do not change these sections from their recommended contents unless advised to do so by Spectra QEST.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"appSettings","type":"text"}]},{"type":"paragraph","content":[{"text":"This section contains name-and-value pairs for application settings.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"logo","type":"text","marks":[{"type":"strong"}]},{"text":" setting can be changed to control the image that shows in the top left of the page:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"qestfield logo:","type":"text","marks":[{"type":"strong"}]},{"text":" \"~/Content/images/logo_small.png\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"qestnet logo:","type":"text","marks":[{"type":"strong"}]},{"text":" \"~/Content/images/logo_small_qestnet.png\"","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"showFavourableConcurrencyNotice","type":"text","marks":[{"type":"strong"}]},{"text":" setting can be changed to control whether an alert notice is shown when concurrent updates have occurred that were resolved in the current user's favor. Typically concurrent updates resolved in the users favor do not require notification, as all of the users changes were saved successfully. An alert is always shown when concurrent updates are resolved in a way that is not in the users favor such that some or all of their changes may have been lost.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"show notice:","type":"text","marks":[{"type":"strong"}]},{"text":" \"true\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"hide notice:","type":"text","marks":[{"type":"strong"}]},{"text":" any other value","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"CustomFields.TextAreaThreshold","type":"text","marks":[{"type":"strong"}]},{"text":" controls whether a text custom field will be displayed as a single line text box or a multi-line text area. Any text custom field defined with a maximum length, up to and including this size, will be displayed as single line text box. Others with a greater maximum length will be displayed as a multi-line text area.","type":"text"}]},{"type":"paragraph","content":[{"text":"Do not change other settings in this section unless advised to do so by Spectra QEST.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"system.web","type":"text"}]},{"type":"paragraph","content":[{"text":"This section defines the core settings used by the QESTField web application. Do not change this section unless advised to do so by Spectra QEST.","type":"text"}]},{"type":"paragraph","content":[{"text":"Hosting in an IIS Server Farm","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"When hosting QESTField on an IIS Server Farm (instead of the more conventional single IIS server), a machine key that is consistent for all servers hosting QESTField must be specified to allow clients to connect to any of the machines. This can be adding a machineKey element to the system.web section. The exact keys and encryption methods may be any that are valid (see the ","type":"text"},{"text":"Microsoft Documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://msdn.microsoft.com/en-us/library/w8h3skw9(v=vs.100).aspx"}}]},{"text":" for more information). The keys should be generated on one of the servers that will be using them and transferred as directly as possible between them. The keys are hexadecimal strings, the simplest way to generate them is in the \"Machine Keys\" section of IIS Manager.","type":"text"}]},{"type":"paragraph","content":[{"text":"Do not use the keys presented in this example","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"While not required, these keys should be changed frequently.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"runtime","type":"text"}]},{"type":"paragraph","content":[{"text":"This section defines the core settings used by the QESTField web application. Do not change this section unless advised to do so by Spectra QEST.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"system.serviceModel","type":"text"}]},{"type":"paragraph","content":[{"text":"This section contains requires two subsections: bindings and client.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n ... \n ... \n ... \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"bindings","type":"text"}]},{"type":"paragraph","content":[{"text":"The type of the bindings defined, need to match those defined for the Lab Service of the QESTNet that the QESTField will be connecting to. By default these bindings are TCP and defined separately for each of the three required endpoints. These client settings control the connection timeouts and buffer sizes, where not overridden by the QESTNet server's binding settings.","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information on how to customize service bindings, see: ","type":"text"},{"text":"https://msdn.microsoft.com/en-us/library/ms731399(v=vs.110).aspx","type":"text","marks":[{"type":"link","attrs":{"href":"https://msdn.microsoft.com/en-us/library/ms731399(v=vs.110).aspx"}}]}]},{"type":"codeBlock","content":[{"text":"\n \n ... \n ... \n ... \n \n","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"client","type":"text"}]},{"type":"paragraph","content":[{"text":"The client section defines the endpoints which the client connects to. QESTField requires three endpoints of QESTNet:","type":"text"}]},{"type":"table","attrs":{"layout":"wide","localId":"6fb8c0f5-92bb-4849-a5e7-b3d594c583fc"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"Endpoint Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"Address","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[169.0]},"content":[{"type":"paragraph","content":[{"text":"Default Binding","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[583.0]},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"Lab_Session","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[169.0]},"content":[{"type":"paragraph","content":[{"text":"Unsecured TCP","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[583.0]},"content":[{"type":"paragraph","content":[{"text":"Allows QESTField to open and close QESTNet session and issue commands.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"Lab_Query","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"/query","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[169.0]},"content":[{"type":"paragraph","content":[{"text":"Unsecured TCP","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[583.0]},"content":[{"type":"paragraph","content":[{"text":"Allows QESTField to query data structures from QESTNet's LIMS functionality set.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.0]},"content":[{"type":"paragraph","content":[{"text":"Lab_File","type":"text","marks":[{"type":"em"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[88.0]},"content":[{"type":"paragraph","content":[{"text":"/file","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[169.0]},"content":[{"type":"paragraph","content":[{"text":"Unsecured Streaming TCP","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[583.0]},"content":[{"type":"paragraph","content":[{"text":"Streams the data content of large files.","type":"text"}]}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"address:","type":"text","marks":[{"type":"strong"}]},{"text":" The endpoint address - typically only the host name must be changed to match the QESTNet server. If further customization of protocol or port has been made then those two must match the QESTNet server configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"binding:","type":"text","marks":[{"type":"strong"}]},{"text":" The binding type - must match the type of the binding configuration.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bindingConfiguration:","type":"text","marks":[{"type":"strong"}]},{"text":" The binding configuration - must match a name from the bindings section.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"contract:","type":"text","marks":[{"type":"strong"}]},{"text":" The service interface - do not change.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"name:","type":"text","marks":[{"type":"strong"}]},{"text":" The identifier for the endpoint - do not change.","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"For more information on how to customize the service client, see: ","type":"text"},{"text":"https://msdn.microsoft.com/en-us/library/ms731704(v=vs.110).aspx","type":"text","marks":[{"type":"link","attrs":{"href":"https://msdn.microsoft.com/en-us/library/ms731704(v=vs.110).aspx"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"system.webServer","type":"text"}]},{"type":"paragraph","content":[{"text":"This section defines instructions to the IIS web server. Do not change this section unless advised to do so by Spectra QEST.","type":"text"}]},{"type":"paragraph","content":[{"text":"Error messages","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Public sites by default will have any errors messages hidden by IIS. The error message will instead show a 500 - Internal server error.","type":"text"},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"36b85c4d-a7c0-4db1-bf49-2a89fd8d4f8d","collection":"contentId-1149208345","height":"250"}}}]},{"type":"paragraph","content":[{"text":"To show the error change httpErrors:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"errorMode:","type":"text","marks":[{"type":"strong"}]},{"text":" Set to \"Detailed\".","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Ensure customErrors under system.web is configured:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"mode:","type":"text","marks":[{"type":"strong"}]},{"text":" Set to \"Off\".","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"An error message explaining the error will be shown instead.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"__fileSize":43214,"__fileMimeType":"image/png","width":541,"id":"a1168532-20c4-47a3-9921-206741fc1e58","collection":"contentId-1149208345","type":"file","__fileName":"qf-example-error-testerror.png","height":409}}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt-include","parameters":{"macroParams":{"":{"value":"Trademarks, Terms of Use and Privacy Statement"},"_parentId":{"value":"3112306498"},"_referencedContentId":{"value":"3112329885"},"nopanel":{"value":"true"}},"macroMetadata":{"macroId":{"value":"57f2e167-04c3-4c86-afba-ec557b669ba8"},"schemaVersion":{"value":"1"},"title":"Insert excerpt"}},"localId":"ff2a04fc-0709-4b2c-a2a2-71a694077d25"}}]},{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported