2024 Update Rollup 2

Contact ManagementPermanent link for this heading

Fabasoft Folio supports the management of contacts. In addition to the classic contact management, a separate contact management app that can be enabled is also available.

Classic Contact ManagementPermanent link for this heading

The following object types define contacts:

For persons

  • Contact Person
    Is used to store the contact data of an external contact person.
  • Employees
    Is used to store the data of an in-house employee.

Name and address details, including e-mail addresses and telephone numbers, can be entered for individual persons. Each person has a list of business objects directly assigned to the person and a list of correspondence (Communication) and a journal. In general, the person's main address is the first address entered. However, if the option to use the organization's address as the main address has been selected, this is the main address.

For organizations

  • Organization
    Is used to store the contact data of an external organization. Contact persons can be assigned to organizations.
  • Own Organization
    Is used to store the data of an own organization. Employees can be assigned to own organizations.

Note: To search for persons and organizations, search for “Contact”.

Creating an OrganizationPermanent link for this heading

An organization represents a legal person. Contact persons who are employed in this organization can be added. In addition, the corresponding business objects are stored in an organization, as well as the direct correspondence with the legal person. All correspondence with an organization - i.e. both those conducted directly with the organization and those conducted indirectly via contact persons - appears in the communication.

To create an Organization, proceed as follows:

  1. Click the “New” action.
  2. Select “Organization” and click “Next”.
  3. Edit the metadata of the organization and click “Next”.

Creating an Own OrganizationPermanent link for this heading

In contrast to organizations representing external partners, an own organization is represented by an Own Organization. Employees can be assigned to own organization.

To create an Own Organization, proceed as follows:

  1. Click the “New” action.
  2. Select “Own Organization” and click “Next”.
  3. Edit the metadata of the organization and click “Next”.

Creating an EmployeePermanent link for this heading

An employee can be created in the Employees field of an own organization or on “Home”.

To create an Employee, proceed as follows:

  1. Click the “New” action.
  2. Select “Employee” and click “Next”.
  3. Edit the employee's metadata and click “Next”.

Creating a Contact PersonPermanent link for this heading

A contact person can be created either in the Contact Persons field of an organization or on “Home”.

To create a Contact Person, proceed as follows:

  1. Click the “New” action.
  2. Select “Contact Person” and click “Next”.
  3. Edit the metadata of the contact person and click “Next”.

Note: Contact persons are not allowed in the Employees field of an own organization.

Displaying the Communication With a Person/OrganizationPermanent link for this heading

Persons and organizations have a Communication field, in which the incoming and outgoing communication of this organization/person is recorded.

  • Incomings
    All incomings for which the person or organization is specified as the addressee are displayed in the Communication field.
  • Outgoings
    For outgoings with the mail processing type “E-Mail Dispatch (Interactive)”, the personalized Outgoing will be entered after generation of the fair copies (if the outgoing was undeliverable, the icon of the fair copy changes).
    For outgoings with the mail processing type “E-Mail Dispatch (Background)”, the Outgoing will be entered upon confirmation of dispatch/printing (if undeliverable, the outgoing no longer appears).

To display the communication with a person/organization, proceed as follows:

  1. In the context menu of the person/organization, click “Properties”.
  2. Switch to the “Communication” tab.

All business objects that have been received from/sent to this person/organization will be displayed in the Communication field.

Creating an Addressee List for Bulk MailingsPermanent link for this heading

Addressee Lists can be created for bulk mailings. An Addressee List is created using sets of contacts, which can be filtered by individual countries.

The contacts determined this way can have several addresses, so a Topic (i.e. a Term) can be specified in an addressee list that gives the purpose of the addressee list (for example, TechEd invitation). In this case, the address of a contact that has this (or a higher-level) Term entered will be used. If no address is found for the Term, the main address of the contact will be used.

