Label Printing

Inleiding #

Het labelsysteem biedt de mogelijkheid om op aanvraag een raw-bericht naar een netwerkprinter te sturen. Deze berichten kunnen vanuit elk module worden verzonden, op voorwaarde dat de juiste configuratie is ingesteld.

Configuratie #

ioi module #

Om de labelafdrukfunctie in een module in te schakelen, activeer je de instelling Manual labelling:

Zodra deze instelling geactiveerd is voor een module, wordt de volgende knop beschikbaar:

ioi label paper format #

Elke label is gekoppeld aan een papierformaat. De labelprinter is ook gekoppeld aan een papierformaat, wat compatibiliteitstests vóór het afdrukken mogelijk maakt.

De numerieke waarden in de velden Width en Height hebben geen invloed op de daadwerkelijke afdruk, maar zijn belangrijk voor een latere functie die in dit document wordt beschreven.

ioi printer model #

Elke printer is gekoppeld aan een model dat kenmerken zoals merk, model en afdruktechnologie specificeert. Voor de functie die in dit document wordt beschreven, wordt de ZPL2-afdruktechnologie gebruikt.

ioi printer #

De volgende informatie wordt ingevuld voor elke labelprinter:

• Printermodel: De afdruktechnologie van dit model moet ZPL2 zijn.
• IP-adres: De ioi backend start het afdrukken.

• Poort: Standaard is dit poort 9100.
• Papierformaat: Een testafdruk kan worden uitgevoerd om te controleren of het papierformaat van de printer overeenkomt met dat van het label.

• ZPL naar PDF: Met deze optie kunnen ZPL-labels als PDF worden afgedrukt. De labelinhoud wordt verzonden naar een API die verantwoordelijk is voor de conversie.

ioi label format #

Deze module is bedoeld voor het aanmaken van labels.

Belangrijkste opties: #

• Multiple printing: Vermenigvuldigingsfactor voor afdrukken (standaard: 1)
• Label paper format: Papierformaat gebruikt voor het label
• For doctype: Geeft aan voor welk documenttype het label bedoeld is (Item, Address, Customer, enz.)
• Site id: Als de filter is geactiveerd en de site is opgegeven, is dit label alleen beschikbaar voor gebruikers op die site.
• Division id: Als de filter is geactiveerd en de divisie is opgegeven, is dit label alleen beschikbaar voor gebruikers in die divisie.
• Filter condition: De voorwaarde moet worden geschreven in Python-formaat en een boolean teruggeven. Het object src_doc geeft toegang tot de eigenschappen van het aanroepende document → src_doc.ioistatus

Voorbeeld: frappe.utils.cint(src_doc.ioistatus) == 0 # test document status

From doctype : #

Een enkel label kan worden aangeroepen vanuit verschillende documenttypes (doctypes). Deze tabel laat toe te specificeren vanuit welk documenttype het label aangeroepen kan worden.

• Doctype: Naam van het aanroepende documenttype.
• Type: Veldtype van het document (Document field, Detail field)
  • Het veldtype bepaalt hoe de link tot stand wordt gebracht met de parameter For doctype. Het doel is een veld van het aanroepende document te koppelen aan een document van het type gespecificeerd in For doctype.
• Field name: Toont compatibele velden op basis van het geselecteerde veldtype.
  • Als Document field, toont het de Link-velden van het aanroepende document die verwijzen naar de For doctype.
  • Als Detail field, toont het de tabelvelden van het aanroepende document die minstens één Link-veld bevatten dat verwijst naar de For doctype.
  • In dat geval toont het veld Child field name enkel de Link-velden van het tabeldoctype die linken naar de For doctype.
• Quantity field name: Optioneel, hiermee kan de waarde van het vermelde veld worden gebruikt als het aantal labels om af te drukken. De vermenigvuldigingsfactor van het label wordt in rekening gebracht.
• Condition: De voorwaarde moet worden geschreven in Python-formaat en een boolean teruggeven. De volgende objecten zijn beschikbaar:
  • master: Toegang tot het document van het type For doctype.
  • src_doc: Toegang tot het document dat de afdruk activeert. Dit document is ofwel het aanroepende document, ofwel een rij in een tabel van het aanroepende document, afhankelijk van het geselecteerde type.
  • src_p_doc: Als het type Detail field is, is src_doc de rij en src_p_doc het bovenliggende document.

Raw #

Raw formaat van het label. Net als bij condities is het mogelijk om variabelen van verschillende bronnen op te nemen (master, src_doc, src_p_doc, system).