| Application Version | 2.17.0 |
| Date | 2026-09-15 |
pCon.basket Online is a client-side web application, therefore in order to operate properly it has to be served by a web server. Any web server which supports static web content can be used (e.g. Apache, NGINX, IIS, ...). pCon.basket is distributed as a zip-container. The whole content of the container has to be unpacked (while keeping the folder structure unchanged) and served by the web server. The index.html in the root of the distribution has to be used as the entry point for the web page.
pCon.basket reqiures access to an EAIWS server during runtime. The EAIWS has to be accessible from client-side. If pCon.basket and EAIWS are hosted on different domains, CORS has to be enabled on the EAIWS server. For further information how to setup the EAIWS see the EAIWS documentation.
Required EAIWS version: 4.19 or newer
The following EAIWS plugin are used from pCon.basket Online and have to be available on the EAIWS server.
To configure the application, the settings.json in the root folder has to be edited. The available settings can be seen here (all fields/settings are optional):
{
"application": {
/**
* Array of languages used for the product data in order of priority. If
* the array is empty or undefined the UI language will be used as fallback.
* The dataLanguage will be used as default language when creating new projects.
*/
"dataLanguage": string[],
/** Default currency used for new projects. */
"currency": string,
/** Default tax scheme used for new projects. */
"taxScheme": string,
/** array of default user restrictions, see section 3.1 */
"userRestrictions": string[],
/**
* List of project states which are supported by the application
* with defined order. Available values:
* `Undefined`, `InProgress`, `Offered`, `NotCommissioned`,
* `ApprovalRequired`, `WaitingForApproval`, `ApprovalDenied`,
* `Approved`, `Ordered`
*/
"supportedProjectStates": string[],
/**
* Name of the activity which should be started immediately after
* starting the application.
*/
"defaultActivity": string,
/**
* If false the user is not able to enter the dashboard.
* Only supported in combination with `defaultActivity`. (default: true)
*/
"dashboardEnabled": boolean,
/**
* If false news will not be shown in the dashboard. (default: true)
*/
"dashboardNewsEnabled": boolean,
/** If false the application settings will not be available. (default: true) */
"settingsEnabled": boolean,
/**
* Name of the activity which should be started to open the file specified by the
* he `file_open_url` url parameter.
*/
"fileOpenActivity": string,
/** Url to the application website */
"websiteUrl": string,
/** Url to the terms of use of the application */
"termsOfUseUrl": string,
/** Url to the privacy policy of the application */
"privacyPolicyUrl": string,
/** Url to the legal notice of the application */
"legalNoticeUrl": string,
/** Url to the help/manual of the application */
"helpUrl": string,
/** Url to the `whats new` document of the application */
"whatsNewUrl": string,
/** Url to the `Contact Support` document/form of the application (default: null) */
"contactSupportUrl": string | null,
/** Email address used to contact the support (default: null) */
"supportEmailAddress": string | null,
/** Email address used for error reporting */
"errorReportEmailAddress": string,
/** ID of the special model information text (default: 71) */
"specialModelInfoTextId": string,
/** Enables/disables article price date support (default: true) */
"priceDateSupported": boolean,
/** application theme */
"theme": {
/** Primary color of the theme as hex string. (default: #0078d4) */
"primaryColor": string,
/** Text color of the theme as hex string. (default: #333333) */
"textColor": string,
/** Application bar color of the theme as hex string. (default: #ffffff) */
"appBarColor": string,
/** Logo of the application. (default: null) */
"logo": string | null,
/**
* Background color of the logo as hex/css color string.
* (default: transparent)
*/
"logoBackgroundColor": string
},
/**
* Custom character limit definition for input fields.
* The suffix "{TEXT_ID}" has to be replaced by the corresponding id of the extra item text.
* e.g. "ItemExtraText_71" for the special design text or "ItemExtraText_@add" for the additional text.
* Available fields:
* - "ProjectName"
* - "ProjectNumber"
* - "ProjectExternalReferenceNumber"
* - "ProjectExternalReferenceText"
* - "ProjectDescription"
* - "ProjectHeaderText"
* - "ProjectFooterText"
* - "ItemBaseArticleNumber"
* - "ItemShortText"
* - "ItemLongText"
* - "ItemFeatureText"
* - "ItemExtraText_{TEXT_ID}"
*/
"inputFieldCharacterLimits": {
"FIELD_NAME": number
}
/**
* Custom data which will be available at runtime to all plugins.
* Please see the documentation/readme of the individual plugins for more details.
*/
"customData": {
"DATAGROUP_KEY": {
"DATA_KEY": object | array | primitive_type
};
}
},
"calculation": {
/**
* name of the pricing procedure to use for the
* project and item calculation (default: STDB2B)
*/
"pricingProcedure": string,
/**
* Defines if the current pricing procedure supports the import of a
* foreign calculation/pricing procedures. @defaultValue false
*/
"importForeignCalculationSupported": boolean
},
"catalog": {
/** if true, article numbers will be shown for catalog items @defaultValue false */
"showArticleNumber": boolean,
/** if true, catalog items will be shown with a larger image @defaultValue true */
"largeItemImages": boolean,
/**
* Array of catalog ids used as the favorite catalogs. If defined the user will not be able
* to define its own favorites. The favorites will be fixed.
* @defaultValue null
*/
"favoriteCatalogs": Array<string> | null,
},
"eaiws": {
/** base url of the EAIWS server */
"baseUrl": string | null,
/** startup to use for session creation */
"startup": string | null,
/**
* Interval for the session keep alive message in milliseconds.
* (default: 60000, 0 disables keep alive)
* Only used if session is created with `baseUrl` and `startup`.
*/
"keepAliveInterval": number,
/**
* gatekeeper ID to use for session creation, ignored if
* `baseUrl` and `startup` are defined
*/
"gatekeeperId": string | null,
/**
* Application ID used to connect to gatekeeper.
*/
"gatekeeperAppId": string
},
"report": {
/**
* Array of template names of report templates which should be available to the user.
* If null all available templates will be shown.
*/
"templates": string[] | null,
/** Name of the default template */
"defaultTemplate": string | null,
/**
* If true, reporting templates assigned to the current user will also be filtered by the
* `templates` option. Otherwise, these templates will always be available. @defaultValue false
*/
"filterUserTemplates": boolean,
/**
* If true, an `Adopt Report` button will be shown. The user can use this to inform the application,
* that current report should be stored as the final report for the current quote. If clicked the `adoptReport`
* property of the `eventAfterGenerateReport` event will be true. @defaultValue false
*/
"showAdoptReportButton": boolean,
/**
* Predefined attachments for each template which will be added to every report.
* The name of the template is used as the key for the dictionary.
* If an empty string is used as the tamplate name the provided attachments
* will be applied to all templates without explicitly defined attachments.
*/
"attachments": {
"TEMPLATE_NAME": {
/** List of PDF urls which should be added in front of the report. */
"prependUrls": string[],
/** List of PDF urls which should be added at the end of the report. */
"appendUrls": string[]
}
};
},
"order": {
/**
* If defined a report using the specified template will
* be generated and attached to the order. (default: null)
*/
"reportTemplate": string | null
};
"projectEditor": {
/** Controls if the delete confirmation dialog should be shown. (default: "Always") */
"deleteItemConfirmation": "Always" | "MultipleItems" | "Never",
/** Controls if the catalog should be opened automatically for empty/new projects. (default: false) */
"openCatalogForEmptyProjects": boolean,
/**
* The default columns shown in the item list.
* Available values: "Image", "ExternalItemNumber"
* (default: ["Image"])
*/
"basketColumns": string[]
},
"plugins": {
/**
* Array of plugin names which can be used to disable certain plugins.
* Disabled plugins will be ignored and not loaded from the application.
*/
"disabledPlugins": string[],
/**
* Array of plugin categories which can be used to disable certain plugins.
* Every plugin with a disabled category will be ignored and not loaded from the application.
*/
"disabledCategories": string[],
/**
* Settings for individual plugins. Some plugins may provide
* additional configuration options which can be defined here.
* Please see the documentation/readme of the individual plugins
* for more details.
*/
"settings": {
"PLUGIN_NAME": object | array | primitive_type
}
}
}
User restrictions can be used to limit the access for the user to certain application features. The restrictions defined in the settings.json are used as default restrictions and can be overridden by authorization or integration plugins. The list of available restrictions can be seen here:
export type UserRestriction =
/** Editing of project informations and items is not allowed. (read-only access) */
"edit" |
/** Editing the project informations is not allowed. (read-only access) */
"project.edit" |
/** The project calculation will not be available. */
"project.calculation" |
/** Editing the project calculation is not allowed. (read-only access) */
"project.calculation.edit" |
/** The project purchase calculation will not be available. */
"project.calculation.purchaseCalculation" |
/** Editing the project purchase calculation is not allowed. (read-only access) */
"project.calculation.purchaseCalculation.edit" |
/** The condition type will not be visible in the project calculation. */
"project.calculation.conditionType" |
/** The margin will not be visible in the project calculation. */
"project.calculation.margin" |
/** The project customer information will not be available. */
"project.customer" |
/** Editing the project customer information is not allowed. (read-only access) */
"project.customer.edit" |
/** Editing/switching the customer by using the customer search is not allowed. (read-only access) */
"project.customer.search.edit" |
/** Editing the general customer data is not allowed. (read-only access) */
"project.customer.general.edit" |
"project.customer.general.company.edit" |
"project.customer.general.externalCustomerId.edit" |
"project.customer.general.customerNumber.edit" |
"project.customer.general.generalAgreementNumber.edit" |
"project.customer.general.customerRelatedRemarks.edit" |
/** The customer main address will not be available. */
"project.customer.mainAddress" |
/** Editing the customer main address is not allowed. (read-only access) */
"project.customer.mainAddress.edit" |
/** The customer shipping address will not be available. */
"project.customer.shippingAddress" |
/** Editing the customer shipping address is not allowed. (read-only access) */
"project.customer.shippingAddress.edit" |
/** The customer billing address will not be available. */
"project.customer.billingAddress" |
/** Editing the customer billing address is not allowed. (read-only access) */
"project.customer.billingAddress.edit" |
/** The project data will not be available. */
"project.data" |
"project.data.projectName" |
"project.data.projectNumber" |
"project.data.projectState" |
"project.data.projectDate" |
"project.data.projectValidToDate" |
"project.data.externalReferenceNumber" |
"project.data.externalReferenceText" |
"project.data.description" |
"project.data.keywords" |
"project.data.dataLanguage" |
"project.data.defaultPriceDate" |
"project.data.headerText" |
"project.data.footerText" |
/** Text formatting functions for project texts will not be available. */
"project.data.textFormatting" |
/** Editing the project data is not allowed. (read-only access) */
"project.data.edit" |
"project.data.projectName.edit" |
"project.data.projectNumber.edit" |
"project.data.projectState.edit" |
"project.data.projectDate.edit" |
"project.data.projectValidToDate.edit" |
"project.data.externalReferenceNumber.edit" |
"project.data.externalReferenceText.edit" |
"project.data.description.edit" |
"project.data.keywords.edit" |
"project.data.dataLanguage.edit" |
"project.data.defaultPriceDate.edit" |
"project.data.headerText.edit" |
"project.data.footerText.edit" |
/** User is not allowed to change the default "valid to date" used for new projects. */
"project.data.projectValidToDate.setDefault" |
/** User is not allowed to change the default data language used for new projects. */
"project.data.dataLanguage.setDefault" |
/** The project party in charge information will not be available. */
"project.partyInCharge" |
/** Editing the project party in charge information is not allowed. (read-only access) */
"project.partyInCharge.edit" |
/** User is not allowed to change the default party in charge used for new projects. */
"project.partyInCharge.setDefaults" |
/** The project currency and taxes will not be available. */
"project.tax" |
/** Editing currency and taxes is not allowed. (read-only access) */
"project.tax.edit" |
/** Currency exchange rates will not be available. */
"project.tax.exchangeRates" |
/** Editing the currency exchange rates and resetting them is not allowed. (read-only access) */
"project.tax.exchangeRates.edit" |
/** Editing the currency exchange rates is not allowed. (read-only access) */
"project.tax.exchangeRates.rate.edit" |
/** Resetting the currency exchange rates is not allowed. */
"project.tax.exchangeRates.reset" |
/** User is not allowed to change the default exchange rates used for new projects. */
"project.tax.exchangeRates.setDefaults" |
/** Tax rates will not be available. */
"project.tax.taxRates" |
/** Editing the tax rates and resetting them is not allowed. (read-only access) */
"project.tax.taxRates.edit" |
/** Editing the tax rates is not allowed. (read-only access) */
"project.tax.taxRates.rate.edit" |
/** Resetting the tax rates is not allowed. */
"project.tax.taxRates.reset" |
/** User is not allowed to change the default tax rates used for new projects. */
"project.tax.taxRates.setDefaults" |
/** The project terms will not be available. */
"project.terms" |
/** Editing the project terms is not allowed. (read-only access) */
"project.terms.edit" |
/** Editing or creating items is not allowed. (read-only access) */
"item.edit" |
/** Additional user defined item images will not be available. */
"item.additionalImages" |
/** Extra item texts (e.g. special model information) will not be available. */
"item.extraTexts" |
/** Editing the extra item texts is not allowed. (read-only access) */
"item.extraTexts.edit" |
/** The external item number of items will not be available. */
"item.externalItemNumber" |
/** Editing of the external item number of items is not allowed. (read-only access) */
"item.externalItemNumber.edit" |
/** The item comments will not be available. */
"item.comments" |
/** Editing of item comments item is not allowed. (read-only access) */
"item.comments.edit" |
/** The item calculation will not be available. */
"item.calculation" |
/** Editing the item calculation is not allowed. (read-only access) */
"item.calculation.edit" |
/** The item purchase calculation will not be available. */
"item.calculation.purchaseCalculation" |
/** Editing the item purchase calculation is not allowed. (read-only access) */
"item.calculation.purchaseCalculation.edit" |
/** The condition type will not be visible in the item calculation. */
"item.calculation.conditionType" |
/** The margin will not be visible in the item calculation. */
"item.calculation.margin" |
/** The `update condition amounts` function will not be available. */
"item.calculation.updateConditionAmounts" |
/** The item configuration will not be available. */
"item.configuration" |
/** Configuration of items/articles is not allowed. (read-only access) */
"item.configuration.edit" |
/** Creating folders will not be available. */
"item.folder.create" |
/** Folder sub totals will not be available. */
"item.folder.subTotal" |
/** Additional text for folders will not be available. */
"item.folder.additionalText" |
/** Full width images for folders will not be available (reporting only). */
"item.folder.fullWidthImage" |
/** Creating set articles will not be available. */
"item.setArticle.create" |
/** Converting a folder into a set article will not be available. */
"item.setArticle.convertTo" |
/** Breaking up a set article will not be available. */
"item.setArticle.breakUp" |
/** Full width images for set articles will not be available (reporting only). */
"item.setArticle.fullWidthImage" |
/** The option to collapse (hide sub items) for set articles will not be available (reporting only). */
"item.setArticle.collapse" |
/** Creating text items will not be available. */
"item.textItem.create" |
/** Additional text for text items will not be available. */
"item.textItem.additionalText" |
/** User defined description for OFML articles will not be available. */
"item.ofmlArticle.userDescription" |
/** Editing the user defined description for OFML articles is not allowed. (read-only access) */
"item.ofmlArticle.userDescription.edit" |
/** Updating/migrating ofml articles will not be available. */
"item.ofmlArticle.update" |
/** Creating user articles will not be available. */
"item.userArticle.create" |
/** Converting an article into a user article will not be available. */
"item.userArticle.convertTo" |
/**
* Editing the purchase price of a user article is not allowed. (read-only access)
* The purchase price will be linked to the sales price in this case.
*/
"item.userArticle.purchasePrice.edit" |
/** Merging articles will not be available. */
"item.mergeArticles" |
/** Splitting up composite articles will not be available. */
"item.splitUpCompositeArticles" |
/** Mark items as alternative (or vice versa) will not be available. */
"item.markAsAlternative" |
/** Mark items as optional (or vice versa) will not be available. */
"item.markAsOptional" |
/** It is not allowed to enter a negative quantity. */
"item.quantity.negative" |
/** It is not allowed to enter a zero quantity. */
"item.quantity.zero" |
/** Geometry export for articles will not be available. */
"item.geometryExport" |
"item.geometryExport.3ds" |
"item.geometryExport.dwg" |
"item.geometryExport.fbx" |
"item.geometryExport.glb" |
"item.geometryExport.usdz" |
"item.geometryExport.pec" |
/** Text formatting functions for item texts will not be available. */
"item.textFormatting" |
/** Reporting will not be available. */
"report" |
/** Editing the report is not allowed. (read-only access) */
"report.edit" |
/** User is not allowed to change the default tamplate options used for new projects. */
"report.template.options.setDefaults" |
/** User is not allowed to add attachments and cover cheets. */
"report.attachments" |
/** The `download report` function will not be available. */
"report.download" |
/** The `send report` function will not be available. */
"report.send" |
/** The `share report` function will not be available. */
"report.share" |
/** Order information / placing an order will not be available. */
"order" |
/** Editing the order information is not allowed. (read-only access) */
"order.edit" |
/** Editing the order number is not allowed. (read-only access) */
"order.orderNumber.edit" |
/** Editing the order number is not allowed. (read-only access) */
"order.vendorNumber.edit" |
/** Editing the order main address is not allowed. (read-only access) */
"order.mainAddress.edit" |
/** Editing the order shipping address is not allowed. (read-only access) */
"order.shippingAddress.edit" |
/** Editing the order billing address is not allowed. (read-only access) */
"order.billingAddress.edit" |
/** Catalog search is not available */
"catalog.search";
.woff2 (MIME type: font/woff2)..env (MIME type: application/octet-stream).© EasternGraphics GmbH | Albert-Einstein-Straße 1 | 98693 Ilmenau | GERMANY
This work (whether as text, file, book or in other form) is copyright. All rights are reserved by
EasternGraphics GmbH. Translation, reproduction or distribution of the whole or parts thereof is permitted only with the prior agreement in writing of EasternGraphics GmbH.
EasternGraphics GmbH accepts no liability for the completeness, freedom from errors, topicality or continuity of this work or for its suitability to the intended purposes of the user. All liability except in the case of malicious intent, gross negligence or harm to life and limb is excluded.
All names or descriptions contained in this work may be the trademarks of the relevant copyright owner and as such legally protected. The fact that such trademarks appear in this work entitles no-one to assume that they are for the free use of all and sundry.