To create an Addressee List for bulk mailings, proceed as follows:

  1. Click the “New” action.
  2. Select “Addressee List”, type a name for the addressee list and click “Next”.
  3. In the context menu of the addressee list, click “Properties”.
  4. Edit the metadata of the addressee list (for example, Topic, Country, Addressees).
    • In the Addressees field, enter individual addressees, Search Folder, Selection Result or further Addressee Lists.
    • In the Country field, enter a country to restrict the addressee list to addressees of a particular country (compared with the country of the address of the addressee).
    • In the Topic field, select a Term to use the corresponding address (for addressees with several addresses entered).
    • In the Exclusions field, enter individual addressees, Search Folder, Selection Result or further Addressee Lists that are contained in the Addressees and are to be excluded from the dispatch.
  5. Click “Next”.

Resolving an addressee list

Before an Addressee List can be used for mailings, it must be resolved. For this purpose, the “Resolve” context menu command is available.

During resolving, the individual addresses will be determined and stored for the addressee list in the form of a CSV file. This CSV file will be stored on the “Result” tab and can be downloaded using the “Download” button. In addition, the number of determined addresses will be provided in the Count field and a preview will be provided in the Addressees (Preview, Maximal 100 Lines) field.

Contact Management AppPermanent link for this heading

The contact management allows you to create and manage contacts in contact rooms. Based on user-defined criteria you can specify address lists that can be exported for sending newsletters, for example.

Contacts can be either contact persons or organizations. Duplicate checks support the avoidance of different datasets.

Special property values of contacts (e.g. salutation, address, telephone number and so on) can be assigned to different contact rooms and are therefore only visible to authorized users in the respective contact rooms. This makes it possible, for example, to ensure that the business contact data of employees are accessible to all employees, while the private contact data is only accessible to the HR department.

Note: To enable the contact management app, an administrator must add the app to a group on the “Apps” tab, in the Licensed Apps field. After applying the changes, a corresponding configuration is automatically added to the App Configurations field. Users who should administer the app can be added as Contacts Administrator to the configuration.

Contacts DashboardPermanent link for this heading

The contacts dashboard provides your access point to the contact management.

When you are added to a contact configuration as a contacts user, a dashboard is automatically created and placed on “Home”. If you are removed as a contacts user, the dashboard will also be removed.

The contacts dashboard is divided into the following areas:

  • Recently Used Contacts
    Shows the last contact persons and organizations you have used.
  • Contact Rooms
    Shows the contact rooms in which the contacts are managed. Each contact room defines its own rights context.
  • Address Lists
    Shows all address lists. In address lists, contacts can be collected and exported from different contact rooms.

You can perform the following actions:

  • Create Contact Room
    As contacts administrator you can use the “Create Contact Room” action to create new contact rooms.
  • Switch to Configuration
    Use the “Switch to Configuration” action to view the configuration associated with the dashboard.
  • Settings
    The “Settings” action allows you to set general contacts dashboard properties, such as the logo or notification setting.

Contacts ConfigurationPermanent link for this heading

In the contacts configuration, you can define as contacts administrator settings for the metadata of contacts. In addition, you can specify users who are allowed to use the contact management.

Note: As contacts administrator, you can switch to the assigned configuration via the contacts dashboard.

Areas

The contacts configuration dashboard is divided into the following areas:

  • Contact Rooms
    Shows the contact rooms in which the contacts are managed. Each contact room defines its own rights context.
  • General areas

Actions

You can perform the following actions:

  • Create Contact Room
    With the “Create Contact Room” action you can define a new contact room.
  • Translations
    The “Translations” action can be used to export or import a CSV file containing the multilingual names of the customizing objects. This enables an external translation.
  • Settings
    Use the “Settings” action to define settings for the metadata of contacts.
  • Team
    The “Team” action allows you to specify contacts administrators who can edit the configuration. Contacts administrators have full control on all contact rooms. Contacts users are authorized to use the contact management. The respective rights are determined by the contact rooms.
    Note: Based on the specified users the consumed licenses of the respective service package are calculated.

Settings

In the contact configuration, you can make the following settings:

