Font Server

FastReport Cloud has a cloud storage for fonts, that can be used in templates. Users may add fonts from a public list, as well as upload their own ( only .ttf fonts are supported for now).

After the upload the font is added to the font list in the online designer, and the exported documents gain the ability to use it.

Impotant to note, that not all export formats support embedded fonts (Word, Excel), it means that if the font is not installed on the local system of a person, who is viewing the export result, it wouldn't be visible.

In some formats embedded fonts are supported, but not enabled by default (PDF), so make sure, that correct export parameters are set.

Font server also can return a css style for a font. This style will include a download link and font permissions will be taken into account.

There are 2 kinds of models for the fonts:

  • A model with font description

  • A reference model

Font description model properties

These models are created automatically, when a new font is uploaded to the server and they are not connected with any user workspace.

The server is analyzing the font file and storing it's description in the model, after that a reference model is created in the uploader's workspace.

During the upload the server is firstly checking, if there is already the same font in the database. If that's the case, the upload and analysis are skipped, and the created reference model will be referencing the font, that is already in the database.

This model has the next properties:

  • Names — A list of names, provided by the font file (there are often multiple)
  • Name — Font's name (usually the same as the first name in the Names list)
  • PostScriptName — Font name in the Adobe PostScript format
  • Weight — Font weight. If the file does not provide the font weight, 400 will be used by default (i.e. regular)
  • Italic — A boolean, indicating that the font is italic
  • PubliclyAccessible — A boolean, indicating that the font is publicly accessible to all users. Only administrators can set this flag and when a normal user uploads a font it will always be false.
  • Id — Unique identificator for a description model.

Reference model properties

These models are created during the font upload or during the addition of a publicly accessible font in the workspace. Permissions for the uploaded fonts are managed with the use of these models.

Reference model has the next properties:

  • Id — Unique identificator for a reference model

  • Enabled — A boolean, indicating that the font is being used and is accesible. If set to false, the font will no longer appear in the online designer font list, but the model will be still in the workspace.

  • Description — Text description filled out by users , which can be used for notes, for example - how and when to use the font.

  • Font — A copie of the font description model, to which this reference model is refering. This is an object structured as the model described above.

  • SubscriptionId — Workspace identificator.

    Every reference model is linked to a workspace.

  • CreatorUserId — Identifier of a user, who uploaded the font.

  • EditorUserId — Identifier of a user, who made the most recent change to this resource.

  • CreatedTime — date and time of the resource creation.

  • EditedTime — date and time of the last change made to the resource.

User permissions

User permissions for the fonts are split into 4 groups.

  1. Get — Accessing information about the font.
    1. Entity — Allows user to get the entire model as well as download the font file directly.
    2. Permission — Allows to get the description of the permissions for the font model.
  2. Update — Updating information about the font.
    1. SubscriptionId — Allows to move the font to another workspace (if the user also has access to font creation in the target workspace).
    2. Entity — Allows to enable/disable the font and to update the description.
  3. Delete — Deletion of the data about the font.
    1. Entity — Allows to delete the reference model from a workspace.
  4. Administrate — Managing permissions to the font.
    1. Owner — Changing the owner of the resource and their permissions to the resource.
    2. Group — Editing permissions for the different user groups within the workspace.
    3. Other — Editing permissions for the different users within the workspace.
    4. Anon — Editing permissions for the anonymous users (who may be not even logged in).