logo
+49 (0) 251 59 083 115
Try now for free
  1. Home
  2. Documentation
  3. Features
  4. System Administration
  5. Settings

Table of Contents

Introduction

This chapter describes all the settings options of the foreknown app for your account.

The settings dialog is opened via the menu item "System Administration / Settings" and is only accessible for users with the "Account Administrator" role.

General Settings

Setup Assistant

The setup assistant appears on the foreknown home page and is designed to assist you with the initial setup of your foreknown account. As soon as the described steps are completed or the setup assistant should no longer be displayed, you can use the checkbox "Show setup wizard" to determine whether it should be displayed or hidden. This setting affects all account administrators.

To the top ↑

Time Recording

Start of Time Recording

With foreknown, a complete time recording system is provided that allows the maintenance of presence, break and absence times and the recording of activities. Associated with this, a time account is managed per employee. In order to define from which date the time recording should start and thus working time bookings are taken into account, a start date for the time recording can be set via this setting.

All working times recorded before this date will not be taken into account when calculating the balances of the time accounts. Any start balances can be posted via the "Time Account" tab in the employee administration.

To the top ↑

Default Settings for Offers

The default settings for offers can be used to influence the creation process of offers and their dispatch via e-mail.

Settings for Creation

  1. File Name of the Offer: A file name for an offer can be defined in a text field. Placeholders can be used to include certain information in the file name. (see Placeholder)
  2. Text Block for the Introductory Text: A text block can be selected that is automatically inserted as the introductory text when an offer is created.
  3. Text Block for the Closing Text: A text block can be selected that is automatically inserted as the closing text when an offer is created.

Settings for E-Mail Dispatch

  1. E-Mail Sender (Mailer): In this drop-down selection field, a sender for sending offers can be defined. The senders result from the Mail (SMTP) applications created under "System Administration / Applications".
  2. E-Mail Addresses of CC Recipients: Several e-mail addresses can be entered in a text field, separated by commas. These e-mail addresses are then used as CC recipients for e-mails.
  3. E-Mail Addresses of BCC Recipients: Several e-mail addresses can be entered in a text field, separated by commas. These e-mail addresses are then used as BCC recipients for e-mails.
  4. Subject of the E-Mail: A subject for the e-mail for sending the offer can be defined in a text field. Placeholders can be used to include certain information in the subject. (see placeholder)
  5. Text Block for the E-Mail: A text block can be selected that is used when creating an e-mail to send the offer to the customer.
  6. Method for sending offer documents: There are four options how non-internal documents of an offer are handled while sending the offer as e-mail.
    1. Attach no documents: This option ignores all documents during the dispatch of the offer via e-mail.
    2. Attach each document: This option adds every relevant document as a separate attachment to the e-mail.
    3. Attach as combined document: This option combines all relevant documents into one pdf document and attaches this as a separate file to the e-mail. The file name is defined via the separate field "File name of the document attachment".
    4. Attach in base document: This option integrates the relevant documents into the offer pdf document. There will be only one attached pdf document with the name defined for the offer file name.
  7. File name of the document attachment: If the "Method for sending offer documents" is set to "Attach as combined document" a file name for the combined document can be defined in a text field. Placeholders can be used to include certain information in the file name. (see Placeholder)

The current values can be changed via the "Edit" button in a pop-up dialogue.

To the top ↑

Default Settings for Orders

The default settings for orders can be used to influence the creation process of orders and their dispatch via e-mail.

Settings for Creation

  1. File Name of the Order: A file name for an order can be defined in a text field. Placeholders can be used to include certain information in the file name. (see Placeholder)
  2. Text Block for the Introductory Text: A text block can be selected that is automatically inserted as the introductory text when an order is created.
  3. Text Block for the Closing Text: A text block can be selected that is automatically inserted as the closing text when an order is created.