“Contact Person” tab

  • Contact Person
    Specifies which optional contact person metadata should be displayed for a contact person.
  • Address
    Specifies which optional address metadata should be displayed for a contact person.
  • Organization
    Specifies which optional organizational metadata should be displayed for a contact person.
  • Further Information
    Specifies which optional additional information metadata should be displayed for a contact person.
  • Declarations of Consent
    Specifies which fields should be displayed for a contact person with regard to declarations of consent for data processing.

“Organization” tab

  • Organization
    Specifies which optional organizational metadata should be displayed for an organization.
  • Address
    Specifies which optional address metadata should be displayed for an organization.
  • Further Information
    Specifies which optional additional information metadata should be displayed for an organization.

“Predefined Values” tab

  • Relationship Types
    Specify values that you want to be selectable for relationship types (for example, business partners).
  • Industries
    Specify values that you want to be selectable for industries (for example, trade).
  • Functions
    Specify values that you want to be selectable for functions (for example, consultant).
  • Kinds of Social Media
    Set values to be selectable for types of social media (for example, Facebook).
  • Kinds of Other Information
    Specify values to be selected for types of additional information (for example, hobby).
  • Declarations of Consent
    Specify values to be selected for types of declarations of consent (for example, e-mail).

“Externally Managed Fields” tab

  • Contact Person
    The selected metadata is displayed read-only for a contact person, if the Managed Externally option is selected for the contact person. This means that the metadata can no longer be changed via the user interface, but only via the import mechanism.
  • Organization
    The selected metadata is displayed read-only for an organization, if the Managed Externally option is selected for the organization. This means that the metadata can no longer be changed via the user interface, but only via the import mechanism.

Contact RoomsPermanent link for this heading

Contact rooms are used for the structured administration of contacts and to define access rights (“Team” action) and default values (“Settings” action > “Default Values” tab).

You can store the contacts directly in the contact room at top level or structure them further with folders. Special property values of contacts (e.g. the salutation) can be assigned to different contact rooms and are therefore only visible to authorized users in the respective contact rooms.

Address lists allow collecting and exporting contacts from different contact rooms.

Unstructured Contact Rooms

If you want to manage a large number of contacts in a contact room, an unstructured contact room is a good option, which allows each user to individually specify which contacts are to be displayed using search criteria.

Using the “Tools” > “Display Entries in Flat List” context menu command, users with full control can convert a contact room into an unstructured contact room. Note that this will delete all existing contact folders.

The following options are now available to you:

  • Search or Adapt Search
    If no manual search criteria are currently defined, you can use the “Search” action to specify what (e.g. organizations) and with which search criteria you want to search. The result is displayed directly in the contact room.
    • If search criteria have already been defined, you can change them accordingly using the “Adapt Search” action.
    • To change what you want to search for, first execute the “Reset Search” action. This will display the “Search” action again.
    • The list is not updated automatically and can be customized manually. So, for example, contacts you have created will be displayed even if they do not match the current search criteria.
  • Refresh
    Updates the list based on the current search criteria. This will undo any changes you have made to the list (e.g. cut or move contacts) and display contacts that have been created in the meantime and match the search criteria.
  • Further Search Functions
    The following additional search functions are available.
    • Reset Search
      Resets the current search criteria. An empty list is displayed.
    • Save Search Form
      If manual search criteria are defined, they can be saved for reuse.
    • Load Search Form
      Loads a saved search form. Only search forms that make sense in the context of the contact room (search for address lists, contact persons or organizations) are offered. The entries in the list are updated accordingly.

Using the “Tools” > “Structure List Entries in Folders" context menu command, you can convert an unstructured contact room back into a structured one. In doing so, the contacts are stored in folders that correspond to the respective initial letter. A separate folder is created for address lists.

