Custom Label templates (ISAD-G)

Owned by Shantanu Roy
Last updated: 21.11.2024
7 min read

In Asta7, we have a feature to print labels for Serie and Stykke. By default, each project will have 4 default label templates:

  1. Liten

  2. Middel

  3. Stor

  4. Stor med QR

However, the dimensions, sections and content of these templates can be modified or new templates can be created from them. Note: This feature is for ISAD-G and in Norsk only.

When a project is created, the 4 default templates are also created in the “label_template“ table. Also when we create our own templates, there will be an entry in this table. When the project is deleted, these entries will also be deleted.

image-20241120-095921.png

The default template export contents:

Labels will be generated

  1. Per Stykke when we have Stykke under Serie

  2. Per storage unit item when we have Mappe under Serie and that Mappe has a storage unit item. If there are multiple mappe but has the same storage unit item, there will be 1 label.

So the simplest candidates for labels are:

  1. Arkiv -> Serie -> Stykke

  2. Arkiv -> Serie -> Mappe (with storage unit)

Other variations of label canditates are:

  1. Arkiv -> Arkivdel -> Serie -> Serie -> Stykke → Mappe_1, Mappe_2 …. Mappe_N (multiple siblings)

  2. Arkiv -> Arkivdel -> Serie -> Serie -> Mappe (with storage unit)

Now depending on whether there is arkivdel, the arkivdel section will show up or be blank.

Also, depending on how many parent Serie the Stykke has, the list of Serie will show up.

Finally, depending on how many Mappe siblings (mappe under mappe is not shown) are there under the Stykke, the list of mappe will show up. We will also show a mappe list for storage unit item, if there are multiple Mappe with the same storage unit item

Liten:

Editor view:

 

image-20241120-111228.png

 

Export:

image-20241120-110723.png

Middel:

Editor view:

 

image-20241120-111512.png

 

Export:

 

image-20241120-111924.png

Stor:

Editor view:

image-20241120-112017.png

Export:

image-20241120-112723.png

Stor med QR

Editor view:

image-20241120-112806.png

Export:

image-20241120-113622.png

Making custom templates: The template editor

We can create our own templates or modify the existing ones using the template editor. To create new template, we need to make a copy of any existing ones. The copy button can be found on the upper right corner.

image-20241121-054250.png

Note that we the name of the templates should be unique.

 

The template is made of sections and its content. First and foremost, we have the “main-section“ which is basically the canvas - and inside that we will be having subsections. To make any modifications to the section like changing the height/width or adding contents, we need to select the section first. Also, to add subsections, we need to select the section under which we want to create the subsection.

 

image-20241121-054955.png
Button to add section (under section properties)

The main section is selected when we click outside the template viewer. Since the main section is the “canvas“, the subsection height total must be within the canvas height. Otherwise the export will break. To identify whether the heights have crossed this limit, a scrollbar will appear. In that case, the canvas height must be increased to accommodate that. The height/width of a section can be changed from the “Width/Height“ accordion menu.

 

image-20241121-055556.png

In this menu, we can also see another option - “Center vertically“, this will make make the alignment of the section content vertically aligned (or disable the alignment).

image-20241121-055745.png
Center vertical: No

 

image-20241121-055816.png
Center vertical: Yes

We can also add borders of the section from the “Border (pt)“ accordion menu

 

image-20241121-060043.png

We can also add background color to sections and clear it if we don’t want it anymore from the color picker and the clear button under section properties accordion

image-20241121-061459.png

Now a section can be of 2 types

  1. Regular content section: This is when the “Array field“ is left blank. With this configuration, we will get all the available contents under “Contents“ section (which we will explore later).

  2. Repeated content section: This is when we select “Serieforeldre“ or “Mapper“ from the array field. Since these two can be multiple, the section will also be repeated N number of times where N = number of Serie, or Mappe. Also, in the content section, now we will see contents relevant to the selected array field type:

 

image-20241121-062112.png
Serieforeldre selected

 

image-20241121-062154.png
Mapper selected

Note that this is how the “List of serie“ in Liten and Middel, or list of Mappe in the Stor / Stor med QR are made.

 

A section can also depend on (be visible or hidden) based on some fields. This is useful when we want a header to show up or not depending on if there is a content. To make a section dependent on some fields, there is a dropdown in the section properties “Dependent Fields“. Observe that the “Arkivdel:“ header section is made to be dependent on arkivdel identifikator and arkivdel Navn. This means this header section will only show up if there are values of both of these fields.

 

image-20241121-062740.png

 

Section contents:

The section content accordion has some content type:

  1. Field

  2. Text (plane text)

  3. QR

However a section can contain either QR or fields (multiple) / Text (multiple)

image-20241121-063048.png

Field

When we add a field, we have to select which field value we want to show. These options will be shown in a dropdown and the option will depend on what we have selected in the array field:

  1. If Serieforeldre is selected, we have:

    1. Identifikator (Serie)

    2. Navn (Serie)

 

image-20241121-063517.png

  1. If Mapper is selected, we have:

    1. Identifikator

    2. Navn

    3. Arkivkode fra

    4. Arkivkode till

    5. Arkivkode fra - Arkivkode till

    6. Period start

    7. Period slutt

    8. Period start - Period slutt

 

image-20241121-063816.png

 

  1. If Array field is left blank, we have:

    1. Identifikator / Lagringsenhetsidentifikator - This is the Stykke Identifikator or the Storage unit identifier (used in the footer of all the default templates)

    2. Organisasjons

      1. Navn

      2. kode

    3. Arkiv

      1. Identifikator

      2. Navn

    4. Arkivdel

      1. Identifikator

      2. Navn

    5. Foreldre → This is also used in the footer of all the default templates this will be the parent serie’s identifikator.

      1. Identifikator

      2. Navn

    6. Innhold

      1. Identifikator

      2. Navn

      3. Eget innhold

      4. Arkivkode fra

      5. Arkivkode till

      6. Arkivkode fra - Arkivkode till

      7. Period start

      8. Period slutt

      9. Period start - Period slutt

Note that if we have the “pair fields” e.g. Arkivkode fra - Arkivkode till, the “-“ will show up if both the values are there.

If there are multiple fields / text or a combination of both, a separator must be selected. We have 2 seperator options: “,“ and “-“. This will separate each items with the selected separator

 

image-20241121-064736.png

QR:

If we select the QR as content, we won’t be able to select any other field or texts. Note that we can change the dimensions of the QR, and accordingly the section height will also be changed.

The QR contains the stykke amid or the storage unit item id (when we have Serie → Mappe (with a storage unit) )

 

image-20241121-064903.png

Plain text:

These can be any text

 

Text style:

We can also edit the content style. The options for content style are:

  1. Horizontal alignment

  2. Font style: Bold, Italic, Underline → we can also clear the applied style

  3. Font size

  4. Color → can also be cleared

image-20241121-073119.png

 

Padding

Apart from the content style, we can also add padding to the content for fine adjustments:

 

image-20241121-073339.png

Note that the padding are relative the section edges, so the content will move up, if we add more bottom padding.

 

Reset and Save

In any case, we have to hit save to actually save the changes we have made. When we copy a template, we have to hit save to save it in DB. If we make any changes after hitting save, we can hit reset to go back to the last saved version.

 

image-20241121-073602.png