Capps Implementation Guide CS 5.3.1
Capps Implementation Guide CS 5.3.1
cApps™
CranSoft® Version 5.3.1 and newer
Document History
Version Author Date Reviewer Date Approver Date Comments
Melanie
1 Elizabeth Warnke 12/15/10 Allison Burkett 12/17/10 12/21/10 First Publication
Waid
Second Publication
Elizabeth
2 Elizabeth Warnke 02/09/11 Melanie Waid 02/09/11 02/09/11 (Added a section for
Warnke
BAPIdirect™)
Melanie Waid Third Publication
Allison
3 Karen Dunson 02/16/11 Patricia 02/16/11 02/16/11 (Added information on
Burkett
Ainsworth cHR™ archiving)
cApps™ Implementation Guide
Table of Contents
Overview ................................................................................................................................................................................... 1
Relevant Documentation ......................................................................................................................................................... 1
System Administration ............................................................................................................................................................ 2
Set Up Security ....................................................................................................................................................................... 2
Grant Security to Process User ............................................................................................................................................... 3
Populate SAP Language Key .................................................................................................................................................. 3
DataGarage®............................................................................................................................................................................. 5
Grant Target Security .............................................................................................................................................................. 5
Populate SAP Settings ............................................................................................................................................................ 5
Set up Single Thread Schedule Group .................................................................................................................................... 6
Publish Groups ........................................................................................................................................................................ 6
Add WHERE Clause Override Conditions ............................................................................................................................... 8
Configure Parameters ............................................................................................................................................................. 9
Build DTS Packages................................................................................................................................................................ 9
Recreate Tables for Modified DTS Packages.......................................................................................................................... 9
Create Finish DTS Packages ................................................................................................................................................ 10
Refresh Data ......................................................................................................................................................................... 10
Index Service Page ............................................................................................................................................................... 11
cConfig™ ................................................................................................................................................................................ 12
Configure Parameters ........................................................................................................................................................... 12
Configure Exclude Dates ....................................................................................................................................................... 13
Import Postal Codes .............................................................................................................................................................. 13
View Definition Tables ........................................................................................................................................................... 14
Setup Security ....................................................................................................................................................................... 15
Define User Security.............................................................................................................................................................. 15
Reset Security ....................................................................................................................................................................... 15
Review Hide On Release Fields ............................................................................................................................................ 16
System Administration .......................................................................................................................................................... 17
Recompile Data Sources ....................................................................................................................................................... 17
BDCdirect® ............................................................................................................................................................................. 18
Populate SAP Information ..................................................................................................................................................... 18
BAPIdirect™............................................................................................................................................................................ 19
Populate SAP Information ..................................................................................................................................................... 19
cApps™ Implementation Guide
cMat™...................................................................................................................................................................................... 20
Configure Parameters ........................................................................................................................................................... 20
Add Valid Units of Measure ................................................................................................................................................... 20
Configure Default Tables ....................................................................................................................................................... 21
Configure Auto-Extend Defaults ....................................................................................................................................... 23
Add Default Values ........................................................................................................................................................... 23
Build QMAT Default .......................................................................................................................................................... 24
Configure Message Center.................................................................................................................................................... 24
cCust™ .................................................................................................................................................................................... 25
Configure Parameters ........................................................................................................................................................... 25
Set Up Account Groups ......................................................................................................................................................... 25
Step 1 – Register a Customer Account Group.................................................................................................................. 26
Step 2 – Generate Customer Account Group Tables ....................................................................................................... 26
Step 3 –View Customer Account Group Configuration Data ............................................................................................ 27
Step 4 – View Customer Account Group Configuration Validation View .......................................................................... 27
Step 5 – View Customer Account Group Configuration Dynamic View ............................................................................ 27
Step 6 – Create Customer Account Group Configuration Data ........................................................................................ 27
Step 7 – Clear Cache ....................................................................................................................................................... 28
Configure Default Tables ....................................................................................................................................................... 28
Add Default Values ........................................................................................................................................................... 29
KNVI Defaults ................................................................................................................................................................... 29
KNVP Defaults .................................................................................................................................................................. 29
Create Partner Function Requirements ................................................................................................................................. 29
Configure Message Center.................................................................................................................................................... 30
cVend™ ................................................................................................................................................................................... 31
Configure Parameters ........................................................................................................................................................... 31
Set Up Account Groups ......................................................................................................................................................... 31
Step 1 – Register Vendor Account Groups ....................................................................................................................... 32
Step 2 – Generate Vendor Account Group Tables ........................................................................................................... 32
Step 3 – View Vendor Account Group Configuration Data ............................................................................................... 33
Step 4 – View Vendor Account Group Configuration Validation View .............................................................................. 33
Step 5 – View Vendor Account Group Configuration Dynamic View ................................................................................ 33
Step 6 – Create Vendor Account Group Configuration Data ............................................................................................ 33
Step 7 – Clear Cache ....................................................................................................................................................... 34
cApps™ Implementation Guide
Overview
Once the cApps™ have been installed, there are many steps required to configure the applications. This document outlines
the configuration steps required in the cApps™ and across all dependent applications; however, not all steps are required by
all cApps™. Complete all applicable steps before getting started with the following cApps™:
cMat™ 5.2
cCust™ 5.2
cVend™ 5.2
cFICO™ 5.2
cHR™ 5.0
NOTE: For cMass™ implementation steps, refer to the cMass™ User Manual.
If the client’s SAP instance has been modified to contain ZFields, several changes must be made in SAP, the cApps™ and
BAPIdirect™. These changes are specified in Appendix G – ZField Checklist of the cConfig™ User Manual.
Relevant Documentation
cApps™ Implementation Plan
CranSoft® User Manual
CranSoft® Security Manual
cConfig™ User Manual
cConfig™ Security Manual
cCust™ User Manual
cMat™ User Manual
cVend™ User Manual
cFICO™ User Manual
cHR™ User Manual
DataGarage® User Manual
BAPIdirect™ User Manual
BDCdirect® User Manual
BDCPlus™ User Manual
CranPort™ User Manual
CatalogBuilder™ User Manual
Page 1 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
System Administration
This section contains configuration settings specific to System Administration.
Set Up Security
In order for users to gain access to the cApps™, three tasks must be completed:
Create CranSoft® User Account.
Add new users to a WebApp.
Add new users to a Security Group for specific WebApps.
NOTE: These steps assume the security groups delivered with the cApps™ are used. Refer to the CranSoft® Security
Manual for details on creating custom security groups.
When adding users to a WebApp, grant security based on the user’s function within the request process. Users should be
granted access to the following WebApps:
cConfig™ – Users who configure the cApp™ security.
cCust™ – Users who create, process, post, monitor or configure the Collaborative Customer Maintenance™ application.
cMat™ – Users who create, process, post, monitor or configure the Collaborative Material Maintenance™ application.
cVend™ – Users who create, process, post, monitor or configure the Collaborative Vendor Maintenance™ application.
cFICO™ – Users who create, process, post and configure the Collaborative Financing and Controlling Maintenance™
application
cHR™ – Users who create, process, post and configure the Collaborative Human Resource Maintenance™ application
BAPIdirect™ – Users who post data into SAP using BAPIs.
BDCdirect® – Users who post data into SAP using BDCs.
BDCPlus™ – Users who post data into SAP using a BDCPlus™ process.
CatalogBuilder™ – Users who run catalog translations.
DataGarage® – Users who configure the download or refreshing of data from SAP.
System Administration – Users who design or modify WebApp pages.
Page 2 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
The following table outlines the WebApp security required for each cApp™:
NOTE: cFICO™ and cHR™ require BAPIdirect™ to be installed due to references in cConfig™; however, BAPIdirect™ is
not used to post request data to SAP. Therefore, security to BAPIdirect™ is not necessary.
Page 3 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 4 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
DataGarage®
This section contains configuration settings specific to DataGarage®.
Page 5 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
This configuration step schedules the download processes to run sequentially and not simultaneously.
To set up a single thread schedule group:
1. Select Publish (Groups) from Configuration on Switchboard.
2. Locate the cApp™ Group.
3. Click Tables button.
4. Locate the Table to add to the
schedule group.
5. Click Schedule Group button.
Schedule Table to run in Single Thread
6. Click Add on the Grid
Toolbar.
7. Enter a schedule group name in Schedule Group field.
NOTE: By default, the Schedule Group is called SingleThread to match the default group defined under Configuration
Schedule Groups. If a custom group is created under Configuration Schedule Groups, populate the Schedule
Group field with the custom group name.
8. Verify Schedule Single Thread check box is enabled.
9. Click Save .
10. Repeat steps #2-9 for all applicable cApps™ and tables.
Publish Groups
Before DTS packages can be built, the source and target connections must be created and the applicable cApp™ groups
must be published. Publishing a group of tables is the process of copying tables from a source to a target. Refer to the
DataGarage® User Manual for a detailed explanation of the publish groups functionality.
The following groups must be published (if installed):
Page 6 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
DataGarage
cConfig
cMat
cMatClassBatch
cVend
cCust
cFICO
cHR
cHR2
To publish groups:
1. Select Publish (Groups) from Configuration on Switchboard.
2. Locate the Group.
3. Click Vertical View .
4. Click Edit .
5. Select a database from Target list box.
NOTE: The Target is typically the
DataGarage® database (dgSAP).
6. Select a database from Source
Database list box.
NOTE: The Source is an SAP Instance
associated with the SAPSystem
listed in the SAP Settings.
7. Click Publish Rules check box to allow
rules for tables in the group to be
published.
8. Verify Publish Tables Schema Owner Publish Groups
is disabled; this feature is not used by
the cApps™.
9. Click Save .
10. Click Publish button; a confirmation message displays.
11. Click Yes .
NOTE: Once the publish group process completes, a confirmation message displays.
12. Click Ok .
13. Repeat steps #2-12 for all applicable groups.
Page 7 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 8 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Configure Parameters
There are specific DataGarage® parameters that must be configured in order to support the cApps™.
To configure DataGarage® parameters:
1. Select Parameters from Configuration on Switchboard.
2. Click Package Info tab.
3. Click Edit .
4. Set the RFC Name Space Option depending on the SAP configuration.
NOTE: The RFC Name Space Options are NAMESPACE and NONNAMESPACE. BackOffice Associates® owns the
Namespace /BOA; Non-namespace transports begin with ZBOA. Consult with the Basis Team to determine if the
SAP installation is configured to run Namespace or Non-namespace.
5. Select BOA RFC from RFC Type list box.
6. Click Save .
Refresh Data
If configuring and using the cApps™ directly subsequent to installation, refreshing all DataGarage® tables is not necessary;
only those tables that have been modified with the addition of a WHERE clause or which have had new DTS packages
created must be refreshed. Data can be refreshed at the target, source or table level. Refer to the DataGarage® User
Manual for detailed information on refreshing DataGarage®.
NOTE: Refreshing data in DataGarage® may take several hours depending on the volume of data.
Page 10 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 11 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
cConfig™
This section contains configuration settings specific to cConfig™.
Configure Parameters
cConfig™ parameters are high-level fields used throughout the WebApp and must be configured per installation.
The SAP Information within cConfig™ parameters must be populated before the individual cApps™ are configured. SAP
information entered in cConfig™ automatically populates the corresponding fields in cMat™, cCust™, cVend™, cFICO™,
cHR™ and BAPIdirect™.
The SAP information for DataGarage® and BDCdirect® must be manually entered. Refer to the DataGarage® and
BDCdirect® sections for detailed information.
Refer to the following table for a description of cConfig™ parameters.
Parameter Group Parameter Description
Characters that are unable to be used in Scenario IDs or Business
Invalid Characters
Process IDs. The default values are '~`!@#$%^_+|{}:"<>.
Options Only used if cHR™ is installed. The Root Organization entered is
Root Organization copied into the cHR™ parameters. It is used to determine the Upper
Limit Organization for the organization chart.
SAP Instance SAP instance to which the cApps™ connect.
SAP Client Number to which the cApps™ connect. An instance of
SAP Client the cApps™ retrieves data from and posts data to a single SAP
client.
Language used for SAP login. If the SAP Language is a language
SAP Info
other than English and cMat™ is installed, populate this field after
SAP Language
valid units of measure have been defined for cMat™. Refer to the
Add Valid Units of Measure section for detailed information.
SAP Server Host Server hosting the SAP database.
SAP System No SAP system number
DataGarage Name of the DataGarage® database. Not editable by the end user.
Name of the DataGarage® database used for the cApps™. Not
DataGarage Info DataGarage Connection
editable by the end user.
SAP Connection Name of the SAP database used for the cApps™
Trace Logging Enables trace logging. By default, this setting is disabled.
Trace Log Settings Number of days the logs are stored. The default value is 0.It is
Trace Log Retention
recommended this value not be set > 7 days.
To configure parameters:
1. Log into cConfig™.
2. Select Parameters from Configuration on Switchboard.
3. Click Edit .
4. Update parameters as needed.
5. Click Save .
Page 12 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
NOTE: The cConfig™ parameters record must be validated after every initial installation of a cApp™.
NOTE: Once the postal codes for the country have been imported, a confirmation message displays.
13. Click Ok .
14. Click Apply Postal Codes button to validate the imported data for the country and to transfer it to the ttPostalCode
table; a confirmation message displays.
15. Click Yes .
NOTE: Once the postal codes for the country have been validated, a confirmation message displays.
16. Click Ok .
NOTE: If any entries are incorrect, validation messages display to outline what must be corrected. Correct the data, clear
the postal codes (via the Clear Postal Codes button on the Vertical View), import the spreadsheet and apply the
postal codes again.
Page 14 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Setup Security
Org Units are defined at the object level. cMat™, cCust™ and cVend™ only support one object; cFICO™, however, supports
multiple objects. Org Units for each object in cFICO™ are individually configured. Org Units are not used by cHR™.
The following table outlines the Org Units available for each object:
Object Org Unit 1 Org Unit 2 Org Unit 3
Company NONE NONE NONE
Company Code NONE NONE NONE
Cost Center Controlling Area NONE NONE
Country Code Company NONE NONE
Customer Company Sales Organization Business Unit
GLAccount Company NONE NONE
Material Plant Sales Organization Business Unit
Profit Center Controlling Area NONE NONE
Vendor Company Purchasing Organization Business Unit
Org Unit values must be registered for each object. Refer to the cConfig™ Security Manual for information on registering the
following Org Units:
Controlling Area
Company
Plant
Sales Organization
Purchasing Organization
Business Unit
Reset Security
Security is automatically reset if rights are extended to existing users for roles, business processes or Org Units. Security
must be manually reset if
There are additions, updates, or deletions to roles, business processes or Org Units
Page 15 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 16 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
System Administration
This section contains configuration settings specific to System Administration.
Page 17 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
BDCdirect®
This section contains configuration settings specific to BDCdirect®.
Page 18 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
BAPIdirect™
This section contains configuration settings specific to BAPIdirect™.
Page 19 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
cMat™
This section contains configuration settings specific to cMat™.
Configure Parameters
cMat™ parameters are fields that configure the WebApp per installation. Refer to the following table for a description of
cMat™ parameters.
Parameter Group Parameter Description
Characters not permitted in the Material Name or Description
Invalid Characters
fields. The default values are ~`!@#$%^*+|{}:<>.
Characters not permitted in the Material Number field. The
Invalid ID Characters
Options default values are ~`!@#$%^*()_+|{}:"<>'.
If checked, the Delete Archives button displays on the Delete
Enable Archive Delete Archives page to allow archives to be deleted. By default, this
setting is enabled.
SAP Instance SAP instance used by SAP when interfacing with the application.
Automatically
SAP Client SAP client the application is interfacing with.
SAP Info populated from
SAP cConfig™ SAP language used when interfacing with the application.
Language
DataGarage Name of the DataGarage® database.
DataGarage Automatically Name of the DataGarage® database with which the application is
DataGarage Info Connection populated from interfacing.
cConfig™
SAP SAP database used by the application.
Connection
To configure parameters:
1. Log into cMat™.
2. Select Parameters from Configuration on Switchboard.
3. Click Edit .
4. Update parameters as needed.
5. Click Save .
Page 20 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 21 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Default tables have been provided where it is logical to default data. For example, Purchasing Source List data would vary
widely, so source list data is not available for defaults.
Most default tables contain ScenarioID as a key. For those that do, defaults may be specified at four levels and are
processed in the following order:
All keys specified – Valid values populated for each key field.
Across Scenario for specified keys – Asterisk (*) populated for Scenario ID and valid values populated for all other
key fields.
Scenario specified for all keys – Valid value populated for Scenario ID and asterisk (*) for all other key fields.
Page 22 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Across all Scenarios and keys – Asterisk (*) populated for Scenario ID and all other key fields.
Records on the Default page write to the corresponding table. When the record is validated, all possible combinations of
default values are computed and stored in a second extended table. When a record is added, changed or deleted, the
defaults process in the background and compute the exact default values for all combinations of keys. When new key values
(e.g., Account Group, Plant) are configured in SAP and/or cConfig™, at least one default value for each table must be
validated in order to recreate the extended default tables.
Configure Auto-Extend Defaults
If the following default tables are populated, target table records are generated automatically.
Default Table Keys Related Request Page Processing
ttKSSKDefault Material Type, Request (Class) Classes specified in ttKSSKDefault are automatically
Class Type, inserted into the ttKSSK table when a create Request is
Class Submitted for the specified Material Type and ‘Auto
Create Class’ is enabled on the Request.
ttMARMDefault Material Type, Request (AUM) Alternative Units of Measure specified in
Order Unit (Base ttMARMDefault are automatically inserted into the
Unit of Measure) ttMARM table when a create Request is submitted for
the specified Material Type/Order Unit combination.
ttDefaultPlant Plant Request (Org Unit – Plants entered in ttDefaultPlant are automatically
Plants) inserted into ttRequestOrgUnit1 when requests are
created.
ttDefaultSalesArea Sales Request (Org Unit – Sales Sales Areas entered in ttDefaultSalesArea are
Organization, Organizations), Request automatically inserted into ttRequestSalesArea and
Distribution (Sales Areas) Sales Organizations are inserted into
Channel ttRequestOrgUnit2 when requests are created.
ttMARDDefault Scenario ID, Request (Storage If Autoextend Storage Location is enabled, the record is
Plant, Storage Location) automatically inserted into the ttMARD table when the
Location corresponding plant (ttMARC) record is created, on
submit of the request or when added on the Request
(Plant) page, and when ‘Auto Create Warehouse’ is
enabled on the Request.
ttMLGTDefault Scenario ID, Request (Warehouse If Auto Extend Storage Type is enabled, the record is
Warehouse Storage Type) automatically inserted into the ttMLGT table when the
Number, corresponding warehouse (ttMLGN) record is created,
Storage Type on submit of the request or when added on the Request
(Warehouse) page, and when ‘Auto Create Warehouse’
is enabled on the Request.
Page 23 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 24 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
cCust™
This section contains configuration settings specific to cCust™.
Configure Parameters
cCust™ parameters are fields that configure the WebApp per installation. Refer to the following table for a description of
cCust™ parameters.
Parameter Group Parameter Description
Characters not permitted in the Customer Name or Description fields.
Invalid Characters
The default values are ~`!@#$%^*+|{}:<>.
Characters not permitted in the Customer Number field. The default
Invalid ID Characters
values are ~`!@#$%^*()_+|{}:"<>'.
Options Defaulted into the Country fields on the Request page and into any
Default Country default records created on the KNA1_ADRC Defaults page. The
default value is US-USA.
If checked, the Delete Archives button displays on the Delete
Enable Archive Delete Archives page to allow archives to be deleted. By default, this setting
is enabled.
SAP Instance Automatically SAP instance used by SAP when interfacing with the application.
populated
SAP Info SAP Client SAP client the application is interfacing with.
from
SAP Language cConfig™ SAP language used when interfacing with the application.
DataGarage Name of the DataGarage® database.
Automatically
populated Name of the DataGarage® database with which the application is
DataGarage Info DGConnection
from interfacing.
cConfig™
SAP Connection SAP database used by the application.
To configure parameters:
1. Log into cCust™.
2. Select Parameters from Configuration on Switchboard.
3. Click Edit .
4. Update parameters as needed.
5. Click Save .
Page 25 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Account Groups should be set up at the onset of the project and whenever a new Account Group, Company Code or Sales
Organization is added to the SAP configuration. The setup process should also be repeated when Account Group field
properties are reconfigured in SAP.
The following sections outline the seven steps required to set up a Customer Account Group.
Step 1 – Register a Customer Account Group
All customer account groups to be used by cCust™ must be registered.
To register a customer account group:
1. Click Configuration on Switchboard.
2. Select Group Registration from Account Group Setup on Vertical Menu.
NOTE: All Customer Account Groups that are valid for cCust™ must be registered on this page. cCust™ is delivered with
standard, pre-registered SAP groups. Do not delete the delivered Account Groups.
3. Click Add on the Grid Toolbar.
Page 26 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 27 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 28 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Default tables have been provided where it is logical to default data. They may be specified at four levels and are processed
in the following order:
All keys specified – Valid values populated for each key field.
Across Scenario for specified keys – Asterisk (*) populated for Scenario ID and valid values populated for all other
key fields.
Scenario specified for all keys – Valid value populated for Scenario ID and asterisk (*) for all other key fields.
Across all Scenarios and keys – Asterisk (*) populated for Scenario ID and all other key fields.
Records on the Default page write to the corresponding table. When the record is validated, all possible combinations of
default values are computed and stored in a second extended table. When a record is added, changed or deleted, the
defaults process in the background and compute the exact default values for all combinations of keys. When new key values
(e.g., Account Group, Company Code, Sales Organization) are configured in SAP and/or cConfig™, at least one default
value for each table must be validated in order to recreate the extended default tables.
Tax Category and Partner Function defaults work differently than other defaults.
On the Default KNVI page, valid Tax Categories are automatically generated when Account Group and Country are
populated. Afterward, Tax Classification can be edited for each Tax Category.
During Customer Account Group Configuration, valid partner functions for each account group are added to the
ttKNVPDefault table and become visible on the Default KNVP page. If the Partner Function is mandatory for the Account
Group in SAP, the record cannot be edited or deleted from the Default KNVP page. Non-mandatory partner functions can be
deleted or marked Recommended. Mandatory and recommended partner functions are automatically created for a Request
when a Sales record is created if that Account Group is configured to auto create partner functions.
NOTE: KNVI Defaults and KNVP Defaults are the exceptions to how cCust™ defaults are processed.
Add Default Values
To add a default value:
1. Click Configuration on Switchboard.
2. Select a default table from Defaults on Vertical Menu.
3. Click Add on the Grid Toolbar.
4. Select options from available list boxes.
Or
5. Click Insert , to manually enter a default value.
6. Click Save .
KNVI Defaults
KNVI Defaults (Tax Category) may only be configured with asterisk (*) populated for Scenario ID and valid values populated
for all other keys.
KNVP Defaults
KNVP Defaults (Partner Functions) are generated by the Account Groups setup process. Mandatory partner functions cannot
be edited on the Default KNVP page. Only the Recommended indicator can be changed for optional KNVP Default records.
Page 29 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 30 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
cVend™
This section contains configuration settings specific to cVend™.
Configure Parameters
cVend™ parameters are fields that configure the WebApp per installation. Refer to the following table for a description of
cVend™ parameters.
Parameter Group Parameter Description
Characters not permitted in the Vendor Name or Description fields.
Invalid Characters
The default values are ~`!@#$%^*+|{}:<>.
Characters not permitted in the Vendor Number field. The default
Invalid ID Characters
values are ~`!@#$%^*()_+|{}:"<>'.
Options Defaulted into the Country fields on the Request page and into any
Default Country default records created on the LFA1_ADRC Defaults page. The
default value is US-USA.
If checked, the Delete Archives button displays on the Delete
Enable Archive Delete Archives page to allow archives to be deleted. By default, this setting
is enabled.
SAP Instance Automatically SAP instance used by SAP when interfacing with the application.
populated
SAP Info SAP Client SAP client the application is interfacing with.
from
SAP Language cConfig™ SAP language used when interfacing with the application.
DataGarage Name of the DataGarage® database.
Automatically
DataGarage populated Name of the DataGarage® database with which the application is
DataGarage Info
Connection from interfacing.
cConfig™
SAP Connection SAP database used by the application.
To configure parameters:
1. Log into cVend™.
2. Select Parameters from Configuration on Switchboard.
3. Click Edit .
4. Update parameters as needed.
5. Click Save .
Page 31 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Account Groups should be set up at the onset of the project and whenever a new Account Group, Company Code or
Purchasing Organization is added to the SAP Configuration. The setup process should also be repeated when Account
Group field properties are reconfigured in SAP.
The following sections outline the steps required to set up a Vendor Account Group.
Step 1 – Register Vendor Account Groups
All vendor Account Groups to be used by cVend™ must be registered.
To register a Vendor Account Group:
1. Click Configuration on Switchboard.
2. Select Group Registration from Account Group Setup on Vertical Menu.
NOTE: All Vendor Account Groups that are valid for cVend™ must be registered on this page. cVend™ is delivered with
standard, pre-registered SAP groups . Do not delete the delivered Account Groups.
3. Click Add on the Grid Toolbar.
Page 32 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 33 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Manage Defaults
Defaults are established during implementation of the cApps™ and are used to enhance the data entry experience by
populating commonly used field with pre-set values.
The names of these default tables reference the SAP table name. Defaults are automatically populated when the
corresponding Request page record is created.
Defaults are delivered empty. It is recommended that all defaults be set up in cVend™ before configuring the application.
Always create a default record with an asterisk (*) for all keys, even if values are not specified at this level.
To configure default tables, select Defaults from the Configuration Menu on the Switchboard.
NOTE: Defaults do not copy into request records already in SAP.
Refer to the following table for details on cVend™ defaults.
Default Table Key Application Data Page
ttLFA1_ADRCDefault Scenario ID, Account Group Request (Address – General), Request (General)
ttLFB1Default Scenario ID, Account Group, Company Code Request (Company Code)
ttLFB5Default Scenario ID, Company Code, Dunning Area Request (Dunning Data)
ttLFM1Default Scenario ID, Account Group, Purchasing Organization Request (Purchasing)
Scenario ID, Account Group, Purchasing Organization,
ttLFM2Default Request (Purchasing – Alternative)
Plant
ttWYT3Default Account Group Request (Partner Functions)
Default tables have been provided where it is logical to default data. The WYT3 (partner function) defaults are generated by
the Account Groups setup process. All other defaults may be specified at four levels and are processed in the following
order:
Page 34 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
All keys specified – Valid values populated for each key field.
Across Scenario for specified keys – Asterisk (*) populated for Scenario ID and valid values populated for all other
key fields.
Scenario specified for all keys – Valid value populated for Scenario ID and asterisk (*) for all other key fields.
Across all Scenarios and keys – Asterisk (*) populated for Scenario ID and all other key fields.
Records on the Default page write to the corresponding table. When the record is validated, all possible combinations of
default values are computed and stored in a second extended table. When a record is added, changed or deleted, the
defaults process in the background and compute the exact default values for all combinations of keys. When new key values
(e.g., Account Group, Company Code, Purchasing Organization) are configured in SAP and/or cConfig™, at least one default
value for each table must be validated in order to recreate the extended default tables.
Partner Function defaults work differently than other defaults. During Vendor Account Group Configuration, valid partner
functions for each account group are added to the ttWYT3Default table and, therefore, become visible on the Default WYT3
page. If the Partner Function is mandatory for the Account Group in SAP, the record cannot be edited or deleted from the
Default WYT3 page. Non-mandatory partner functions can be deleted or marked Recommended. Mandatory and
recommended partner functions are automatically created for a Request when a Purchasing record is created if that Account
Group is configured to auto create partner functions.
NOTE: WYT3 Defaults are the exceptions to how cVend™ defaults are processed.
Add Default Values
To add a default value:
1. Click Configuration on Switchboard.
2. Select a default table from Defaults on Vertical Menu.
3. Click Add on the Grid Toolbar.
4. Select options from available list boxes.
Or
Click Insert to manually add a default value.
5. Click Save .
WYT3 Defaults
WYT3 (Partner Function) defaults are generated by the Account Groups setup process. Mandatory partner functions cannot
be edited on the Default WYT3 page. Only the Recommended indicator can be changed for optional WYT3 Default records.
And/Or
Click Purchase Org Required check box.
NOTE: If Company Code Required is selected for a Partner Function, any vendor added for that Partner Function must
exist in a valid Company Code. If Purchase Org Required is selected for a Partner Function, any vendor added for
that Partner Function must exist in a valid Purchasing Organization.
5. Click Save .
Page 36 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
cFICO™
This section contains configuration settings specific to cFICO™.
Configure Parameters
cFICO™ parameters are high-level fields used throughout the WebApp that must be configured per installation. Refer to the
following table for a description of cFICO ™ parameters.
Parameter Group Parameter Description
Characters not permitted in the Object Name or Description fields.
Invalid Characters
The default values are ~`!@#$%^*+|{}:"<>.
Characters not permitted in the Object Number field. The default
Invalid ID Characters
Options values are ~`!@#$%^*()_+|{}:"<>'.
If checked, the Delete Archives button displays on the Delete
Enable Archive Delete Archives page to allow archives to be deleted. By default, this setting
is enabled.
SAP Instance SAP instance used by SAP when interfacing with the application.
Automatically
SAP Client SAP client the application is interfacing with.
SAP Info populated from
SAP cConfig™ SAP language used when interfacing with the application.
Language
DataGarage Name of the DataGarage® database.
DataGarage Automatically Name of the DataGarage® database with which the application is
DataGarage Info Connection populated from interfacing.
cConfig™
SAP SAP database used by the application.
Connection
To configure parameters:
1. Log into cFICO™.
2. Select Parameters from Configuration on Switchboard.
3. Click Edit .
4. Update parameters as needed.
5. Click Save .
Page 38 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
cHR™
This section contains configuration settings specific to cHR™.
Configure Parameters
cHR™ parameters are high-level fields used throughout the WebApp that must be configured per installation. Refer to the
following table for a description of cHR ™ parameters.
Parameter Group Parameter Description
Characters not permitted in the Object Name or Description fields.
Invalid Characters
The default values are ~`!@#$%^*+|{}:"<>.
Characters not permitted in the Object Number field. The default
Invalid ID Characters
values are ~`!@#$%^*()_+|{}:"<>'.
If checked, the Delete Archives button displays on the Delete
Enable Archive Delete Archives page to allow archives to be deleted. By default, this setting
is enabled.
Options
Delete Archives Before Data that contrails when archives are deleted.
Finish in Background Not supported in the current release.
Defaulted into the Country fields on the Request page and into any
Default Country default records created on the LFA1_ADRC Defaults page. The
default value is US-USA.
Manual Security Update Not supported in the current release.
SAP Instance SAP instance used by SAP when interfacing with the application.
Automatically
SAP Client SAP client the application is interfacing with.
populated from
SAP Info SAP cConfig™ SAP language used when interfacing with the application.
Language
Root Organization The organization that is at the top of the organization hierarchy.
DataGarage Name of the DataGarage® database.
DataGarage Automatically Name of the DataGarage® database with which the application is
DataGarage Info Connection populated from interfacing.
cConfig™
SAP SAP database used by the application.
Connection
Tracing Trace Level Enables trace logging. By default, this setting is enabled.
Trace Log Retention Interval Number of days the logs are kept. The default value is 7 days.
To configure parameters:
1. Log into cHR™.
2. Select Parameters from Configuration on Switchboard.
3. Click Edit .
4. Update parameters as needed.
5. Click Save .
Page 39 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Page 42 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
CatalogBuilder™
Run CatalogBuilder™ for all installed cApps™ to pull in SAP translations. Refer to the CatalogBuilder™ User Manual for
detailed information.
SAP
If a view contains records that include the language aliased to boaSAPLanguage, CranSoft® displays the data in the
language defined in the user’s login language. The boaSAPLanguage feature aids clients who intend to have multiple
languages logging into the cApps™. If language-specific configuration is not maintained in SAP, the user may experience
undesirable results.
cCust™ Implementations
For cCust™ implementations, perform the following steps for every supported language:
Maintain language-specific text for Country (LAND1) in T005T. If text is not maintained for all supported languages,
some pages will not render.
Maintain language-specific text for Account Group (KTOKD) in T077X. If text is not maintained for all supported
languages, Search capability is limited.
Maintain language-specific text for all list box fields used in the application. If a text value is not maintained for a
supported language, users logging in with that language cannot select/view values for the field.
cVend™ Implementations
For cVend™ implementations, perform the following steps for every supported language:
Maintain language-specific text for Country (LAND1) in T005T. If text is not maintained for all supported languages,
some pages will not render.
Maintain language-specific text for Account Group (KTOKK) in T077Y. If text is not maintained for all supported
languages, Search capability is limited.
Maintain language-specific text for all list box fields used in the application. If a text value is not maintained for a
supported language, users logging in with that language cannot select/view values for the field.
cMat™ Implementations
For cMat™ implementations, perform the following steps for every supported language:
Maintain language-specific text for Country (LAND1) in T005T. If text is not maintained for all supported languages,
some pages may not render.
Maintain language-specific text for Unit of Measures (MSEHI) in T006A. If text is not maintained for all supported
languages, some pages may not render.
Maintain language-specific texts for all list box fields used in the application. If a text value is not maintained for a
supported language, users logging in with that language cannot select/view values for the field.
cFICO™ Implementations
For cFICO™ implementations, perform the following steps for every supported language:
Maintain language-specific text for Country (LAND1) in T005T. If text is not maintained for all supported languages,
some pages will not render.
Page 43 of 44
This document contains confidential and proprietary information and is for the privileged use of the intended client only. Reproduction is prohibited unless
authorized by BackOffice Associates. CranSoft and cApps are trademarks or registered trademarks of BackOffice Associates, LLC. Copyright 2010©
BackOffice Associates, LLC.
cApps™ Implementation Guide
Maintain language-specific text for Chart of Account Names in T004T. If text is not maintained for all supported
languages, Search capability is limited.
Maintain language-specific text for all list box fields used in the application. If a text value is not maintained for a
supported language, users logging in with that language cannot select/view values for the field.