Note:

  • A maximum of 10000 objects will be returned as search result. When the maximum is reached, a corresponding dialog is displayed.
  • The origin of objects is the unstructured room.
  • “Open Origin” opens the unstructured room.
    Note: The object is only possibly visible in the query-based list.
  • Objects in query-based lists of the room have no link state (unless the object is assigned to another room).
  • Unstructured rooms do not have orphaned objects.
  • Automatic change of room assignment is not applied. The room assignment can be done manually using the corresponding context menu command.
    Note: For structured rooms, the assignment is changed when an object is cut and located in exactly one other room.
  • Unstructured rooms cannot be converted into folders.
  • Time travel is not available in unstructured rooms in the query-based list.
  • Unstructured rooms cannot be kept up-to-date in the mobile app or in the Fabasoft Folio Folder.

Creating Contact PersonsPermanent link for this heading

To create a contact person, proceed as follows:

  1. Navigate in the desired contact room.
  2. Click the “Create Contact Person” action.
  3. Enter the contact person’s data. First name and surname are mandatory fields.
  4. Optionally, click the “Show Additional Fields” button to see all available fields of the contact person.
  5. Click “Create”.

Note:

  • If no main organization is assigned to the contact person, an organization name and the function in the organization can be assigned textually.
  • If organizations are assigned to the contact person, the addresses and telephone numbers of the current organizations are added to the contact person.
  • Before a contact person is created, a duplicate check is automatically carried out (see chapter “Duplicate Check”).

Creating OrganizationsPermanent link for this heading

To create an organization, proceed as follows:

  1. Navigate in the desired contact room.
  2. Click the “Create Organization” action.
  3. Enter the organization’s data. The name is a mandatory field.
  4. Optionally, click the “Show Additional Fields” button to see all available fields of the organization.
  5. Click “Create”.

Note: Before an organization is created, a duplicate check is automatically carried out (see chapter “Duplicate Check”).

Duplicate CheckPermanent link for this heading

When creating or changing contacts, it is checked whether a corresponding contact already exists. The duplicate check is only performed with contacts that the user, who executes the action, has access to. If a duplicate has been found, you can clean up or merge the contacts in a dialog.

Contact persons are recognized as duplicates if

  • either the e-mail address already exists and/or
  • the given first name and surname already exist.
    Note: If the first name is empty, contact persons with the same last name and also empty first name will be recognized as duplicates.

Organizations are recognized as duplicates if

  • either the e-mail address already exists and/or
  • the entered organization name already exists.

To perform a duplicate check, proceed as follows:

  1. When creating or editing a contact, a duplicate check is automatically carried out. If a duplicate is found, a dialog will be opened.
  2. Values that differ are highlighted. The new value is highlighted in yellow and the old value is crossed out. Move the mouse pointer over the corresponding line. You can adjust the values accordingly by using the “Insert”, “Remove", “Replace” or “Discard” buttons. The “Restore” button can be used to discard an adjustment.
  3. Click “Next” after resolving all conflicts.

Changing the Assignment of ContactsPermanent link for this heading

Contacts can be assigned to another contact room. Full control is required in the source contact room and change access in the target contact room. If you do not have the necessary rights, the change request can also be forwarded to another user.

To change an assignment of contacts, proceed as follows:

  1. Navigate to the desired contact.
  2. In the contact's context menu, click “Change Assignment” (available only for users with full control).
  3. If you have change access in the target contact room, you can change the assignment by yourself, otherwise you can forward the change request, for example, to a contact administrator.
    • Case 1: Select the target contact room and click “Change Assignment”.
    • Case 2: Click “Forward”. Select a user (contact administrator) and click “Forward”. The selected user receives an activity in the worklist. The assignment to the contact room can be changed via the “Change assignment” work step.

Note: You can determine contact administrators by switching to the configuration and clicking the “Team” action.

Using Address ListsPermanent link for this heading

Address lists can be created in a contact room (access rights context) using the “Create Address List” action. However, the contacts in address lists can be collected from different contact rooms.

If a user does not have access rights to a contact in the address list, the contact is displayed with “Access Denied”.

Additional address lists can be created in address lists. This makes it possible to create an address list hierarchy. For example, an address list “Events” can consist of address lists for different events. When exporting the “Events” address list, all contacts of the subordinate address lists are taken into account.