Settings for E-Mail Dispatch

  1. E-Mail Sender (Mailer): In this drop-down selection field, a sender for sending orders can be defined. The senders result from the Mail (SMTP) applications created under "System Administration / Applications".
  2. E-Mail Addresses of CC Recipients: Several e-mail addresses can be entered in a text field, separated by commas. These e-mail addresses are then used as CC recipients for e-mails.
  3. E-Mail Addresses of BCC Recipients: Several e-mail addresses can be entered in a text field, separated by commas. These e-mail addresses are then used as BCC recipients for e-mails.
  4. Subject of the E-Mail: A subject for the e-mail for sending the order confirmation can be defined in a text field. Placeholders can be used to include certain information in the subject. (see placeholder)
  5. Text Block for the E-Mail: A text block can be selected that is used when creating an e-mail to send the order confirmation to the customer.
  6. Method for sending order documents: There are four options how non-internal documents of an order are handled while sending the order as e-mail.
    1. Attach no documents: This option ignores all documents during the dispatch of the order via e-mail.
    2. Attach each document: This option adds every relevant document as a separate attachment to the e-mail.
    3. Attach as combined document: This option combines all relevant documents into one pdf document and attaches this as a separate file to the e-mail. The file name is defined via the separate field "File name of the document attachment".
    4. Attach in base document: This option integrates the relevant documents into the order pdf document. There will be only one attached pdf document with the name defined for the order file name.
  7. File name of the document attachment: If the "Method for sending order documents" is set to "Attach as combined document" a file name for the combined document can be defined in a text field. Placeholders can be used to include certain information in the file name. (see Placeholder)

The current values can be changed via the "Edit" button in a pop-up dialogue.

To the top ↑

Default Settings for Invoices

When creating invoices via the invoice assistant, settings are made that determine how an invoice and associated activity report are generated. The following properties can be used to define default values which are taken into account by the invoice assistant.

Settings for Invoices

  1. Grouping for Service Entries: A drop-down field can be used to select the type of grouping to be applied to service entries in order to generate invoice items.
  2. Grouping for Additional Service Entries: A drop-down field can be used to select which type of grouping should be applied to additional services in order to generate invoice items.
  3. Name of Invoice: A name for an invoice can be defined in a text field. Placeholders can be used to include certain information in the name. (see Placeholder)
  4. Invoice File Name: A file name for an invoice can be defined in a text field. With the help of placeholders can be used to include certain information in the file name. (see Placeholder)
  5. Text Block for the Introductory Text: A text block can be selected that is automatically inserted as the introductory text when an invoice is created.
  6. Text Block for the Closing Text: A text block can be selected that is automatically inserted as the closing text when an invoice is created.

Settings for Activity Reports

  1. Create Activity Report in Invoice: Defines whether an activity report should be integrated into the invoice document. Assumes that the invoice template used supports the output and that the output is integrated via the variable "showServiceEntryData".
  2. Ignore separate activity report when sending invoices: Defines whether an activity report should be added as an attachment when sending the invoice via e-mail.
  3. File Name of the Activity Report: A file name for an activity report can be defined in a text field. Placeholders can be used to include certain information in the file name. (see Placeholder)

Settings for E-Mail Dispatch

  1. E-Mail Sender (Mailer): In this drop-down selection field, a sender for sending invoices and activity reports can be defined. The senders result from the Mail (SMTP) applications created under "System Administration / Applications".
  2. E-Mail Addresses of CC Recipients: Several e-mail addresses can be entered in a text field, separated by commas. These e-mail addresses are then used as CC recipients for e-mails.
  3. E-Mail Addresses of BCC Recipients: Several e-mail addresses can be entered in a text field, separated by commas. These e-mail addresses are then used as BCC recipients for e-mails.
  4. Subject of the E-Mail (Invoice): A subject for the e-mail for sending the invoice can be defined in a text field. Placeholders can be used to include certain information in the subject. (see placeholder)
  5. Text Block for the E-Mail (Invoice): A text block can be selected which is inserted into the e-mail when an e-mail is created for sending the invoice to the customer.
  6. Subject of the E-Mail (Activity Report): A subject for the e-mail for sending the activity report can be defined in a text field. Placeholders can be used to include certain information in the subject. (see placeholder)
  7. Text Block for the E-Mail (Activity Report): A text block can be selected which is inserted into the e-mail when an e-mail is created for sending the activity report to the customer.
  8. Method for sending invoice documents: There are four options how non-internal documents of an invoice are handled while sending the invoice as e-mail.
    1. Attach no documents: This option ignores all documents during the dispatch of the invoice via e-mail.
    2. Attach each document: This option adds every relevant document as a separate attachment to the e-mail.
    3. Attach as combined document: This option combines all relevant documents into one pdf document and attaches this as a separate file to the e-mail. The file name is defined via the separate field "File name of the document attachment".
    4. Attach in base document: This option integrates the relevant documents into the invoice pdf document. There will be only one attached pdf document with the name defined for the invoice file name.
  9. File name of the document attachment: If the "Method for sending invoice documents" is set to "Attach as combined document" a file name for the combined document can be defined in a text field. Placeholders can be used to include certain information in the file name. (see Placeholder)

