Skip to main content
Skip table of contents

Define card type

This article describes how to define a card type in the CardDesigner tool in Nexus Card SDK.

A card type is a card definition, which includes layout for a card. You can define a card front and back, card printer, encoding, and associate card types with databases. The card types are handled in the Card Table view in the CardDesigner tool.


Start the CardDesigner tool
  1. Start the CardDesigner tool from the Start menu in Windows.
Create card type
  1. In CardDesigner, click File > New Card Type or click the Create new card type button in the tool bar.
  2. The New Card Type dialog box opens. Continue to make settings for the new card type.
Make global settings

In the New Card Type dialog box > Global tab, you make settings for the card layout.

FieldDescription

Name

Name of the card type.

Front

Card layout assigned to the card front. (One card layout can be used by different card types.)
Click New... to create a new blank card layout. After configuring the card type, you can open and edit the layout in Card Layout view.

Back

Card layout assigned to the card back. (One card layout can be used by different card types.)
Click New... to create a new blank card layout. After configuring the card type, you can open and edit the layout in Card Layout view.

Default Card Type checkbox

The default card type is the card type that will be automatically produced if no other card type has been assigned.
Make printer settings

In the New Card Type dialog box > Print tab, you make settings for the different printers.

Field

Description
PrinterSelect the printer you want from the list of available and installed printers. The respective card type will then be output to this printer.
Default SettingsIf this option is enabled, the default settings of the selected printer are used.
Special SettingsEnabling this option allows you to use custom print settings. The printer settings are set in a printer-specific dialog box, which is displayed via the ... button.

Description

Description of the card material used. Make sure the spelling of the material is consistent throughout.

Note

This description is only relevant if the Message on Change of Material option is enabled.
Message on Change of MaterialIf this option is enabled,
  • the suitable material will be requested immediately the first time you print to the printer.
  • after changing the material name, the new card material will be requested for subsequent printing.
Rewrite Card with Position MarksUse this option to ensure that the rewrite printer only accepts cards with position marks if they were introduced in the intended orientation. (This feature is only available in conjunction with built-in encoding.)
Make encoding settings

In the New Card Type dialog box > Encoding tab, you select and configure encoding.

  1. Click New to create a new encoding. The Encoding Type Selection dialog box will open.
  2. Select an encoding type from the list and click Next > to confirm the selection.
  3. The Encoding Description dialog box opens and lists all encoding rules available for this card type (that is, which have been installed on your computer.

  4. Optional: Click Import to install additional encoding rules which contain your customer-specific encoding structure.
  5. Select an encoding rule and click Next > to confirm your selection. In the Encoding Fields dialog box that opens, all available encoding fields are listed.

    An encoding rule may contain one or more encoding fields. The value of an encoding field can be fixed or variable:

    Values that are identical to all cards such as, for example, the company ID (company code) or the validity of a card are constant, fixed entries.

    Values that are individual and different such as, for example, card numbers or card versions are variable settings read in from a database.

  6. To assign specific values to the encoding fields, select an encoding field from the list, and click Edit to open the Encoding Field – Database Field Assignment dialog box.

    The following settings can be used in an encoding field:
    • Only constant values (Values enclosed in double quotes, for example, "0147", or "11-99")
    • Only variable values (Values bound to a database field, for example, CardNumber or CardVersion)
    • Mixed constant and/or variable values (Combine values by using the plus sign, for example, "0147"+CardNumber+"11-99")

  7. Map the encoding field to a database field or a fixed value:

    1. Click Database Field... to open a list of available database fields.
    2. Select the database field you want, and then click OK to go back to the Encoding Field – Database Field Assignment dialog box.
  8. Define further settings to adjust the value of the encoding field. You can, for example, extend your input to include fixed values by entering the card validity in addition to the card number.
  9. Click OK to confirm your entries and to go back to the Encoding Fields dialog box or click Cancel to close the dialog box without making any changes.
  10. In the Encoding Fields dialog box, click Finish to save your settings. You will automatically go back to the Encoding tab.
  11. If there are more than one encoding, you can use the toggle button to set the order of the encodings. During production, the encodings are performed from top to bottom.

    The actual production order may also be dependent on (and influenced by) the hardware used.

Edit an encoding

You can change an existing encoding at a later date.

  1. Click the Edit Card Type button on the Toolbar - Card Table, or use the menu bar (File > Edit Card Type...), or double-click on the name of the card type in the Card Table view to open the Card Table: Edit Card Type... dialog box.
  2. In the Encoding tab, select an encoding rule from the list and click Edit. The Encoding Fields dialog box opens.
  3. Select an encoding field and click Edit and Next.
  4. In the Encoding Configuration dialog box you can use the Encoding Fields, Devices and Condition tabs to adjust the settings of the encoding rules.
    1. In the Encoding Fields tab you change an existing assignment between encoding fields and database fields.
      1. Select an encoding field displayed in the list, and click Edit to change the existing assignment (described above in this article).
    2. In the Devices tab you assign other encoders or readers.
      1. Select another encoder, if further encoders are connected to the system. The card type will be encoded using the device that is displayed. There can be internal encoders, which are directly integrated into a printer, and external encoders, which are connected as an independent device.
      2. Select another reader, if further readers are connected to the system. The card type will be read using the device that is displayed. The procedure for installing hardware components is described in detail in Configure Card SDK.
    3. In the Condition tab you decide if a conditional encoding as necessary. Conditional encodings are required, for example, if the employees of a company should not all have the same permissions. Conditional encodings enable you, for example, to distinguish ID cards which authorize access either to the premises or to the canteen, from those which authorize both in combination.
      1. Here, you can set conditions to determine whether and when a card should be encoded. If encoding conditions have already been defined for an encoding type, these settings are automatically displayed in the input fields when clicking on this tab.
      2. Select a database field. An encoding is performed during runtime, in accordance with the contents of the database field.
      3. Enter a value in the Value field. The encoding is only performed if the value of the database field matches the contents of the specified database field during runtime.

        If multiple encoding descriptions are assigned to one card type, you must make sure that the defined condition allows to uniquely select one of the descriptions.

      4. Click OK to save your settings. The Encoding Configuration dialog box is closed, and you automatically go back to the Card Table: Edit Card Type tab.

Make data source settings

In the Data Source tab you can configure an individual data source for each card type, and link the fields of CardDesigner to the fields of an external data source (Fields section). In addition, you can set up an individual counter (Counter section) for each card type.

These are the settings available to set up a counter:

Initial ValueThe value the numbering starts with.
StepsThe value by which the counter is increased every time a card is produced.
FieldOn production, the counter value is assigned to this database field.
Multiple InitializationWhen this option is selected, a new counter value will be assigned on each production. If this option is disabled, the counter value will only be assigned to the field if it is empty.
Edit card type
  1. Click the Edit Card Type button on the Toolbar - Card Table (select a card type first), or use the menu bar (File > Edit Card Type...), or double-click on the name of the card type in the Card Table view to open the Card Table: Edit Card Type... dialog box.
  2. Use the Global, Print, Encoding, and Data Source tabs to set, change or delete the different settings, see "Create card type" in this article.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.