You can manually compose address lists by copying and pasting contacts into the address list. Alternatively, you can also define search criteria.

To define search criteria for an address list, proceed as follows:

  1. Navigate in the desired address list.
  2. Click the “Define Search Criteria” action.
  3. Select whether you want to search for contact persons or organizations.
    You can also restrict the objects you are looking for to the current contact room or your organization.
  4. Enter the search criteria and click “Save Query”.
  5. Click on the “Refresh Result” action to apply the search criteria.

Note:

  • “Refresh Result” applies the last saved query to the address list.
  • You can also use the “Define Search Criteria” action for a standard search without saving the query. You can copy the search hits manually.

Importing and Exporting ContactsPermanent link for this heading

The import and export of contacts is possible in address lists. When importing contacts, they are assigned to the contact room of the used address list. If a user-defined form is assigned to contacts, these properties can also be imported and exported (the programming name of the respective property serves as the column caption).

Import

Contacts can be imported and updated using a CSV or XLSX file.

To import contacts, proceed as follows:

  1. Navigate in the desired address list.
  2. Click the “Import Contacts” action.
  3. Click the “Download CSV Template” button to obtain a template describing the required data structure.
  4. In the Content field, enter the path to the CSV or XLSX file that defines the contacts.
  5. Click “Start import”.
  6. After the import has completed, click “Next”.

The imported contacts are stored in the address list and in the corresponding contact room.

The CSV columns are generally user-defined text fields of the type string or date (yyyy-mm-dd). For multi-value fields (e.g. nameorgext) a carriage return (CR LF) is used as separator.

Note: The externally managed properties of a contact can only be updated, if the specified data source matches the data source of the existing contact.

Organization

The following table contains all relevant columns for organizations.

CSV Column

Field

Possible Value

objexternalkey

Import ID

String

To fill fields with several lines (e.g. addresses), you can specify several lines with the same external key (objexternalkey) in the CSV file.

objclass

Object Class

String (ContactRoomOrganisation)

externaldatasource

External Data Source

String

orgname

Name

String

address.addrstreet

Addresses (Street)

String

address.addrpostofficebox

Addresses (P.O. Box)

String

address.addrzipcode

Addresses (Zip Code)

String

address.addrcity

Addresses (City)

String

address.addrstate

Addresses (State)

String

address.addrcountry

Addresses (State)

String

address.addrtopic

Addresses (Type)

Reference of an address type (e.g. TermBusiness, TermPrivate)

emailinformation.emailaddress

E-Mail Addresses (E-Mail Address)

String

emailinformation.addrtopic

E-Mail Addresses (Type)

Reference of an address type (e.g. TermEMail1, TermEMail2)

telephone.telnumber

Telephone Numbers (Telephone Number)

String

telephone.addrtopic

Telephone Numbers (Type)

Reference of an address type (e.g. TermBusiness, TermFax)

website

Web Site

String

telephonebusiness

Telephone Numbers (Telephone Number, Business)

String

telephonefax

Telephone Numbers (Telephone Number, Fax)

String

telephonemobile

Telephone Numbers (Telephone Number, Mobile)

String

telephoneprivate

Telephone Numbers (Telephone Number, Private)

String

emailbusiness

E-Mail Addresses (E-Mail Address, Business)

String

emailprivate

E-Mail Addresses (E-Mail Address, Private)

String

addressbusiness.addrstreet

Addresses (Street, Business)

String

addressbusiness.addrpostofficebox

Addresses (P.O. Box, Business)

String

addressbusiness.addrzipcode

Addresses (Zip Code, Business)

String

addressbusiness.addrcity

Addresses (City, Business)

String

addressbusiness.addrstate

Addresses (State, Business)

String

addressbusiness.addrcountry

Addresses (Country, Business)

String

addressinvoice.addrstreet

Addresses (Street, Invoice)

String

addressinvoice.addrpostofficebox