The current values can be changed via the "Edit" button in a pop-up dialogue.

To the Top ↑

Placeholder

All placeholders are described below.

Placeholders that are labelled as optional must be marked with a question mark in the placeholder. Otherwise, the placeholder would not be replaced if the required data is not available.

Example: {?customerNumber}

  1. Offers
    1. Offer Date: see placeholder for a date value
    2. Offer Number: {offerNumber}
    3. Customer Name: {customerName}
    4. Customer Number (optional): {customerNumber}
  2. Orders
    1. Order Date: see placeholder for a date value
    2. Order Number: {orderNumber}
    3. Order Version: {versionNumber}
    4. Name of the Customer: {customerName}
    5. Customer Number (optional): {customerNumber}
  3. Invoices, combined documents, and activity reports:
    1. Invoice Date: see placeholder for a date value
    2. Start Date of the Service Period (optional): The start date of the selected service period and all its parts can be integrated into the name of the invoice using the following placeholders.
      1. {SSYYYY}: Complete Year
      2. {SSYY}: Year as two-digit number
      3. {SSMM}: Month as two-digit number
      4. {SSMMM}: Month as text (short version e.g. Jan)
      5. {SSMMMM}: Month as text (long version e.g. January)
      6. {SSDD}: Day as two-digit number
      7. {SSW}: Week as one or two-digit number
      8. {SSWW}: Week as two-digit number (with leading zeros)
    3. End Date of the Service Period (optional): The end date of the selected service period and all its parts can be integrated into the name of the invoice using the following placeholders.
      1. {SEYYYY}: Complete Year
      2. {SEYY}: Year as two-digit number
      3. {SEMM}: Month as two-digit number
      4. {SEMMM}: Month as text (short version e.g. Jan)
      5. {SEMMMM}: Month as text (long version e.g. January)
      6. {SEDD}: Day as two-digit number
      7. {SEW}: Week as one or two-digit number
      8. {SEWW}: Week as two-digit number (with leading zeros)
    4. Invoice Number: {invoiceNumber}
    5. Name of Customer: {customerName}
    6. Customer Number (optional): {customerNumber}
    7. Order Reference (optional): {orderReference}
    8. Order Number (optional): {orderNumber}
    9. Order Name (optional): {orderName}
    10. Cost Center of the Order (optional): {costCenterId}

Placeholder for a date value

  • {YYYY}: Complete year number
  • {YY}: Two-digit year
  • {MM}: Month as two-digit number
  • {MMM}: Month as text (short version e.g. Jan)
  • {MMMM}: Month as text (long version e.g. January)
  • {DD}: Day as a two-digit number
  • {W}: Week as one or two-digit number
  • {WW}: Week as a two-digit number

Example: A file name is to be generated for an invoice that contains the customer no., the order no. and the invoice no. and the service end date.

Solution: {invoiceNumber}_{customerNumber}_{orderNumber}_{SEYYYY}{SEMM}{SEDD} Result: IV-2023-10023_CU-10002_OR_2023_10035_20231231.pdf

IMPORTANT: Please note that for all settings that generate a file name only contains characters that are permitted for file names. It is recommended that only letters, numbers and characters such as underscore, hyphen should be used. Umlauts or characters such as ampersands or question marks can be problematic for some operating systems.

To the Top ↑

Back to "System Administration"
Users