Professional Documents
Culture Documents
Manual Coresuite Designer en
Manual Coresuite Designer en
Version 2.95
© coresystems
All rights reserved. No parts of this work may be reproduced in any form
or by any means - graphic, electronic, or mechanical, including
photocopying, recording, taping, or information storage and retrieval
systems - without the written permission of the publisher.
2 Getting Started 18
2.1 System Requirements 18
2.2 Installation 18
2.3 Getting Help 20
3 Training Guide 21
3.1 Designer - Creating a report 21
3.1.1 Planning the C ontents of a Report 21
What is the main purpose of this report? 21
Who will use this report? 22
What will be the title of this report? 22
What Information must be displayed on Page Header and Footer? 22
Identifying and Finding the correct data 23
Organizing and Processing data 23
3.1.2 C reating the prototype 23
3.2 Integrated Designer - Sharpshooter 24
3.2.1 Beginners Guide 24
C reating a Layoutdefinition 24
Overview Designer 26
C reating a Layout 27
Printdefinition 30
3.2.2 Advanced Guide 32
C reating a Data Source (Query) 32
Designing 36
C reating a Layout 37
3.3 Crystal Reports Designer 40
3.3.1 Beginners Guide 41
Adjusting a standard C rystal Report 41
3.4 Crystal Dashboard Designer (former XCelsius) 42
3.4.1 Beginners Guide 43
C reating a Simple Dashboard 44
Preview the Dashboard 46
4 coresuite accounting 49
4.1 Objectives and General Information 49
4.2 Account Mapping 50
4.3 Accounting Classes 53
4.4 Accounting Class Groups and Subtotals 57
4.5 User tables 60
4.5.1 C OR_FIN_AC C TC ORMSK 60
4.5.2 C OR_FIN_AC C TC LSGRP 61
4.5.3 C OR_FIN_AC C TGRPMSK 61
4.5.4 C OR_FIN_AC C TC LASS 61
4.5.5 C OR_FIN_AC C TC ALC DEF 62
5 coresuite cube 63
5.1 Advantages 63
5.2 Getting Started 64
5.2.1 System Requirements 64
Start SQL Server Services 65
5.2.2 Recommended Pre-Installation 65
C onfigure Reporting Services 67
5.2.3 Installation 69
Step 1 - C ube Type 71
Step 2 - Data Warehouse 71
Step 3 - ETL Database 73
Step 4 - Analysis Server 75
Step 5 - Staging Database 76
Step 6 - Source Database 77
Step 7 - Report Server 78
Step 8 - Perform Installation 79
Finish 80
5.2.4 Access to Reports 81
5.3 cube Reports 81
5.3.1 Finance 83
Excel 83
Balance 83
ProfitLoss 84
VAT 85
Report Server 86
Balance 86
ProfitLoss 87
ProfitLoss ProfitC enters 87
5.3.2 Sales 88
Excel 88
OpenSales 88
Revenue 89
SalesDocuments 90
5.4 Reference Guide 91
5.4.1 Access C onfiguration 91
5.4.2 Reporting Services advanced configuration 93
User access to web interface 93
Email Delivery 95
Deploy Reports 97
5.4.3 Subscribe to a Report 99
11 FAQ 505
11.1 Document_88 vs Document Datasource 505
11.1.1 How to use new Datasource 516
11.1.2 How to adjust VAT Subtotals 517
11.1.3 How to adjust Batch Number details 518
11.1.4 How to adjust Serial Number details 520
Index 523
1 Introduction
Would you like an AddOn that simplifies work in SAP Business One and optimizes
business processes in your company?
With the coresuite country package, you can supplement financial evaluations
optimally and change the presentation of marketing documents to meet your
requirements. Searching for data in SAP Business One will be as easy as searching
the Internet with Google and you can customize your SAP environment aligned to
your in-house processes without any high additional programming costs.
The package includes standard documents that range from quotations, order
confirmations, delivery notes and layouts to reports for CRM, sales, purchasing,
service, warehouse or production departments, and much more. With the core
suite country package all you need to do is to manage and update one single
layout for all marketing documents. Thanks to this layout system, changes can be
made within a few minutes and print jobs can be created according to the type of
document to be printed.
For technical information about the coresuite designer module see the online
guide.
More information about standard layouts and reports delivered with the coresuite
country package is available in this documentation under coresuite Layouts &
Reports
coresuite designer module Version 2.51 and higher is supported for SAP
Business One Version 2007A and higher.
12
The last valid Version for SAP Business One 2005 is coresuite designer
2.50
Finally, you can access account statements, charts of accounts, budget reports,
cash flow calculations or even just balances in a matter of seconds. Our
dashboards provide you with quick information on your business. The accounting
functionality provides you a clearer presentation of data and data grouping,
improved drill-down functionality and concrete evaluations at the level of a profit
centre, distribution rule or project. Furthermore, classification have been
introduced to give you reliable financial indicators at the push of a button.
Within the coresuite country package you receive numerous sales, accounting
and service dashboards which are created with SAP Crystal Dashboards (former
Business Objects Xcelsius). These exiting dashboards can be integrated completely
as a widget in SAP 8.8 PL 12 (or later).
Furthermore you can modify and adapt all dashboards to you personal needs.
More information about standard layouts and reports delivered with the coresuite
country package is available in this documentation under coresuite Layouts &
Reports
coresuite accounting module Version 1.5 and higher is supported for SAP
Business One Version 2007A and higher.
The last valid Version for SAP Business One 2005 is coresuite accounting
1.48.
In all of the important fields in SAP Business One (including user-defined- fields),
you can find documents and business partners within seconds, using various search
requests.
Whether you are searching for files by contact name, open quotations, tasks,
opportunities, receipts or even dates – looking for files with this search engine is a
joy!
For technical information about the coresuite enterprise search module see the
chapter coresuite enterprise search.
1 Introduction 13
The coresuite country package is the perfect tool for customizing a new or an
existing SAP Business One environment.
Have you seen a function at a presentation or on our website that you would also
like to have? No problem – in just a few clicks the function can be in your system
and will be in operation. Thanks to the simple import and export support, you have
access to all existing customize rules. Furthermore, you can tailor the existing
rules to your personalized requirements or can also create new rules with the help
of an assistant.
For technical information about the coresuite customize module see chapter
coresuite customize.
coresuite widgets
More information about widgets delivered with the coresuite country package is
available in this documentation under coresuite Widgets.
To see the latest updates of the coresuite country package, please refer to the
online change log (www.coresystems.ch/coresuite-support-changelog.html). Plans
for future changes can be reviewed online on our Road Map (www.coresystems.ch/
roadmap.html).
New explained in the guide is how to import example rules into your database.
For more details see the chapter coresuite customize > Reference Guide > Import/
Export > Import Examples
14
coresuite designer - Parameter
New since version 2.90: It is possible to define default values for a parameter so
that the parameter does not have to be defined in each Layoutdefinition which
uses the same datasource.
'[%ParamName@=DefValue]'
For more details see the chapter coresuite designer > Reference Guide >
Parameter > SQL Query Syntax
For more details see the chapter coresuite designer > Reference Guide >
Integrated Designer - Sharpshooter > Standard Functions > GetDesc
The Sales Documents (SAR06000) report which displays relevant data for selected
Sales Documents is documented.
New sinc e V ersion 2.90 is a Parameter "Inc lude doc ument Freight/Rounding" to be
able to c alc ulate Freight and Rounding from Doc ument Header in the Amounts display ed.
For more details see the chapter coresuite layouts, reports & dashboards > Sales
Reports > Sales Documents (SAR06000)
This Guide was intended as a user guide to provide a complete overview and
detailed information about the functions and content of the coresuite country
package.
This guide is structured such that it can be used as a manual or training guide as
1 Introduction 15
well as a reference book.
If it is the first time you are using the coresuite country package, we suggest you
start with the chapter Getting Started. Here you will find instructions, how to
acquire and install the coresuite country package and activate each module.
The chapter "Training Guide" is designed to be used as a Self Training Guide to get
to know the coresuite country package with detailed step by step description and
use cases.
Each module coresuite country package has its own chapter with more detailed
information like Objectives, Settings, Form Details, Reference Guides and an
overview over existing content.
1.3 Glossary
Useful tips and warnings are marked with the listed symbols below:
Icon Term
Warning
Note
Example
Sy ntax
This document also holds information about which reports and layouts are available
in all coresuite country packages some reports and layouts are created with
external designer such as Crystal Reports or XCelsius.
Country Specific Layouts and Layouts and Reports created with an external
application are marked specifically.
Designer type
16
LD - Created with integrated Sharpshooter Designer
Country specific
1 Introduction 17
2 Getting Started
Processor: Intel Pentium 4 (or comparable), Dual core processors are advantageous
Memory (RAM): 250 MB free memory
Hard Disc: 50 MB free memory
Windows XP, Windows 2003, Windows Vista, Windows Server 2008, Windows 7 –
32 Bit or 64 Bit
Runtime: Microsoft .Net 3.5 SP01
SQL-Server: Microsoft SQL Server 2005 SP3, Microsoft SQL Server 2008
Version SAP® Business One: 2007A SP1, 8.8 or higher
For detailed information about the hard- and software of SAP® Business One go to
www.sap.com or the SAP Partner Portal (requires SAP® S-User Number).
2.2 Installation
A detailed Installation Guide and Files required to install the coresuite framework
which is the base of any coresuite module can be downloaded from the core
systems website (help.coresystems.ch).
In order to get a License for the coresuite country package your system needs to
be registered on portal.coresystems.ch. Only coresuite partners can request the
licenses.
If y ou are an SAP® Partner but not a c oresuite partner c ontac t info@c oresy stems.c h
for more information on how to bec ome a c oresuite partner.
18
Once the system is registered the license can be downloaded automatically (1)
within SAP® Business One or manually imported (2) from the email sent after the
registration.
2 Getting Started 19
Each Module can be activated for the whole company (Global module configuration)
or for each user (user module configuration).
Should you have questions or suggestions about our products, please contact us at
the following address:
coresystems ag
Villa im Park
Dorfstrasse 69
5210 Windisch
Switzerland
Hotline.: +41 (0) 848 088 088
Fax: +41 (0) 56 444 20 50
E-Mail: info@coresystems.ch
www.coresystems.ch
www.coresuite.ch
For support and service please follow the described process as described on the
coresuite support website or contact support@coresystems.ch .
20
3 Training Guide
The training guide is can be used as a self training book on the different modules
of the coresuite country package.
First, you should decide upon which information should be displayed in the report.
The steps describes in the following chapter will help to plan the contents of your
report.
Reports are management tools. The purpose of a report is to allow the user to
retrieve the most important facts and connections from existing data as quick as
possible, in order to make the best decisions. A report is only helpful if the correct
data is presented in logically organized form. If the data displayed is not correct or
not structured, the report can delay the decision process or even result in wrong
decisions. Therefore, describing the purpose of the report in one or two sentences
is a good starting point when creating a report. Defining the purpose of your report
helps you focus on its fundamental requirements, and defines both the starting
point and the goal of the report. Here are some examples:
· The purpose of the report is to demonstrate the monthly and yearly turnover of
the sales department, compare current year’s sales results with those of the
previous year and identify sales employees whose results do not comply with
company's requirements
· The purpose of the report is to demonstrate the turnover of each article in stock
and present a proposition regarding the volume of repeated orders based on
3 Training Guide 21
that.
· The purpose of a the report is to calculate the average punctuation and handicap
of each member of a golf club.
Most often reports are used by many people. A detailed turnover report concerning
the whole company, for example, is useful for Sales Representatives, the regional
and national Sales Managers and the Board of Directors. Each of these parties is
interested in a different aspects of the report.
· Sales Representatives use the report to check their individual turnover and to
compare them with the results of other Sales Representatives in the same area.
· Regional Sales Managers use the report to evaluate Sales Representatives in
their area and to compare their result with those of Sales Representatives in
other areas.
· National Sales Management uses the report to evaluate sales results at a
regional level and to compare the global turnover with the current sales forecast.
· The Board of Directors uses the report to evaluate the results of the Marketing
Director and the Sales Department as a whole and to organize specific areas,
such as production needs, storage capacity, etc.
As every user of the report has different interests, it is important to plan the
report such that it will contain all the necessary information required.
Give your report a meaningful title. You might change it later. The title is only
important once creating the prototype for your report.
You can insert the printing date, the names of the people who created the report,
a written description of the purpose of the report, which areas are covered or
similar information. If you want to include such information, make a list to help
you prepare the draft of your report. Depending on the type of information you
want to display, the data can be received from a number of different sources.
· A text block can be created as text object and positioned in any desired
place in the report.
· Data about people who view and print the report can be collected from the
specific fields of the database tables. If the data is to be collected from a
database table, which one(s) are the right one(s)?
The coresuite country package will not only provide you with general information
22
such as printing date or page number but also with information about the SAP®
Business One Company or the user who prints and views the report.
The central area of the report should contain all the data required the fit the
purpose of the report. It should also contain all the necessary data for the different
users who will view the report. This step requires examining the available
database tables. The coresuite country package allows you to combine data from
different databases in order to create simple or complex reports as by
requirements of the users.
· Most data for a standard report is taken directly from database fields.
Which fields do you want to use, and where are they located?
· Other data is calculated based on database fields. Which data is used for
the calculation?
· Some other data is specific for the report and inserted as text objects
(titles, notes, definitions)
Some information of the report (for example, turnover data) can be loaded directly
from database fields; other information must be calculated from database fields
(for example, sales provisions which are calculated based on the relationship
between turnover results and ratio). When planning your report, is is useful to
separate (or to specifically highlight) the data which needs to be calculated from
the data which can be directly retrieved from the database directly.
Which information is to be highlighted in the report? You can direct the attention
of the reader towards certain data by highlighting it in your report. In the case of
stock reports, for example, all articles which have not been displaced are
highlighted, so that special attention is dedicated to them.
When you have answered all the questions in this chapter and have an idea of what
your report should look like, proceed to the next step.
Creating a prototype on paper is a good idea even for more experienced , but it
has an essential meaning for beginners. Using the drawn draft as model, you can
concentrate your full attention on getting to know the use of commands instead of
simultaneously trying to create the report and learn the functions and effects of
the design tool. This way, you can separate planning from execution.
3 Training Guide 23
1. Take a piece of paper the same size that you want the completed report to be.
2. Draw the title and other important headers; you can use rectangles and lines to
represent the different elements of the report.
3. Draw the footnote information.
4. Check if the page layout is balanced.
5. Consider the information you want to include in the central area of the report.
· Count the number of necessary fields and calculate the appropriate distance
between these fields.
· Draw rectangles to represent the fields, bearing in mind the calculated
distances.
· Change the distances if necessary.
· Establish the logic sequence in which data in the central area of the report is to
be displayed.
· In order to determine the logic sequence, write definitions for the fields
6. Use small boxes for group values and sums.
7. Randomly add some labels in the column where labels are to be displayed.
8. Write some elements which should be highlighted in bold, so that they stand out
from the rest of the report.
The following learning program was designed to provide you with basic information
required to create your first report. In this chapter we will create a simple report
which provides an overview about the business partners in SAP® Business One.
For that purpose, we will use the default coresuite designer data sources and
parameters. In the next chapter ‘Next Steps – Advanced’ we will demonstrate how
to define data sources yourself using database queries and parameters.
Creating a Layoutdefinition
The report created in this chapter refers to the Business Partner Master Data in
SAP® Business One. The first step is to define the Layoutdefinition for the
report.
· Description
24
Specify an appropriate name for your layout that describes the report best.
· Design Form Type
Here you can find predefined form types supplied by coresuite designer for all
SAP® Business One forms. Select the form type ‘Business Partner” appropriate
to your form.
· Category
This field determines category. Our report belongs to category ‘Business
Partner’.
· Layout Type
You can insert your layout type here. For our example, select ‘Document’
· Menu Position
If you want the report to appear on the SAP® menu as well, select the location
here. In our example, the report will appear in the Business Partner Reports file.
In future to access our report, select: ‘Business Partner >Business Partner
Reports > Getting Started – Beginners‘.
· Menu Description
Insert the definition which appears in the menu (see previous point).
· Use Data
Select ‘Business Partner’ as the data source for our reports. The Designer
prepares data sources for different areas.
You don’t need to fill in the ‘Queries’ separator. This separator will be necessary
in the next chapter, when you prepare data sources with your own data base
queries. Move on to the separator ‘Parameter’. Load the relevant parameters using
the button ‘get data source’. In fact, we will only need the parameter Card Code.
Select ‘Card Code’ as well for as definition for this parameter. Select ‘No prompt if
already filled’ from the parameter mode and the input sequence ‘1’. We won’t
need the remaining separators yet. Click on ‘Add’ at the lower left.
You can find further information regarding layout definition in the form layout
definition.
3 Training Guide 25
Lay outdefinition
Now open the Designer using the ‘Open Designer’ button. You are asked to insert
the Card Code. In order to be able to view the result of the report you must enter a
valid ID. In our model data base the card code C1000 would correspond to our
supplier Funsports.
open designer
If C1000 already exists in the layout definition under ‘Design Param Value’,
this entry will be shown when you access the Designer or the preview.
Overview Designer
26
oveview designer
Creating a Layout
A simple layout consists fundamentally of a page header, a data band and a page
footer.
Page Header
The header can contain information such as document names, firm logos and the
like. It is displayed at the top, as is usually the case with text processing
programs.
3 Training Guide 27
Databand
In the current example, the data band is displayed immediately below the header
and corresponds to the area which is repeated in each layout. There is a header
box and a detail box in the data band. You can name the columns in the header
box, for example, BP code, BP name and country. The entries of the queries
together with the data sources are listed in the detail box. The designer also offers
you the possibility of inserting a footer which functions in the same manner as the
header.
Page Footer
The footer is displayed in the lower section of the page. It contains information
such as author, page number, or the like.
Procedure
Select the first level from the separator ’document directory’. Afterwards, you can
write the description and the title of our report in the separator ‘properties’. The
title will appear afterwards in the layout in the place of the marker ‘Document
title’. You have different elements in the data band of your working area. You can
delete them so that only your data band remains.
Designer
Use the mouse to select the Advanced Data Band in the middle of your working
area. You can select in the list box ‘Data Source’ under the title ‘data’ from the
‘properties’ separator (on the right, on your screen). Select your data sources for
this data band. We want to display the Business Partner Details in this data band.
28
You can structure your report based on the Business Partner Details.
1. Open a header section in your data band (1). Fill in the information regarding
‘Partner Details’ in the header section using the Text box tool.
2. Open a Detail Area under the header. You can write the titles of the lines on the
left using the text tool again. You can use the copy command to copy the text
boxes and then double click to edit. The dynamic parts of your report should be
displayed on the right. Select the separator ‘Data Sources>Bands’. You will see
all the structural elements you have introduced in the data band. To move these
structural elements into the layout, click on the mouse button, drag and drop
them there.
3. If you want to see a preview, click on page preview. Make sure you entered a
correct parameter (here C1000 for the firm Funsport) when opening the
Designer. Otherwise, an empty report will be displayed.
c reate databand
After completing this data band, you can add a new data band following the above
described procedure. As data source, you can select the information of your
3 Training Guide 29
contact person, for example. To do so, select that item from the data source in
separator ‘properties’ as done in the previous example. The data band once more
features a header with the title (contact person here) and the Detail Area. The
textboxes appear in the Detail Area again, featuring the line titles and the
elements you pull out from the data source into your report.
additional databand
preview report
Printdefinition
After completing the layout, apply it to the Business Partner Form using the Print
Definition command. To do so, use the mouse button to select ‘Administration >
AddOns > coresuite designer > Print definition’ from the menu. You can easily
access the Business Partner Form by clicking on the button. To create a new
30
Print Definition, simply use the mouse to select:
The form which creates the print definitions is opened in a new window. A default
Form Type has already been defined for our Business Partner. Select form type
‘134: Business Partner’. Under language, select the option German. Set the status
to ‘active’ and then notify your form type for printing.
Using the right mouse button, insert a new line in the list box, where you can also
immediately select the layout we have created. Define 1 as the number of copies.
To save the print definition, click on the list box at the lower left side.
c onfigure printdefinition
You have just created your first layout, which can be accessed from SAP®. You
have saved both your report and the business partner form in the menu. From here
on, you will be able to access your report in two different ways:
3 Training Guide 31
Access the Report from the Menu
report, click on the symbol in the menu toolbar. In this case, you don’t need to
enter the ID, as it is entered automatically when you open the business partner.
Chapter Print Definition gives you further information on Print Definition.
This chapter describes the creation of a report using your own data source. The
difference from Beginners Guide is that here you will work with your own SQL
query.
The first step is the definition of the data source. With coresuite designer you
can use predefined data sources or create a report based on SQL query data
sources. In this first example, data is queried with SQL from SAP® Business ONE
master data.
Our report is based on business partner master data from SAP® Business One.
First of all, a table with the necessary information must be created. For that
purpose, we select the system information line under ‘View>System information’.
After that, we choose an existing business partner from the Business Partner
Master Data and drag the mouse over ‘Code’ to select it. The System Information
line will now display the name of the table. In this specific case, the name of the
table is 'OCRD’.
32
business partner master data
Next, we will create the query. For that purpose, we will use the SAP® Query
Generator under ‘Extras > Queries >Queries Generator’. You can select the tables
for our queries in the white field on the upper left area. We will use the ‘OCRD’
table and also the ‘OCRY’ table, which contains the names of the countries. Next,
click on the field ‘select’ (highlighted in yellow) and after that choose the different
parameters.
From the OCRD table choose: Balance, CardCode, CardName, Address, ZipCode
From the OCRY table choose: Name
3 Training Guide 33
SAP query generator
After the query has been executed as shown above, it can be executed using the
command button ‘execute’. SAP® Business One then executes following SQL
query:
34
result
The query can now be saved. We will click on ‘save’ and name our report ‘Business
Partners Balance’. We create the category ‘My reports’ under ‘Manage
Categories’.
3 Training Guide 35
Designing
You can access again the query you have created, through ‘Extras > Queries >
Query Manager’ or using the icon in the selection toolbar. To apply the query
in the coresuite designer, click on the list box ‘Create Report’.
c reate report
You can start a new report using the assistant. In this example, we won’t be using
the assistant, so we will close it. We will now create a new report, using ‘File >
New’ (blank report) and reject the current report.
36
The data from the query is now integrated in the layout. You can view all structural
elements from the previous query in ‘Data sources > Data sources’.
data sourc e
C reating a Layout
Document Setup
Choose the separator ’Document Directory’ on the right side and select the first
level. Next, change to separator ‘properties’. We activate the ‘Double Pass’
function (more information on this subject will be given further on) and give our
document a title and a description.
3 Training Guide 37
properties
Page Header
As it happens with regular text processing programs, we will now provide our
layout with a header. Select the page header icon from the left column and draw it
over the working area. Next, change to ‘data source > data source’ in the right
column and open ‘special fields’. Choose the document title and drag it into the
header with the mouse, keeping the mouse button pressed. The mouse becomes a
pencil and the field in which the title is to appear can be expanded. When defining
areas, bear in mind that the fields are aligned with the raster. The same will be
done with the document title. Finally, align both lines to the left and the title will
appear in bold.
38
page header
Data Band
As said, the Data Band is the area which is always repeated in your document.
First, draw the Data Band under the Header. Next, the Data Band must be coupled
with the right Data Sources. To do so, open ‘properties’ in the right column and
double click to select your business Partner’s data under ‘Data > Data Source >
B1_Data’
Following this, a Header (not repeated) and a Detail (repeated according to number
of Data Lines) are inserted in the Data Band. In this example, the titles of the
columns are placed in the Header. In the Detail area the text elements
corresponding to the Data Band are pulled out of the Data Sources into the working
area.
3 Training Guide 39
insert elements
Overview
Requirements
· In order to view any Crystal Reports in SAP® Business One prior to Version 8.8 it
is required to install Crystal Reports Runtime (CR2008). This does not require a
license and can be downloaded from the SAP WIKI SDN (Software Developer
Network)
For more detailed information on how to use Crystal Reports go to SAP Crystal
Solutions Support.
40
3.3.1 Beginners Guide
In the Beginners Guide we will demonstrate Step by Step how to make adjustments
to the DIN Layout Document DIN - CR (DOC40000) to print company specific
information on all the Marketing Documents sent to the Business Partners.
Access
3. Select the button Open Designer to launch the report in Crystal Reports 2008
The launc h of Cry stal Reports might take several sec onds. The lay out w ill be display ed in
design mode.
3 Training Guide 41
4. Adjust the report by dragging any fields required from the Field Explorer to the
appropriate location on the Report and save the changes.
5. To update the changed in the SAP Business One Database select the Save in DB
button in the Layoutdefinition
Further References
For more information regarding how to design reports with Crystal Reports go to
SAP Crystal Solutions Support.
Note
Requirements
· In order to view any Crystal (former XCelsius) Dashboard in SAP® Business One it
is required to Flashplayer. We recommend the free Adobe Flashplayer 10.0.
For more detailed information on how to use there are several Forum, Blogs and
Training Offers available online. Also review our Webinar Creating Charts and
Interact with XCelsius for a demonstration of the integration of XCelsius and SAP®
Business One using coresuite.
42
Dashboards (former XCelsius) with SAP Business One using the coresuite country
package.
Knowledge Requirements
Similar to the principles on creating a new report there are a few important steps
to consider when creating a Dashboard.
Step 1
Before starting with the design with the software create the design of the XCelsius
Dashboard on Paper. Discuss the design and Information with prospective users.
Step 2
Once the Design is decided on paper start with the design of the Dashboard in
XCelsius. Use sample data in the Excel Spreadsheet for the design.
At this point it is not yet relevant how I get the correct Data.
Create a flashfile with sample data to discuss the design in a group and gather
feedback.
Step 3
Once the XCelsius Design is completed create the SQL Queries to get the data from
SAP Business One in the correct format. Ensure that the data is returned with the
exact number of row and columns required for the XCelsius Dashboard.
3 Training Guide 43
Save the queries in SAP Business One under your own Category (do not use
"General").
Store the exact Query Name and Region in XCelsius as described in the Reference
Guide Crystal Dashboards under Data Transfer.
Step 4
Create the final SWF file and load it to SAP Business One as described in the
Reference Guide for Crystal Dashboards under the section Reference Guide ->
Crystal Dashboard Designer -> Flashfile Integration.
Simple Dashboards contain one component (for example Pie Chart, Column Chart,
Gauge,...) only. The Flash File of these Dashboards can be reused with different
datasource queries, in order to display different data, without having to change
the Dashboard design itself. Therefore there is no knowledge or access to the
Crystal Dashboards Designer required.
The Simple Dashboards are created by using one of the Sample Dashboards (or
Dashboard Containers) provided with the coresuite country package.
In the following few steps we demonstrate how to create your own Pie Chart
displaying the Top 10 Countries which made the highest Sales Revenue over the
last 12 months
Choose
>> Administration > Add-Ons > coresuite designer > Layoutmanagement
44
· Double Click on the Row Sample Pie Chart (GEN70003) to open the
Layoutdefinition of the Sample Dashboard which contains a Pie Chart
To create your own Dashboard duplicate the layout of the Sample Dashboard first
via
> Right Click > Duplicate
3 Training Guide 45
1. Enter the name "Top 10 Customers"
W hen using the Dashboard in a W idget they w ill be sorted first by Category and
Sec ond by Name. For details on the c oresuite dashboard w idget review the user guide.
3. Select the Query "SWA_LD_SYS_SAR:COR_PIE_Top10BusinessPartners" from the
Drop Down Box
Any of the Sample Queries w ith prefix COR_PIE c an be selec ted to be used in the
Simple Pie Chart Dashboard
Update the Layoutdefinition and Preview the Dashboard by selecting the Preview
Button
46
Top 10 Customers > W ith Legend
Click on the magnifier to hide the Legend and enlarge the Pie Chart.
To go back to the previous view select the information icon.
3 Training Guide 47
Top 10 Customers > W ithout Legend
48
4 coresuite accounting
The coresuite account mapping divides the accounts defined in the SAP Business
One Chart of Accounts into account classes (three-digit numbers).
The coresuite accounting has the following objectives with the new mapping
functionality:
· Overview / contraction of the key figures on one side (for example income
statement)
· Meaningful financial ratios (KPI or Key Performance Indicators)
· Due to a standardization (division into class and class groups) it will be easier to
poll more complex financial ratios such as liquidity levels, profit margins, etc.
The goal is to provide all responsible personal with the help of these
classifications and the resulting Key Performance Indicators (KPIs) a holistic
overview of the enterprise in short time.
· Standardized financial reports for SAP® Business One customers that look the
same for all customers (various industries, various countries, several companies
in a corporate group). This enables a comparison between each other.
4 coresuite accounting 49
· Sums and consolidated data, which cannot be modified. This results in less
issues for the customers (no or few support cases).
It is ensured in coresuite accounting that most of the financial reports will work
as well without the mapping configuration. However, the user will not be able to
benefit from the advantages of the correct configuration.
General Information
Each account must be assigned to one class (three-digit number). If a class is not
used, it will not be used or displayed in reports. It is also possible that certain
classes are not relevant for individual countries. In this case, the affected class
can be ignored. Below is an explanation of the "Mapping Form":
50
It is possible to select several lines. As soon as a selected line is mapped,
all other selected lines are automatically mapped as well.
The class codes are pre-installed and should never be changed. The class
tables are managed by the coresystems ag. Suggestions for adjustments
and improvements are very welcome. When upgrading coresuite
accounting the tables will be overwritten with the possibly modified or
improved standard tables.
In order to view all assignments of the current client select the button "Mapping
Overview". The various groups are explained in the next chapter of this manual.
4 coresuite accounting 51
Not assigned accounts
Account that are not assigned will be highlighet at the beginning or the Mapping
Report as shown below:
52
4.3 Accounting Classes
For the financial reports all accounts are assigned to a specific class (three-digit
number). These classes are assigned fix to a class group (four-digit number
assigned). This assignment cannot be changed. Subtotals (two-digit number) are
calculated according to the class groups and classes. Any financial report, which is
named with "KPI" (Key Performance Indicators), is based on the account allocation
in classes.
Below is a list of all classes and a brief explanation which account type should be
assigned to the appropriate class.
Assets
Current assets
120 : Investments
Short-term investments, which are easily recoverable
190 : Prepayments
4 coresuite accounting 53
Prepaid expenses and not yet received income (deferred and accrued assets)
200 : Stocks
Stocks in general, including finished and semi-finished goods and raw materials
210 : Investments
Long-term financial assets (including investments, awarded loans)
Trade Creditors
290 : Accruals
Not yet paid expenses and income received in advance (deferred and accrued
assets)
54
300 : Provisions
Short-term liabilities, which are still uncertain (reason, date or amount)
350 : Capital
Share capital, issued capital
Turnover
500 : Sales Revenue
Revenue from the sales / distribution / retail, etc. ( "general" sales class)
505 : Services
Option to additionally divide revenues into services
4 coresuite accounting 55
Internally produced and capitalised assets
560 : Utilities
For example rent, energy, cleaning
570 : Tax
For example industrial or motor vehicle tax
580 : Insurance
For example company insurance (excluding motor vehicles)
620 : Freight
For example packaging, freight, sales commissions, warranty costs
"Control Cost Accounting" can be used to transfer costs from the indirect
cost (class group: Total Costs) in direct costs which will be posted to the
gross profit. Examples are salaries or rent, which clearly can be assigned
directly to a turnover.
56
630 : Depreciation
Depreciation on investments (loss due to retirement)
SubTotals
SubTotal: Assets (10)
The sum of all assets
4 coresuite accounting 57
SubTotal: Own Capital (30)
Sum of the assets minus liabilities (debts / obligations)
Class Groups
1000 : Cash at Bank and In Hand
Banks and cash
58
1010 : Trade Debtors
Short-term debts (domestic, foreign, intercompany)
1030 : Prepayments
Prepaid expenses and not yet received income (deferred and accrued assets)
1040 : Stock
Sum of all stocks
1090 : Capital
Share capital, subscribed capital
5000 : Turnover
Operational revenue from the core business, including stock changes and
capitalised service
4 coresuite accounting 59
5025 : Salary and Benefits
Salary, social insurance, other charges
5035 : Depreciation
Depreciation of assets
The following chapters focus on the user tables which are created during the core
suite country package installation.
Only fields most relevant for the basic understanding will be explained.
COR_FIN_ACCTCORMSK
COR_FIN_ACCTCLSGRP
COR_FIN_ACCTGRPMSK
COR_FIN_ACCTCLASS
COR_FIN_ACCTCALCDEF
4.5.1 COR_FIN_ACCTCORMSK
Field descriptions
60
CoreMask subtotals
Purpose
With the help of these fields, the name of the subtotals is made available to the
coresuite accounting module.
4.5.2 COR_FIN_ACCTCLSGRP
Field descriptions
Purpose
With the help of these fields, the name of the class groups are made available to
the coresuite accounting module.
4.5.3 COR_FIN_ACCTGRPMSK
Field descriptions
Typ "P" is used for Profit and Loss (P&L) and "B" is used for
balance sheet.
Purpose
With the help of these fields, the coresuite accounting module can provide simple
Key Performance Indicators (KPI) such as "Gross Profit" without the full completion
of the class mapping.
These fields are also responsible for a standardised breakdown in P&L and balance
sheet.
4.5.4 COR_FIN_ACCTCLASS
Field descriptions
4 coresuite accounting 61
ClsGroup the class group (four-digit code)
Purpose
With the help of these fields, the coresuite accounting module can provide
standardised and country independent simple KPI Reports.
The field for the multi-language functionality allows for the naming of the classes.
4.5.5 COR_FIN_ACCTCALCDEF
Field descriptions
Purpose
With the help of these fields, the coresuite accounting module knows where to
place the subtotals in the KPI reports.
62
5 coresuite cube
With coresuite cube you extend your existing ERP by an efficient Reporting
component. coresuite cube allows the analysis of data by mouse click and without
programming knowledge. Evaluations are fast processed, topically available and,
besides, visually attractive.
5.1 Advantages
Thanks to the Drag and Drop function the data can be evaluated fast and simply.
Putting together of own reports is very easy. As soon as your evaluation has the
desired form, the settings can be stored locally and you can access at it
Subscribe Evaluations.
Your supervisor needs the weekly product turnovers, the production manager the
stocks at the end of the month and the administrative council the liquidity
overview per quarter. Quite simply: Subscribe for your tailor-made report. The
5 coresuite cube 63
desired evaluation with topical information is automatically dispatched by mail.
Manual interventions become superfluous.
Speed
coresuite cube is a multidimensional data cube. All data are stored away in pre
aggregated values and the access needs only minimum arithmetic achievement.
This brings you the advantage that, e.g., complicated evaluations about several
years are processed in short time.
Find relevant information about how to get the coresuite cube running on your
system.
The following products and shared features must be available in the mentioned
Version.
Function Product
Source Database (SAP · SQL Server 2005 Standard Edition or higher
Business One company · SAP Business One 2007A SP01 or higher.
Database(s)) · coresuite country package with an updated
version of the accounting module installed for at
least one user (only for finance cube)
64
Function Product
· Reporting Services 2008 SP2 for the Reports
created with the report server, R2 not supported.
In general it is rec ommended to use the latest servic e pac k levels to avoid any
c omplic ations. (SQL 2008 R2 Management Tools or at least Native Client 10.5)
The SQL Server Analysis, SQL Server Agent and Browser Services can be started in
the Services on the Server.
5 coresuite cube 65
For data security and performance reasons it is strongly recommended to install a
dedicated BI instance to store the Data Warehouse Database, which is the central
database that collects relevant data from the SAP Business One company database
(s). This enables you to create user-defined access to different cubes and data.
Instanc
Function e Features
Name
Productive SAP Any Database engine only
database,
coreStage
For more the information on how to install a second SQL Server Instance and
configure security refer to the Microsoft SQL Server documentation.
Basic configuration required in order to install the coresuite cube is available in the
chapter Configure Reporting Services some more tips on how to configure the
Microsoft Reporting Services is available in the chapter Reference Guide >
Reporting Services advanced configuration
· User access to web interface
· Email Delivery
· Deploy Reports
· Subscribe to a Report
For additional the information on how to install and configure the Microsoft
Reporting Services 2008 refer to the Microsoft SQL Server documentation.
66
Configure Reporting Services
First ensure that the SQL Server Reporting Services are installed and running. See
also chapter Start SQL Server Services.
If the SQL Server w as installed w ith the default settings the database w as c reated
already
5 coresuite cube 67
4. Specify SMTP settings according to the customer's needs and environment
6. For the installation of the cube you will need the Report Server URL which can be
configured under the Web Service URL: "http://servername/
reports_instancename"
68
5.2.3 Installation
The coresuite country package includes the installation wizard for the coresuite
cube that can be executed from within SAP Business One under:
Main Menu --> Administration --> Add-Ons --> coresuite Administration --> core
suite cube
5 coresuite cube 69
The cube is installed in 8 simple steps.
70
Step 1 - Cube Type
Enter the relevant information for the Data Warehouse which is the central
database that collects relevant data from the SAP Business One company database
(s) and click Next to continue.
After selec ting Next to proc eed the c onnec tion w ill be tested. Is is required that the
SQL Server Analy sis, SQL Server Agent and SQL Server Brow ser Servic es are running to
proc eed further.
See the c hapters Start SQL Server Servic es and for details.
5 coresuite cube 71
Further description
It is required to enter the SQL Server connection information where the database
will be automatically created by the installation wizard. For more flexible security
settings we recommend to install the Data Warehouse Database on a second
named instance of the SQL Server (see Recommended Pre-Installation for details).
Field Description
SQL Server Instance Enter the Name of the of the SQL Server including
(*) (SQL Server named SQL Instance.
name\SQL Instance
name) If there is only one loc al SQL Server instanc e enter:
loc alhost
Mandatory
information If there w as an SQL instanc e c reated for the data
w arehouse enter: loc alhost\bi
W here "bi" is the name of the instanc e c reated for the
data w arehouse.
SQL Username (*) Enter the Username to connect to the SQL Server.
The user must has full administrator rights.
Mandatory
information
SQL Password (*) Enter the Password for the user to connect to the
SQL Server.
Mandatory
information
72
FromDate (yyyymmdd Optionally set a filter for the data to be transferred
) from the company database(s) to the Data
Warehouse for Reporting.
Optional The FromDate is the earlist reference date of the
information
postings which will be transferred.
Enter the relevant settings for the Mail alert of the ETL Database and click Next to
continue.
5 coresuite cube 73
Further description
ETL (Extract, Transform, Load) is the process to Extract data from different
sources and transform this data into a unique format to finally Load it into the
Data Warehouse.
Field Description
Mail alert ETL Select this Checkbox to receive Mail alerts of expired
expired facts facts of the Sales Cube.
(Checkbox)
Spec ify if y ou w ant to get informed about deliveries,
Only available for invoic es, returns or c redit memos w hic h are
sales c ube -- deleted or c anc elled in the sourc e database.
-- based on this notific ation, y ou are provided w ith the
ability to c orrec t inc orrec t
-- data c aused by the sourc e sy stem manually .
74
Step 4 - Analysis Server
Enter the relevant settings for the Analysis Server and click Next to continue.
Further description
The Analysis Server will process the data and update the data warehouse with
actual data.
Field Description
Analysis Server Enter the Name of the of the SQL Server of the
Instance (*) (SQL Analysis Server Instance.
Server name\SQL
Instance name) W e rec ommend to use the same SQL Server as the
SAP Business One c ompany database server.
Mandatory
information If this is a loc al installation leave the default:
loc alhost
5 coresuite cube 75
Step 5 - Staging Database
Enter the relevant settings for the Staging Database which is the is the storage
area and click Next to continue.
Further description
The Staging Database is the storage area of the cube. Here the source data from
the SAP Business One Company Database is cleaned, transformed, combined and
prepared for the Data Warehouse.
Field Description
SQL Server Instance Enter the Name of the of the SQL Server including
(*) (SQL Server named SQL Instance.
name\SQL Instance
name) W e rec ommend to leave the default settings and use
the SAP Business One c ompany database server.
Mandatory
information
SQL Username (*) Enter the Username to connect to the SQL Server.
The user must has full administrator rights.
Mandatory
information The user must has full administrator rights.
SQL Password (*) Enter the Password for the user to connect to the
SQL Server.
Mandatory
information
76
Step 6 - Source Database
Enter the relevant settings for the Source Database which is the SAP Business One
Company Database and click Next to continue.
Further description
The Source Database is the SAP Business One Company Database from which the
data is gathered for reporting.
Field Description
Source Database (*) Select an available Database from the Drop Down
(Drop Down Box) Box. This will be the database from which the data is
gathered for the reporting.
Mandatory
information The original Database w ill not be modified.
Display Name (*) Enter the name for the Database to be displayed in
(Text Box) the reports.
Mandatory
information
Import Time ( Enter the time when the import of the data is
yyyymmdd) started.
5 coresuite cube 77
installation.
Enter the relevant settings for the Report Server and click Next to continue.
Further description
Field Description
Optional
Report Server URL Enter the correct URL of the Report Server where the
(*) reports should be installed. See also chapter
Configure Reporting Services for more information.
Mandatory
information if the
reports should be
installed
78
Step 8 - Perform Installation
Select which items (Data warehouse, ETL Database, Staging Database, Reports) to
install and click Next to continue.
Further description
In the last step select which items to install. Here you can decide to leave out
certain functionality or install other at a later stage.
Field Description
5 coresuite cube 79
Reports (Checkbox) Select this Checkbox to install the reports for the
Microsoft Reporting Services 2008 included in the
coresuite country package.
Finish
80
5.2.4 Access to Reports
Once the installation is completed a new Main Menu entry is created in the SAP
Business One Menu from which the cube reports can be launched.
The menu is split in the different cube types (e.g. Finance, Sales) and then in the
different Report Types (Excel and Report Server).
The following Reports for the coresuite cube are included in the coresuite country
package
Usage and
Name Content Description
Menu entries
Balance Overview of the Balance on Accounts To display the form
(Excel) from the Main
Menu
Select cube -->
Finance --> Excel --
> Balance
5 coresuite cube 81
Usage and
Name Content Description
Menu entries
ProfitLoss Profit and Loss Statement To display the form
(Excel) from the Main
Menu
Select cube -->
Finance --> Excel --
> ProfitLoss
82
Usage and
Name Content Description
Menu entries
Revenue Revenue Overview To display the form
(Excel) from the Main
Menu
Select cube -->
Sales --> Excel -->
Revenue
5.3.1 Finance
Find details to all standard reports for the finance cube in this chapter.
Excel
Reports created with Excel are opened in the external application Microsoft Excel.
Data can be dynamically analysed via Pivot Tables.
Balance
Purpose
Overview of the Balance on Accounts
Preview Sample
5 coresuite cube 83
ProfitLoss
Purpose
Profit and Loss Statement
Preview Sample
84
VAT
Purpose
VAT Overview
Preview Sample
5 coresuite cube 85
Report Server
Reports created with the Report Server are open internally in SAP Business One.
Balance
Purpose
Overview of the Balance on Accounts
Preview Sample
86
ProfitLoss
Purpose
Profit and Loss Statement
Preview Sample
Purpose
Profit and Loss Statement by Profit centers
5 coresuite cube 87
Select cube --> Finance --> Report Server --> ProfitLoss ProfitCenter
Preview Sample
5.3.2 Sales
Find details to all standard reports for the sales cube in this chapter.
Excel
Reports created with Excel are opened in the external application Microsoft Excel.
Data can be dynamically analysed via Pivot Tables.
OpenSales
Purpose
Information about Open Sales
Preview Sample
88
Revenue
Purpose
Revenue Overview
Preview Sample
5 coresuite cube 89
SalesDocuments
Purpose
Overview about all Sales Documents
Preview Sample
90
5.4 Reference Guide
This chapter explains more advanced settings to configure and use the coresuite
cube
The predefined role "Brow sers" is already c onfigured for ty pic al needs.
If you wish to add additional roles, this can be done with SQL Server Management
Studio.
5 coresuite cube 91
3. Navigate to the "Browsers" role and open it's Properties
92
5.4.2 Reporting Services advanced configuration
5 coresuite cube 93
4. Choose "New Role Assignment" and enter an active directory user or group that
shall be allowed to access the web interface.
5. Choose role "Browser". Hit "OK".
6. Navigate back to the directory "Data Sources" and open it's properties pane.
7. Go to "Security" and edit the element's security.
8. Remove the users or group you created before. These users do not need to see
your data sources.
94
Your Report Server's basic security settings are configured.
Email Delivery
To provide individual E-Mail subscriptions to your user's, the following steps must
be accomplished.
3. Restart the Report Server via services.msc (see also chapter Start SQL Server
Services) or the Reporting Services Configuration Wizard.
This sc hedule c an be used by y our users for automated report delivery via E-Mail.
5 coresuite cube 95
3. Hit "OK"
To provide your users with subscriptions, the execution account for the specific
data source must be stored on the report server.
96
4. Save your settings.
Deploy Reports
Prerequisites
MS SQL Server Business Intelligence Development Studio is installed on your server
Deployment guide
5 coresuite cube 97
1. Open the following file: "C:
\Temp\coresuite\sales_cube\sales\resources\reports\coreReports_Sales.sln"
2. Adjust both data sources "DS_Sales_OLAP" and "DS_Sales_OLTP" to the
appropriate settings.
98
4. Deploy the whole project to your report server.
5. Check the following URL: "http://servername/reports_instancename". Two new
folders must appear (Data Sources and Sales)
Subsc ribe to a report if y ou w ant the report server to provide y ou w ith the latest
reports automatic ally .
If y ou don't c hange the c onfiguration settings, the server w ill automatic ally send y ou an E-
Mail w ith the report attac hed as a PDF.
5 coresuite cube 99
1. Open the Report Server's web interface with your Internet Explorer (http://
ServerName/Reports_InstanceName).
2. Open the report you want to subscribe to.
3. Hit "New Subscription"
4. Adjust the subscription form and choose a shared schedule or define your own
schedule if you want to do so.
100
5. Hit "OK".
Y ou c an manage y our existing subsc riptions in the "My Subsc riptions" area of
Reporting Servic es.
The coresuite customize module is powerful tool to implement new business logic
and change the look and behavior of SAP® Business One forms. To implement this
we use so called "customize rules". There are 3 ways to create these rules:
102
2. Use the examples delivered with the coresuite country package and make
adjustments if required.
More information on how to get the examples is available in the Reference
Guide under Import Examples.
More information on each examples is available in the Reference Guide under
Installed Examples.
3. Use the right click wizard to create simple rules like mandatory fields, colored
fields, field placement and more.
More information on the functions of the right click wizard is available in the
Reference Guide under Right Click Wizard.
The following chapters describes the forms, that are created by coresuite
customize and where all rules can be defined and adjusted.
104
6.2.1 Optimizer
The mask coresuite customize Optimizer has the function of creating new and
working on already existing rules. What a rule is and how this operates will be
described in the chapter Usage more precisely.
Every row corresponds to a rule and every column is therefore a feature of the rule.
The columns will be described mire precisely in the following. You will find examples
for Optimizer in chapter Usage.
With "Add row" / "Delete row" ("Duplicate row" only available in the right click
menu) new rows can be added and marked rows can be deleted. Changes are only
effective, when the button "Update" has been pressed.
The columns are kept in terms of color, so that the individual areas can be structured
and therefore distinguished.
These columns contain general settings. Preferably these columns shall be filled
first, because some of the following columns depend on their selection.
1.
Chart description
Name of the Description
column
Name of the Name of the rule. Enables differentiation of the rules ( the list
rule will be sorted by this name). The name should be inimitable.
Type The type decides the execution type of the rule. There are 4
different types:
- 0: CSCode(c# Code)
- 1: VBCode (Visual Base Code)
- 10: SQL (Structured Query Language)
- 20: RegEx (Regular Expression)
Action This column defines the action, which shall be accomplished.
This is especially important for the type 'SQL'. With 'Change
Values' a return value from the SQL Statement can be written
into a field.
- 0: Validate (Check)
- 1: Change Values (Change values, only for SQL!)
Name the rules usefully (for example with logogram for the maker)! It
helps you to find them easier later on.
Warning messages can be defined in the red area, which are being displayed at a
possible false function of the rule. A false function must not mean, that a rule was
compiled wrongly. It can come up to a false function, when the checking of a field
with RedEx fails, in other words when the field doesn't correspond with the
requested values.
106
Chart description
Name of the Description
column
Only warning States, whether a warning shall be issued, in case the check
fails. The user can continue working as usual.
Text of the The text, which is being issued in a warning. This text can be
warning translated to different languages. To do so you need the
translation parameter syntax from the coresuite designer. More
information in the chapter Translation Parameter.
Status bar States, whether a warning shall be shown as a status bar. The
message status bar message appears as a red bar at the bottom edge of
SAP® Business One.
If „Only Warning“ has not been chosen, the action will not be
accomplished. In this way it can be prevented, that a data base is
added or a field abandoned, until the corresponding condition has been
fulfilled.
These three columns serve the purpose, to define a base element. A value can be
Chart description
Name Description
ItemUID Base Item UID of the base elements (see definition: ItemUID of the
elements).
If it es a matrix or a grid, the column description must be
indicated additionally.
Column Base Column description of the base element (empty, when not used)
In this area the element is being specified, which starts the rule. In addition to the
element of triggering, the EventType, BeforeAction and the FormModus must be
selected as well.
All events, which are found in SAP® Business One, can be chosen as EventType
(see definition: Events in SAP® Business One). The mode of a form is a further
parameter for specification (for example, only events while adding a data base).
108
Chart description
Name Description
110
When „ALL“ has been chosen, it doesn't matter what state it is.
MODIFY contains ADD and UPDATE.
Attention at combing elements with events. Not all events through the
same events. E.g. a button doesn't have a ValidateEvent!
The most important column is the expression column, in which is being defined,
what should be checked in particular. It's not possible to edit it directly. Through a
click on the button, through a double click on the column or on the row button an
editor opens (according to the selected type from the chapter General Settings
(Blue) ). The individual editors are being explained in chapterEditors.
Code Editor
This editor opens, when either 'CSCODE' or 'VBCODE' has been chosen in the column
'Type'. The code editor allows writing normal C# or VisualBasic code, which will then
be compiled and executed when the corresponding event is triggered. In order to
validate the code, it can be parsed (using the third symbol from the left).
Compiling errors will then be shown. The code will be accomplished in a method in
a help class. The „pVal” object can be used and provides the following properties:
It's important, that a Boolean-value returns to show if the validation was successful
or not. ("return true;" or "return false," at the end)! „False” means the validation
was not successful and SAP® Business One will abort the started action. If global
variables or classes (see chapter Extended Code) are used, these may be accessed
here as well.
112
By clicking on „Save” (first symbol from the left), the code is written into the
„Expression”-field.
Editor Description
Functions
RegEx Editor
The regular expression editor is also opened by double-clicking the correct cell. The
editor allows you to select a template (e.g. email address) or an expression can be
written into the „Expression”-field. The „Example Value”-field allows you to test
SQL Editor
If the type SQL is selected, a double-click on the „Expression”-field will open the
SQL editor. A special feature, is that parameters can be defined.
For example: To use the CardCode of the current form in the SQL statement you
can use the following syntax:
[%G;4]
More information in selecting parameters can be found in chapter Select parameter
.
114
If a value is validated, the validation will be unsuccessful, if NULL or an empty
value is returned. Everything else will be interpreted as a successful validation!
Every row corresponds to a rule and every column is therefore a feature of the rule.
The columns will be described mire precisely in the following. You will find examples
for Item Placement in chapter Usage.
With "Add row" / "Delete row" ("Duplicate row" only available in the right click
menu) new rows can be added and marked rows can be deleted. Changes are only
effective, when the button "Update" has been pressed.
116
Invisible Visibility of the element, which will be relocated (checked ==
invisible)
Assistant
The assistant provides the possibility to see the property of an existing field in
SAP Business One. The properties are written to the status bar -> see screenshot).
Use double click to insert the field directly into the Item Placement.
Every row corresponds to a rule and every column is therefore a feature of the rule.
The columns will be described mire precisely in the following. You will find examples
for Function Button in chapter Usage.
With "Add row" / "Delete row" ("Duplicate row" only available in the right click
menu) new rows can be added and marked rows can be deleted. Changes are only
effective, when the button "Update" has been pressed.
Chart description
Name Description
Active States, whether a row is active or not.
Description Describes the function.
Type Type of the function:
118
- CSCode, c# Code sequence
- VBCode, Visual Basic Code sequence
- Shell, Shell order (as the commando row order)
Name Name, which shall be shown. This text can be translated to
different languages. To do so you need the translation parameter
syntax from the coresuite designer. More information in the
chapter Translation Parameter.
Form Type FormType, which shall be placed on the button. More then one
FormType can be indicated, they must be separated by a comma.
Picture path Path for a picture (JPG or BMP, 16x16 Pixel), which will show in
the right click menu.
No button Shall the function be lodged to a button or only be visible in the
right click menu.
Printout Executive function, click on the arrow or double click on the cell
will open the Editor for the editing.
The code editor as well as the relevant code sequences can be opened as well as
written with a click on the arrow or a double click on the column 'Expression' (see
chapter Editors).
The primary function of the mask coresuite customize New Items is to compile
new and handle already existing rules. What a rule is and how it works is described
more precisely in chapter Usage.
Every row corresponds to a rule and every column is therefore a feature of the rule.
The columns will be described mire precisely in the following. You will find examples
for New Items in chapter Usage.
With "Add row" / "Delete row" ("Duplicate row" only available in the right click
menu) new rows can be added and marked rows can be deleted. Changes are only
effective, when the button "Update" has been pressed.
Chart description
Name Description
Active States, which row is active or not.
Item Type Selection on the type of the element
120
ComboBox is a DropDownList
ExtendedTextEdit is a text field, which allows more then one rows
Assistant
The assistant provides the possibility to see the property of an existing field in
SAP Business One. The properties are written to the status bar -> see screenshot).
Use double click to insert the field directly into the Item Placement.
122
6.2.5 New Menu
Every row corresponds to a rule and every column is therefore a feature of the rule.
The columns will be described mire precisely in the following. You will find examples
for New Menu in chapter Usage.
With "Add row" / "Delete row" ("Duplicate row" only available in the right click
menu) new rows can be added and marked rows can be deleted. Changes are only
effective, when the button "Update" has been pressed.
Chart description
Name Description
Active States, whether the row is active or not.
Description Description of a new menu point.
Menu name Name of the menu point (will be shown). This text can be
translated to different languages. To do so you need the
translation parameter syntax from the coresuite designer. More
information in the chapter Translation Parameter.
Menu type Type of the menu. There are 3 different menu types:
The Code Editor can be opened and the corresponding Code sequence written with
a click on the arrow or a double click on the column 'printout' (see chapter Editors).
124
6.2.6 Extended Code
Simple problems may be solved using code in simple methods, as described in the
chapter Optimizer. Bigger problems on the other hand may be to complex for this.
For these problems, the menu point „Extended Code” provides the possibility to
define global variables and classes. In this menu point, global variables and classes
can be defined, which you can have access from everywhere. Also the „Using”
import can be set here, so you do not need to write the complete namespace every
time. Further explanations about the code, can be found in chapter Basic course
Code.
There are two programming languages available: C# and Visual Basic. The
ComboBox on the right top allows you to select your corresponding code version.
A double-click on the field „Usings” and „Script” will open the editor from the Code
Editor chapter and allows you to edit the corresponding code.
It is not possible to access VB code with C# code nor the other way
round.
Chart description
Name Description
Using Using-declarations, allows using other namespaces
Script Global code
Realise in States, whether the editor with the error code description will
Debugmode be shown when run-time errors occur.
Code Type Selection between C# and VB code
The mask Export fulfills its name and serves the purpose of exporting the core
suite customize rules from the SAP® Busniess One system. Thereby all rules are
being written in a file (File with the ending *.cocu).
Exportformular
With one click on „Export“ all data from the database will be fetched and saved
into a file with the ending *.cocu (coresuite customize). The exact process of the
exporting is being explained under coresuite customize -> Referenec Guide ->
Import/Export -> Export rules.
Chart description
Name Description
126
6.2.8 Import
The mask Import serves the purpose of downloading rules from a file. Thereby all
rules are being written into a file (File with the ending *.cocu). The exact process
of an import is being described under coresuite customize -> Reference Guide ->
Import/Export -> Import rules.
Chart description
Name Description
Import (Button) Takes over the selected rule into the data base.
Import This rule will be imported, when the tick has been set.
(Column)
Overwrite When the tick has been set, an already existing, same named
rule will be overwritten with anew rule.
A notification confirms the number and the success of the takeover of the rule.
Delete rules
If you want to delete a lot of rules at once, you can click on the button "Delete
rules" in the import-form. A new form shows the different modules, which can be
marked with a tick each. ALL rules of the ticked modules are being deleted when
clicked on "Delete".
6.2.9 Authorization
Every rule of every module can be activated or deactivated for every user. That
means that certain rules can be set as active for certain users. coresuite
customize creates therefore 15 new user groups in the SAP Business One
authorization folder (Group 1, Group 2, ... Group 15).
128
You can now define the rights for this 15 groups for every SAP Business One user
(Full / No Authorization).
After this declaration you can now set the authorizations for every coresuite
customize rule (see below). If you don't use the coresuite customize authorization
all rules are for all users activ.
Here are some examples for the programming with C# , which will simplify the
handling with coresuite customize.
Additional information about developing with SAP Business One is available on the
official SAP developer homepage (sdn.sap.com).
The SAP Business One SDK objects can be retrieved using the following code:
' VB .Net
Dim application As SAPbouiCOM.Application = customize.B1Connector().Application
Dim company As SAPbobsCOM.Company = customize.B1Connector().Company
// C#
SAPbouiCOM.Application application = customize.B1Connector.GetB1Connector().Appli
SAPbobsCOM.Company company = customize.B1Connector.GetB1Connector().Company;
130
Matrix
Select values
If one wants to select a value from a form, first of all one has to know, which type,
the to be selected element, it is.
In SAP® Business One there are following element types:
After selecting the value, this value will be in the variable "value" (string == Text
variable)
With the element CheckBox you get a Boolean-Wert back (Boolean == true or
false), whether the checkbox has a tick or not.
With the help of the code editor you are able to create your own SAP elements
(Textfields, DropDownBoxes). Every element has the same base, there are only a
few specific attributes which can be set.
// Set position with the help of a reference element(textfield with uid '4')
te1.SetSizeAndPosition(TextEdit.GetFromUID(pVal.Form, "4"));
te1.Top += 20;
// Set additional attributes (depends on type, look for more details in the SDK o
te1.AffectsFormMode = false; te1.FromPane = 98; te1.ToPane = 98
// Add the new element to the form (current form == 'pVal.Form') and refresh the
pVal.Form.AddItems(te1);
pVal.Form.Update();
Create Grid
With the help of a grid you can display a list of results from a SQL query.
132
try
{
// GRID, WILL CONTAIN THE VALUES TO DISPLAY
SwissAddonFramework.UI.Components.Grid grid = SwissAddonFramework.UI.Component
grid.Width = 380; grid.Height = 260; grid.Top = 5; grid.Left = 5;
// LOAD FORM
form.Load();
// YOUR QUERY
string query= "SELECT ItemCode, ItemName FROM OITM";
This code creates a SAP form with a list which will be filled with the results of the
query ("SELECT ItemCode, ItemName FROM OITM").
Row Description
string query= "SELECT ItemCode, ItemName
Query which will fillsFROM OITM";
the list. Replace it with your
own one!
grid.Columns["ItemCode"].Editable = "ItemCode"
Sets the row false; and "ItemName" to 'not-
grid.Columns["ItemName"].Editable = false;
editable'.
This function can be set on a new menu (with the modul NewMenu) or a function
button (with the modul FunctionButton).
For advanced developers coresuite customize allows the user to import custom dlls
compiled with the .NET Framework 2.0.
To import a custom DLL correctly the user needs to follow the procedure here
described.
Be sure that the .DLL you're going to import has been compiled with .NET
Framework 2.0.
If you are using MS® Visual Studio you can check the version in the Solution
Explorer Properties
134
If your .DLL has not been compiled with .NET Framework 2.0 please recompile it.
Zip the COR_Customize folder and rename it with a unique name. We suggest to
assign to the .zip file the same name as the .dll.
Change the extension of the package from .zip to .sip.
You are now able to import your .sip file using the coresuite Administration menu
under Administration -> Add-Ons -> coresuite administration -> Administration
.
Please check the coresuite Installation Manual on how to import .sip packages.
Once coresuite has been restarted you will be able to use the imported .dll into
your customize rules.
6.3.3 Editor
136
6.3.4 FormType
Every document (or mask or window) in SAP® Business One has a clear
characterisation, named FromType, which are mostly numbers. With the help of
these numbers, a print layout (coresuite designer) or a rule for a function (core
suite customize) can be permanently determined on a document.
Finance
Description FormType
Accounts code 804
Journal posting 392
Posting pre-acquisition 229
Allocation to an account sample 800
Continuant posting 670
Exchange rate balance 370
Conversion balance 372
Finance report template 704
Document print 184
Opportunities
Sales
Decription FormType
Offer 149
Customer's order 139
Delivery 140
Retoure 180
Outgoing payment condition 65308
Outgoing payment invoice 65300
Outgoing invoice 133
Outgoing credit 179
Outgoing advanced invoice 60091
Purchase
Description FormType
Order 142
Goods inward 143
Retoure 182
Receipt payment condition 65309
Receipt payment invoice 65301
Receipt invoice 141
Receipt credit 181
Receipt advanced invoice 60092
Goods debut price 992
Business partner
Description FormType
Business partner historical data 134
Activity 651
Warehouse management
Description FormType
Article master data 150
Goods inwards 721
Goods outwards 720
Stock rearrangement 940
138
Production
Description FormType
Stock list 672
Production order 65211
Receipt of the production 65214
Output of the production 65213
Service
Description FormType
Service call 60110
Historical data customer equipment 60150
Service contract 60126
Solution database 60120
Personal
Description FormType
Employees historical data 60100
The import/export of already existing rules will be executed through a file with the
ending *.cocu.
The following two chapters explain the process of imports and exports.
The exact form descriptions as well as functions of the individual fields or columns
are being elucidated more precisely in chapter Export and Import.
Import rules
Import
The file can be read in the following submenu:
Administration -> AddOns -> coresuite customize -> Import / Export -> Import
140
The *.cocu file can be chosen (1) and opened (2). The File Dialog will be closed
after that and all existing rules will be loaded into the list. The list can be extended
depending on how many rules there are. In the status bar you can see, the number
of rules, which are already loaded in the list.
The button "Delete" will delete all rules of the selected module (4).
The "Examples" button offers the possibility to import the examples which are
shipped with coresuite customize.
142
Import Examples
When installing the latest Version of coresuite customize on a new system the
sample rules are already installed but not activated.
When upgrading the system the new or updated example rules are not
automatically installed to prevent that existing rules are overwritten. In order to
get the new rules and/or the latest version of a rule you can import them from the
Import Form.
Select --> Administration --> Add-Ons --> coresuite customize --> Import / Export
--> Import Rules
As soon as all rules are displayed, the rules, which should be imported, can be
selected in the column "Import" (3). If a rule with the same name already exists,
the old rule can be overwritten by selecting the checkbox in the column "Overwrite"
(4).
By click on the button "Import" (5) the selected rules will be imported. A
notification will confirm the success as well as the number of deleted (overwritten)
and imported rules.
Export rules
In order to export created rules in a file, open the window "Export", which can be
found under:
Administration -> AddOns -> coresuite customize -> Import / Export -> Import.
144
As soon as the window is open, all existing rules will be filled into the list (1),
which has been sorted according to the modules. A status bar shows, how far
advanced one is (in percent).
When all rules are loaded, the requested rules can be selected by the column
"Export" (2). One click on the button "..." (3) opens a FileDialog, in which the
location and name of the file can be determined, in which the rules will be written.
Through a click on the button "Export", the export process can be started (4), if
one is content with the selection and has chosen a location on the hard disk.
In order to delete rules, there is a possibility to delete all rules form an area at
once. On the implementation mask there is a button "Delete rules" (4) for that.
By clicking on "Delete", the rules of the clicked modules are definitely deleted.
146
Import Excel rows to UDT
This functionality allows the user to import data from an Excel Sheet to a User
Defined Table.
The columns to import must have the same name as the fields name into the
target user defined table. Furthermore the data type for such column must match
the field type.
In the following example the user wants to import the columns Country, Zip , City,
StateName and State.
The target user defined table can be selected from the combobox on top of the
form.
Clicking on "Browse .xls file" the user can select the Excel file to import.
Clicking on "Import .xls file" the system check the correspondence between the
column names defined into the Excel file and the UDT. All the column that match
are highlighted in orange.
148
At this stage the user can confirm the import or refuse it.
Clicking on "YES" the import process will start. In the status bar the user can
observe the line currently imported.
RollBack Option
The user has the possibility to decide either to confirm or delete the inserts if an
error occurs.
Enabling the "Rollback on error" option all the inserts executed since the error
occurred will be rolled back.
Disabling the "Rollback on error" option all the inserts executed since the error
occurred will be committed into the UDT.
Form Optimizer
Name Description
BUP:0004: Do not allow * in business partner name Doesn't allow characters of
type * in field name on the
business partner form
BUP:0009: Validate email address on BP Validates the email address
on business partner form
BUP:0010: Validate website on BP Validates the website
address on business
partner form
BUP:0011: Increase card code Copies the business
partner billing address to
the delivery address. If a
delivery address is selected
it will be copied to the
billing address. The function
is available directly on the
business partner form.
DOC:0002: Show Business Partner Info Shows a message box with
business partners remarks
when choosing the
business partner on sales
and purchase documents.
The remarks are taken from
150
the text in the field or the
folder "Remarks" of the
business parter form.
SRV:0003: Show Business Partner Info Shows a message box with
business partners remarks
when choosing the
business partner on a
service call form. The
remarks are taken from the
text in the field or the folder
"Remarks" of the business
parter form.
GEN:0001: Wallpaper Generates a dynamic
wallpaper including the
company name, shortcuts
and other usefull
information. The wallpaper
is generated during the
SAP Business One startup.
ITM:0005: Do not allow * in item name Doesn't allow characters of
type * in field name on the
item form
ITM:0006: Do not allow * in item group name Doesn't allow characters of
type * in field name on the
item group form
ITM:0007: Do not allow * in warehouse code Doesn't allow characters of
type * in field code on the
warehouse form
ITM:0008: Do not allow * in warehouse name Doesn't allow characters of
type * in field name on the
warehouse form
152
The examples can be copied and adapt to provide a quick start with
coresuite customize. These examples are tested against the SAP
demo databases and are shipped without any warranties.
Additional settings can be made if an example rule is opened with the Editor. The
examples provide an introduction and a settings part.
At the creation of rules for the module ItemPlacement and New Items, the
assistant helps with additional information.
Press the button "Assistant on" to activate it (available on the masks of Item
Placement and New Items ). Now there's the possibility to get to know the
characteristic of any element by a click on the particular element (will be displayed
on the status bar -> see Screenshot). This element with all it's parameters will be
entered into the list through a double click on this element.
A strength of SAP® Business One is the link between independent data. In this
manner the relevant business partner or the item details can be opened with one
click on an orange arrow.
Description Value
No target object. -1
User-defined object. 0
G/L account object. 1
Business Partner object. 2
Item object. 4
Sales employee object. 53
Transaction template. 55
Journal Posting object. 30
Loading Factor object. 62
Recurring Transaction object. 34
Product Tree object. 66
Check for Payment object. 57
Payment Terms object. 40
Deposit object. 25
Predated Deposit object. 76
Warehouse object. 64
Import File object. 69
Budget System object. 78
Sales Tax Authorities object. 126
Sales Tax Codes object. 128
Run External Application object. 86
Due Date objects. 71
User Defaults object. 93
Financial Period object. 111
Sales Opportunity object. 97
Confirmation Level object. 120
Confirmation Template object. 121
Confirmation Document object. 122
Draft object. 112
154
Goods Issue object. 60
Goods Receipt object. 59
Project Code object. 63
Contact object. 33
Journal Voucher object. 28
Profit Center object. 61
Vendor Payment object. 46
Receipt object. 24
Quotation object. 23
Order object. 17
Delivery Note object. 15
Delivery Note Return object. 16
Invoice object. 13
Invoice Credit Memo object. 14
Purchase Order object. 22
Goods Receipt PO object. 20
Goods Return object. 21
Purchase Invoice object. 18
Purchase Invoice Credit Memo object. 19
Correction Invoice object. 132
Stock Transfer object. 67
Work Instructions object. 68
Alerts Template object. 80
Special Prices object. 85
Customer/Vendor Catalog Number 73
Special Prices object. 7
Serial Numbers for Items object. 94
Item Batch Numbers object. 106
User Valid Values object. 110
User Display Categories object. 114
Address Format object. 113
Indicator object. 138
Cash Discount object. 133
Delivery Type object. 49
VAT Group object. 5
VAT Indicator object. 135
Goods Shipment object. 139
Expense Definition object. 125
Credit Card object. 36
Business Partner Central Bank Indicator object. 161
Business Partner Bank Account object. 187
156
6.3.9 PaneLevel
At the processing of the surface view from SAP® Business One you will meet the
term PaneLevel (PL).
PaneLevel is a term, which has been invented by SAP®. It's being represented by a
number (e.g. 6) and is a character on a window(e.g. Business partner historical
data).
It helps, to show the different information fields on individual folders.
Furthermore every element has two specifications: "From PaneLevel" (FromPane)
and "To PaneLevel" (ToPane). Therewith it is possible to define, when an element
is being shown or not.
An example
The mask "Business partner historical data" has altogether 8 folders. Each of these
folders covers a PaneLevel. By a click on this folder, the PaneLevel of the mask will
change and only these elements will be shown, which are assigned to this
PaneLevel.
The register "General" for example represents the PaneLevel 1. All elements, which
are shown in this folder, have "From PaneLevel=1" and "To PaneLevel=1". If one
changes to another folder, e.g. "Contact person", the PaneLevel will change to 3
and the elements will be faded in, which contains the number 3 between "From
PaneLevel" and "To PaneLevel".
The head as well as the bottom information has the character "From PaneLevel=0"
An element with "From PaneLevel=1" and "To PaneLevel=4" will be shown in the
folder "General", "Contact person" and "Character".
The character of an element (among others "From PaneLevel" and "To PaneLevel")
can be shown with the Assistenten, which is available in the forms ItemPlacement
and New Item.
General 1
Contact partner 3
Character 4
Remark 5
Payment term 6
Addresses 7
Payment system 8
Accounting 9
Purchase data 1
Sales data 2
Stock data 3
Character 4
Remarks 5
General 6
Planning data 7
158
Folder PaneLevel
The coresuite customize right click menu allows a quick configuration of SAP
Business One. The menu is only available to SAP super user. To enable / disable
the menu for the current user click in the SAP main menu on "Enable / Disable
Wizard" .
160
Add CFL
On a new created field on the main form we want the user to select a value from a
list instead of just typing in a random value.
Click with the right mouse button on the field you want to add a ChooseFromList
(CFL = list of values, the user can select, which pops up when he/she presses the
'TAB' key). Choose now in the coresuite customize sub menu "Add CFL".
There will be a pop up where you can specify the query of which the result will be
shown and the write back column.
Field description
Name Description
Query The results of this query will be shown in a new window. It
makes sense to develop the query in the query generator and
then copy-paste it here in the text field.
Write back Specify the column which will be written back to the field on the
After your selection you have to press "OK" and the window is going to be closed
and reopened again. When you now press tab on the field the ChooseFromList is
being opened.
The user can now select a line in the list and the value in the 'write back column'
will be written back into the field on the main form.
162
To remove the ChooseFromList you can click with your right mouse button on the
field and choose 'coresuite customize' -> 'Remove CFL'
A new folder is in need (e.g. in order to display UDFs on the main window or
additional information).
Click with the right mouse button on the folder you want to add an additionally
folder. Choose now in the coresuite customize sub menu "Add folder".
There will be a pop up where you can specify the description of the folder.
After you entered a description for the folder and pressed "OK" the window is going
to be closed and reopened again and you see your new folder.
164
If you don't need the folder you can remove the folder by just right clicking on it
again and hit 'Remove folder'
166
Color field
The background of a field (for example Label, Textbox, ComboBox, ...) should be
changed to a different color.
Click with the right mouse button on the field where you want to change the color.
Choose now in the coresuite customize sub menu "Color field".
To choose the color a color picker is displayed after clicking the menu.
168
The background color can be reset using the right click menu.
A field (for example Textbox, ComboBox, ...) must contain a value before adding a
new document.
Click with the right mouse button on the field which should be made mandatory.
Choose now in the coresuite customize sub menu "Make field mandatory".
As soon as the user tries to add the document the following message appears.
170
The mandatory field can be removed the same way as making it mandatory.
Hide field
Hide a field (for example Label, Textbox, ComboBox, Folder, ...) to make it
invisible to the user.
Click with the right mouse button on the field which should be hidden from the
user. Choose now in the coresuite customize sub menu "Hide field".
Hidden fields can be make visible again by using the right click menu.
172
Lock field
Lock a field (for example Textbox, ComboBox, ...) to make it unchangeable for the
user. The field can only be changed in the form Add mode.
Click with the right mouse button on the field which should be locked. Choose now
in the coresuite customize sub menu "Lock field".
174
Move an element
A field of SAP Business One is on a wrong place / has the wrong size / shall not be
displayed at all.
As an example, the invoice receiver address from the register "Logistic" will be
moved to the head of the document.
ItemUID 6
From 0
PaneLevel
Until 0
PaneLevel
RunAsCode Yes
176
Form Type 139
ItemUID 7
Left 360 (depends on the user settings and the resolution)
Top 85 (depends on the user settings and the resolution)
Width 135 (depends on the user settings and the resolution)
Height 35 (depends on the user settings and the resolution)
From 0
PaneLevel
Until 0
PaneLevel
RunAsCode Yes
Relative data can be made for the parameter Left, Top, Width and
Height, e.g. +20. The new value is then the old value +20.
If no information has been made, the element will keep it's initial
characteristic.
Click with the right mouse button on the field you want to move. Choose now in
the coresuite customize sub menu "Move Field".
There will be a pop up where you can specify the new parameters.
Field description
Name Description
Reference Item ItemUID of the field which will be the reference point in the
window (e.g. the 'Document Due Date' is 46). To turn the system
information on, please activate it under 'View -> System
178
Information'
After your selection you have to press "OK" and the window is going to be closed
and reopened again and you see your new field.
To put the field back to the position it was before you can click with your right
The window is going to be closed and reopened again and you see that the field is
being set back to the original position.
Click with the right mouse button on the UDF you want to move to the main form.
Choose now in the coresuite customize sub menu "Copy UDF to main window".
There will be a pop up where you can specify the new parameters.
180
Field description
Name Description
Description Description of the field (how it's going to be labeled). You can
use the translation from the Text-Table from the coresuite
designer, e.g. '[@T0150000]' for the name 'Picklist'. For a list of
all T-Codes see 'Tools -> Default Forms -> SWA_LD_TEXT - Text'
.
Reference Item ItemUID of a label which will be the reference point in the
(Label) window (e.g. the 'Journal Remark' on the folder 'Accounting' is
19). To turn the system information on, please activate it under
'View -> System Information'
Factor If you have selected above or below, this number defines the
number of times of the placement.
E.g. 'Above' and 'Factor 3' means, that the UDF will be placed
three times above the reference item.
Visibility Only on current folder: The new field will only be visible on the
current folder, if you click on a different folder it will be not
visible
Always: The new field will be always visible, e.g. if you want to
place the field on to the header or footer section of the
document or if there are no folders at all.
After your selection you have to press "OK" and the window is going to be closed
and reopened again and you see your new field.
182
The window is going to be closed and reopened again and you see that the field is
being removed.
6.3.11 Rule
What is a Rule
A rule is a term for a specific function, therefore a check, calculation or change in
SAP® Business One. Each module of coresuite customize consists of rules, which
is being represented through a row in the list at a time.
Example: Rule which generates a new card code before saving the business
partner.
184
6.3.12 SAP Window
All windows in SAP® Business One (Forms or mask as well) have a height and a
width. These will be quoted in pixel. The starting point (0,0) is on the top left of
the window.
There are different types of windows. Some have a static size (Business partner in
SAP® B1 2005), some can be enlarged or belittles by the user.
Eigensc haften eines Fensters und eines Textfeldes in SAP Business One
[%TYPE;ITEMUID;COLUID;ROW;KEY]
Name Description
COLUID If the element is a matrix (== List, e.g. on the sales document of
UID 38), then the column can be indicated, from which it shall be
selected.
ROW If the element is a matrix (== List, e.g. on the sales document of
UID 38), then the row can be indicated, from which it shall be
selected (if nothing is indicated, the current row will be picked).
KEY If the element is a ComboBox (== Selection list), then the key
can be selected with 'K'. A ComboBox always consists of a key
and a value. Mostly the value will be shown, but the key will be
saved (e.g. "Swiss Francs" is visible, but CHF is written in the
database) (If nothing else is indicated, the value (visible) will be
picked).
The square brackets are being used as a beginning and a end characterisation
Start: [%
End: ]
Some examples
Description
Selection of a business partner code from a sales document [%G;4]
Selection of a currency (CHF) from a sales document [%G;63;;;K]
Selection of a column (Amount) of a row (1) from a sales [%G;38;11;1]
document
186
Selection of a column (Amount) of the current row from a sales [%G;38;11]
document
If the parameter selection isn't enough to get to the requested target, there is the
possibility, to let everything being run per code. Thereby one has more
possibilities, but looses on the account of the performance.
All text definitions in the module coresuite customize can be translated with the
help of the coresuite designer. This includes the following fields:
[@T0000001]
The value T0000001 represents the key for the Text-Table. The Text-Table can be
found in the menu Tools -> Default Forms -> SWA_LD_TEXT - Text
Depending on the language of the current user, coresuite customize takes the
translated text.
188
6.3.15 User defined Tables
coresuite customize creates UDT, in which the entered information are being
saved.
COR_CUSTOM_FIELD
COR_CUSTOM_FUNCB
COR_CUSTOM_NEWITEMS
COR_CUSTOM_NEWMENU
COR_CUSTOM_GSCRIPT
COR_CUSTOM_PLACE
The two rules a) and b) can be created using the Optimizer form. An example is
already installed coresuite customize is used the first time.
a)
Module Optimizer
Type REGEX
Action Validate
Text of the warning Please indicate telephone number
Status bar message Yes (clicked)
FormTyp of the basic 134
elements
ItemUID of the basic 43
elements
FormType 134
190
ItemUID 1
b)
Module Optimizer
Type REGEX
Action Validate
Text of the warning Please indicate a valid email address
Status bar message Yes (clicked)
FormType of the basic 134
elements
ItemUID of the basic 60
elements
FormType 134
ItemUID 1
Event Type ItemPressed
Before Event Yes (clicked)
Form Modus MODIFY
Printout ^\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$ (equal
to template "Email")
For detailed information on all functions and settings on the forms for the core
suite designer module under the Administration module of SAP® Business One
review the chapter Form Details.
Once you use the coresuite designer module and need specific information about
the functions and settings, the chapter Reference Guide will be helpful. This
chapter includes tips and advanced functions for the coresuite designer.
This chapter presents a full description of all the windows for the coresuite
designer.
Access
194
To display the Default Form for the Texts, Parameter or Form Types settings
window choose
>> Tools > Default Forms > relevant menu entry
The Text List c an also be ac c essed from a Report under >> Administration > Add-Ons
> c oresuite designer > Text List (GEN00001)
The default form for Texts, Parameters or Form Ty pes c an also be ac c essed from the
Func tions Button from the Lay outdefinition or the Printdefinition.
7.1.1 Configuration
General Settings and Functions are defined in the Configuration Window of the
coresuite designer module.
Access
196
· DMS - Not in use any longer
· Editor - Define general settings for the coresuite editor
General
Description
Text Displays the default language for the translations. This language is
Language used when language is selected that is not available. To change the
Textbox language see details for the register Text.
(read-only)
Log Queries Select this Checkbox to write all SQL queries executed when
Checkbox viewing coresuite reports and layouts in a Textfile under
%temp%/swald/%companyname%/queries/query.txt.
This function should not be activated during productive usage as it
may cause performance issues.
Force Select this Checkbox to always use the default printer and
Default overwrite all settings under the Layoutdefinition > Printer settings.
printer
Checkbox
Set Print - Select here after which action(s) the print flag (Printed = 'Y') for a
Flag when Marketing and Inventory Documents in SAP® Business One is set.
Checkbox · Printing: Print Flag is updated after printing a document (default
option)
· Emailing: Print Flag is updated after the document was sent via
Email
· Faxing: Print Flag is updated after the document was sent via
selec ted.
Text
Description
Text Select a language from the Drop Down Box to change the main
Language language used for the multi language Text Codes.
Drop Down
After c hanging the main language w e suggest to reinstall all texts to
Box
198
prevent a mixture of languages as basis
Export Export Texts created and translated in the company to an XML file
Button
Import Import Texts and translations from an XML file
Button
Importing new texts overw rites any existing texts and translations
and adds additional texts and translations.
The defaults texts delivered w ith the c oresuite c ountry pac kage are
stored under the SAP® Business One Client installation folder. Example:
Preview
Description
Preview Select one of the available options to define the size of the preview
Window Drop window once a user selects the Preview in SAP® Business One
Down Box
1 - Normal
2 - Maximized
Opens the preview window in full screen size
3 - Minimized
Opens the preview window and minimizes it immediately (in the
lower left section of the window)
4 - User
Opens the preview window in the same size the user closed it the
last time
100% Select this Checkbox to display the layout always in 100% mode
Checkbox instead of fitting it into the window
Install
Description
Reinstall Select this button to start a reinstall for the coresuite designer
button module. This will install any missing Parameters, Formtypes,
200
Layoutdefinitions or Printdefinitions.
Selec t this func tion in c ase there are any issues during the
installation of the c oresuite c ountry pac kage or if any lay outs or reports
Select Grid
Description
Only relevant if there is more than one Selec t Grid defined in the
Lay outdefinition.
Only relevant if there is more than one Selec t Grid defined in the
Lay outdefinition.
Description
Preview Mail Select an available option from the Drop Down Box to define the
Mode Drop default mode when the user select to send an e-mail button from
Down Box SAP® Business One.
202
The Smtp settings are ac tivated onc e they are selec ted in the e-mail/Fax tab of a
Printdefinition.
Startlayout
Description
User Drop Select the user from the Drop Down Box for who the layout should
Down Box be started automatically once coresuite is started.
Layout Drop Select the Layout from the Drop Down Box which should be loaded
Down Box automatically once coresuite is started.
The manager w ants to see the Servic e Dashboard every day so the Dashboard w ill be
Description
User Drop Select the user from the Drop Down Box for which the Batch Print
Down Box Job should start
Alert Drop Select an SAP Business One Alarm notification from the Drop Down
Down Box Box that should be executed
PrintMode Select the Print Mode to be used from the Drop Down Box. Available
Drop Down modes are:
Box - Preview
- Print
- Email
- Fax
- PDF
Parameter Enter the Path for Remote Printing in this Text Box.
Scan-Path
Text Box
Intervall Enter the amount of minutes for the interval how often the Batch
[min] Text Print Job should be executed.
Box In order for the changes to take effect a restart of the coresuite
Add-On is required.
204
Editor
Description
Write back Select this Checkbox to write back <BR/> when a new line is
<BR/> for entered in the coresuite editor.
Newline By default the Checkbox is not selected.
Checkbox
Preserve Select this Checkbox to preserve spaces in the coresuite editor.
Spaces By default the Checkbox is not selected.
Checkbox
7.1.2 Layoutmanagement
Access
To display the Layoutmanagement window choose
>> Administration > Add-Ons > coresuite designer > Layoutmanagement
Filter Section
To display only the relevant Layout- and Printdefinitions in the Browser apply the
appropriate Filter.
Description
206
Type Drop Select a Type to filter the displayed Layout- and Printdefinitions by
Down Box this Type. Available Types are
Status Drop Select a Status to filter the displayed Layout- and Printdefinitions
Down Box by this Status. Available Status are
Only after the Filter Button is selec ted the defined Filter is applied to
the list in the Brow ser Sec tion.
Browser Section
Category All results displayed in the Browser are grouped first by the
Column category defined in the respective Layout- and Printdefinitions.
Double Clic k on the Marker to expand / c ollapse the Grid and display
/ hide all Print- and Lay outdefinition under this Category
Form Type All results displayed in the Browser are grouped second by the Form
Column Type defined in the respective Layout- and Printdefinitions.
Double Clic k on the Marker to expand / c ollapse the Grid and display
/ hide all Print- and Lay outdefinition under this Form Ty pe
Double Clic k on the Marker to expand / c ollapse the Grid and display
/ hide all Lay outdefinitions w hic h are assigned to this Printdefinition
208
displayed in this column.
The column is empty if the Layout- or Printdefinition is user-
defined.
Sys Checkbox If the Layoutdefinition is delivered with the coresuite country
package and will be automatically overwritten with the latest
Version available it is called a System Definition. This Checkbox
marks which Layoutdefinitions are System Definitions.
Action Section
The Action List displays all single actions to be performed once the Execute Button
is selected. Select an row in the Browser and click on the respective Action Button
(described below) to add an action to the action list. To remove an action from the
list Right Click the corresponding row and select Delete Row from the Context
Menu.
Description
The progress of the exec ution of all ac tions w ill be display ed in the
messages.
210
Export
Once the Execute Button is selected and any of the Actions in the List are of type
Export a new Window will open to define the Export Settings for each Layout- and
Printdefinition.
Description
Your Enter your company prefix (Namespace) here. This will simplify the
namespace Optional Code entry.
Textbox
Optional new Enter the new unique codes for each Print- and Layoutdefinition
Code Column here.
Import
To import any packages which include Print- or Layoutdefinitions follow the steps
described below:
If the V ersion from the Export File differs from the one y ou are w orking w ith an
w arning Message w ill pop up.
Once the Export File is loaded a window will be displayed to adjust the import
settings for the 4 Objects
- Queries
- Layouts
- Printdefinitions
- Texts
212
Description
Import Select a Query Category which will be used to store the Queries to
Queries to import.
category
Drop Down Selec t "Auto assign" to generate the same Query Category as in the
Sy stems the queries w ere exported from.
Box
Exists This Checkbox is selected in case the Layout- or Printdefinition
Column with the same name already exists in the database.
(Read-Only)
Set all Select an Action Type from the Drop Down Box that will be applied
actions to to all Layout- and Printdefinition in the Import Package. The Action
Drop Down Type can be set for each layout afterwards accordingly.
Box There are 3 Action Types:
- Add new: Always adds the Layout- or Printdefinition new to the
database.
- Overwrite: Overwrites the Layout- or Printdefinition in case it
already exists.
- Ignore: The corresponding Layout- or Printdefinition is not
imported.
W hen selec ting "Add new " all Referenc es (e.g.: Lay out1 linked to
Lay out2) w ithin the Import Pac kage are automatic ally adjusted
Action Select an Action Type from the Drop Down Box that will be applied
Column with to the corresponding Layout- or Printdefinition
Drop Down There are 3 Action Types:
Boxes - Add new: Always adds the Layout- or Printdefinition new to the
W hen selec ting "Add new " all Referenc es (e.g.: Lay out1 linked to
Lay out2) w ithin the Import Pac kage are automatic ally adjusted
If Text Select an Action Type from the Drop Down Box that will be applied
Already to the Texts in the Import Package that already exist in the
exists Drop Database.
Down Box There are 3 Action Types:
- Add new: Adds all Texts new to the database.
- Overwrite: Overwrites the existing Texts.
- Ignore: The existing Texts are not imported.
Execute Select this button to open the start the Import of the Queries,
Button Texts, Layout- and Printdefinitions from the Import Package. A
message will be displayed to show the status of the Import:
7.1.3 Layoutdefinition
Access
214
Lay outdefinition > General Information
Description
Name Enter a name of the Layoutdefinition in this Textbox that describes
Textbox the Report best. We also advise to enter a unique code in order to
find and determine the report later on.
Category Select an appropriate Category from the Drop Down Box here. This
Drop Down will influence the available selection of predefined Datasources as
Box described below.
Design Select an appropriate Formtype from the Drop Down Box.
Formtype Formtypes for standard SAP® Business One forms are always
Drop Down available. Formtypes for User Forms can be created as described
Box under coresuite designer -> Form Details -> Form Types and will
then also be available to select. Displayed is the unique id and the
name of the Formtype.
Example: If y our report w ill display data about a spec ific Business
Partners, selec t the form ty pe ‘134 Business Partner’. Relevant Codes and
data is then taken from this Form.
For general Reports which are viewed from a Menu Entry rather
than a specific form it is not required to select a Formtype.
Type Drop Defines the type of layout. The following Selections are available:
Down Box · Master Layout - Select this type when the layout is to be used as
Master Layout in the Sharpshooter designer. See here for more
detailed information.
· Document - No special effect on the layout
216
Queries
To create your own data sources you can save them in the SAP Business One Query
Manager and attach them to the layout definition in the Queries Tab.
To attac h a new query add a new row by right c lic k on the Grid Header and selec ting
Add Row
Description
Query 1 Select an available Query from the Drop Down Box to be used in the
column with report.
Drop Down
Boxes All queries saved in the Query Manager are available to selec t. They
are sorted first by Query Category and then by Query Name
Query 2 Select a subquery when required.
column with
Drop Down The first query returns information about the c ompanies Employ ees
(name, telephone number, etc ). If y ou w ant to display the latest Sales
Boxes
Orders of the c orresponding Employ ee, a subquery to return the data
from the Sales Order(s) must be c reated.
Link Field 1 This Text Box is only relevant when a subquery is selected in the
column with Query 2 column.
Text Boxes Enter a Field returned by the Query selected in the Query 1 Column
in this Text Box which will be used to link to the subquery.
Example for the key of Ow ner of a Sales Order doc ument s linked to
the Employ ee Master data is: Ow nerCode
My Form Displays the form type if the layout is used as Select Grid.
Type column
with Drop
Down Boxes
(Read-Only)
Title column Displays the title if the layout is used as Select Grid.
Parameter
In order to allow the user to filter the data display in the report or change the look
of the report, parameters can be defined in the Data Source Queries or used in the
layout itself. In order to use and fill these parameters the relevant data has to be
entered in the Parameters Tab of the Layoutdefinition.
Description
Get from Select this button to automatically fill the list of Parameters from
Datasource the Parameters defined in the Data Source Queries
button
Parameter Select an available Parameter from the list. The name and type of
combo box the parameter selected has to match the parameter defined in the
datasource.
Description Enter your own description of the parameter. It is displayed when a
text box user opens a report and can be translated by using Text Codes
218
Choose from List: {SELECT X , Y FROM TABLE}
Combo Box: [value1;desc ription1;value2;desc ription2]
Parameter Select a Parameter Mode from the list. The options are:
Mode combo · default
box default setting
· No Prompt if already filled
When a parameter has been defined by an activated form, for
example, when you are already working on a business partner,
the ID is automatically provided as a default parameter and does
not have to be entered additionally.
· Always use design value
The parameter from is always opened even if a parameter was
provided
Input Order Enter a value here in order to display the Parameter Form to the
text box user. When several Parameters are displayed they are order
alphabetically by the values entered here.
History check Select this checkbox to enables the parameter input history. That
box means the last entered values in the Parameterform will be saved
and displayed the next time you run the report.
If the checkbox is not selected the value defined in the Design
Param Value with always be displayed.
the user to selec t by w hic h Sales Employ ees or Ac c ounts the data should be filtered in the
report.
The Parameter Doc Entry for marketing doc uments or CardCode for Business Partners
is automatic ally provided w hen launc hing the report from the open form.
Alw ay s enter a value in the c olumn Input Order, even if there is only one parameter
to display . If nothing is entered the Parameter Form w ill not be display ed to the user.
To add a new parameter add a new row by right c lic k on the Grid Header and
selec ting Add Row or selec t the Get from Datasourc e button to enter all parameters
defined in the Queries attac hed to the Lay outdefinition.
To c reate y our ow n parameters, open and edit the parameter form w ith the func tion
button.
Further information
For more details on how to create and use Parameters see the Parameter chapter
in the Reference Guide.
Further information and tips to the layout can be added in the Details Tab. This
information will then also be displayed in the Parameter Form to the user.
Printer
Numerous printer settings can be defined with the coresuite designer. Several
printer cells and others can be assigned to the layout. For example, in the case of
invoices, a receipt of payment can be added as last page.
Description
User combo Select the users for who the settings in this row should be applied.
box If nothing is selected the settings are valid for all users.
Copy text Enter the number of copies to be printed from a print definition in
box Print definition.
printer ‘A’ and the other by printer ‘B’, then tw o lines c an be c reated. In
one line, c opy = 0 is entered (and printer A) and in the other line, c opy =
Page combo Define the page for which the settings in this row should be
220
box applied. Available options are:
Formtype Select one available form type for which the settings in this row
combo box should be applied. This is useful when one layout is the basis for
different form types.
The DIN Lay out is used for AR Invoic e, Delivery , Purc hase Orders,...
Free Text Enter a Free Text that can be used as a parameter provided by the
text box Printdefinition here.
Tw o printing orders (e.g. a Sales Order and a Produc tion Order) are
to be exec uted w ith one lay out, the free text ‘prod’, for example, c an
be added in the definition. This variable enables y ou to define variations
to the normal Sales Order lay out in the Designer.
Lang combo Select the language to overwrite all other language settings for this
box printer.
Choose Select this Checkbox to display the Settings Window of the Printer.
Check Box
Printer text This field displays the selected printer…
box (read-
only)
P combo box ...which can be selected from this column.
Tray text box This field displays the selected tray...
(read-only)
P combo box ...which can be selected from this column.
Backside Select the Layout that should be printed on the Backside of the
Layout report.
Combobox
Users
Only c ertain users are allow ed to view c ertain financ ial reports or dashboards.
External Report
All settings relevant for external reports such as Excel, Word, Crystal Reports or
Dashboards are defined in the External Report Tab.
Description
Data Export Select an available Export Format from the Drop Down Box.
Format Drop Depending on the Export Format different settings for the External
Down Box Report will be displayed or not.
The following Export Formats are available:
· No Export
· Excel / Word - use this Format to prepare the data to be used in
Excel / Word
· CSV File(s) - use this Format to prepare the data to be used in
Excel / Word
· Crystal Reports XML - use this Format to prepare the data to be
used in Crystal Reports
· XCelsius XML - use this Format to prepare the data to be used in
Crystal Dashboards (former XCelsius) keeping the query name as
defined in SAP Business One
222
· Simple XCelsius XML - use this Format to prepare the data to be
used in Crystal Dashboards (former XCelsius) renaming the query
name to SWA_LD_Data_X where X is the number of the query
starting with 1
· DataSet XML - use this Format to store the data in a DataSet
XML file
· DataSet Schema - use this Format to store the data in a DataSet
Schema file
Company/ Select this Checkbox to export additionally the Company and User
User information of the current database.
Checkbox
Parameter Select this Checkbox to export additionally the System and Layout
Checkbox Parameters of the current Layoutdefinition.
Text Select this Checkbox to export additionally the Texts in the
Checkbox corresponding language.
Refresh Enter the number of seconds for the time interval to refresh the
[seconds] data.
Text Box
Only relevant for Dy namic Reports suc h as Cry stal Dashboards
(former X Celsius)
Generate Select this Checkbox prevent launching the preview when the data
Data Only is generated.
Checkbox
Can be used to view a dashboard from an external applic ation suc h
as Flashplay er. The Lay outdefinition itself c an then be set as Startlay out
so that the data is generated as soon as the c orresponding user starts the
c oresuite add-on. In this c ase the user might not w ant the dashboard
itself to open but only to generate the data.
File Path Select the Browse Button to attach an existing File used when
Text Box launching the Preview/Print/Email... Function in SAP Business One.
with Browse
Button
Use Design Select this Checkbox when an additional Design File is used. When
File this Checkbox is selected the file under the Use Design File text
Checkbox Box is opened when selecting the Open Designer Button.
W e rec ommend to alw ay s use this option. For more details refer to
the referenc e guide Deploy Data for External Report
Do not forget to save any c hanges in the Database by selec ting this
Remove from Select this Button to Remove the File used when launching the
DB Button Preview/Print/Email... from the Database and store the the
content in a physical file. The Preview/Print/Email... will then be
launched directly from this physical file.
W hen using this option it is not possible to duplic ate or export the
Lay outdefinition.
Ensure that the file is ac c essible for all users w ho need to use the
report.
Deploy File This Checkbox displays if the file is currently deployed from the
from Database or a physical File. Select the appropriate Buttons to
Database change this setting.
Checkbox
(Read-Only)
Menus
Define the Menu entries from which the Layout should be launched in this register.
The Update Menu button updates all entries in the SAP Business One Menu
The Sy stem - Part is managed by the Sy stem w ith the exc eptions of the Position and
the Desc ription - Columns w hic h c an be modified by the user.
The User - Part c an be used for all User defined Entries. Add a new row via Right Clic k
-> Add New .
224
Lay outdefinition > Menu
Description
Parent Select the Father of an existing SAP Business One Menu from the
Combo Box list.
Description Optional: Enter the description of the menu. You may use
Textbox Textcodes to translate the description. If the description is empty
the name of the Layoutdefinition will be used.
Pos Textbox Optional: If there is more than one Layout assigned to the same
Fathermenu you may use this Column to sort the menu entries.
Function Optional: The Value of this Textbox will be stored in the
Textbox Systemparameter [%MenuFunction]. With this parameter you
may use a Layout in different Contexts.
7.1.4 Printdefinition
The print definition allows you to assign a layout to a specific form type. This is
necessary, among other reasons, because different layouts can be defined for a
single form.
Description
This button is used when several print definitions are defined for a
226
· Print after Saving
· Print
· E-mail
· Fax
· PDF
· MS Word
· MS Excel
SAP Leiste
Status Determines the status of the print definition. Possible options are:
Open Form
· The print definition can be opened in the SAP® menu under ‘Administration >
AddOns > coresuite designer > Printdefinition’.
· It is also possible to open the print definitions in each form using
Extended Definition
Description
Document
Description
228
Name in this field.
Language Indicates which layout is to be printed for what language.
Email/Fax
coresuite designer can generate e-mail and fax messages. The corresponding
settings are activated in this separator.
Description
File Type Determines the file type of the attachment. Possible options are
PDF, RTF, TIF, GIF, EMF, JPG, BMP
Send Mode Mode used to send the message. The following modes are possible:
Default
This mode prioritizes Outlook.
SAP® prompt
Uses the B1 mailer service and displays the e-mail one more time
before it is sent.
SAP® direct
Sends directly using B1 mailer service
Smtp prompt
Sends the e-mail via configured Smtp service and displays the e-
mail one more time before it is sent.
Smtp direct
MAPI prompt
Uses Window default client and displays the e-mail one more time
MAPI direct
Attempts to send directly using Windows Standard Client
Res. Res. stands for resolution and indicates the resolution of the
attachment at export. The resolution is given in dpi (dots per
inch).
Quality The quality of the export is rated between 0 and 100.
Exportpath Determines the export path. If empty,
tempfolder\swald\dbname\export is used.
To Address Determines the target address of the e-mail message.
CC Contains the address for the copy.
BCC Contains the address for the blind copy.
Subject Contains the subject.
Email Text Contains the text in the e-mail message.
From Defines the e-mail sender.
Address
Predefined texts can be added to coresuite designer. You can also define the
corresponding translations for each structural element of the text. They are then
dynamically loaded into the corresponding layout.
Text
230
Description
Code Enter a user defined code as unique identifier for the new Text
Textbox here.
If the code is not entered the next available user code UXXXXXXXX
will be automatically entered
Text Textbox Contents of structural elements of the text. It can also be edited
with coresuite editor using the right mouse button
Open Form
The text collection can be opened from the print or layout definition using the
function button:
Translate
Each of the defined texts in Text collection can be translated in this window. This
is the default translation function of SAP® Business One.
Table Descriptions
Open Form
The translation can be opened from the text collection using the right mouse
button.
232
7.1.6 Sample Queries
Access
Description
Further reference
For more details on how to use the sample queries see the comments in the
respective query itself and refer to the training Guide Creating a Simple Dashboard
or the reference guide Sample Dashboards
7.1.7 Parameter
All the parameters used by coresuite designer are defined in Form Parameter.
Table Description
234
Idem Id Indicates the Item ID in the form. Identifiable in the corresponding
form when ‘View > System Information’ is activated.
Open Form
The parameters can be opened from the print or layout definition using the
function button:
All form types are listed in this window. The form types of all relevant Forms from
SAP® B1 are available in coresuite designer. You may find it necessary to create
your own form types for special extensions or the like.
Description
Open Form
The form types can be opened from the print or layout definition using the function
button:
236
Func tions > Open Formty pes
7.2.1 General
Batch Printing
The Batch Printing functionality in the coresuite designer module allows you to set
up the system to automatically print or send specific documents.
The following example demonstrates how to print customer orders, which have not
yet been printed. A sample query, which has to be adjusted slightly, is
automatically installed with the coresuite country package. The SAP Business One
standard alarms will be used to trigger the start of the print job.
Define Query
Access
The following columns are required in order to be able to use the query for our
example of Batch Printing:
· FormType: Enter the Formtype of the Document here. In our example we want
to return not printed Sales Orders, therefore we use '139' as the form type for
Sales Orders.
· PrintDef: Enter the Code of the relevant Printdefinition here. In our example we
want to use the standard Printdefinition for Sales Orders. Therefore we enter
the Code 'T0000010' of the Printdefinition for Sales Orders here. To find the
correct code of the Printdefinition see the screenshot below.
· DocEntry: The correct Document Entry is selected from the appropriate table.
· AttGroup: Enter the column by which the Documents should be grouped. This is
optional.
238
Setup SAP Business One Alarm
Once the Query is defined you will have to set up the Alarm in SAP Business One to
trigger the automatic printing.
Access
In the last step we will set up the coresuite designer to start the Batch Printing
automatically. To do this we will define the relevant settings in the Batchprint
Configuration.
Access
240
In order to start the printing an SAP Business One user has to be selected and the
Alert defined in the Previous step has to be selected.
In addition, the time interval how often the batch printing job are run has to be
set at the bottom of the form.
Copy Queries
In the printdefinition > documents the copies can be defined. The "1" which is
shonn in the image below is a query which is saved as "1".
In the folder "SWA_LD_Copy" are every queries, which can be chosen in the
printdefinitions under "Copies" and "Copies M." With this system, there are
endless possibilities to define the number of copies in documents.
A practise example is the definition of copies with UDF. Therefore a new query
must be saved
SELECT
CASE
WHEN T0.U_Copies IS NULL
THEN 1
ELSE T0.U_Copies
END
FROM OCRD T0
WHERE T0.CardCode = '[%CardCode]'
This query must be saved in the folder "SWA_LD_Copy" and can so be used in the
printdefinition. If in the UDF is a NULL-value, the designer will print one copy. If
the UDF contains a value, the designer will print the copies defined in this UDF.
242
C opies country
SELECT
CASE
WHEN T0.Country <> (SELECT T2.Country FROM OADM T2)
THEN 2
ELSE 1
END
FROM OCRD T0
WHERE T0.CardCode = '[%CardCode]'
Data Sources
The most frequent data sources for each form are saved in the layout definition.
Besides the saved sources, own queries can be defined, too.
See the next Chapters for details.
C reating Queries
The default SQL generator is opened under ’Tools > Queries > Query Generator’.
The query can be entered here. After the entry is complete, the result can be
displayed using the ‘Execute’ button.
The query you have created is displayed in the usual notation in the upper field.
The result of the query is shown in the lower field. The query can be edited using
the button. Experienced users create their own queries directly in this view or
copy the query from the SQL server manager into this view. When both the query
and the result are correct, the query you have just created or edited can be saved.
244
edit the query
Saving Queries
The query can now be named and saved in a category. After naming the query, the
desired category must be selected, so that it is displayed in the ‘query category’.
As final step, you must confirm the actions with the ‘Save’ button. New categories
are created under ‘Manage Categories’.
246
query manager
The definition is applied directly from the query and the layout type is set
automatically at ‘User Query’. The query in line 1 is also automatically applied. If
the layout definition was correctly created, the layout can be created in the
Designer (button ‘Open Designer’). The form for the layout definition is described
in the Forms chapter under Layout definition. The layout configuration is explained
in the chapter Designer.
When you work with marketing documents coresuite designer will help you in
several areas.
1. DocEntry retrieval
When working with coresuite designer is essential to read out datatable keys from
the form.
Those keys are called Parameters and can be used in all the queries related to this
layout.
They can even be used in a Printdefinition to get for example an dynamic
emailaddress.
But when working with marketing documents we cannot read out the DocEntry from
the form which is the regular way for coresuite designer to get parameters.
In the case of marketing documents coresuite designer creates the DocEntry -
Parameter automatically for you using the predefined parameters: DocNum,
DocDate and DocSeries.
248
Y ou c an alw ay s use [%Doc Entry ] for all y our marketing doc related queries and
definitions.
Since we can read out the FormType of every SAP- Form by SDK we use it as our
unique Object Identifier.
A lot of scripts in our standard layouts are using the FormType Parameter to
enable/disable Areas and for other conditional stuff.
So as soon as we have a FormType on the marketing documents we may use:
- Unified Queries (Using the Placeholder @@RDR)
- The ObjectId Parameter
- Conditional formatting and other individual things.
3. DataSource
First of all if you are dealing with regular documents opened as draft Form in SAP
or using the Draft List directly from SAP B1 you don't need to care about drafts at
all.
As written in point 2. coresuite designer is FormType driven.So how can we deal
with Draft Documents in other than above cases (they do not have a FormType)?
For example if you would like to use draft documents which are using our
Document_88 datasource from SelectGrids, Remote- or Batchprinting you need to
specifiy the SWA_LD_DRAFT Formtype in the related Printdefinition. This
indicates coresuite designer that you would like to use the DRF - Replacement for
the @@RDR - Queries and will set the Parameter AddMode to "Y".
When working with External Reports such as Excel, Crystal Reports, Dashboards
and others there are 2 options to deploy the data to the report displayed.
1. Deployment from the Database
2. Deployment from a File stored on an accessible Folder
Access
At the bottom of the tab are 2 buttons to change the Deployment Option
In order to give access to the report to all users and to be able to export the report
we recommend to deploy the file directly from the database instead of using a
Shared Folder to ensure data integrity.
In case you wish to export and import the Layoutdefinition from one to
another database you have to deploy the data via database.
The documents generated can be sent by e-mail with coresuite designer. The
settings of the e-mail function can be established under E-Mail / Fax in the Print
Definition. The fundamental fields in this form are presented in the form
250
descriptions in Print definition.
In this example, (Print Definition Service Order) the target address was taken from
the contact person of the business partner with a SQL query. The corresponding
query parameter is [%callID]. Likewise, the CC address (e.g. defined technician)
and the BCC can be defined.
You can either work with an SQL query or with text elements, but you can’t
use both simultaneously in a field.
The subject was created with a text from the Text Collection --> [@0000021]
and the current [%callID].
coresuite designer enables you to produce multilingual reports without effort and
in a very short execution time. You can save time, as you don’t need to define a
new layout for each individual language. All you need is a single layout with
multilingual textboxes. These textboxes are stored in a Text Collection and loaded
into the report. You can save time even if you make changes to the texts. For
example, when general terms and conditions are altered, you don’t have to look
for each document and adjust it. The adjustment can be very easily made in the
Text Collection and all documents will be updated.
This chapter describes how to create, translate and finally use new texts.
C reate Text
In order to edit or create texts, the Text Collection must be opened. To do so, you
can use the ‘Functions’ button in the print or layout definition and select the
option ‘Texts’.
252
The text table is opened in a new window. Here, a new text can be added in the
text column. You don’t have to insert the code as it is given automatically. The
text entry is confirmed with the button ‘update’.
input text
Translate Text
You can translate the element by using the right mouse button on the text.
The translations for the selected text block can be created in the new window. The
language to be used for the translation can be selected in the left column and the
element you want to translate can be entered in the right column. Use the ‘Add’
button to confirm the added element. In this example, the text is added to the
table ‘swissLD Text’ with the label "U0000275". The label will be used later to
integrate the text block in a layout.
In this example, a new layout is created. In the following chapter we intend to use
this layout on the business partner to add language information. But first, we will
address only the layout and layout definition. A new layout is defined under ‘
Administration > AddOns > coresuite designer > layoutdefinition’:
In this example, only Master Data is used as data source, because the example
does not really use data sources. After saving the layout, the Designer is opened.
To test the textboxes, a single Advanced Data Band containing a detail component
is enough. The created text component ‘U0000275’ can be selected from ‘Data
Sources > LD > Txt’ and pulled into the Detail (highlighted in orange, in this
example).
254
use of the text elements
After saving the layout, the preview shows the added text in the default language,
in this case German:
preview
[@T0000014]
(The code of the text block must always be placed between square brackets
with a ‘@’)
The next question is: how does the Designer recognize what language to use for
the layout output? This is established in the print definition. In this example, a
print definition is created in which the language defined for the business partner
should be read and added to the layout. First, a new print definition is created in
the business partner form. As layout, we will select the layout ‘translation tool’ we
have created and attribute the language statically first.
When the business partners’ preview is accessed now, the layouts are always
displayed in French (as the language was attributed statically). Next, a query is
created which returns the language dynamically to the print definition. For that
purpose, a new query is created:
This query does nothing more than return the corresponding language to the
business partner in the OCRD table. The query must absolutely be saved in the
‘SWA_LD_LANGUAGE’ category.
256
save query
The print definition will be now updated. Each query which is saved in this category
can be selected in the print definition in this language.
Now the layout is shown in the language corresponding to the business partner.
What happens when, for example, ‘Russian’ is assigned to a business partner, but
no translation has been created yet? These elements appear in the Import language
which was defined in the Designer configuration.
In order to allow the user to filter the data display in the report or change the look
of the report, parameters can be defined in the Data Source Queries or used in the
layout itself. In order to use and fill these parameters the relevant data has to be
entered in the Parameters Tab of the Layoutdefinition.
See bellow information for more details on how to configure and use parameters.
Available Systemparameter
coresuite designer supports you with a bunch of Systemparameter which you can
use in:
- Scripts ( per GetData("LD.Par.ParamName"))
- Queries ( per [%ParamName])
List of the most used Systemparameters together with a sample Use Case:
Parameter Beschreibung
PrintMode Contains the Mode/State in which the
Layout is during Rendering .
"N" -> Print oder Preview
"P" -> PDF
"E" -> Email
"F" -> Fax
"W" -> Word
"X" -> Excel
Typical Use Case : Print on a preprinted
Form and use the same Layout for Emails
(-> In Emails the Logo should be visible
but on the Printout not)
Solution : Logo visible if PrintMode<>"N"
FormType Contains the Formtype of the Form from
which the Layout was started.
"139" -> Sales Order
"140" -> Delivery
...
Typical Use Case : Printing of a specific
Sales Quotation Footer.
Solution : Footer visible if
FormType="149"
Preview "Y" if in Preview Mode, "N" if not.
Typical Use Case : Hyperlink Arrows
should only be visible in Preview Mode.
Solution : Set the Visible Property of the
Hyperlink to Preview="Y".
UserId Contains the logged on User
Typical Use Case : Get the from
Emailaddress automatically when
258
emailing via coresuite designer
Solution : Add a Query in the Email/Fax
Tab of the Printdefinition.
To get an idea what Parameters are used you may use a preinstalled Layout called
"Parameters Check" for example on the Sales Order Printdefinition:
coresuite designer presents default parameters for the most frequent SAP® form
types. These can be imported from ‘layout definition>parameter’, using the
following button:
Item ID
This ID is the clear label of a form field. If, for example, the parameter
(employee) ‘empID’ is selected, the ID of the ‘employee nor‘ field must be read as
the form ‘personnel > employee master data’. The ID on the form can be identified
by activating ‘view > system information’:
Parameter FormType
After creating the parameter, a matching form type has to be assigned to it. It is
important that the parameter always knows in which form it works. In the case of
labelled parameters, the Form Type form can be opened using the
‘ParamFormType’ button.
260
define parameter, open form ty pe
A parameter does not necessarily have to apply to only one form. Several
parameters can be used for several different forms – this is the case with
‘DocNum’ below, which applies to several forms. All forms must be indicated. All
usual form types are available in the Designer. If a specific form type is not
available by default, it must be previously created. To do so, use the form
Formtypes.
'[%ParamName]'
Square brackets and percent sign must be used to ensure the connection between
the query and the defined parameter.
The following example uses the 'Account' parameter and filters the data for
account codes selected be the user in the parameter form or displays data of all
...
WHERE (T0.FormatCode = '[%Account]' OR '[%Account]' = '')
New since version 2.90 it is possible to define default values for a parameter so
that the parameter does not have to be defined in each Layoutdefinition which
uses the datasource.
'[%ParamName@=DefValue]'
The following example uses the 'AddVoucher' parameter and sets the default
value to 'N':
Parameter Design
There are different ways of entering parameters, depending on the query. Some
parameters must be entered manually as is the case, for example, when the
starting date and the end date of a report period must be entered. But the
parameters can also be fed in directly. This happens, for example, when a business
partner form is opened and the print preview button is activated. In this case, the
SAP® obviously does not ask for the BP’s ‘card code’ anymore. The different
possibilities for designing parameters are presented in this chapter.
Summary
262
Parameters are designed in the layout definition in the separator Parameter.
The columns Parameter and Description have no effect on the design. The
columns ‘Design Param Value’, ‘Parameter Modes’ and ‘Input Sequence’ are used to
design parameter inputs. The definition of the columns is made in the Form
Description.
Parameter modes
Next, you will be shown how to define parameters. In a further step, a more
detailed presentation is made on how to incorporate small SQL queries, in order to
define the parameter list automatically. For example, when using Choose From
List, you can only work with this kind of queries.
The user must enter the parameter manually. For this mode, the parameter
doesn’t have to be defined. The column ‘Design Param Value’ can be left empty.
[Parameter1;Description1;Parameter2;Description2]
264
c reate a c ombobox
The user can select the parameters from a Choose from List. The notation for the
‘Design Param Value’ column is explained below:
Choose from List only works if a Query has been manually created. The
parameters must be inserted in SQL notation.
To generate a Choose from List, a SQL query must be placed inside curly
brackets:
{SELECT.... FROM......}
Instead of normal values, small SQL queries can be inserted between the brackets
of the Parameterdesigns (in the case of Choose from List, the query is absolutely
necessary). The SQL query must be structured at least in this form:
For Combobox
266
Input Sequence
Some queries require several parameters. To order them correctly, the input
sequence must be defined in the layout definition under Parameters:
input sequenc e
PDF Export
Based on the print definition, this chapter shows you how to create a PDF export.
Both a PDF of the order and a PDF of the production order should be created. First,
the PDF Export must be activated in the print definition. coresuite designer then
autonomously generates names for the files. The file names can obviously also be
created manually. You can do so in the separator ‘Documents’. The corresponding
name must only be noted in the column ‘Export File Name’.
To print a document, the layout definition and the print definition must be
correctly established.
· the print definition essentially establishes the number of copies which are to be
printed in the SAP® when the print button is activated
· the layout definition establishes the printer and tray selection, as well as the
user and the language
The following example shows how to complete the printing of a newly created
report while a production order is printed with the printer in Production. The two
documents should be slightly different:
268
Printdefinition
To access the Print Definition in the Order form, use the button. A new line is
then added to it. In this new line you will work with the default Din Layout again. A
copy should be printed from both layouts. The layout for Production is labelled in
the field ‘Free Text’. The separator can be defined any way you want. In this case,
it was named ‘prod’. The Production layout is special, because the Production
Department always gets the receipts in German only. This is defined in the field
‘Language’.
Printdefinition
Layoutdefinition
The next step is the Layout Definition. The working of the Printer Settings is
explained in the Layout definition chapter. This case has a special feature: there is
a second line with the note ‘prod’. This Free Text must be exactly the same as the
one in the Print Definition. A separate printer was also assigned to his line, as the
Production department is in a different place.
Lay outdefinition
When the printing command is given, both Production and the Office get an
identical copy. For the moment, the Free Text is useless. It would have sufficed to
have a line with two copies and the layout definition set to copy ‘0’ and ‘1’. But
variations for these documents will be created next.
Variations in terms of document structure are set in the Designer. In the present
example, two changes are made:
First, the document footer is hidden. For that purpose, ‘Document Footer’ is
selected from the document directory:
In the settings under Bindings the ’visible’ field is activated. The Script Editor is
opened in the new window. The purpose of this small script is the following
definition:
‘When ‘prod’ does NOT appear in the parameter, the footer should be visible. To
do so, the following script is used:
GetData("LD.Par.FreeText")<>"prod"
to access the parameter Free Text, the command ‘Data Sources > LD >
Par > FreeText’ can be loaded into the Editor
270
disable footer
The second step is changing the document title. For that purpose, you must click in
the working area, on the document title. This time, the existing script is expanded
under ‘Generate Script’ In Characteristics. The completed script now says:
‘When the parameter ‘Free Text’ says ‘prod’, the document title is overwritten
with ‘Produktionsauftrag' (in german)’ The corresponding syntax is
The layout can be saved now. When the print button of any given business partner
is activated now, coresuite designer prints the documents as in the initial
situation.
Remote Printing
coresuite designer can receive print orders in a file and then carry them out. In
order to carry out such orders, the following steps are needed:
· Set up files
· Configurate designer
· Compile print job file
Set up file
A file will be set up at a random place, in which the print jobs will be saved later
on.
Configurate designer
Next, the designer must be configurated. For this purpose the configuration will be
activated under "Administration > AddOns > coresuite designer > config". In the
index "Batchprint" in the right column "Parameter Scan-Pfac" the just compiled file
can be declared. Mode and user will be handled analog to the Batchprinting. (The
interval is not needed for Remote Printings).
272
Restart coresuite after the setting up.
Menuleiste SAP
Preview
Opens a preview window
Print
Select Grid
A SelectGrid allows the user to select and mark several lines and subsequently print
them, for example. Next, a SelectGrid is created with business partners with an
account balance > 5000. The business partners can be selected and a letter is
created.
Layout Letter
A new layout is defined for the letter. The Card Code is selected as parameter:
Next, the letter is formatted in the Designer. In this example, only the business
partner’s address is added.
274
Query Business Partner
The following query reads the business partners who generated an account balance
> 5000.
SelectGrid erstellen
The SelectGrid is created by means of a new layout definition. Using the ‘Just
Grid’ option prevents the layouts from opening immediately. The query we have
just created is added. The opened grid must have a form type, so the name is
saved in the ‘My form type’ area. It is also possible to insert an additional
definition in ‘FormDef’, which will show up at the same time. The layout is saved
in the ‘Business Partner Reports’ directory.
The grid can already now be viewed with the preview button, although it has
absolutely no functionalities yet.
The ’formAction’ form must be defined now. For that purpose, a new entry is
created in Form Types.
Defining Parameter
The parameter Card Code appears in the SelectGrid. Although we have already
used a Card Code parameter in the layout of the letter, a new parameter must be
created for the SelectGrid.
Printdefinition_grd
Finally, a print definition must be created for the grid. The print definition applies
to the form type ‘formAction’ and contains the layout ‘Christmas promotion’. As
far as copies are concerned, only the ‘Copies M.’, meaning mass print, are
relevant in this case. The usual number of copies is not considered in SelectGrids.
276
To end the configuration, you only have to define the Matrix ID under ‘Extended
Definitions’. In the case of SelectGrids, the ID is ‘grdSelect’.
Overview SIP
The rootfile is located on the first level. The beginning of the file name is of your
own choice and must be followed by the ‘_ldpack’. The _ldpack contains all
references concerning sub-directories and file names. The ‘SWA_LD_PACKAGE’
directory is located on the same level. It must begin exactly as stated but the end
of the file name can freely be chosen. This directory contains all queries, layout
templates and parameters. The next chapter describes the contents of these xml
files.
278
(1) Rootfile
The root file contains all important references regarding directories and
definitions. The pkg name can be freely chosen in the package definition. The pkg
prefix is attributed to developing companies by SAP® and is added here. The
layout folder name defines which directory is to appear afterwards in the
installation list in coresuite and can be freely be chosen as well. The layoutdefpath
and the layoutdatapath refer to the RST-File and to the Definition File. The
Formparamdefpath refers to the Formparameterdefinition. The Datadefpath refers
to Datadefinition. Note: For the layout to be automatically installed in the client’s
system, each release requires the pkgversion to be updated.
(2) Datadefinition
Queries are saved in Data Definition. All queries and query definitions (the same
principle as in the layout definition under ‘queries’) are saved in a container using
an ID. The container ID is then selected as data source from the Definition file.
> : >
< : <
Wrong
SELECT * FROM OCRD WHERE DocDate > [%FromDate]
Right
SELECT * FROM OCRD WHERE DocDate > [%FromDate]
(3) Formparameterdefinition
Form types and parameters are contained in the form parameter definition. An 8
character code (with attributed prefix, please) corresponds to each form type, as
well as the type which can be read from the system information of each form.
Similarly to data collection, the remaining information on the form type is saved
directly in SAP®. The listed parameters belong to the form types. In this case,
there is an 8 character code too and it must be provided with a prefix. The U_key
is the parameter key, identical to the one shown in the query.
Global parameters can also be collected outside the form type, directly under
parameters. This can be used, for example, for universal parameters, such as
280
‘visible Yes / No’ and the like. U_ptype is the format of the parameter (A=
Alphanumeric, D=Date, N=Numeric)
12345678: The codes must have a prefix, be clear and have 8 characters.
(4) Layoutfolder
You can create as many layout folders as you wish. These must be correctly
activated in the root file. In each layout folder there must be a definition file, as
well as the RST file, which can be saved from the Designer.
The rst file can be directly exported from Designer under ‘save as’.
The 8 character code must be provided with a prefix. The category, design form
type and name are identical to the Form in coresuite designer. Several categories
can be selected from the layout type (T0000002 = Document, T0000003 = Data,
T0000004 = Other, T0000099 = UserQueery). The name of the Containers must be
selected from Usedata. To prevent clients from changing the layout, you can select
istemplate="Y"
282
<printorder layoutid="COR00301" count="1" countM="1" />
</printorders>
</printdef>
</printdefs>
</layout>
12345678: The codes must have a prefix, be clear and have 8 characters.
sip Export
Both elements on the first level (xml file and directory) must be packed together as
a zip file. After this, the file must be renamed to .sip so that it can be imported
into the AddOn Manager.
coresuite administration
The SIP can be imported under ‘Administration > AddOns > coresuite
administration > Administration’ and then be installed.
Components
This chapter describes the main components of the Designer. Components can
either be selected from the menu bar under ‘Paste’ or directly in the components
area.
Textbox
The text box allows you to insert unformatted texts simply and quickly by
means of an Editor.
Advanced Text
This text box is used to structure data into the text or to import data from
coresuite editor.
Picture
Insert images in the report
Shape
Insert and format different forms
Barcode
Makes it possible to insert a barcode. The display of the barcode (EAN 13, etc)
284
can be defined.
Chart Control
Inserts existing diagrams in the report.
Widget
Inserts dynamic graphics, such as indicator graphics.
Page Header
Inserts a page header similar to the ones in MS Office.
Header
Adds a header to the data band (not repeated in every data sentence)
Detail
Adds a repeating area to the data band (is repeated in every data sentence)
Advanced Data Band
The data band is the basis and passes on data sources such as filter and
sorting conditions.
Advanced Group Band
The group band can be added to the data band and provided with grouping
criteria.
Footer
Adds a footer to the data band (not repeated in every data sentence)
Side by Side
Allows displaying several data bands side by side.
Page Footer
Adds a page footer similar to the ones in MS Office
Page overlay
The overlay is needed in order to overlay whole pages or to create a
watermark
Content
Contents allows you to define the Design area in the master layout.
Group header
These are only present in the Designer for the sake of compatibility.
Group Footer
These are only present in the Designer for the sake of compatibility.
Textbox
The text box can be pulled into the working area using the button. A simple
editor is enough to work in the text box.
Settings (static)
Appearance This area allows you to define different display options for the text.
Among others, orientation, font, margins, colours, etc.
Data The tag defines the additional information for components.
Design The name contains the definition of the components. This way, the
component appears afterwards in the Document Directory as well.
Layout Location defines the distance to the upper and the left margin of
elements in a superior position. Size defines width and height.
Advanced Text
The advanced text box can be pulled into the working area with the button.
The formatted Text Editor is suitable to work in this field.
286
Erw eiterter Editor
Settings (static)
Component settings in this case are the same as in the normal Text box.
Picture
The image can be pulled into the working area using the button. After
stretching the image, you must indicate which image is to be loaded into the area.
Bild definieren
Eigenschaften (statisch)
Appearance The Size Mode indicates the scale mode of the image. Possible
options are ‘stretch’ and ‘normal’.
Data The Tag defines additional information for the components.
Design The Name contains the definition of the components. This way, the
Shape
A shape can be inserted using the button. You can select a suitable shape
from the properties in ShapeStyle.
Settings (static)
Appearance Display enables you to define colour, aspect and style of the shape.
Data The Tag defines additional information on the components
Design The Name contains the definition of the components. This way, the
component appears afterwards in the Document Directory as well.
Layout Location defines the distance to the upper and the left margin of
the element in a superior position. Size defines width and height
Navigation Bookmark adds a bookmark to components. The field Hyperlink
allows you to insert a link which is executed when you click on the
image.
Render Grow to bottom gibt an, ob die Komponente sich bis zum unteren
Ende der übergeordneten Komponente vergrössern darf. Visible
bestimmt die Sichtbarkeit im Dokument.
Script Defines the script code which will be called before reproduction.
288
Barcode
A barcode can be inserted with the button. The inserted code and the type of
presentation can be defined in the properties.
Settings (static)
Appearance The corresponding code can be entered in the field ’Code’. ‘Code
type’ defines how the code will subsequently be presented.
Page Header
The page header can be inserted into the working area using the button. The
header is opened directly on the page and displayed similarly to a header in MS
Office. The area of the header can be formatted with the usual means (e.g. text
boxes, images or shapes).
Seitenkopfzeile
Settings (static)
Render CanGrow defines whether the header section can be stretched when
the contents of the header increases. CanShrink has the opposite
function: it determines whether the header section can be shrunk
to a minimum. ‘Mode’ defines where the header is to be displayed.
Possible options: All Pages, Odd Pages, Even Pages.
The Advanced Data Band is inserted into the working area using the button.
The Data band is the most important element in a layout. A DataSource is
attributed to each Data Band when it is introduced in the Layoutdefinition. You can
then work with the loaded data in the form of headers, details and corresponding
contents. Consequently, the most important setting in a data band is the data
source. The settings of the data band allow you to filter and sort data and more.
Settings (static)
Data The data intended for a particular data band is selected from the
‘Data Source’ field. The ‘Filter Expression’ field allows you to filter
data according to defined criteria. The listing sequence can be
defined in the ‘Sort’ field. The expression corresponding to the
Total of a particular band can be defined in the ‘Totals’ field. This
total can be called by means of a function.
Design The name of the data band can be defined in the ’Name’ field.
Important: Define the name at the very beginning.
Layout -
Render CanGrow and Can Shrink define if the data band can be stretched
290
and shrunk together with the Page header. NewPageAfter and
NewPageBefore define whether the beginning of the data band
should be displayed in a new page and whether you should proceed
to a new page after the data band. Using Visible you can define if
the Data Band is to be shown or hidden during rendering.
Others AlignBottom orientates the data band in accordance with the
background of the document. Empty Text and EmptyNum converts
NULL contents of a table contents. Empty Text transforms NULL
into ‘’’’(empty string) and EmptyNum transforms NULL into 0.
Header
The Header can be inserted into the working area using the button. The
Header is opened in a data band. Contrary to Detail, the header in a data band is
not repeated after each data sentence. At most, settings can be established to
define if the header is to be displayed in each new page. This setting and other
important parameters are activated in Settings under ‘Render’.
Settings (static)
Render CanBreak defines whether a break can be inserted at the next page
in the header or, if that is the case, whether it should begin at the
next page. Can Grow and CanShrink define if the header can be
stretched and shrunk. MinSpaceAfter defines how much space must
be available after the header. If there is too little space, it will be
displayed on a new page.
Detail
Detail can be inserted into the working area using the button. Details are
opened in a Data band. Detail is the area which gets repeated as many times as
the number of data sentences to be fed into the reports. The most important
settings are activated in Settings under ‘Render’ (Analogue Header)
The settings for these components are the same as those in Header.
The Advanced GroupBand is inserted into the working area using the button.
This band is appropriate for grouping the sources which are sent to the data band.
In the case of the group band as well, it is advisable to define the GroupExpression
and the Name of the Group Band at the very beginning.
Advanc ed GroupBand
Settings (static)
Footer
The footer can be inserted in the working area using the button. It will be
opened in a Data band. Contrary to Detail, the footer in a Data Band is not
repeated after every data sentence. The settings for the footer are the same as
those for the Header.
Settings (static)
292
The settings for these components are the same as those for the Header.
Side by Side
The ’Side by Side’ component can be inserted in the working area using the
button. It is opened directly in the working area. Several data bands can be placed
in this component. Depending on the structure of the data band, they can be
placed side by side.
In the following example, no data has been defined in the Designer. The data
sentences in both data bands will be simulated in properties with the ‘Instance
Count’ field.
Page Footer
The footer can be inserted in the working area using the button. It functions
similarly to Page header.
Settings (static)
The settings for these components are the same as those of the Page header.
Page Overlay
The Page Overlay can be inserted into the working area using the button. Page
Overlay does not affect data bands or the like. It is only used as overlay or
watermark. Text blocks or images can be inserted in Page Overlay.
C ontent
The contents components are used only in the Master Template to signal the
Design Area of the report.
Bookmarks
Bookmarks can be added to any object in the Designer which will then
automatically add an entry in the Navigator in the Preview to link to this
bookmark.
#BookmarkFirstLevel
You may define several levels in the Navigation by separating the text with a '/'
character.
294
#BookmarkFirstLevel/BookmarkSecondLevel/BookmarkThirdLevel
Use the Standard LD func tion LD.BookmarkText w hen y ou w ant to inc lude spec ial
c harac ters suc h as ‘/’ or a ‘\’ in the bookmark text to prevent the Designer to interpret it
as a sub level.
Datasource
In coresuite designer, there are different possibilities to work with Data. To get
optimal results, please follow the instructions below:
Document tree
The Document tree shows you which element in the layout has been selected. The
different component correspondences and sequences are also clearly visible. In the
following example, you can recognise that the barcode belongs to ‘page header 1’
which, in turn, belongs to ‘page 1’ and that this is part of ‘doc 1’. The document
tree becomes more helpful as the scope of the layout gradually increases. Naming
components clearly can help you maintain visibility.
Filtering Data
Data sentences can be filtered directly in coresuite designer. To do so, use the
‘FilterExpression’ setting. FilterExpression is displayed using the personnel list
from the previous chapter. The FilterExpression is defined in the
AdvancedDataBand under properties: the data band should only display the
employee with emplD 1.
FilterExpression
When executing the report, only Marc Manager, who holds emplD 1, should be
296
displayed.
Functions
Functions are an important topic for Designer. They are irreplaceable for
generating dynamic reports. The Designer is supplied with many standard functions
, which can be activated. Additionally, own functions can be defined in the layouts.
In this chapter, we will work with Visual Basic.
Basic Principles
The function can be accessed afterwards in the components bindings (settings) and
returns the value calculated by the instructions. It can be accessed with the
following syntax:
<Function name>(<Inputs>)
The following example uses the item list (stock control). First, a SQL query is
generated, presenting our data source. The query was created and saved in the
query generator.
Based on this query, a new layout definition is initialized. In it, both the saved SQL
query and the design form type 150 are selected.
Lay outdefinition
After creating the layout definition, the Designer is initialized. In the Designer, a
simple item list is created. First, the data band with the data source from the SQL
query is called. The band has a header section, which describes the columns, and a
detail area. Text components which describe the item code and description and
stock control (OnHand) are placed in these two areas.
Next, the text colour of the stock control (OnHand) should be coloured dynamically.
The point is that the stock is coloured ‘red’ when the number of items in storage
reaches 0 or less, ‘orange’ when the number ranges from 1 to 100, and ‘green’
over 100. The easiest way to do so is to work with styles. The basics on this
subject can be found in the Text tools chapter. Three new styles were defined. The
only difference between them is the name (rot, orange, gruen) and the filling
options, in which colours correspond to names.
298
Sty les
Next, a script is created. For that purpose, the first level of the document
directory is selected and the function is defined in the settings in CommonScript.
The function syntax is:
Function Farbe(bestand As Double) As String
Dim col As String
If bestand <= 0 Then
col = "rot"
Else If 0 < bestand AND bestand < 101 Then
col = "orange"
Else
col = "gruen"
End If
Return col
End Function
The function is called ’Farbe’, requires the stock in Double format and returns a
string. A variable named ‘col’ is initialized which will give a value to the If then
Else condition. This variable will finally be returned with ‘Return’.
This script does nothing more than check the stock and then return the style
definition. Next, the function must be applied to the settings of the text
components in stock control. This is accomplished in the bindings. The function
‘Colour’ is called from the binding ‘Style Name’ and the necessary input value is
inserted. The value is taken from the band into the script editor.
When called, the report is displayed as follows. The stock is coloured in accordance
with the definition in the function:
300
getData / Data
getData
If Data is read from an Advanced Databand, coresuite designer transforms NULL-
Entries into Empty Strings (Alphanumeric Data) and 0 (Numeric Data). But if you
load some data directly with getData("Expression"), coresuite designer submits
the original values. That means, also NULL can be loaded in this case.
Data
To avoid this NULL-Entries, the Function must be Data("Expression"). Now, the
characteristics are the same like in the Advanced Databand: NULL gets to
"" (Alphanumeric) or 0 (Numeric).
Grouping Data
With this data source, a new layout is created in personnel master data and
subsequently formatted in the Designer. Start with an Advanced Data Band, which
uses the created query as Data Source. As the personnel list is to be displayed
grouped by department, an Advanced Group Band will be inserted in this Advanced
Data Band, featuring, as usual, the Details and respective contents. In this
example, a header with a text element indicating the department was inserted at
the top. The Header is repeated for every new group, the Details for every data
sentence, as usual.
The GroupBand must be told what grouping criteria to use. For that purpose, click
on the AdvancedGroupBand and define the ‘GroupExpressions’ under properties. In
this example, the Group Expression is ‘Department’.
Definition GroupExpression
302
Result
Previews from Designer can be provided with link buttons. This allows you to open
SAP® forms directly from Preview. Next, the link button is explained using the
business partner based on the CRM report.
link arrow
A new Shape is created in the Detail area where the ID of the business partner is
located, too. The XML Code of the arrow in the example, which can directly be
inserted in the layout with ctrl+V, is as follows:
How you can link this Arrow you learn in the sections:
304
· OpenLayout
· OpenPrintdef
· OpenObject
start Designer
Page properties
Using the Designer, you can create several completely different pages. (Use to
create a new page). These pages are configured in Page Settings. To access them,
click on the corresponding page and select settings. It is also possible to access
them directly using the button on the upper line. The following settings can be
defined per page:
Pivot Tables
In this section, a pivot table will be built. The pivot shows the availability of items
in the different stocks. As datasource, a simple query will be used:
After, a new layoutdefinition will be built containing this query. In the designer, a
pivot-table is placed by the corresponding tool. In the properties the Datasource
(query) must be defined like the advanced databand. With double click on the
pivot-table, a new property window opens:
Properties
In the source fields area, the elements of the query are listed. With drag and drop,
they can placed into the sections in the middle. In this example, the warehouses
are defined in the x-dimension and the different items in thy y-dimension. In the
facts-field, the actual stock (onHand) is showed. Of course, its also possible to
build the report in several dimensions, for example in the y-dimension first
grouped by the article group and then by the articles.
306
Styles
In the section "Styles", for each fieldtype in the table, a style can be chosen. In the
designer installation, several styles are already pre-installed. They can be used like
in the following example:
Result
Chapter Functions introduced the creation of own Functions. The present chapter
describes the existing default functions in Designer. These are always called into
the Bindings with LD.<function name>. You should bear in mind that these
functions must be activated. This can be defined in Imports.
AddAttachement
LD.AddAttachement([Pfad])
308
Next, in the DocumentRow of the DIN Layout the function is insertet, which sends
to every Item the Sheet
The path in this example is static. But the Filename is generated in a dynamic
way: Its the ItemCode. The File Format is again Static. So, when this Quotation is
sent by mail, for each article which has a FactSheet, an attachement will be sent.
LD.AddAttachment("C:\workshop\FactSheets\" & DocumentRow("ItemCode")
& ".pdf")^
Hy perlink
Hyperlink
As value in the hyperlink field in the bindings, the name and the parameter is
transmittet. As Example, here is the name 'MyClick123' and the parameter is the
path and also the name of the article image.
"[Name; Parameter]"
Generate Skript
In the generate script of the document the hyperlink is called and connected with a
funcion of the Common Script (see next point).
Common Skript
In the Common Script of the document, the function (called MyClick) is defined and
opens the msPaint.
310
Private Sub MyClick(rawUrl As String, sPath As String)
Dim p As System.Diagnostics.Process = New System.Diagnostics.Process()
p.StartInfo.FileName = "mspaint.exe"
p.StartInfo.Arguments = sPath
p.Start()
End Sub
BookmarkText
LD.BookmarkText(<Text As String>)
LD.BookmarkText("#one/two")
C reateTableFromText
The name which will later be used for recalling, can be defined under ‘name’.
The text element from the data source is entered under "text". The line or
column break is entered under column and rowsplitter.
Next, the standard layout is adjusted (document DIN), in order to allow small tables
to be created with the text editor. This is the only way to create tables, as the
editor does not recognize html tables.
Creating a Table
First, a small table is created in a sales order. In the present example, the line
extension of an item is used and a small table is inserted. In this example, the
table is structured like this: if a new line is created in the editor with the enter
command, a new line will be displayed afterwards in the table. If an empty space is
created with 4 strokes of the space key, this will be interpreted as a new column.
The variable we have just defined is overwritten with the return value from the
Create TableFromText function. The fact is that the function indicates the
312
maximum number of columns in the table. The following script is inserted in the
GetDataScript of the ‘Document Row’ data band under ‘properties’.
GetDataSc ript
The following values must be fed into the function: Just select ‘Engine’ as
render engine. In this example, the string ‘Zeilenerweiterung’ is inserted as
name. As text, the corresponding element is sent from the data sources. In
our example, the line extension, the element in question would be this
DocumentRow("text"). To finalize, we only need to define the condition for
inserting a new line and column. A new column is inserted by means of a string
of 4 strikes of the space key {" "}. An ‘enter’ is created
together with the {vbcr} string. This function now creates the table and
displays the maximum number of columns as return value (numColumns).
Now, a new data band is created in the document under DocumentRows. The name
which was defined earlier on can be entered here. In this case: Zeilenerweiterung.
314
row 1 column 1 row 1 column 2 row 1 column 3
row 2 column 1 row 2 column 2 row 2 column 3
Date
LD.Date(<Element>,<Dateformat>)
This function works just like the ‘’Fstr’’ function. The only difference is that in
this function we will work with date formats. As an example, an extended text
filed is inserted here and its contents are defined under Bindings.
The different elements are joined with a &. Strings must always be written
between ‘’’’. You can find a reference to the different date formats (here dd.MM.
yyyy) at http://msdn2.microsoft.com/en-us/library/8kb3ddd4.aspx.
When the layout is rendered, the text box is displayed as follows: ‘’Today is
25.02.2008’’
DrawImage
LD.DrawImage(<Path As Object>)
Example: Display product images. This function uses the default bitmap path
and the picture name from the Marketing data source to produce complete
dynamic bitmap paths.
LD.DrawImage(GetData("B1_Data.CompanyDefaults.BitmapPath") &
DocumentRow("RowRowItems.PicturName"))
Fstr
LD.FStr(<Element>,<Numberformat>)
This function allows you to define the contents of simple text. As an example, we
will use the stock control list from chapter Functions. In the case of stock control,
the entered value is a simple number:
The different elements are joined with a &. Strings must always be written
between ‘’’’. You can find a reference to the different number formats (here
#######) at http://msdn2.microsoft.com/en-us/library/0c899ak8.aspx
GetDesc
This function returns the description of User defined fields (UDFs). This
description exists for UDFs where valid values are defined.
316
> Define User Defined Field (UDF) w ith valid values in SAP Business One
In the SAP Business One Form the left column displays the value which can usually
be queried and is returned by the default datasources.
In order to obtain the value on the right (description) the LD.GetDesc Function
must be used.
Example:
Translation
The description of the valid values can also be translated (1). In order to print the
translated description of the UDF additionally provide the Language Id as a
parameter and consider to use the correct table (2) as displayed in the definition.
use the table as display ed in the Translations Form (point 2 in Sc reenshot below ).
Example:
LD.GetDesc("ADOC","U_UDF",GetData("B1_Data.Document.U_UDF"),GetData
("LD.Par.LangCode"))
GetDimensions
In the next example, an image which is in item settings must be displayed with
maximum 320px width and height. This function cannot be used in the bindings, as
it doesn’t give a return value. In the example, an image was inserted in the layout
and given the name ‘ProductImage’ in the properties. The following code was
inserted in the Common Script:
To be able to use this function, the DrawImage function must be run first. If
not, the input parameter ‘Productimage.Image’ is missing and the function is
unable to calculate the new dimensions!
318
GetEANC heckDigit
LD.GetEANCheckDigit(<Code As String>)
This function generates a check digit for Codes. In an EAN-13 code, for example,
the last digit is a check digit:
If the 12 first digits of the code are fed into the function, it will generate this
check digit.
LD.GetEANCheckDigit("012345678900")
Return Value: 5
GetFormattedAddress
When new marketing documents are added, SAP® B1 inserts the shipping and
billing addresses in the separator ‘Logistics’. Several addresses can be entered per
business partner. They are essentially divided into two address types: ‘Ship to’ and
‘Bill to’. However, several addresses can be saved under these address types,
using the ‘AddrCode’ label.
If you want to print addresses which have been formatted as explained above,
other than in these documents, you must use this function. Using V1, only the
standard address (usually the billing address) is printed. V2 allows you to print any
address you want. Bellow, the shipping address of Funsport Solo is shown.(C1000).
Displayed:
Althardstr. 999
8105 Regensdorf
SWITZERLAND
GetMLDesc
LD.GetMLDesc(<defValue>,<Table>,<Fieldname>,<Primarycode>,
<Languagecode>)
GetMLDesc function enables you to trial print several field entries from the SAP®-
form in a desired language. Designer offers default translations for the values in
some fields. These can be called into the layout using ‘DescML’. The following
example presents the translation for the name of an item.
320
LD.GetMLDesc(Artikel("ItemName"),"OITM","ItemName",Artikel("ItemCode"),
GetData("LD.Par.LangCode"))
Designparameter
Result:
IsEmpty
LD.IsEmpty(<Element As String>)
This function gives back information on whether a table field has contents or not.
If so, the output is TRUE, if not, FALSE. The next example checks if a product
image has been attributed to an item.
If an image has been attributed, the answer is FALSE, if no image exists, the
answer is TRUE.
IsPurchase / IsSales
LD.IsPurchase(<Formtype As String>)
LD.IsSale(<Formtype As String>)
LD.IsPurchase("139")
MultiLine
LD.MultiLine(<Expression AS String>)
Manual line breaks which are defined in SAP® can be lost in Designer. The
Designer uses a different format to work on line breaks. Example follows. A text
component ‘Remarks’ was integrated in the layout. Two lines of text were written
there and subsequently shown in the print preview.
322
initial situation
The function can now be called from Bindings under properties for this text
component. The following value was entered under Value: LD.MultiLine(Document
("Comments")). Now, the line break will be correctly applied:
MultiLine RTF
LD.MultiLineRTF(<Expression AS String>)
This function works just like the LD.MultiLine. However, it is used for Advanced
Text fields. These text fields process and convert line breaks from SAP®. The
function LD.MultiLineRTF corrects the line breaks so that they are correctly
presented in the layout.
OneNewLine
LD.OneNewLine(<Expression AS String>)
This function can be used in address boxes for example. When the post office box
is omitted, an empty line can be created:
LD.OneNewLine(LD.MultiLine(Document("Adress")))
OpenLayout
In the case of parameters, the description comes first, then the value, even if
there are several parameters. Example: "CardCode", "C1000"
This function allows you to open a layout, for example, using a shape, an arrow or
a similar object. In the following example, an arrow is entered before the card
code of a function, which opens the corresponding CRM report.
The following code was entered in the arrow’s hyperlink under bindings:
LD.OpenLayout("T0000301","CardCode",Datasource("CardCode"),"FromDate",
GetData("LD.Par.FromDate"))
324
Result
The CRM report corresponding to the CardCode is opened.
OpenObject
Objec t Ty pes
V1
LD.OpenObject("2", "C1001")
V2
LD.OpenObject(SAPbouiCOM.BoLinkedObject.lf_BusinessPartner, "C1001")
Result
Both variants open the business partner with the card code "C1001"
OpenPrintdef
This function can open a print definition. In the following example, an offer is
opened, using an arrow shape:
The following code was entered in the arrow’s hyperlink under bindings:
LD.OpenPrintDef(LayoutHelper.LayoutOpener.OpenLayoutModes.Preview,
"149", "DocEntry", "1")
Result
The corresponding document for the offer is opened.
ParamDate
LD.ParamDate(<Element>,<Dateformat>)
This function works just like the ‘’Date’’ function. It is used for data which
requires parameterization.
326
ParamDateTime
LD.ParamDateTime(<Parameter>)
This function works just like the ParamDate. It will return a Datetime format which
enables, for example, subsequent calculations based on that date. In the following
example, a parameter (FromDate) is read as it would appear, for example, in the
CRM report.
LD.ParamDateTime(GetData("LD.Par.FromDate"))
Result
02.04.2008 00:00:00
QueryData
LD.QueryData("<SQL-Query>")
This function makes it possible to extract contents from tables outside the Data
source. The return value is always displayed in the first line and first column of the
query result. If errors are detected in the query, an error report is displayed in its
place.
With the function QueryData, the current user name should be printed. The
following function is inserted as the value for one of the text boxes.
Result
This example serves only for demonstration purposes. The current user name
can also be easily printed using the GetData ("B1_Data.UserDetails.U_NAME").
LD.QueryDataDate("<SQL-Query As String>")
Date(LD.QueryDataDate("Select GetDate()"))
Result
30 days are added to the current date and inserted in the text field. This
example serves only to demonstrate the idea, as there are more reasonable
ways of adding 30 days to the present date.
ReplaceTextParam
This function replaces all text markers which are queried in the form "[%
@U0000276]" by the corresponding inserted text. This function is useful, for
example, when default markers are entered in UDFs instead of text. In the
following example, "[@U0000276]" was inserted in the business partner’s remarks.
When this field is queried in the layouter, the return output "[@U0000276]" is
given without this function.
328
WeekOfYear
LD.WeekOfYear(<Date As Object>)
The WeekOfYear function calculates the corresponding week based on a given data
object, for example, ‘Now’.
For example, inputting 11th March will return the following ‘Week 11’.
Calculation Monday
When the week calculation is to start on Monday, the following syntax can be used:
LD.WeekOfYearMon(<Datum als Objekt>)
WeekOfYearISO8601
Template properties
When the Designer is opened from a layout definition for the first time,
preconfigured settings are loaded into it, allowing you to work directly. Model
settings can naturally be adjusted as well. To access these settings, click on the
upper level of the Document directory and then select properties.
Behaviour When Double Pass is set to True, the Designer renders twice when
the report is accessed. This can be useful, for example, when ‘page
x from y’ appears in the footer. The Designer generates the pages,
counts them and corrects the number of pages in the second cycle.
Without Double Pass, this would not function.
Appearance When Double Pass is set to True, the Designer renders twice when
the report is accessed. This can be useful, for example, when ‘page
x from y’ appears in the footer. The Designer generates the pages,
counts them and corrects the number of pages in the second cycle.
Without Double Pass, this would not function.
Design You can define the name of your document in this area. The default
name is usually ‘doc1’, as you can see on the top of the document
directory.
Grid The Grid is the background raster which helps you position
Settings elements. You can define the size of the raster under GridStep, and
whether to show or hide the raster in ShowGrid.
Render The defined style sheet of the document can be changed in
Stylesheet.However, a single style sentence per document will
usually suffice. More Info on styles are to be found in the Texttools
chapter.
Script Under Common Script you can define functions which can be used in
the document. More info on this subject can be found in Functions
chapter in Advanced Designer. Visual Basic is the standard language
in the Designer, but you can change to a different language under
Script Language.
Others You can save further information about the document under Title
and Description. This information can be accessed in Datasources
under ‘Special Fields’, and can be used in the layout.
Texttools
The Text tools in the Designer function like the Office tools. They can be used not
only as simple text formatting options, but also to format styles. To format text
blocks without styles you can work as usual with text tools. Formatting possibilities
include font, orientation, borders, text and background colour and margins
(distances).
330
To work with styles, a text field must be selected and a style must be attributed
from the Dropdownlist. New styles are created with the format model editor. To
open it, click on the button. You can select existing styles under Format and
subsequently work with them in the properties Area. A new style is defined with
the button. It can be formatted again in properties and provided with a name.
This name will also appear in the Dropdown List.
Texttools
Totals
After creating the new Layout definition, the layout is formatted in the Designer.
First, the Data Band is extracted from where the Data source ‘Opportunity’ is
shown in properties. This data band features a header section where the columns
are identified using simple text elements. A few details follow the header section.
In this example, the first detail components include service job number, the card
code and the BP name, as well as the pondered value. This is followed by another
detail at full width, which displays the call definition. The third detail in this
example serves only as separation. It contains no text elements. All these details
are then repeated as many times as there are data sentences in the Opportunity
table. At the end, the sum of all these pondered values should be displayed. This
element should obviously not be repeated. Consequently, a footer with a text box
is inserted after the data sentences.
332
c reate lay out
The next step is about calculating the sums in the data band and displaying them
in the text box in the footer area. First, the sum has to be calculated. For that
purpose, this aggregate function must be added to the data band. Next, use the
mouse to select the data band and choose ‘Totals’ from properties. All aggregate
settings are defined in properties. In this example, ‘Sum’ must be selected from ‘
Aggregate function’. From ‘Expression’ select ‘Pondered Value’ as this will have to
be summed. The name ‘Summe’ will have to be used in the exact same manner
later on.
new aggregate
We have now defined the manner in which the sum is to be calculated. Next, the
sum still has to be displayed in the text element in the footer. To do so, use the
mouse to select the text box. Under the properties of this text box you can change
getTotal
getRunningTotal
In some Cases, a Running Total like in the example below is needed:
334
To design this running Totals, a now column is needed. In the Textbox of the
column, the function getRunningTotal is used. The Aggregate "Summe" is already
defined in this case on the Databand and can be reused in this Case again:
overview Designer
Working area
The working area is the area where the report is designed and configured.
Components can be pulled into this area using a drag and drop command, and be
processed there.
Components (Objects)
These are the structural elements that make up a report. From simple text
structural elements to data bands and data pivot tables: all the necessary elements
to create a report can be found here.
Texttools
Text tools are used for text processing of structural elements, as is the case with
usual MS Office products.
Current object
The components of the report can either be selected from the working area or
from the drop down list. All settings in separator properties refer to the displayed
object.
336
7.2.3 Crystal Reports Designer
This reference guide for the Crystal Reports Designer provides information on
relevant functions and basic tips for the Crystal Reports Designer in relation to the
integration with coresuite into SAP® Business One. The different topics are sorted
alphabetically.
File Storage
File Path
Where the path for the Extension folder can be defined in SAP® Business One
under
Module Administration --> System Initialization --> General Settings --> Path Tab
File ID
In order to view the files relevant for the External Report such as Crystal Reports
you may select the browse button next to the File ID:
Relevant Files
Two files are required to design reports with Crystal
1. Crystal Reports Design File (*.rpt) which is stored in the folder "FileToDesign"
2. The dataschema which stores both, the data used in the report and the schema
(information if a field is string or integer,...).
This xml file is created as soon as Crystal Reports is launched from the
Layoutdefinition and stored in the Extension Folder:
Initiate a Reinstall in the coresuite designer Config Menu (-> Paths get
3.
corrected)
Multi-Language reports
Together with the data relevant for your documents or reports coresuite also
provides the Datasource for all translated texts in called SWA_LD_Txt.
Via Drag and Drop from the Field Explorer into a textbox in your report you can
ensure your reports will always be translated to the required language.
Multi-Layouts
The best practise is to look at the DOC_Document DIN - RPT (DOC40000) layout
delivered for all Marketing layouts to get some details.
The general idea is to to use
1. Formula Fields in Crystal Reports store the dynamic values
2. Either the Object Type from the data field {Document.ObjType} or the FormType
from the data field {SWA_LD_Par.FormType} to get the actual document or
object type.
3. Different cases for each object type
338
Opening Crystal Reports Designer
Crystal Reports can be opened from the Layoutdefinition Form with the following
steps:
Pre-Defined Datasources
With the layout definition you can use certain pre-defined datasources relevant for
different categories such as documents, crm, sales documents, etc. To use these
datasources in your crystal report follow the steps described below:
1. Create a new connection with the Database Expert in Crystal Reports --> Menu
Database --> Database Expert
2. Make new connection with ADO.NET (XML)
3. Enter the file path of the dataSchema.xml file provided by coresuite. This file is
created and refreshed every time Crystal Reports is launched from the
Layoutdefinition. It is stored under Extension Folder +
"\SWA_LD\ExternalReport\FILE ID". In order to have a dynamic File path you may
also use
"../dataSchema.xml"
as file path
340
4. Select the "Finish" button to create the new connection which will be named
"B1_CR_Data"
5. Now you can add and remove any datasource you need for your report
Remote Designing
If you want to design your report on a system that only has Crystal Reports but not
SAP® Business One installed you only need to copy the 2 files
1. Crystal Reports Design File (*.rpt) which is stored under "SAP Extension Folder
+ "\SWA_LD\ExternalReport\FILE ID\FileToDesign"
2. dataSchema.xml
to your system. The dataSchema.xml provides the correct schema and sample data
to design your report.
342
Subreports Links
When creating subreports it is important to set the correct link and filter to
prevent any duplication of data in the Details section of your main report.
You can adjust links and filters in your subreport after it has been added with the
following steps.
1. Right-Click on your report and select Change Subreport Links...
2. Select all Fields from the Main report you will have to use in the subreport. This
includes the fields to be used as a filter (for example LineNum) and also fields
that will be displayed in the subreport but are coming from the main report such
as Texts, Formula Fields or General Data. IN general DO NOT select the
Checkbox "Select data in subreport based on field:"
3. Inside the Subreport set the correct filter in the Select Expert
Data Transfer
Definition
In the XCelsius template provided with the coresuite country package the
definition for the Database connection is already predefined and should not be
changed.
The settings are as displayed below:
Load Data
For our Dashboards we only load the data from the cache. In the XCelsius template
provided with the coresuite country package one sample query to load the
Company Name and display it in the Header of the Dashboard is already included.
344
To load your data into the XCelsius Dashboard follow the steps described below:
1. Create and Save the Query in SAP Business One under your own component. (Do
not use the General Component)
2. Attach the Query to your Layoutdefinition
3. In XCelsius enter the correct name of the Query. More information on the
correct Query name for the 2 Export Types "XCelsius XML" and "Simple XCelsius
XML" is available under Query Naming Conventions.
4. Define the Range in the Excel Spreadsheet when the data should be entered
Usage
Do not forget to set the correct Refresh Interval under Usage Tab.
346
File Storage
File Path
Where the path for the Extension folder can be defined in SAP Business One
under
Module Administration --> System Initialization --> General Settings --> Path Tab
If no Extension Folder is defined the AddOn Folder in the SAP Business One
Client will be used instead.
File ID
In order to view the files relevant for the External Report such as XCelsius you may
select the browse button next to the File ID:
Relevant Files
Two files are required to display reports with XCelsius
The info.txt file stores the timestamp when the cache in the data.xml was
refreshed the last time.
Initiate a Reinstall in the coresuite designer Config Menu (-> Paths get
3.
corrected)
Flashfile Integration
Once the XCelsius Dashboard is completed and exported to Flasfile (*.swf) you may
save the Flashfile anywhere on your system on integrate it to the Layoutdefinition
as described below:
348
Multi-Language Dashboard
In order to be able to display the labels and data of the Dashboard in the current
language set in SAP Business One you may use the Multi-Language Textcodes of
the coresuite designer.
For performance reaseon we suggest to only load the textcodes used in the
XCelsius Dashboard.
In the XCelsius template provided with the coresuite country designer there are
already a few examples of how we translated the labels in our dashboards.
.
Sample Query in SAP Business One
=VLOOKUP("T0070013";SWA_LD_TEXT!A1:B50;2;FALSE)
The XCelsius can be opened from the Layoutdefinition Form with the following
steps:
A sample XCelsius (XLF) File is delivered with the coresuite country package that
can be used to create your Dashboard. The Database connections are already
defined here. This file is stored in the externalreport folder in the default
installation path of the coresuite designer.
The Dashboards delivered with the coresuite country package do not use the
350
design file. That means you may not make any adjustments to these Dashboards
besides adjusting the Refresh Interval
Refresh Interval
All standard XCelsius reports delivered with the coresuite country package are
refreshed automatically in a pre-set time Interval. That means in this time interval
the queries from the datasource are executed and refreshed in the cache for the
XCelsius Dashboard.Depending on the requirements of the company and the
amount of data to be retrieved, the time interval can be adjusted for each
Dashboard in the Layoutdefinition on the "External Report" tab.
Notice that the minimum refresh interval for the Dashboards delivered with the
country package is 10 seconds. This is defined as the default refresh interval in
XCelsius itself.
This also means that the actual refresh interval might be up to 10 seconds more
than the interval set in the Layoutdefinition as explained above.
For user specific created Dashboards the time interval in XCelsius can be adjusted
accordingly.
Sample Dashboards
The coresuite country package includes several "Sample Dashboards" which are
designed with one component only. These dashboards can be used to create your
own Dashboards without requiring the knowledge or access to Crystal Dashboards
Designer Software.
When these Simple Dashboards are combined (for example in the SAP 8.8 Cockpit)
they make a new user defined dashboard with data only relevant for the specific
company.
For more details on how to use those sample dashboards to create your own
dashboard see the Training Guide Creating a Simple Dashboard.
The Sample Column Chart Dashboard displays the Quantity of the Top 12 items in
Stock in comparison to the Quantity Committed on Sales Orders.
352
Dashboard
All Sample Queries delivered w ith the c oresuite c ountry pac kage w ith prefix
COR_COL c an be used for this Dashboard Container
/*
***** General Information *****
Name: COR_COL_Top12ItemsOnHand
Description:
Returns the in Stock Quantity in Comparison to the Is
Committed Quantity of the 12 Items with most in Stock
/* @@Timeout=[1200]*/
SELECT TOP 12
/* Label ItemCode */
ItemCode AS Serie
/* Monthly Balance */
,'In Stock' AS Category1
,OnHand AS Value1
/* Monthly Budget */
,'Is Committed' AS Category2
,IsCommited AS Value2
/*
,'234767' /* BLUE */ AS Color1
,'EAA013' /* YELLOW */ AS Color2
*/
FROM OITM
ORDER BY OnHand Desc
The Sample Gauge Dashboard displays the Quantity of the Top 12 items in Stock in
comparison to the Quantity Committed on Sales Orders.
Dashboard
354
$
Sample Gauge
All Sample Queries delivered w ith the c oresuite c ountry pac kage w ith prefix
COR_GAU c an be used for this Dashboard Container
/*
***** General Information *****
Name: COR_GAU_TurnoverVsBudget
Description:
Returns the Percentage of Turnover in Comparison of the
Budget for the current financial year
(Total Journal Entries)
The data is gathered from the View: [COR_VIEW_FIN_FINANCE]
SAMPLE:
/* @@Timeout=[1200]*/
SELECT
'Value' AS Value
,'MaxLimit' AS MaxLimit
,'FromRange1' AS FromRange1
,'FromRange2' AS FromRange2
,'Turnover' AS Value
,'Budget' AS [Target]
,'Delta' AS Gap
356
UNION ALL
SELECT
CASE WHEN SUM(DebMonthlyBudget - CredMonthlyBudget) = 0
THEN '1.0' ELSE CAST(SUM(Debit - Credit)/SUM(DebMonthlyBudget
- CredMonthlyBudget) AS nvarchar(521)) END AS Value
,'1' AS MaxLimit
,'0.6' AS FromRange1
,'0.9' AS FromRange2
/* Retun the amounts in with SAP Business One settings
for Thousand Seperator and always 0 decimals */
,REPLACE(REPLACE(CONVERT(varchar, CAST(ROUND(SUM(Credit
- Debit),0) AS money),1),'.00',''),',',@ThousSep) AS Value
,REPLACE(REPLACE(CONVERT(varchar, CAST(ROUND(SUM(
CredMonthlyBudget - DebMonthlyBudget),0) AS money),1),'.00',
''),',',@ThousSep) AS [Target]
,REPLACE(REPLACE(CONVERT(varchar, CAST(ROUND(SUM(
CredMonthlyBudget - DebMonthlyBudget) - SUM(Credit - Debit),0
) AS money),1),'.00',''),',',@ThousSep) AS Gap
FROM COR_VIEW_FIN_FINANCE V1
WHERE
/* Use current Finance Year Only */
Year = DatePart(year,@FinancYear)
/* Only use acoremask 40 of postable account and
groupmask not eqal to 9*/
AND V1.CoreMask = '40'
AND V1.Postable ='Y' AND V1.GroupMask <> 9
AND V1.Type <> 'BTF1_JournalVoucher'
The Sample Pie Chart Dashboard displays the Quantity of the Top 12 items in Stock
in comparison to the Quantity Committed on Sales Orders.
Dashboard
Click on the magnifier to hide the Legend and enlarge the Pie Chart.
To go back to the previous view select the information icon.
358
Sample Pie Chart > W ithout Legend
All Sample Queries delivered w ith the c oresuite c ountry pac kage w ith prefix
COR_GAU c an be used for this Dashboard Container
/*
***** General Information *****
Name: COR_PIE_TopItems
Description:
Returns the Top 10 Items by Sales Revenue
(Total of all Invoices and Credit Memos)
The data is gathered from the View: [COR_VIEW_SAR_SALES]
/* @@Timeout=[1200]*/
SELECT TOP 10
SUBSTRING(ItemName,0,20) AS Name
,SUM(LineTotal) AS Value
/*,CASE ROW_NUMBER() OVER(ORDER BY SUM(LineTotal) DESC)
WHEN '1' THEN '43900A' /* GREEN */
WHEN '2' THEN 'EAA013' /* YELLOW */
WHEN '3' THEN 'B80D02' /* RED */
WHEN '4' THEN '234767' /* BLUE */
WHEN '5' THEN '161616' /* DARK GREY */
ELSE ''
END AS color*/
FROM [COR_VIEW_SAR_SALES]
WHERE ObjType IN ('13','14')
GROUP BY ItemName
ORDER BY SUM(LineTotal) DESC
360
8 coreuite enterprise search
How much time do you spend searching for SAP® Business One documents every
day? How great would be to have just one tool to search Business Partners,
Marketing Documents, Master Data and much more... With coresuite enterprise
search you can do this! Now you can access all objects of your SAP® Business
ONE Systems in a single screen!
On the left of the enterprise search the user has the possibility to switch between
the "search" mode ( ), the "my objects" mode ( ) and the "history" mode (
).
"Search" Mode
Two search capabilities are provided: the indexed search and the free text search.
In this section the indexed search will be briefly discussed. Please refer to the
specific sections to understand the functionalities provided by each research
method.
While typing some letters the autocomplete offers you possible matches. After
selecting one entry from the drop down list, all the documents related to this entry
are displayed on the main result box.
362
The autocomplete feature contains all the Business Partners, the Business Partner
Contacts, the Employees and the Items currently recorded into SAP® Business
ONE.
All search results are displayed in a tree view. Every category header displays
within brackets the number of found documents. All open overdue documents are
highlighted in red.
364
"My Objects" Mode
This functionality gives an overview about the documents currently assigned to the
logged user. After selecting the "my objects" tab all the documents assigned will be
automatically loaded and displayed to the user.
366
8.2 Reference Guide
After the first installation some fields are search enabled by default.
The following table defines the default settings for each category.
368
Remarks
Service Contract ID
Contracts
Customer Code
Customer Name
Contact Person Code
Contact Person Name
Description
be.as integration
The enterprise search allows to search for work orders in case your Company is
using be.as Add-On 2009-SP01 Build 19 or higher.
By default, the following fields are enabled by default after the first installation:
8.2.2 Configuration
Superusers can define the searchable fields for each type of SAP® Business ONE
searchable object.
Business ONE users have the possibility to choose different kind of options that will
affect the search results.
Superuser Settings
The settings icon allows the superuser to access the full configuration menu.
The entry "Company field settings" shows enabled \ disabled fields scanned by the
search engine for all the users.
The new configuration will take effect for all the users after restarting SAP®
Business ONE
Selectable fields are all the most relevant standard fields of Business ONE plus all
the user define fields of each category.
370
Fields marked with are those taken into consideration by the search engine.
Selecting too many fields you could face performance issue. Please select
carefully the fields you really need.
If some UDFs have been defined into a certain table related with a certain
category, such UDFs will be also displayed and searchable as well.
Please note that UDFs are not activated by defaults and need to be enabled by a
superuser.
Consider for example the Business Partner Master Data, where a new UDF called
"Served Area (UDF)" has been created.
The coresuite enterprise search allows you to set this field as searchable in the
company field settings menu associated to the Business partners category.
Every user can choose different parameters to refine the search result.
The following sections explain the purpose of each setting.
This category allows the user to restrict the search only to the documents assigned
to him.
In the following example only one Sales Order has been assigned to the current
logged user "Peter Knecht". When an extended research is performed, only the
sales order 245 assigned to him is displayed.
372
Categories affected by the "only my documents" setting are: All the marketing
documents, drafts, service calls and sales opportunities.
"Include document lines settings" allows to search in the body of the document.
In the following example the user searches for item I00008 in the body of the
document. All the documents which contain this item number in the body are
displayed by the coresuite enterprise search.
If the users want to search closed documents, they should activate the "Include
closed documents" setting.
With this setting enabled both open and closed documents are searched by the
search engine.
Included categories
The user has the possibility to define the categories which he is interested to
view.
Searchable categories are displayed below.
374
coresuite time integration
be.as integration
If the external Add-On be.as is installed, the following categories are also
available:
The integrated search is the main feature of coresuite enterprise search. The
following documents are now supported by the search engine:
· Activities
· Business Partners
· Business Partners Contacts
· Drafts
· Employees
· Items
· Production Order
· Sales Opportunities
· Marketing Documents
- Sales Quotations
- Sales Orders
- Deliveries
- Returns
- A/R Down Payment Requests
- A/R Down Payment Invoices
- A/R Invoices
- A/R Credit Memo
- A/R Reserve Invoices
- Purchase Quotations (only available in SAP Version 8.81 and higher)
- Purchase Orders
- Good Receipts PO
- Good Returns
- A/P Down Payment Requests
- A/P Down Payment Invoices
- A/P Invoices
- A/P Credit Memo
- A/P Reserve Invoices
· Service Calls
· Service Contracts
376
In the chapter Enabled Fields it is described which fields are automatically
activated by default when installing coresuite enterprise search the first time.
Indexed Search allows the user to gather all the documents related to the selected
entry in the drop down list.
The autocomplete drop down list allows the users to select between Business
Partners, Business Partners Contacts, Employees and Items.
be.as integration
If the be.as AddOn is installed, the following results are also expected:
Indexed search is usually faster than the free text search. Whenever possible
this should be the first search method used by the user.
The free text search allows to search specific text in the Included categories
predefined by the user and the fields defined by the superuser.
To perform a free text search users have to click the search button .
Please note that if you select an entry from the drop down list you activate the
indexed search instead of the free text search and the search result could
differ.
378
The menu entries Time Projects and Subscriptions are only available if core
suite time in currently installed.
Advanced Search
The advanced search allows searching of multiple terms at the same time. For
example it is possible to search for a business partner that has already bought the
newly introduced item.
The single search term can be combined by the Boolean operator AND.
Assume that you want to find all the documents related to the Business Partner
"CTI Computer" which contain the item code "I00012". The string used to perform
this search is: CTI Computer AND I00012 .
After typing the search string press the button to perform the search.
All search results are displayed in a tree view. Every category header displays
within brackets the number of documents found.
380
Open documents which are overdue are highlighted in red.
High priority service calls are marked with a red exclamation point (e.g.
).
Actions
Right clicking on each result item will open a context menu where different actions
could be performed. The following table defines all the possible options available
for each category.
382
8.2.4 Open documents view
My objects show all assigned documents of the current SAP® Business One user.
Buttons
Refresh open documents
Open the menu, after selecting the relevant object
As in the Search Tab, it's possible to display the context menu by right clicking the
selected document.
The history folder shows the last edited SAP® Business One documents (since 10
days ago) sorted by date.
384
Buttons
Refresh open documents
Open the menu, after selecting the relevant object
This section includes all information about standard layouts and reports delivered
with the coresuite country package.
The Overview displays a list of all available reports and layouts. These are grouped
in categories and detailed information about the settings and data displayed is
documented for each report.
9.1 Overview
The following Reports and Layouts are included in the coresuite country package
Usage and
Name Content Description
Menu entries
Outgoing Letter to a Business Partner which To display the form
Payment - LD includes relevant information about from the Preview
(BAN1000) CD Outgoing Payments. of the Form
LD
"Outgoing
Payment" (426)
Select -> Banking ->
Outgoing Payments
-> Outgoing
Payments
CRM Report - This Report displays all relevant To display the form
LD (BUP00301) information for a certain Customer from the Preview
CD LD
(Contact Details, Addresses, Sales of the Form
Volume, Opportunities, Activities, Service "Business Partner
Calls, Financial Information,...). Master Data" (134)
Displayed are all open documents and Select -> Business
documents created after the Reference Partner -> Business
386
Usage and
Name Content Description
Menu entries
Date entered by the user. Partner Master Data
CRM Report - This Report displays all relevant To display the form
CR (BUP20000) information for a certain Customer from the Preview
CR
(Contact Details, Addresses, Sales of the Form
Volume, Opportunities, Activities, Service "Business Partner
Calls, Financial Information,...). Master Data" (134)
Displayed are all open documents and Select -> Business
documents created after the Reference Partner -> Business
Date entered by the user. Partner Master Data
Document ESR Printing for the ESR document attached to To display the form
- LD an AR Invoice. from the Preview
(DOC00006) of the Form "AR
CD LD CH
Invoice" (133)
Select -> Sales AR ->
AR Invoice
Item Label - Sample for label printing of all items To display the form
LD included in a Marketing document adjust the relevant
(DOC00007) Printdefinitions
CD LD
By default not
assigned to any
Printdefinition. This
layout can be used
to attach to any
Marketing
document.
Document DIN Available for coresuite france and To display the form
FR - LD benelux (Belgium) only. from the Preview
(DOC00009) Standard Marketing Document Layout to of any Marketing
CD LD FR
send to customers and vendors. Can be document Form
used for the following marketing Select -> Sales AR ->
document in SAP Business One: · Sales Quotation
Sales (149)
· Sales Order (139)
· Sales Quotation
· Delivery (140)
· Sales Order · Return (180)
· Delivery · AR Down Payment
· Return Request (65308)
· AR Down Payment Request · AR Down Payment
Invoice (65300)
· AR Down Payment Invoice
· AR Invoice (133)
· AR Invoice · AR Credit Note
· AR Credit Note (179)
· AR Reserve Invoice · AR Reserve
Purchasing Invoice (60091)
· Purchase Order or select ->
· Goods Receipt PO Purchasing AP -> ...
· Purchase Order
· Goods Return
(142)
· AP Down Payment Request · Goods Receipt
388
Usage and
Name Content Description
Menu entries
· AP Down Payment Invoice PO (143)
· AP Invoice · Goods Return
· AP Credit Note (182)
· AP Down Payment
· AP Reserve Invoice
Request (56309)
· AP Down Payment
Invoice (56301)
· AP Invoice (141)
· AP Credit Note
(181)
· AP Reserve
Invoice (60092)
Document DIN Available for coresuite france and To display the form
FR Blue - LD benelux (Belgium) only. from the Preview
(DOC00010) Standard Marketing Document Layout to of any Marketing
CD LD FR
send to customers and vendors. Can be document Form
used for the following marketing Select -> Sales AR ->
document in SAP Business One: · Sales Quotation
Sales (149)
· Sales Order (139)
· Sales Quotation
· Delivery (140)
· Sales Order · Return (180)
· Delivery · AR Down Payment
· Return Request (65308)
· AR Down Payment Request · AR Down Payment
Invoice (65300)
· AR Down Payment Invoice
· AR Invoice (133)
· AR Invoice · AR Credit Note
· AR Credit Note (179)
· AR Reserve Invoice · AR Reserve
Purchasing Invoice (60091)
· Purchase Order or select ->
· Goods Receipt PO Purchasing AP -> ...
· Purchase Order
· Goods Return
(142)
· AP Down Payment Request · Goods Receipt
· AP Down Payment Invoice PO (143)
· AP Invoice · Goods Return
· AP Credit Note (182)
· AP Reserve Invoice · AP Down Payment
Request (56309)
· AP Down Payment
Invoice (56301)
· AP Invoice (141)
· AP Credit Note
(181)
· AP Reserve
Document DIN Available for coresuite france and To display the form
FR Green - LD benelux (Belgium) only. from the Preview
(DOC00011) Standard Marketing Document Layout to of any Marketing
CD LD FR
send to customers and vendors. Can be document Form
used for the following marketing Select -> Sales AR ->
document in SAP Business One: · Sales Quotation
Sales (149)
· Sales Order (139)
· Sales Quotation
· Delivery (140)
· Sales Order · Return (180)
· Delivery · AR Down Payment
· Return Request (65308)
· AR Down Payment Request · AR Down Payment
Invoice (65300)
· AR Down Payment Invoice
· AR Invoice (133)
· AR Invoice · AR Credit Note
· AR Credit Note (179)
· AR Reserve Invoice · AR Reserve
Purchasing Invoice (60091)
· Purchase Order or select ->
· Goods Receipt PO Purchasing AP -> ...
· Purchase Order
· Goods Return
(142)
· AP Down Payment Request · Goods Receipt
· AP Down Payment Invoice PO (143)
· AP Invoice · Goods Return
· AP Credit Note (182)
· AP Reserve Invoice · AP Down Payment
Request (56309)
· AP Down Payment
Invoice (56301)
· AP Invoice (141)
· AP Credit Note
(181)
· AP Reserve
Invoice (60092)
Dunning Letter Layout to print Dunning Letters from the To display the form
- LD SAP Dunning Wizard from the Preview
(DOC02500)CD of the
LD
Form"DunningLette
rSelect"
-> see below
390
Usage and
Name Content Description
Menu entries
Dunning Letter A new Form "DunningLetterSelect" which To display the form
- Select Grid displays a Select Grid with the list of from the Preview
CD
(DOC02501) Customers from the loaded Dunning Run. of the Form
LD
"Dunning
Printing" (60014)
Select -> Sales AR ->
Dunning Wizard ->
Load existing Run ->
Preview from Step 5
of 6 in the Wizard
Document DIN This Layout was created with Crystal To display the form
- CR Reports. adjust the relevant
(DOC40000) Standard Marketing Document Layout to Printdefinitions
CD CR
send to customers and vendors. Can be By default not
used for the following marketing assigned to any
document in SAP Business One: Printdefinition. This
Sales layout can be used
· Sales Quotation to attach to any
· Sales Order Marketing
· Delivery document.
· Return For coresuite
· AR Down Payment Request america this layout
· AR Down Payment Invoice can be accessed by
· AR Invoice the preview from
· AR Credit Note any marketing
· AR Reserve Invoice document form:
Purchasing Select -> Sales AR ->
· Purchase Order · Sales Quotation
· Goods Receipt PO (149)
· Sales Order (139)
· Goods Return
· Delivery (140)
· AP Down Payment Request · Return (180)
· AP Down Payment Invoice · AR Down Payment
· AP Invoice Request (65308)
· AP Credit Note · AR Down Payment
Invoice (65300)
· AP Reserve Invoice
· AR Invoice (133)
· AR Credit Note
(179)
· AR Reserve
Invoice (60091)
or select ->
Purchasing AP -> ...
· Purchase Order
Employee List Listing of the names, phone numbers and To display the form
- LD email addresses of all Employees of the from the Main
(EMP50000)CD selected department(s). Menu
LD
Select Human
Resources -->
Human Resources
Reports -->
Employee List
(EMP50000)
Chart of Listing of all accounts and the existing To display the form
Accounts - LD profit centers and distribution rules. from the Main
(FIN05401) LD Menu
Select coresuite
Reports -->
Financials --> Lists
--> Chart of
Accounts (FIN05401)
392
Usage and
Name Content Description
Menu entries
Balance Balance sheet according to an external To display the form
Template - LD Template (SAP® partners can create their from the Main
(FIN05403) LD own templates). Menu
Select coresuite
Reports -->
Financials -->
Balance Sheet -->
Balance Template
(FIN05403))
Profit and Profit and loss statement according to the To display the form
Loss - LD chart of accounts (only standard subtotals from the Main
(FIN05404) LD and standard groupings) with possibility Menu
to analyse for each profit center, project Select coresuite
or distribution rule. Reports -->
Financials --> Profit
and Loss --> Profit
and Loss (FIN05404)
Profit and Profit and loss statement according to an To display the form
Loss Template external individual template (including from the Main
- LD the possibility to analyse for each profit Menu
(FIN05405) LD center, project or distribution rule) Select coresuite
Reports -->
Financials --> Profit
and Loss --> Profit
and Loss by
Template
(FIN05405)
BP Account Account journal per business partner (all To display the form
Journal - LD postings per business partner) from the Main
(FIN05410) LD Menu
Select coresuite
Reports -->
Financials -->
Customer (A/R) -->
Customer (A/R)
Account Journals
(FIN05410)
Opening Opening Balance (in general the 1st day of To display the form
Balance - LD each fiscal year, without ongoing from the Main
(FIN05413) LD bookings for the new fiscal year) Menu
Select coresuite
Reports -->
Financials -->
Balance Sheet -->
Opening Balance
(FIN05413)
VAT by Code - List of taxation and VAT base amounts To display the form
LD (FIN05414) for each tax code defined in the from the Main
LD
corresponding period. Menu
Select coresuite
Reports -->
Financials --> Tax
Report --> VAT by
Code (FIN05414)
394
Usage and
Name Content Description
Menu entries
VAT by List of taxation and VAT base amounts To display the form
Account - LD for each account and tax code defined in from the Main
(FIN05415) LD the corresponding period. Ideal to derive Menu
the VAT-liable turnover. Select coresuite
Reports -->
Financials --> Tax
Report --> VAT by
Account (FIN05415)
Reconciliation Sub report used by default from other To display the form
- LD reports to display details about the from the Report
(FIN05416) LD reconciliation. Select Linked Arrow
in --> Journal Entry
(FIN05419)
Journal Entry - Collection and presentation of all journal To display the form
LD (FIN05419) entries (possibly filtered by marketing from the Main
LD
document type). Menu
Select coresuite
Reports -->
Financials -->
Journal/Statement
--> Journal Entry
(FIN05419)
or
To display the form
from the Preview
of the Form
"Journal
Entry" (392)
Select -> Financials
-> Journal Entry
Profit and Profit and loss statement divided into To display the form
Loss by profit centers (including KPI measures). from the Main
Profitcenter - Menu
KPI Correct Account Mapping is required Select coresuite
(FIN05430)LD to view this report. Reports -->
Financials --> Profit
and Loss --> Profit
and Loss by Profit
Center (FIN05430)
396
Usage and
Name Content Description
Menu entries
Financials -->
Budget --> Budget
Report (FIN05433)
Profit and Lost Profit and loss statement according to KPI To display the form
- KPI (with financial ratios), including the from the Main
(FIN05438)LD option to filter by profit center, project or Menu
distribution rule. Select coresuite
Reports -->
Correct Account Mapping is required Financials --> Profit
to view this report. and Loss --> Profit
and Loss - KPI
(FIN05438)
Tax Report Available for coresuite switzerland only. To display the form
Switzerland - Country specific Report for Tax from the Main
LD (FIN05450) Declaration. This report is available in the Menu
LD CH
languages German, French and Italian Select coresuite
only. Reports -->
Financials --> Tax
Report --> Tax
Report Switzerland
(FIN05450)
Journal des Available for coresuite france and To display the form
écriture - LD benelux (Belgium) only. from the Main
(FIN05500)LD Menu
FR
Select Financials -->
Financial Reports ->
Accounting ->
Extension ->
Journaux -->
Sélection/Code
Transaction
(FIN05500)
or select Financials
--> Financial
Reports ->
Accounting ->
Extension ->
Journaux -->
Sélection
automatique
· Achat (FIN05500)
· Vente (FIN05500)
· Stock (FIN05500)
· Ecriture
398
Usage and
Name Content Description
Menu entries
(FIN05500)
· Chèque
(FIN05500)
· Report à nouveau
(FIN05500)
· Effet de
commerce
(FIN05500)
· Encaissement
(FIN05500)
· Décaissement
(FIN05500)
· Dépôt (FIN05500)
· Tous (FIN05500)
Cumuls des BP Available for coresuite france and To display the form
(FIN05511)LD benelux (Belgium) only. from the Main
FR
Menu
Select Financials -->
Financial Reports ->
Accounting ->
Extension -> Grand
livres --> Cumulus -
> Cumulus des
clients (FIN05511)
or select Financials
--> Financial
Reports ->
Accounting ->
Extension -> Grand
livres --> Cumulus -
> Cumulus des
Cumuls des Available for coresuite france and To display the form
comptes benelux (Belgium) only. from the Main
généraux Menu
(FIN05513)LD Select Financials -->
FR
Financial Reports ->
Accounting ->
Extension -> Grand
livres --> Cumulus -
> Cumulus des
comptes généraux
(FIN05513)
400
Usage and
Name Content Description
Menu entries
Journaux --> Journal
périodique
(FIN05517)
Grand Livre Available for coresuite france and To display the form
devise interne benelux (Belgium) only. from the Main
(FIN05518)LD Menu
FR
Select Financials -->
Financial Reports ->
Accounting ->
Extension -> Grand
livres --> Général ->
Devise interne
(FIN05518)
Grand Livre Available for coresuite france and To display the form
toutes devises benelux (Belgium) only. from the Main
(FIN05519)LD Menu
FR
Select Financials -->
Financial Reports ->
Accounting ->
Extension -> Grand
livres --> Général ->
Toutes devise
(FIN05519)
Grand Livre Available for coresuite france and To display the form
centre / benelux (Belgium) only. from the Main
général Menu
(FIN05520)LD Select Financials -->
FR
Cost Accounting ->
Etats -> Grand livres
--> Centre / Général
(FIN05520)
Grand Livre Available for coresuite france and To display the form
général / benelux (Belgium) only. from the Main
centre Menu
(FIN05521)LD Select Financials -->
FR
Cost Accounting ->
Etats -> Grand livres
--> Général / Centre
(FIN05521)
Grand Livre Available for coresuite france and To display the form
général / benelux (Belgium) only. from the Main
projet Menu
(FIN05523)LD Select Financials -->
FR
Cost Accounting ->
Etats -> Grand livres
--> Général / Projet
(FIN05523)
Grand livre Available for coresuite france and To display the form
des BP benelux (Belgium) only. from the Main
(FIN05525)LD Menu
FR
Select Financials -->
Financial Reports ->
Accounting ->
Extension -> Grand
livres --> Clients ->
Grand livre des
clients (FIN05525)
or select Financials
--> Financial
Reports ->
Accounting ->
Extension -> Grand
livres --> Clients ->
Grand livre des
fournisseurs
(FIN05525)
402
Usage and
Name Content Description
Menu entries
Extension ->
Balances -> Clients -
> Balance
collectifs / clients
(FIN05527)
or select Financials
--> Financial
Reports -> Financial
-> Extension ->
Balances -> Clients -
> Balance
collectifs /
fournisseurs
(FIN05527)
Balance clients Available for coresuite france and To display the form
(FIN05530)LD benelux (Belgium) only. from the Main
FR
Menu
Select Financials -->
Financial Reports ->
Financial ->
Extension ->
Trial Balance - List of all account without grouping To display the form
LD (FIN05533) (Brought forward, Debit, Credit, Balance). from the Main
LD
This is the ideal report for the accountant Menu
who can retrieve a breakdown in Debit Select coresuite
and Credit. Reports -->
Financials -->
Journal/Statement
--> Journal Balance
(FIN05533)
or in coresuite
france and benelux
(Belgium) only:
Financials -->
Financial Reports ->
Financial ->
Extension ->
Balances -->
Générale -> Balance
générale Devise
interne (FIN05533)
Balance centre Available for coresuite france and To display the form
/ générale benelux (Belgium) only. from the Main
(FIN05534)LD Menu
FR
Select Financials -->
Cost Accounting ->
Etats -> Balances --
> Centre / Général
(FIN05534)
404
Usage and
Name Content Description
Menu entries
Balance Available for coresuite france and To display the form
générale / benelux (Belgium) only. from the Main
centre Menu
(FIN05535)LD Select Financials -->
FR
Cost Accounting ->
Etats -> Balances --
> Général / Centre
(FIN05535)
Balance projet Available for coresuite france and To display the form
/ générale benelux (Belgium) only. from the Main
(FIN05537)LD Menu
FR
Select Financials -->
Cost Accounting ->
Etats -> Balances --
> Projet / Général
(FIN05537)
Grand livre Available for coresuite france and To display the form
collectifs / BP benelux (Belgium) only. from the Main
(FIN05540)LD Menu
FR
Select Financials -->
Financial Reports ->
Accounting ->
Extension -> Grand
livres --> Clients ->
Grand livre
Grand livre Available for coresuite france and To display the form
BP / collectifs benelux (Belgium) only. from the Main
(FIN05542)LD Menu
FR
Select Financials -->
Financial Reports ->
Accounting ->
Extension -> Grand
livres --> Clients ->
Grand livre clients /
collectifs(FIN05542)
or select Financials
--> Financial
Reports ->
Accounting ->
Extension -> Grand
livres --> Clients ->
Grand livre
fournisseurs /
collectifs(FIN05542)
406
Usage and
Name Content Description
Menu entries
interne (FIN05543)
Tax Report Available for coresuite switzerland only. To display the form
Switzerland Country specific Report for Tax from the Main
01.01.2010 - Declaration. This report is available in the Menu
30.06.2010 - languages German, French and Italian Select coresuite
LD (FIN60002) only. Reports -->
LD CH
Financials --> Tax
Report --> Tax
Report Switzerland
01.01.2010 -
30.06.2010
(FIN60002)
Balansrapport Balance report specific for the Swedish To display the form
- LF Localization from the Main
(FIN60005) CR Menu
SE
Select Reports -->
Financials -->
Financial -->
Balansrapport - LF
(FIN60005)
Parameter Report displays current Print and System To display the form
Check - LD Parameters such as Versions, File Paths, from the Preview
(GEN00012)LD Status,... of the Form
"Printdefinition"
Select ->
Administration ->
Add-ons -> core
suite designer ->
Printdefinition
408
Usage and
Name Content Description
Menu entries
-> Production Order
Sales Pivot - Pivot Table for Sales Revenue To display the form
LD from the Main
(SAR06001) CD Menu
LD
Select coresuite
Reports --> Sales --
> Sales Pivot
(SAR06001)
Stock Transfer Layout for stock transfer document with To display the form
- LD an overview of all items, locations, from the Preview
CD
(STO08003) quantities and prices including of the Form "Stock
LD
information about serial and batch Transfer" (940)
numbers. Select -> Stock
Management ->
Stock Transactions -
> Stock Transfer
Pick List - LD Layout for Pick List with an overview of To display the form
(STO08004)CD selected Orders, items, locations and from the Preview
LD
quantities. of the Form "Pick
List" (85)
Select -> Stock
Management -> Pick
and Pack -> Pick
List
9.2 Banking
410
9.2.1 Outgoing Payment - LD (BAN1000)
Purpose
Letter to a Business Partner which includes relevant information about Outgoing
Payments.
To display the form from the Preview of the Form "Outgoing Payment" (426)
Select -> Banking -> Outgoing Payments -> Outgoing Payments
Layout
9.3 Documents
The category Documents includes any layouts for Marketing documents to be sent
to customers and vendors.
Description
Standard Multi-Language DIN Layout designed for all Marketing documents under
the Sales and Purchasing Modules. It applies the standard requirements of a
business letter to be sent to customers and vendors. Due to the expandable data
sources the layout can be adjusted with additional customized information stored
in User Defined Fields.
· The company Logo is automatically updated from the Logo defined in SAP under
· If exists Item Serial Numbers, Batches and Pictures are printed for each relevant
document row.
· Relevant information about base documents, payment and tax information and
down payments is printed when applicable.
Usage
This Layout is automatically assigned to be used for all marketing documents
(including draft documents):
Sales Module
· Sales Quotations
· Sales Orders
· Deliveries
· Returns
· A/R Down Payment Requests
· A/R Down Payment Invoices
· A/R Credit Notes
· A/R Reserved Invoices
Purchasing Module
· Purchase Order
· Goods Receipt PO
· Goods Return
· A/P Down Payment Request
· A/P Down Payment Invoices
· A/R Credit Notes
· A/R Reserved Invoices
412
These Marketing documents can be viewed in SAP Business One as preview before
and after adding the actual document. It can be exported to Word or PDF and
attached to Emails with predefined Subject and To Address.
To display the form from the Preview of any Marketing document Form
Select -> Sales AR ->
· Sales Quotation (149)
· Sales Order (139)
· Delivery (140)
· Return (180)
· AR Down Payment Request (65308)
· AR Down Payment Invoice (65300)
· AR Invoice (133)
· AR Credit Note (179)
· AR Reserve Invoice (60091)
414
Print Definitions
Usage
Sales Module
· Sales Quotations
· Sales Orders
· Deliveries
· Returns
· A/R Down Payment Requests
· A/R Down Payment Invoices
· A/R Credit Notes
· A/R Reserved Invoices
Purchasing Module
· Purchase Order
· Goods Receipt PO
· Goods Return
· A/P Down Payment Request
· A/P Down Payment Invoices
· A/R Credit Notes
· A/R Reserved Invoices
Description
Multi-language DIN Layout created with SAP Business Objects Crystal Reports 2008.
Designed for all Marketing documents under the Sales and Purchasing Modules. It
applies the standard requirements of a business letter to be sent to customers and
vendors. Due to the expandable data sources the layout can be adjusted with
additional customized information stored in User Defined Fields.
· The company Logo is automatically updated from the Logo defined in SAP under
SAP Business One Module Administration --> System Initialization --> Print
Preferences --> General Tab
Usage
This Layout is automatically assigned to be used for all marketing documents
(including draft documents):
Sales Module
· Sales Quotations
· Sales Orders
· Deliveries
· Returns
· A/R Down Payment Requests
· A/R Down Payment Invoices
· A/R Credit Notes
· A/R Reserved Invoices
Purchasing Module
· Purchase Order
· Goods Receipt PO
· Goods Return
· A/P Down Payment Request
· A/P Down Payment Invoices
· A/R Credit Notes
· A/R Reserved Invoices
To display the form from the Preview of any Marketing document Form
Select
416
-> Sales AR ->
· Sales Quotation (149)
· Sales Order (139)
· Delivery (140)
· Return (180)
· AR Down Payment Request (65308)
· AR Down Payment Invoice (65300)
· AR Invoice (133)
· AR Credit Note (179)
· AR Reserve Invoice (60091)
or select
-> Purchasing AP -> ...
· Purchase Order (142)
· Goods Receipt PO (143)
· Goods Return (182)
· AP Down Payment Request (56309)
· AP Down Payment Invoice (56301)
· AP Invoice (141)
· AP Credit Note (181)
· AP Reserve Invoice (60092)
·
These Marketing documents can be viewed in SAP Business One as preview before
and after adding the actual document. It can be exported to Word or PDF and
attached to Emails with predefined Subject and To Address.
Remarks
In order to be able to view the Layout Crystal Reports Viewer (integrated in SAP
Business One Version 8.8 and higher) is required on the system.
In order to adjust the layout Crystal Reports 2008 is required.
See more details on how to customize the marketing layout with Crystal Reports in
the manual coresuite designer
The Marketing DIN Layout created with Crystal might be adjusted in a future
Version. Changes are NOT automatically applied to the layout in the system. In
order to get the latest Version of the Layout we suggest the following steps:
1. Duplicate the existing layout to ensure any customization is saved.
2. Reinstall the layout as described in the manual coresuite designer
Example
As the report created with Crystal Reports can only be viewed when Crystal reports
Viewer is installed we use the Standard Marketing DIN Layout in all Printdefinitions
for Marketing Documents. That means there are no preinstalled Printdefinitions
defined to use this layout. In order to use the layout for your marketing documents
418
change the existing Printdefinitions to use this layout instead of the standard DIN
layout "Document DIN (DOC00008)" as described below:
Step 1 (Option 1)
Step 1 (Option 2)
Step 2
Change the Layout under the Document Tab from DOC: Document DIN (DOC00008)
to DOC: Document DIN -RPT (DOC40000)
Step 3
See below the list of all the current financial reports in coresuite country
package.
The unique description is displayed in brackets in order to uniquely identify each
report.
420
9 coresuite layouts, reports & dashboards 421
9.4.1 Profit and Loss
Purpose
Profit and loss statement according to KPI (with financial ratios), including the
option to filter by profit center, project or distribution rule
Parameter form
Field Description
Preview Sample
422
The 1st page (see above screenshot) is a contraction of the Profit and
Loss statement which fits on a DIN A4 page. These are important for the
More details are usually only required for the accountant. The required
through the tree on the left side of the report or by drilling down with
Purpose
Profit and loss statement according to the chart of accounts (only standard
subtotals and standard groupings) with possibility to analyse for each profit center,
project or distribution rule
Parameter form
Field Description
424
displayed
contraction in this report and the report can therefore quickly become very
Preview Sample
Purpose
Profit and loss statement according to an external individual template (including
the possibility to analyse for each profit center, project or distribution rule)
Parameter form
Field Description
Show Zero Saldo "NO" = Zero Saldo are not displayed (Standard)
"YES" = Zero Saldo are displayed
Preview Sample
Individual according to the Template
Purpose
Profit and loss statement divided into profit centers (including KPI measures)
Parameter form
426
Field Description
Show Zero Saldo "NO" = Zero Saldo are not displayed (Standard)
"YES" = Zero Saldo are displayed
Preview Sample
Purpose
Listing of assets and liabilities of the company's annual balance sheet date
Parameter form
Add Voucher (Text Select from the Drop Down Box if Journal Vouchers
Drop Down Box) (Journal Entries which have not yet been posted)
should be displayed in the report or not.
Possible Selections:
· No (Default)
Do not display Journal Vouchers
· Yes
Display Journal Vouchers
Ignore Adjustment Select from the Drop Down Box if Transactions with/
(per 13.) (Text Drop without Adj. Trans (Period 13) selected are
Down Box) displayed.
Show Zero Balance Select from the Drop Down Box if Accounts with
(Text Drop Down Box) Zero Balance should be displayed in the report or
not.
Possible Selections:
· No (Default)
Do not display Accounts with Zero Balance
· Yes
Display Accounts with Zero Balance
Show previous year Select from the Drop Down Box if the Balance of the
(Text Drop Down Box) Previous Year should be displayed in the report or
not.
Possible Selections:
· No (Default)
Do not display the Balance of the previous year
· Yes
Display the Balance of the previous year
To Level (Text Drop Select from the Drop Down Box to which Account
Down Box) Level the details should be displayed.
Possible Selections:
· All (Default)
Display all account levels up to level 7
· Number 1 to 6
Display accounts up to the selected Level
Currency (Text Drop Select the Currency Type from the Drop Down Box in
Down Box) which to display the amounts.
Possible Selections:
· Local Currency (Default)
· System Currency
430
· Chart of Account (Default)
This Parameter is Sort by SAP Business One Standard Chart of
only available in
Account
German Loc alisation.
· Account Level 2 - HGB
Sort by Account Level 2 from the Chart of Account.
Preview Sample
Purpose
Balance sheet according to an external Template (SAP® partners can create their
own templates)
Parameter form
Field Description
Show Zero Saldo "NO" = Zero Saldo are not displayed (Standard)
"YES" = Zero Saldo are displayed
Preview Sample
432
Opening Balance (FIN05413)
Purpose
Opening Balance (in general the 1st day of each fiscal year, without ongoing
bookings for the new fiscal year)
Parameter form
Show Zero Balance Select from the Drop Down Box if Accounts with
(Text Drop Down Box) Zero Balance should be displayed in the report or
not.
Possible Selections:
· No (Default)
Do not display Accounts with Zero Balance
· Yes
Display Accounts with Zero Balance
Add Voucher (Text Select from the Drop Down Box if Journal Vouchers
Drop Down Box) (Journal Entries which have not yet been posted)
should be displayed in the report or not.
Possible Selections:
· No (Default)
Do not display Journal Vouchers
· Yes
Display Journal Vouchers
Ignore Adjustment Select from the Drop Down Box if Transactions with/
(per 13.) (Text Drop without Adj. Trans (Period 13) selected are
Down Box) displayed.
Possible Selection:
· No (Default)
Display Transactions with and without Adj. Trans
(Period 13) selected
· Yes
Ignore (do not display) Transactions with Adj.
434
Trans (Period 13) selected. Only display
Transactions without Adj. Trans (Period 13)
selected.
· Only
Only display Transactions with Adj. Trans (Period
13) selected. Do not display Transactions without
Adj. Trans (Period 13) selected.
Currency (Text Drop Select the Currency Type from the Drop Down Box in
Down Box) which to display the amounts.
Possible Selections:
· Local Currency (Default)
· System Currency
Preview Sample
Purpose
Query of account activity, including the graphical representation of the movements
Parameter form
Reference Date To Select the latest Date as filter in the datasource query
(Date Calendar
Selection)
Account (Text Select the account(s) from the choose from list which
Choose From List) should be displayed in the report. It is possible to
select multiple accounts. Only Journal Transactions
posted on the selected account(s) will be displayed.
Add Voucher (Text Select from the Drop Down Box if Journal Vouchers
Drop Down Box) (Journal Entries which have not yet been posted) should
be displayed in the report or not.
Possible Selections:
· No (Default)
Do not display Journal Vouchers
· Yes
Display Journal Vouchers
Ignore Adjustment Select from the Drop Down Box if Transactions with/
(per 13.) (Text without Adj. Trans (Period 13) selected are
Drop Down Box) displayed.
Possible Selection:
· No (Default)
Display Transactions with and without Adj. Trans
(Period 13) selected
· Yes
Ignore (do not display) Transactions with Adj. Trans
(Period 13) selected. Only display Transactions
without Adj. Trans (Period 13) selected.
· Only
Only display Transactions with Adj. Trans (Period 13)
selected. Do not display Transactions without Adj.
Trans (Period 13) selected.
Hide accounts Select from the Drop Down Box if accounts with no
with no movements in the selected date range should be
movements (Text displayed in the report or not.
Drop Down Box) Possible Selections:
· Yes (Default)
Do not display accounts with no movements in the
selected date range
· No
438
Display the balance brought forward of accounts with
no movements in the selected date range
Hide cancelled Select from the Drop Down Box if Cancelled Journal
Journal Entries Entries including the Reversal Journal Entries should
(Text Drop Down be displayed in the report or not.
Box) Possible Selections:
· No (Default)
Display all Journal Entries including the Cancelled
Journal Entries and Reversal Journal Entries
· Yes
Do not display Cancelled Journal Entries nor Reversal
Journal Entries
Details (Invoices) Select from the Drop Down Box if Details from Invoices
(Text Drop Down should be displayed in the report or not.
Box) Possible Selections:
· Yes (Default)
Display all Invoice details
· No
Do not display all Invoice details
New page after Select from the Drop Down Box if a new page should be
new account (Text started after each account or not.
Drop Down Box) Possible Selections:
· Yes (Default)
Start a new page after each account.
· No
All accounts are listed below each other
Show Chart (Text Select from the Drop Down Box if a bar chart of
Drop Down Box) balance per month should be displayed in the report or
not. The bar chart is only relevant for profit and loss
accounts.
Possible Selections:
· No (Default)
Do not display the Chart
· Yes
Display the Chart
Optional Filter The parameters below allow to filter the data displayed
in the Report. All filters are optional and can be left
empty.
Profit center (Text Select the profit center(s) from the choose from list
Choose From List) which should be displayed in the report. It is possible to
Project (Text Select the project(s) from the choose from list which
Choose From List) should be displayed in the report. It is possible to
select multiple project. Only Journal Transactions
posted on the selected project(s) will be displayed.
Preview Sample
440
Trial Balance (FIN05533)
Purpose
List of all account without grouping (Brought forward, Debit, Credit, Balance)
The ideal report for the accountant who can retrieve a breakdown in Debit
and Credit.
Parameter form
Field Description
Show Zero Saldo "NO" = Zero Saldo are not displayed (Standard)
"YES" = Zero Saldo are displayed
Purpose
Collection and presentation of all journal entries (possibly filtered by marketing
document type)
Parameter form
Field Description
Preview Sample
442
9 coresuite layouts, reports & dashboards 443
9.4.4 Budget
Purpose
Comparison of current income including the budget (broken down into KPI
measures)
Parameter Form
Add Voucher (Text Select from the Drop Down Box if Journal Vouchers
Drop Down Box) (Journal Entries which have not yet been posted)
should be displayed in the report or not.
Possible Selections:
444
· No (Default)
Do not display Journal Vouchers
· Yes
Display Journal Vouchers
Ignore Adjustment Select from the Drop Down Box if Transactions with/
(per 13.) (Text Drop without Adj. Trans (Period 13) selected are
Down Box) displayed.
Possible Selection:
· No (Default)
Display Transactions with and without Adj. Trans
(Period 13) selected
· Yes
Ignore (do not display) Transactions with Adj.
Trans (Period 13) selected. Only display
Transactions without Adj. Trans (Period 13)
selected.
· Only
Only display Transactions with Adj. Trans (Period
13) selected. Do not display Transactions without
Adj. Trans (Period 13) selected
Budget (Text Drop Select one or all of the available budgets from the
Down Box) Drop Down Box. For example Internal/External
Budget or Worstcase/Bestcase. In general budget
scenarios are created on profit center, therefore the
default value is "All" (all budgets of the individual
profit centers combined).
Show Chart (Text Select from the Drop Down Box if 4 Gauges and 5
Drop Down Box) Bar Charts of Profit & Loss vs Budget should be
displayed in the report or not.
Possible Selections:
· No (Default)
Do not display the Gauges & Charts
· Yes
Display the Gauges & Charts
Show previous year Select from the Drop Down Box if the balance and
(Text Drop Down Box) budget of the previous year should be displayed in
the report or not.
Possible Selections:
· No (Default)
Do not display the previous year balance and
budget
· Yes
Display the previous year balance and budget
3.0
Profit center (Text Select the profit center(s) from the choose from list
Choose From List) which should be displayed in the report. It is possible
to select multiple profit centers. Only Journal
Transactions posted on the selected profit center(s)
will be displayed.
Project (Text Choose Select the project(s) from the choose from list which
From List) should be displayed in the report. It is possible to
select multiple project. Only Journal Transactions
posted on the selected project(s) will be displayed.
446
Preview Sample Details
Purpose
Comparison of current income including the budget (broken down according to the
chart of accounts)
Parameter form
Field Description
448
(per 13.) "NO" = Adjustments in the 13. are taken into account
"ONLY" = Only adjustments of the 13. period are
displayed
In comparison to the report Profit and Loss vs. Budget - KPI (FIN05439)
there is no contraction in this report and the report can therefore quickly
Preview Sample
Purpose
Budget (only Budget numbers) according to KPI (subtotals). the ideal report for the
bank or third party.
Parameter form
450
Parameter form description
Field Description
Add Voucher (Text Select from the Drop Down Box if Journal Vouchers
Drop Down Box) (Journal Entries which have not yet been posted)
should be displayed in the report or not.
Possible Selections:
· No (Default)
Do not display Journal Vouchers
· Yes
Display Journal Vouchers
Ignore Adjustment Select from the Drop Down Box if Transactions with/
(per 13.) (Text Drop without Adj. Trans (Period 13) selected are
Down Box) displayed.
Possible Selection:
· No (Default)
Display Transactions with and without Adj. Trans
(Period 13) selected
· Yes
Ignore (do not display) Transactions with Adj.
Trans (Period 13) selected. Only display
Transactions without Adj. Trans (Period 13)
Budget (Text Drop Select one or all of the available budgets from the
Down Box) Drop Down Box. For example Internal/External
Budget or Worstcase/Bestcase. In general budget
scenarios are created on profit center, therefore the
default value is "All" (all budgets of the individual
profit centers combined).
Profit center (Text Select the profit center(s) from the choose from list
Choose From List) which should be displayed in the report. It is possible
to select multiple profit centers. Only Journal
Transactions posted on the selected profit center(s)
will be displayed.
Project (Text Choose Select the project(s) from the choose from list which
From List) should be displayed in the report. It is possible to
select multiple project. Only Journal Transactions
posted on the selected project(s) will be displayed.
Preview Sample
452
Budget Report (FIN05433)
Purpose
Budget according to chart of accounts (only Budget numbers). Grouped according to
chart of accounts.
Parameter form
Field Description
Show Zero Saldo "NO" = Zero Saldo are not displayed (Standard)
"YES" = Zero Saldo are displayed
Preview Sample
454
9 coresuite layouts, reports & dashboards 455
Profit and Loss vs Budget Dashboard - XC (FIN600001)
Purpose
The coresuite Profit and Loss vs Budget Dashboard compares the current income
including to the budget (broken down into KPI measures).
Gross Profit, Turnover, Profit(loss), Total Costs and Budget are calculated
according to the account classification of coresuite accounting.
This is a Sample Dashboard delivered for free w ithin the c ountry pac kage to
demonstrate how data related to financ ial key numbers c an be visualized w ith Cry stal
Dashboard. To use this dashboard in a produc tive environment c ontac t
support@c oresy stems.c h to buy the adjusted dashboard spec ific for y our c ompany .
General Authorizations
Only users with authorization right to the Datasource "Profit/Loss Dashboard - XC
(FIN60001)" can view this report. The authorization can be set in SAP Business
One under
Main Menu -> Administration -> System Initialization -> Authorizations -> General
Authorizations:
Subject:
-> User Authorization -> coresuite designer -> Datasource -> FIN -> Profit/Loss
Dashboard - XC (FIN60001).
Screenshot
456
Help
Purpose
List of outstanding sales for business partners (customers / debtors). Debtor list,
which are handled by the accounts receivable manager.
Parameter form
Field Description
Reference Date By default the current date is entered. That means all
open postings are displayed.
If the reference date is set to the past only postings
with a posting date (Field: RefDate) BEFORE this
date are displayed.
Furthermore the "Age" of postings is calculated
according to the date entered here.
Optional Filter
Due date to Filter the report by Due Date to. That means postings
with a later due date (Field: DueDate) will not be
displayed.
Optional Parameters
Additionally there are optional Parameters for specific customer requirements that
can be activated on request. To activate the parameters it is required to duplicate
458
the report and enter values in the input order.
The coresuite standard reports do not display these parameters as it would lead to
more complex and not user-friendly reports.
Field Description
Due Date from Parameter "FromDate": Filter the report by Due Date
from. That means postings with a earlier due date
(Field: DueDate) will not be displayed.
Posting Date from Parameter "Date01": Filter the report by Posting Date
from. That means postings with a earlier posting
date (Field: RefDate) will not be displayed.
Preview Sample
The age of a posting is calculated depending on the 2 Parameters "Age By" and
"Reference Date".
Postings on Account (e.g. unallocated Payments) always have the age 0 that means
they will be displayed in the column "Postings on Account & not due Invoices"
Example:
An Invoice was created on 01.01.2010 with due date 02.02.2010.
Parameter entered:
· "Reference Date" = "03.03.2010"
· "Age By" = "Due Date"
Selecting the "star" (see the marker on page 2 of the report) jumps directly
into the SAP® Business One "Internal reconciliation" and provides the option
Section 3 (Summary)
460
Customer (A/R) Ageing Statement (FIN05418)
Purpose
Statement of the open positions of the Business Partners
The report can easily be sent to a client or business partner via e-mail. It
Parameter form
Field Description
Reference Date to By default the current date is entered. That means all
open sales are taken into consideration.
Preview Sample
Purpose
Account journal per business partner (all postings per business partner)
Parameter form
Field Description
New page after new "YES" = A new page for each Business Partner
business partner "NO" = Everything together
Preview Sample
462
9.4.6 Vendor (A/P)
Purpose
List of outstanding purchases from business partners (vendor / creditors).
Creditors list, which are handled by the accounts payable manager.
Parameter form
Field Description
Reference Date By default the current date is entered. That means all
open postings are displayed.
If the reference date is set to the past only postings
with a posting date (Field: RefDate) BEFORE this
date are displayed.
Furthermore the "Age" of postings is calculated
according to the date entered here.
Optional Filter
Due date to Filter the report by Due Date to. That means postings
with a later due date (Field: DueDate) will not be
displayed.
Optional Parameters
Additionally there are optional Parameters for specific customer requirements that
can be activated on request. To activate the parameters it is required to duplicate
Field Description
Due Date from Parameter "FromDate": Filter the report by Due Date
from. That means postings with a earlier due date
(Field: DueDate) will not be displayed.
Posting Date from Parameter "Date01": Filter the report by Posting Date
from. That means postings with a earlier posting
date (Field: RefDate) will not be displayed.
Preview Sample
The age of a posting is calculated depending on the 2 Parameters "Age By" and
"Reference Date".
Postings on Account (e.g. unallocated Payments) always have the age 0 that means
they will be displayed in the column "Postings on Account & not due Invoices"
Example:
An Invoice was created on 01.01.2010 with due date 02.02.2010.
Parameter entered:
· "Reference Date" = "03.03.2010"
· "Age By" = "Due Date"
464
Section 2 (Postings in detail by Business Partner)
Selecting the "star" (see the marker on page 2 of the report) jumps directly
into the SAP® Business One "Internal reconciliation" and provides the option
Section 3 (Summary)
Purpose
Account journal per business partner (all postings per business partner)
Parameter form
Field Description
New page after new "YES" = A new page for each Business Partner
business partner "NO" = Everything together
Preview Sample
466
9.4.7 Lists
Purpose
Listing of all accounts and the existing profit centers and distribution rules.
Parameter form
No parameter form
Preview Sample
Purpose
Listing of all accounts, including the division into classes, class groups and
Subtotals (KPI)
Parameter form
Field Description
Preview Sample
468
Chart of Accounts Template (FIN05401)
Purpose
Listing of all accounts (including the profit center and distribution rules) of
existing external chart of accounts templates.
Parameter form
Field Description
Preview Sample
Individual according to the Template
Purpose
List of taxation and VAT base amounts for each tax code defined in the
corresponding period.
Parameter form
Field Description
Preview Sample
470
VAT by Account (FIN05415)
Purpose
List of taxation and VAT base amounts for each account and tax code defined in
the corresponding period. Ideal to derive the VAT-liable turnover.
Parameter form
Field Description
Preview Sample
Purpose
Country specific Report for Tax Declaration. This report is available in the
languages German, French and Italian only. It was used before 2010 only.
Parameter form
Field Description
Display Tax Tutorial "Ja" = Display the Tutorial on how to adjust the
settings in SAP for the Tax declaration Boxes as first
page
"Nein" = Only show the tax declaration report
Purpose
Country specific Report for Tax Declaration. This report is available in the
languages German, French and Italian only.
474
Parameter form
Field Description
Display Tax Tutorial "Ja" = Display the Tutorial on how to adjust the
settings in SAP for the Tax declaration Boxes as first
page
"Nein" = Only show the tax declaration report
System Message
In case one or more if the Tax Declaration Boxes is not defined in SAP, a message
box will be displayed as information. To display the Report select OK.
Display the Tutorial on how to adjust the settings in SAP for the Tax declaration
Boxes as first page by selecting Yes in the Parameter Form.
For a correct swiss tax report you need to enter exactly the following tax
declaration boxes in SAP Business One under:
> Administration > Setup > Financials > Tax > Tax Declaration Boxes
Legal requirements:
· The Taxcode 'V5' or 'V4' is not used anymore for the swiss tax-report 2010. They
can be kept or removed as required.
· Tax declaration box 230 (see report) is used for special tax exempt transactions
like education, rent etc. If you need to fill in that box an additional tax code and
tax declaration box will be required.
· For more information about the swiss tax report 2010 visit:
http://www.estv.admin.ch/mwst/aktuell/
476
Sample German
478
Sample Italian
Purpose
Query of account activity, including the graphical representation of the movements
Parameter form
Reference Date To Select the latest Date as filter in the datasource query
(Date Calendar
Selection)
Filter by (Text Select the Date Type from the Drop Down Box by which
Drop Down Box) the Journal Entries (Vouchers) are filtered according to
the Date Range entered above.
Possible Selections:
480
· Reference Date (Default)
· Due Date
Account (Text Select the account(s) from the choose from list which
Choose From List) should be displayed in the report. It is possible to
select multiple accounts. Only Journal Transactions
posted on the selected account(s) will be displayed.
Add Voucher (Text Select from the Drop Down Box if Journal Vouchers
Drop Down Box) (Journal Entries which have not yet been posted) should
be displayed in the report or not.
Possible Selections:
· No (Default)
Do not display Journal Vouchers
· Yes
Display Journal Vouchers
Ignore Adjustment Select from the Drop Down Box if Transactions with/
(per 13.) (Text without Adj. Trans (Period 13) selected are
Drop Down Box) displayed.
Possible Selection:
· No (Default)
Display Transactions with and without Adj. Trans
(Period 13) selected
· Yes
Ignore (do not display) Transactions with Adj. Trans
(Period 13) selected. Only display Transactions
without Adj. Trans (Period 13) selected.
· Only
Only display Transactions with Adj. Trans (Period 13)
selected. Do not display Transactions without Adj.
Trans (Period 13) selected.
Hide accounts Select from the Drop Down Box if accounts with no
with no movements in the selected date range should be
movements (Text displayed in the report or not.
Drop Down Box) Possible Selections:
· Yes (Default)
Do not display accounts with no movements in the
selected date range
· No
Display the balance brought forward of accounts with
no movements in the selected date range
Hide cancelled Select from the Drop Down Box if Cancelled Journal
Details (Invoices) Select from the Drop Down Box if Details from Invoices
(Text Drop Down should be displayed in the report or not.
Box) Possible Selections:
· Yes (Default)
Display all Invoice details
· No
Do not display all Invoice details
New page after Select from the Drop Down Box if a new page should be
new account (Text started after each account or not.
Drop Down Box) Possible Selections:
· Yes (Default)
Start a new page after each account.
· No
All accounts are listed below each other
Show Chart (Text Select from the Drop Down Box if a bar chart of
Drop Down Box) balance per month should be displayed in the report or
not. The bar chart is only relevant for profit and loss
accounts.
Possible Selections:
· No (Default)
Do not display the Chart
· Yes
Display the Chart
Optional Filter The parameters below allow to filter the data displayed
in the Report. All filters are optional and can be left
empty.
Profit center (Text Select the profit center(s) from the choose from list
Choose From List) which should be displayed in the report. It is possible to
select multiple profit centers. Only Journal
Transactions posted on the selected profit center(s)
will be displayed.
482
Project (Text Select the project(s) from the choose from list which
Choose From List) should be displayed in the report. It is possible to
select multiple project. Only Journal Transactions
posted on the selected project(s) will be displayed.
Report
See below the list of all the current sales reports in coresuite country package.
The unique description is displayed in brackets in order to uniquely identify each
report.
Purpose
The coresuite Sales Revenue Dashboard displays Sales Revenue of the current
Financial Year grouped by Sales Employees, Countries, Customers or Item
Groups (Service documents are marked as "Service" item group) in comparison to
the Previous Year To Day (YTD).
The amounts displayed are the net amounts taken from the Sales Marketing
484
Documents. Sales Revenue is the combination of Invoices and Credit Notes.
Discounts are taken into consideration, Tax or Freight are not included.
This is a Sample Dashboard delivered for free w ithin the c ountry pac kage to
demonstrate how data related to sales doc uments c an be visualized w ith Cry stal
Dashboard. To use this dashboard in a produc tive environment c ontac t
support@c oresy stems.c h to buy the adjusted dashboard spec ific for y our c ompany .
General Authorizations
Only users with authorization right to the Datasource "Sales Revenue Dashboard -
XC (FIN60001)" can view this report. The authorization can be set in SAP Business
One under
Main Menu -> Administration -> System Initialization -> Authorizations -> General
Authorizations:
Subject:
-> User Authorization -> coresuite designer -> Datasource -> SAR -> Sales Revenue
Dashboard - XC (FIN60001).
Screenshot
486
9.5.2 Sales Documents (SAR06000)
Purpose
Display relevant data for selected Sales Documents. All amounts displayed are net
amounts.
Parameter form
Order by (Text Select the Object Type from the Drop Down Box by
Drop Down Box) which the Data is grouped.
Possible Selections:
· Business Partner (Default)
· Delivery Date (Due Date)
· Document Date
· Document Owner
· Sales Person
· Item Group
· Country
· Item Name
· Business Partner Group
· Dist. Rule (Profit Center)
Document Type Select the Document Type(s) from the Drop Down Box
(Text Drop Down which should be displayed in the report.
Status (Text Drop Select from the Drop Down Box documents of which
Down Box) status should be displayed.
Possible Selections:
· Open (Default)
Only display open documents
· Close
Only display closed documents
· All
Display both open and closed documents
Detailed (Text Select from the Drop Down Box if the all document
Drop Down Box) rows should be displayed in the report or not.
Possible Selections:
· No (Default)
Do not display document rows
· Yes
Display document rows
Include document Select from the Drop Down Box if Freight and
Freight/Rounding Rounding on Document Header should be calculated in
(Text Drop Down the amounts displayed or not.
Box) Possible Selection:
· No (Default)
Do not take the Freight and Rounding on Document
Header into consideration
· Yes
Take the Freight and Rounding on Document Header
into consideration
488
added this parameter and used the default value to display
Optional Filter The parameters below allow to filter the data displayed
in the Report. All filters are optional and can be left
empty.
Business Partner Select the Business Partner(s) from the choose from
(Text Choose From list which should be displayed in the report. It is
List) possible to select multiple Business Partners. Only
Documents for the selected Business Partner(s) will be
displayed.
Item (Text Choose Select the item(s) from the choose from list which
From List) should be displayed in the report. It is possible to
select multiple items. Only Documents for the selected
item(s) will be displayed.
Reference Date To Select the latest Date as filter in the datasource query
(Date Calendar
Selection)
Sales employee Select the Sales employee(s) from the choose from list
(Text Choose From which should be displayed in the report. It is possible to
List) select multiple Sales employees. Only Documents for
the selected Sales employee(s) will be displayed.
Preview Sample
See below the list of all the current service reports in coresuite country package.
The unique description is displayed in brackets in order to uniquely identify each
report.
Purpose
The coresuite Service Dashboard displays the queue of all open Service Calls in
the SAP Business One system and offers analysis of the Workload of Service
Consultants with 3 integrated charts.
This is a Sample Dashboard delivered for free w ithin the c ountry pac kage to
demonstrate how data related to servic e c alls c an be visualized w ith Cry stal Dashboard.
To use this dashboard in a produc tive environment c ontac t support@c oresy stems.c h to
buy the adjusted dashboard spec ific for y our c ompany .
490
By default the values of the Dashboard are refreshed automatically every 5
Minutes. This interval can be adjusted by your administrator.
Screenshot
Help
This section includes all information about widgets delivered with the coresuite
country package which can be used in the SAP Cockpit.
10.1 Prerequisite
· The Cockpit is enabled for the Company (contact your administrator in case it is
not activated)
10.2 Overview
The following table resumes the widgets currently available with the country
package.
494
Name Description Access
enterprise Search your Database for Contact, To display the form
search Documents and more from within the SAP and use it in the
Business One Cockpit SAP Business One
Cockpit
Select -> My Cockpit
-> coresuite widgets
-> enterprise search
and drag the widget
to the cockpit
social Access Social Networks like Linked In, To display the form
networks Facebook and others from the SAP and use it in the
Business One Cockpit to contact your SAP Business One
Business Partner Contacts online. Cockpit
Select -> My Cockpit
-> coresuite widgets
-> social networks
and drag the widget
to the cockpit
world time Show different clocks with all time zones. To display the form
Add your custom description like the and use it in the
name of the company, customers or SAP Business One
subsidiaries Cockpit
Select -> My Cockpit
-> coresuite widgets
-> world time
and drag the widget
to the cockpit
coresuite time Shows relevant data to each employee, To display the form
balances like the worked time and the remaining and use it in the
holidays. SAP Business One
Cockpit
In order to use this w idget, c oresuite
Select -> My Cockpit
time must be installed as prerequisite.
-> coresuite widgets
-> Balances
and drag the widget
to the cockpit
10.3 dashboards
View simple and complex Dashboards from the SAP Business One Cockpit to get
important numbers in a quick view.
496
Preview Dashboard Name Description
guide.
498
Preview Dashboard Name Description
In order to display all the dashboard w idgets, Adobe® Flash Play er must be installed
and c oresuite designer must be installed and running.
With the coresuite enterprise search widget you can search and display objects
of your SAP® Business ONE Systems and show them in a single screen.
500
Searc h results
The social networks widgets displays the most common social network portals into
your SAP® Business One Cockpit.
To choose which website should be display click on the Settings menu entry located
at the top right corner of the widget.
502
The configuration is automatically saved. When Business One is restarted and the
coresuite country package starts, the choosen portal will be re-loaded
automatically.
The world time widgets shows a lit of configurable clocks. This widget can be used
to monitor the time in different time zones (e.g. with subsidiaries or business
partners).
After dragging the world time widget into the SAP Business One cockpit, two clocks
are displayed by default.
The widget settings form allows the user to modify the existing clocks or add new
ones.
This widget shows the worked hours and holidays of each employee.
504
11 FAQ
· What is the difference between the Datasources Document_88 and Document for
Marketing Documents?
See answer under "Document_88 vs Document Datasource"
· Why is it very slow or I even get Timeout errors when printing marketing
documents after upgrading SAP Business One to Version 8.8?
See answer under "How to use the new Datasource"
· Why are my VAT details not displayed in the Marketing Documents when using
the Datasource Document_88?
See answer under "How to adjust VAT Subtotals"
· Why are my Batch Number details not displayed in the Marketing Documents
when using the Datasource Document_88?
See answer under "How to adjust Batch Number details"
· Why are my Serial Number details not displayed in the Marketing Documents
when using the Datasource Document_88?
See answer under "How to adjust Serial Number details"
Due to new Tables introduced in SAP 8.8 for Batch and Serial Numbers, we
introduced a new Datasource Document_88 for Marketing documents.
The Datasource Document is still available for compatibility reason but not used in
the latest Version of the coresuite country package. The datasource may still be
used in user defined layouts.
The table below should explain the similarities and differences between these two
datasource and when you should use which datasource.
11 FAQ 505
Description Document_88 Document
issues in V ersion 8.8
w hen using this
datasourc e in a
Company Database that
handles many Batc h or
Serial Numbers.
B1_Data.Row. B1_Data.Row.
RowRowBatchNumber RowRowBatchNumber
s s
Relevant Data from Relevant Data from
Tables: Tables (VIEW in SAP
SAP Business One 8.8 Business One 8.8)
· OITL - Inventory · OIBT - Batch Number
Transaction Log for Item
· ITL1 - Serial & Batch · IBT1 - Batch Number
Details in Transaction
Transaction
· OBTQ - Batch
Number Quantities
506
Description Document_88 Document
· IBT1 - Batch Number
Transaction
B1_Data.Row.
RowRowBatchNumber
s.
BatchNumbersMaster
Relevant Data from
Tables:
· OBTN (Batch
Numbers Master
Data)
· OR in case of draft
documents OBDN
(Batch Numbers -
Draft - Master Data)
B1_Data.Row. B1_Data.Row.
RowRowSerialNumber RowRowSerialNumber
s s
Relevant Data from Relevant Data from
Tables: Tables (VIEW in SAP
SAP Business One 8.8 Business One 8.8)
· OITL - Inventory · OSRI - Serial
Transaction Log Numbers for Item
· ITL1 - Serial & Batch · SRI1 - Serial Number
Details in Transaction for Item
Transaction
· OSRQ - Serial
Number Quantities
11 FAQ 507
Description Document_88 Document
Transaction for Item
B1_Data.Row.
RowRowSerialNumber
s.
SerialNumbersMaster
Relevant Data from
Tables:
· OSRN (Serial
Numbers Master
Data)
· OR in case of draft
documents ODSN
(Serial Numbers -
Draft - Master Data)
Fields RowRowBatchNumbers
Below is a detailed view of the fields in the datasource RowRowBatchNumbers
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
508
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
11 FAQ 509
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
510
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
11 FAQ 511
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
Fields RowRowSerialNumbers
Below is a detailed view of the fields in the datasource RowRowSerialNumbers
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
512
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
11 FAQ 513
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
514
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
11 FAQ 515
Name Description Document_88: Document:
Origin SAP Origin SAP
Business One Business One
Table.Field Table.Field
Reason:
New Tables for Serial and Batch Numbers were introduced in SAP 8.8. The old
Tables where replaces by SQL Views. When using these views in the original
Datasource SQL Query combined in JOINs with other tables it takes many
ressources to get the results. The more Serial and/or Batch Numbers are in a
Company Database the slower it will be to return these Results.
516
11.1.2 How to adjust VAT Subtotals
Reason:
The Datasources B1_Data.Document.DocumentVatSum, B1_Data.Document.
DocumentDpmVatSum, B1_Data.Document.DocumentExpVatSum and B1_Data.
Document.DocumentDocumentWithExpVatSum were removed in the Datasource
Document_88.
11 FAQ 517
3. Change the DataSource Property of the Databand to the correct Datasource
B1_Data.Document.DocumentDocumentWithExpDpmVatSum
518
The default Marketing DIN lay out "Doc ument DIN - LD (DOC00008)" delivered w ith the
c oresuite c ountry pac kage is NOT affec ted by this issue as the relevant details are not
display ed.
Reason:
Due to the changes in the Table structure for Batch Numbers in SAP Business One
we had to move the Batch Number Details like Dates, Notes, User Defined
Fields, ... to a new Datasource Query BatchNumbersMaster.
11 FAQ 519
3. Adjust the relevant Text Fields to draw the data from the new Datasource
Query RowBatchNumbersBatchNumbersMaster.
Example in the DIN Layout "Document DIN - LD (DOC00008)" use the relevant
fields (Example CreateDate, ExpDate, UDF,...) of the subquey
RowBatchNumbersBatchNumbersMaster of the AdvancedDataBand
DocumentRowBatchNumbers under Bands.
The default Marketing DIN lay out "Doc ument DIN - LD (DOC00008)" delivered w ith the
c oresuite c ountry pac kage is NOT affec ted by this issue as the relevant details are not
display ed.
520
Reason:
Due to the changes in the Table structure for Serial Numbers in SAP Business One
we had to move the Serial Number Details like Dates, Notes, User Defined
Fields, ... to a new Datasource Query SerialNumbersMaster.
3. Adjust the relevant Text Fields to draw the data from the new Datasource
Query RowSerialNumbersSerialNumbersMaster.
Example in the DIN Layout "Document DIN - LD (DOC00008)" use the relevant
fields (Example CreateDate, ExpDate, UDF,...) of the subquey
RowSerialNumbersSerialNumbersMaster of the AdvancedDataBand
DocumentRowSerials under Bands.
11 FAQ 521
Index -C-
C# 112, 130
categories 374
-*- Chart of Accounts (FIN05401) 467
Chart of Accounts KPI (FIN05401) 468
*.cocu 140 Chart of Accounts Template (FIN05401) 469
Choose from List 265
-A- Class Groups 57
Classes 53
Account Mapping 50 closed documents 374
AddHyperlink 310 cocu 140, 144
Advanced Data Band 290 Code 136
Advanced Group Band 292 Combobox 131, 132, 175, 264
Advanced Text 286 configuration 196, 370
AdvancedGroupBand 301 Content 294
Aggregatfunktionen 331 Copy Queries 241
Anzahl 331 COR_CUSTOM_EC 125
Arrows 304 COR_CUSTOM_EX 126
Ausdruck 105 COR_CUSTOM_FB 118
Auslöserelement 105 COR_CUSTOM_FO 105
Availability French 17 COR_CUSTOM_IM 127
Availability Germany 17 COR_CUSTOM_IP 115
Availability Swedish Database 17 COR_CUSTOM_NI 120
Availability Switzerland 17 COR_CUSTOM_NM 123
Availability UK 17 coresuite time 367, 370, 372, 377, 378, 380
Availability USA 17 Course 130
Availability, Standalone designer 17 Create items 132
Average 331 CreateTableFromText 311
Customer (A/R) 458
-B- Customer (A/R) Account Journals (FIN05410)
462
Balance Sheet 429 Customer (A/R) Ageing Report (FIN05406)
Balance Sheet (FIN05402) 429 458
Balance Template (FIN05403) 431 Customer (A/R) Ageing Statement (FIN05418)
Barcode 289 461
Basic element 105
Basiselement 105 -D-
BatchPrinting 237
BookmarkText 311 Data Sources 243
Breite 185 DataSource 290
Budget 444 Date 315
Budget Report - KPI (FIN05440) 450 default fields 367
Budget Report (FIN05433) 453 Delete rule 146
Button 132 Designer Summary 336
Detail 291 Grid 132
document lines 373 Grid Settings 329
Document tree 295 Grouping 301
DrawImage 315
Durchschnitt 331 -H-
-E- Header
Height
291
185
Editor 112 Hide field 171
E-Mail 250 history view 384
estimated Standard deviation 331 Höhe 185
Estimated variation 331
Example 130 -I-
Examples 149
Export 126, 140, 144 Import 127, 140
Export rule 144 Import rule 140
Extended Code 125 Inclination 331
ExtendeTextEdit 131 Integrated Sharpshooter Designer 17
External Crystal Reports 17 Introduction 130
External XCelsius 17 IsEmpty 321
IsPurchase 322
-F- IsPurchase / IsSales
IsSales 322
322
Read parameter
Read value 131
186 -U-
RegEx 112, 136 UDF 180
RemotePrinting 272 UDF auf Hauptform 180
ReplaceTextParam 328 UI 103
Rightclick 160
Rightclickmenu 160 -V-
Rule 183
Rules 128 Validation 190
Varianz 331
-S- Variation 331
VAT by Account (FIN05415) 471
Schiefe 331 VAT by Code (FIN05414) 470
search free text 378 VB 112
search in autocomplete mode 377 VB.Net 130
SelectGrid 274 Vendor (A/P) 463
settings 370, 372 Vendor (A/P) Account Journals (FIN05410)
Shape 288 465
Shell 186 Vendor (A/P) Ageing Report (FIN05406) 463
Side by Side 293 Visual Basic 130
SQL 112, 136, 186
SQL Parameter Query 266 -W-
Standard deviation 331
Standard Functions 308 WeekOfYear 329
Standardabweichung 331 Width 185
styles 330 Window 185
Subtotals 57 Windows 103
Sum 331 Wizard 160
Summe 331
Systeminformationen" 32
-T-
Tax Report 470
Technical information 189
Template properties 329
Text Collection 252
Textbox 285
Textcollection 230
TextEdit 131, 132, 175
Texttools 330
INFO
For further information
and support visit our
product website
www.coresuite.com
Infoline:
+41 (0)848 088 088
Address:
coresystems ag
Villa im Park
5210 Windisch
Schweiz