Addresses (P.O. Box, Invoice)

String

addressinvoice.addrzipcode

Addresses (Zip Code, Invoice)

String

addressinvoice.addrcity

Addresses (City, Invoice)

String

addressinvoice.addrstate

Addresses (State, Invoice)

String

addressinvoice.addrcountry

Addresses (Country, Invoice)

String

addressprivate.addrstreet

Addresses (Street, Private)

String

addressprivate.addrpostofficebox

Addresses (P.O. Box, Private)

String

addressprivate.addrzipcode

Addresses (Zip Code, Private)

String

addressprivate.addrcity

Addresses (City, Private)

String

addressprivate.addrstate

Addresses (State, Private)

String

addressprivate.addrcountry

Addresses (Country, Private)

String

orgsuppliernr

Supplier Number

String

orgcustomernr

Customer Number

String

orgtradeid

Trade Directory ID

String

orgvatid

VAT ID

String

orgdataprocid

Data Processing ID

String

orgjurisdiction

Court of Jurisdiction

String

orgindustries

Industries

Import ID of a term

overridekeys

-

CSV columns of properties to be overwritten separated by commas (otherwise empty values are ignored and values are added in list properties)

Note: For overridekeys with multipart CSV column names, specify the string before the dot (e.g. telephone). Overwriting therefore affects all values of the telephone aggregate and all other telephone columns serving simplification purposes (telephone.telnumber, telephone.addrtopic, telephonebusiness, telephonefax etc.). For addresses, e-mail addresses and telephone numbers you have to specify the respective base column (address, emailinformation or telephone).

Contact Person

The following table contains all relevant columns for contact persons.

CSV Column

Field

Possible Value

objexternalkey

Import ID

String

To fill fields with several lines (e.g. addresses), you can specify several lines with the same external key (objexternalkey) in the CSV file.

objclass

Object Class

String (ContactRoomPerson)

externaldatasource

External Data Source

String

userfirstname

First Name

String

persmiddlename

Middle Initial

String

usersurname

Surname

String

persposttitle

Post Title

String

persawardedtitle

Awarded Title

String

persjobtitle

Job Title

String

persacademictitle

Academic Title

String

persnickname

Nickname

String

perssex

Sex

String (SEX_FEMALE or SEX_MALE)

persbirthday

Date of Birth

Date

perssalutations.salutation

Salutations (Salutation)

String

perssalutations.addrtopic

Salutations (Type)

Reference of a salutation type (either TermFormalSalutation or TermPersonalSalutation)

persmothertongue

Mother Tongue

Reference of a system language (e.g. LANG_GERMAN, LANG_ENGLISH)

commlanguage

Language for Communication

Reference of a system language (e.g. LANG_GERMAN, LANG_ENGLISH)

address.addrstreet

Addresses (Street)

String

address.addrpostofficebox

Addresses (P.O. Box)

String

address.addrzipcode

Addresses (Zip Code)

String

address.addrcity

Addresses (City)

String

address.addrstate

Addresses (State)

String

address.addrcountry

Addresses (State)

String

address.addrtopic

Addresses (Type)

Reference of an address type (e.g. TermBusiness, TermPrivate)

emailinformation.emailaddress

E-Mail Addresses (E-Mail Address)

String

emailinformation.addrtopic

E-Mail Addresses (Type)

Reference of an address type (e.g. TermEMail1, TermEMail2)

telephone.telnumber

Telephone Numbers (Telephone Number)

String

telephone.addrtopic

Telephone Numbers (Type)

Reference of an address type (e.g. TermBusiness, TermFax)

website

Web Site

String

telephonebusiness

Telephone Numbers (Telephone Number, Business)

String

telephonefax

Telephone Numbers (Telephone Number, Fax)

String

telephonemobile

Telephone Numbers (Telephone Number, Mobile)

String

telephoneprivate

Telephone Numbers (Telephone Number, Private)

String

emailbusiness

E-Mail Addresses (E-Mail Address, Business)

String

emailprivate

