FAQ - Working with AdminUI

September 28, 2021|Nataliia Berdychevska

1What is the purpose of AdminUI page?

All the functionalities which users work with in the SMASHDOCs editor are set in the Admin page. Tools for editing texts, paragraph decorators, export templates, settings for transforming Word-documents during the import to SMASHDOCs are arranged with the help of AdminUI.

2How can I get the access to the Admin page?

To be able to reach the Admin page you need to get a special provisioning key. This key you should request and receive at the SMASHDOCs administration. After that insert the key in the corresponding field and click "Submit".

Modal window after inserting link of the Admin page highlighted

3Which settings are available in the AdminUI page?

There are 20 tabs in the AdminUI page, where all settings can be found. These are:

Quick Format Buttons

Component Tags

Special Characters

Inline Styles

Paragraph Decorators

XRef Groups

Import Settings

Sample Documents

SDOX Templates

SmartDocuments Templates

Export Templates

Word Templates

ParsX Mapping

Features

CleanUp Routines

Default Settings

Identity

URLs

Documents

Users

4Which settings are available in the tab "Features"?

Having opened this tab you are able to enable/disable certain options in SMASHDOCs editor in your system. These settings are divided to separate groups, these are:

Authentification

Login page

Document user management

Document creation

Editor in general

Editor tables

Editor top toolbar

Export

Inline styles (Standard)

Modules & Inline objects

System limitations

In each group there are toggles that can be switched on/off. By doing this the administrator can activate or deactivate certain features in the system.

5If I am an administrator and I need to forbid some users to create documents in the system, what should I do?

Firstly, it is worth mentioning that users in each system are divided to internal and external users. You can forbid only external users to create documents. For that, you must be sure that users who should not have permission to create documents in your system are external and then you need to disable the toggle "Allow document creation for exernal users" in the group "Document creation". Remember, that in this case external users will not be able to create or duplicate documents.

Toggle "Allow document creation for external users" highlighted

6If I need to set limits on number of users in a document or on the amount of documents in the system, where can I find these settings?

Such limits are in the tab "Features" in group "System limitations". Here you have to insert the required number of documents/users.

Setting limits on users per document and documents per system

7How can I define, which users are internal and which ones are external?

You can do this in the tab "Users". To make a user internal you should add user's domain into the Internal User Domains line. Also, you can set all users in the system as internal by inserting a symbol '*' into Internal User Domains line. Remember, if the field "Internal User Domains" is empty, this means that all users are external.

Internal User Domains line highlighted

8If I am an administrator of the system, can I decide, who is allowed to take part in the eSign process?

Yes, you can. Only internal users have access to the eSign-function and you are able to decide who can be an internal user. You can find the information how to set a user as internal in question 7.

9Are there any special rules for the Word-document that is uploaded as a new Word template in the tab "Word Templates"?

In each Word-template you must set styles which correspond to particular styles in the SMASHDOCs system. Apart from that, ten placeholders must be obligatory added to the .docx-file with a template for SMASHDOCs system to accept all styles from the template.

Ten placeholders to be added into Word template

10Where can I find added Word templates in the editor?

During the export to Microsoft Word there appears a dialog window with suggested Word templates, that have been previously added in Admin UI page.

The added template is highlighted

11For which formats can templates be created in the tab "Export Templates"?

Export templates can be added for such formats as Epub, PDF and InDesign.

12What happens if I switch off a toggle of one of export formats?

In this case templates for this format will be still in the system, but you will not see them in the list of templates.

13If I am an administrator of several systems, can I copy existing export templates from one system and upload them to another?

Yes, you can. For this you need to download required templates as a .json-file from one system and upload them to the target system.

14Which components of new paragraph decorator creation are there in Admin UI settings?

As soon as you start creating a new paragraph decorator, you will see the following subtabs:

Decorator's name

Positioning

List

Referencing

Typography

Distances

Frames

Filling

ToC

Short cuts

15What do such terms as "Indentation level" and "Fixed indentation" in the subtab "Position" mean?

Indentation level - level where your text starts at the grid in the document; fixed indentation - if active, the text is not moving after pressing TAB / Shift+TAB (TAB and Shift+TAB movings must not be set in this case).

16What is the difference between ordered and unordered types of paragraph decorators?

Unordered type means that the list is displayed with special items, instead of numbers (e.g. bullets, dashes). Ordered type means that the list is displayed with numbers.

17What do terms "Prefix" and "Suffix" in the subtab "List" mean?

Prefix and suffix are symbols that are placed before and after the number in the list. For instance, if the number looks like "(i)", the first bracket is a prefix, the second bracket is a suffix correspondingly.

18Can I create prefixes other than those that are offered by the system?