E-Mail Addresses (E-Mail Address, Private)

String

addressbusiness.addrstreet

Addresses (Street, Business)

String

addressbusiness.addrpostofficebox

Addresses (P.O. Box, Business)

String

addressbusiness.addrzipcode

Addresses (Zip Code, Business)

String

addressbusiness.addrcity

Addresses (City, Business)

String

addressbusiness.addrstate

Addresses (State, Business)

String

addressbusiness.addrcountry

Addresses (Country, Business)

String

addressinvoice.addrstreet

Addresses (Street, Invoice)

String

addressinvoice.addrpostofficebox

Addresses (P.O. Box, Invoice)

String

addressinvoice.addrzipcode

Addresses (Zip Code, Invoice)

String

addressinvoice.addrcity

Addresses (City, Invoice)

String

addressinvoice.addrstate

Addresses (State, Invoice)

String

addressinvoice.addrcountry

Addresses (Country, Invoice)

String

addressprivate.addrstreet

Addresses (Street, Private)

String

addressprivate.addrpostofficebox

Addresses (P.O. Box, Private)

String

addressprivate.addrzipcode

Addresses (Zip Code, Private)

String

addressprivate.addrcity

Addresses (City, Private)

String

addressprivate.addrstate

Addresses (State, Private)

String

addressprivate.addrcountry

Addresses (Country, Private)

String

persfunctionbc

Function According to Business Card

String

perssupervisor

Supervisor

String

persassistent

Assistant

String

persmainorgname

Name of the Organization

String

persfunctions

Functions

Import IDs of terms separated by a carriage return

persmainorg

Main Organization

Import ID of an organization

perscurremployments.emplorg

Current Organizations (Organization)

Import ID of an organization

perscurremployments.emplfunction

Current Organizations (Function)

String

perscurremployments.emplfrom

Current Organizations (From)

String

perscurremployments.emplto

Current Organizations (To)

String

perspastemployments.emplorg

Previous Organizations (Organization)

Import ID of an organization

perspastemployments.emplfunction

Previous Organizations (Function)

Import ID of a term

perspastemployments.emplfrom

Previous Organizations (From)

String

perspastemployments.emplto

Previous Organizations (To)

String

persconsentdeclarations

Declarations of Consent

Import IDs of terms separated by a carriage return

overridekeys

-

CSV columns of properties to be overwritten separated by commas (otherwise empty values are ignored and values are added in list properties)

Note: For overridekeys with multipart CSV column names, specify the string before the dot (e.g. telephone). Overwriting therefore affects all values of the telephone aggregate and all other telephone columns serving simplification purposes (telephone.telnumber, telephone.addrtopic, telephonebusiness, telephonefax etc.). For addresses, e-mail addresses and telephone numbers you have to specify the respective base column (address, emailinformation or telephone).

Export

Contacts can be exported as CSV file. For property lists, the first value found is exported.

To export contacts, proceed as follows:

  1. Navigate in the desired address list.
  2. Click the “Export Contacts” action.
  3. By default, the columns to be included in the CSV file are determined by the column settings of the address list. Adjust the columns if necessary.
    Note: The last used settings are saved for the address list, if the export was carried out by a user with at least change rights. You can restore the columns according to the address list by clicking the “Reset” button.
  4. Optionally, click “Show Details” to set the order for exporting addresses, phone numbers, e-mail addresses, salutations and contact rooms. The order of the contact rooms is always the second criterion. Only the first value found is exported.
    Example: If you specify the sequence for e-mail addresses with “Business, Private” and the sequence of contact rooms with “Room 1, Room 2”, the following sequence is defined:
    • First, the first business e-mail address assigned to room 1 is searched for.
    • if no e-mail address was found, the first business e-mail address assigned to room 2 is searched for.
    • If no e-mail address was found, the first private e-mail address assigned to room 1 is searched for.
    • If no e-mail address was found, the first private e-mail address assigned to room 2 is searched for.
  5. Click “Export”.

The CSV file with the selected columns is downloaded.

Note: Contacts in the wastebasket are not exported.

Deleting ContactsPermanent link for this heading

To delete a contact (to be placed in the recycle bin) you need to have change access. If property values of the contact are assigned to a different contact room, also change access is required in this room. If you do not have the necessary rights, contact a contacts administrator. To delete permanently a contact (to be removed from the recycle bin) full control is required.

To delete a contact, execute the “Delete” context menu command.

Using Address BooksPermanent link for this heading

Access to contacts is also possible via third-party products such as “Apple Contacts”, which support the CardDAV standard.

To display contacts in a third-party product, proceed as follows:

  1. Navigate in a contact room or address list.
  2. Click the “Add to Address Book List” action.
    Note: The “Remove From Address Book List” action can be used to remove the contact room or address list again.
  3. Switch to your third-party contacts product.
  4. Configure a new account in the third-party product. Enter your Folio log-in e-mail address and password.

The Folio contacts are now displayed in the third-party product and can be edited if applicable.

Serial E-MailsPermanent link for this heading

Via a serial e-mail you can send personalized e-mails to defined recipients from the contact management.

To send a serial e-mail, proceed as follows:

  1. Navigate to a Teamroom and create a “Serial E-Mail” object.
  2. Define the metadata for the e-mails to be sent (see below).
  3. The “Define Addressees” action can be used to define the recipients and to generate the CSV file with the contact data.
  4. The “Execute E-Mail Test Dispatch” action can be used to specify test recipients who receive the specified number of sample e-mails. This allows you to check whether the e-mails meet your requirements.
  5. The “Send Serial E-Mail” action can be used to send the e-mails to the recipients. In the send overview you can also create or update the CSV file with the recipient data.
    You can check the result on the “Transmission Log” tab of the serial e-mail. For the recipient contacts, the serial e-mail is stored on the “Communication” tab.
    When the action is executed again, only e-mails that have not yet been sent are sent (e.g. due to a sending error).

Metadata

Serial E-Mail tab

  • Name
    The name of the serial e-mail.
  • E-Mail Subject
    Defines the subject of the e-mail.
  • Use E-Mail Message From Document
    Defines whether the e-mail text should be entered directly or whether a file should be uploaded. For directly entered text or for an HTML file, the following placeholders can be used to personalize the e-mail:
    • [=addressee_FSCFOLIO_1_1001_FieldAddrSurName]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrFirstName]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrSalutation]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrSexSalutation]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrStreet]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrPostOfficeBox]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrZipCode]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrCity]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrTitle]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrContact]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrCountry]
    • [=addressee_FSCFOLIO_1_1001_FieldTelNumber]
    • [=addressee_FSCFOLIO_1_1001_FieldOrganization]
    • [=addressee_FSCFOLIO_1_1001_FieldAddrState]
    • [=addressee_FSCFOLIO_1_1001_FieldMiddleName]
    • [=addressee_FSCFOLIO_1_1001_FieldPostTitle]
  • E-Mail Message
    The e-mail message as text or file.
  • Attachments
    The specified contents are added as attachments to the e-mail. HTML attachments can also be personalized.
  • Send Attachments as
    The contents can be sent in the original format or as a PDF file. If conversion to PDF is not possible, the file is sent in the original format.

“Addressees” tab

  • Name of Sender
    Defines the name of the sender. By default, your user name is used.
  • E-Mail Address of Sender
    Defines the e-mail address of the sender. By default, your user e-mail address is used.
  • Addressees
    The e-mail is sent to the defined addressees (contact persons, organizations and address lists).
  • Robinson List
    Allows filtering the specified addressees by contacts, organizations and address lists.
  • Create/Recreate CSV File
    To determine the contact data from the addressees, a CSV file must be created before sending.

“Transmission Log” tab

  • Transmission Errors (Preview)
    Shows a limited number of transmission errors that occurred.
  • Transmission Log
    Contains the complete transmission log. If applicable, the corresponding error message is shown for each e-mail.