Yes, you can. For that you have to activate advanced list pattern settings, add numbering placeholder and translate it to all supported languages.

Adding numbering placeholders highlighted

19Which XRefs list patterns can I set in the subtab "List"?

If you have three subparagraphs and you want to make a cross-reference to the third one, in the line 'Xrefs list pattern' you can set such an outlook of your cross-reference, where the numbering of previous subparagraphs will be displayed, too. For that you have to insert three levels with placeholders in a dot in the line 'Xrefs list pattern'.

Xref list pattern highlighted

20What does the term "Reference group" in the subtab "Referencing" mean?

Reference group is a text component with certain styles applied, to which you can create cross-references from the component with paragraph decorator that currently is being set.

21In which case should I tick the checkbox "Read only" in the tab "Typography"?

If you want to set this particular paragraph decorator as non-editable, you have to give it a status "Read only" by ticking the corresponding checkbox.

22What is ToC indentation?

ToC indentation defines the indentation level of your style in table of contents (directory).

23What do terms PD Subset and default PD in the tab "SDOX Templates" mean?

PD Subset and Default PD are the set of applicable styles to the text that is created in SMASHDOCs account. All styles that were added to a particular SDOX template will be available in the editor.

24Can I set multiple default PDs?

No. You can set only one default paragraph decorator, while PD Subset may consist of more than 1 paragraph decorators.

25What is the point of settings in the tab "Import Settings"?

While applying settings in this tab, you can decide how styles of an imported document will look like in SMASHDOCs editor, when you avoid manual mapping and styles are mapped by the system automatically. For the system to perform this mapping according to your needs, you have to set convertible styles in the Admin page in the tab "Import Set Up".

26Can I create a new cleanup routine in the AdminUI page?

No. You can add cleanup routines to your system by uploading a .json-file with keys of required cleanup routines.

27What will happen, if I activate code edit mode?

If code edit mode activated, you will see the list of cleanup routines in text-format and you will be able to edit them. Moreover, your uploaded file with cleanup routines will look like editable text.

Code edit mode activated

28If cleanup routines already exist in the system and I add new routines under the same keys, what will happen?

The old routines will remain and new ones will not be added.

29What does the button "Reset" mean?

Once you click this button, all customer cleanup routines will be deleted and only 4 default routines will be available.

30Which cleanup routines are default?

Default cleanup routines are the following:

Remove all blank lines

Delete unnecessary spaces

Remove landscape

Remove portrait

31Can I delete default routines?

Yes. To do that you have to select routines and click "Delete". Remember: code edit mode should be deactivated in this case.

32When I create a new component tag and tick the field "Unique", what happens?

If you activate the checkbox "Unique", the created component tag can be set only once per component type.

33Can I set multiple fields for one component tag?

Yes, you can. The number of fields you can add to a single component tag is unlimited.

34How will the fields for a component tag look like?

You can decide upon the field type in the settings. There are six main types of field:

Radio buttons

Dropdown (single selection)

Search dropdown

Checkbox

Text field

Weblink field

Once you choose one of suggested types, the field will have a corresponding outlook.

35What is value in component tags?

Value is a so-called type of component tag. For example, component tag "Priority" can have such types as "1", "2", "3".

36Can I decide which and how many values the created component tag will have?

Yes, these settings are configurable per system.

37What is the point of Quick Format Buttons settings?

In Quick Format Buttons settings you can add new style and then find it in the main toolbar at the top of the page while working with a document in SMASHDOCs editor under a certain icon that has been added in settings.

38Can I apply certain settings to the outlook of comments in the imported Word-document?

Yes, you can find these settings in the tab "Default Settings". There you can select the conversation type, in which comments will be imported, and conversation field, where the main message will be imported.

39Can I decide in Admin page who will be allowed to see comments in my document after importing Word-document?

Yes, there is such an opportunity. You have to open a tab "Default Settings" and choose "Conversation scope". There you can select, whether comments in your imported documents will be visible for all or for you only.

40Are all the fields in the tab "Default Settings" obligatory to fill in?

No. The fields "Default style" and "Empty line" are optional.

41What should I insert in the field "Empty line"?

If you want empty lines (without any text, numbers or bullets) to be white and invisible, you should leave this field empty. In case you want these lines to acquire any color, insert there a code of a corresponding color.

42Is it possible to configure text for footnotes through the AdminUI page?

Yes. For that open the tab "Default settings" and in the line "Footnotes settings" insert such information as color, font-family and font-style.

Footnote settings

43If I set a user as a system admin, will there be any differences in outlook of Admin UI page for this user?

If user is system admin, this user has the access to the tabs "Users" and "Documents" in Admin Console only. The user can also reach mentioned tabs from the avatar-menu in SMASHDOCs editor.