Pàgines

Es mostren els missatges amb l'etiqueta de comentaris cartes. Mostrar tots els missatges
Es mostren els missatges amb l'etiqueta de comentaris cartes. Mostrar tots els missatges

dimarts, 6 d’agost del 2013

Factures professionals

Factures amb el paquet invoice

El paquet invoice permet crear i calcular l’import d’una factura simplement introduint els paràmetres bàsic com ara el concepte, la quantitat, el preu i l’IVA.

Basant-nos en la classe de document carta (\documentclass{letter}) podem definir l’emissor de la factura, amb les seves dades corresponents, des del comandament 
\adress{DadesEmissor}
El receptor de la factura, i les dades de facturació, es defineix des de la definició de l’entorn letter:
\begin{letter}{DadesReceptor}
Finalment, podem aprofitar el comandament \data per definir la data i el número de la factura.

El paquet invoice  defineix un nou entorn anomenat invoice des d’on es defineix la moneda en què es factura i el percentatge de l’IVA. Per exemple:
\begin{invoice}{Euro}{21}
Dins d’aquest entorn tenim diferents comandaments:

  • \ProjectTitle{RaóDeLaFacturació} En una factura poden haver-hi diferents raons de facturació, per exemple diferents pressupostos. Sota cadascun hi haurà els diferents concepte, despeses i descomptes que, finalment se sumen. 
  • Els diferents conceptes s'incorporen amb el comandament \Fee{Concepte}{PreuUnitari}{Quantitat}
  • A més dels diferents conceptes en una factura s’hi poden afegir despeses puntuals sobre les que no es carrega IVA que es cobren en la mateixa moneda amb el comandament \EBC{DespesaConcepte}{Quantitat}. Si la despesa es va pagar en una altra moneda podem usar el comandament \EFC{DespesaConcepte}{Moneda}{Quantitat}{FactorDeConversió}{}invoice  farà els càlculs que correspongui perquè allò pagat en una altra moneda es carregui en la moneda de la factura. 
  • Si volem fer algun descompte l’introduïm amb el comandament \Discount{ConcepteDescompte}{QuantitatADescomptar} 

El paquet fa tots els càlculs necessaris perquè no calgui més que introduir les dades amb l’ajut del paquet fp. Hi ha un bug, reportat a tex.stackexchange que implicava al paquet per la inclusió de gràfics graphicx però que s’ha resolt. Al fitxer comprimit invoice.zip adjunt trobareu el fitxer d’estil invoice.sty rectificat i amb la declaració de l’opció d’idioma català (catalan). També hi ha el fitxer de definició de les variables d’idioma traduïdes al català invoice.def.



invoice-2.zip
Visualització Baixa






invoice.pdf
Visualització Baixa






invoice.tex
Baixa





Podeu estudiar el codi d’una factura al fitxer tex font i veure el resultat al PDF adjunt on s’ha utilitzat el tipus de lletra Paratype Sans Narrow.

Publicat per primera evgada el diumenge 24 de febrer de 2013.

dilluns, 5 d’agost del 2013

Personalitzar documents amb datatool

Una manera fàcil de combinar correspondència

Ja vam parlar en l’article Combinar i personalitzar correspondència amb KOMA-Script sobre com crear cartes personalitzades amb el paquet scrltr2 del conjunt KOMA-Script . En aquesta ocasió, però, veurem com personalitzar documents de tota mena amb el concurs del potent paquet datatool.

 datatool és capaç de crear una base de dades a partir d’un fitxer CSV, un fitxer de text on els valors estan separats per comes. En un fitxer CSV ben formatat la primera fila conté el nom dels camps separats per comes i cada fila subsegüent és un registre amb els diferents camps.  datatool aleshores importa les dades del CSV i hi treballa amb tota la potència d’una base de dades. La detallada documentació del paquet informa que és capaç de gestionar una base de dades, de crear gràfics circulars, lineals o de barres i de personalitzar documentació.

En aquest article ens centrarem en aquest darrer aspecte i per estudiar el cas hem creat un document d’ajuda al professorat que en la primera part li proporciona informació global sobre les qualificacions dels estudiants en conjunt tot calculant diferents mitjanes de notes. La segona part del document són els butlletins de qualificació a lliurar a cada estudiant. Són pàgines independents personalitzades amb el nom de cada estudiant i llurs qualificacions amb indicació de la mitjana.

Per aconseguir-ho partim d’un fitxer en format CSV (dades.csv) amb els següents camps: Nom, Cognom1, Cognom2, Genere, Dni, Email, Assignatura1, Assignatura2, Assignatura3. Aquest fitxer dades.csv s’importa al document en forma de la base de dades anomenada estudiants amb el comandament
\DTLloaddb{estudiants}{dades.csv}
El comandament que fa la màgia és
\DTLforeach{nombasedades}{assignacions}{text} 
perquè per cada registre, cada fila de la base de dades nombasedades primer fa una assignació de camps a macros per, en acabat, usar aquestes macros al text. Vegem-ne un exemple:
\DTLforeach{estudiants}{%
\cognomP=Cognom1,\cognomS=Cognom2,\nom=Nom}{%
\cognomP\\%
\cognomS\\%
\nom}
Aquest comandament agafa cada fila, cada registre de la base de dades estudiants, i assigna cada camp a una macro (a la macro \cognomP li assigna el camp Cognom1, per exemple). Aleshores escriu un a sota de l’altre el contingut de les macros amb el contingut dels camps.

Basant-nos amb aquestes iteracions podem fer que una acció es repeteixi per cada registre obtenint així i amb un sol document font tants documents finals com registres tingui el fitxer de dades. Això és el que permet crear tants documents personalitzats com persones tinguem a la llista. El codi simplificat és el següent:
\DTLforeach{estudiants}{%
\nom=Nom,\cognomP=Cognom1,\cognomS=Cognom2,\asA=Assignatura1,\asB=Assignatura2,\asC=Assignatura3,\mitj=Mitjana% }{%
\vspace*{2cm}%
Comunicació de qualificacions\par
\vspace{3cm}
D'acord amb les dades dipositades en aquesta institució,\\%
en/na \textbf{\nom\ \cognomP\ \cognomS} amb DNI \dni ha obtingut aquestes qualificacions:\par
\begin{tabular}{ccc}
\bfseries Assignatura 1 & \bfseries Assignatura 2 & \bfseries Assignatura 3\\
\asA & \asB & \asC
\end{tabular}\par
resultant una nota mitjana de \DTLround{\mitj}{\mitj}{2}\mitj \par
\vspace{7cm}
Barcelona, \today \par
\newpage}
}
Observeu que primer es fa l’assignació a macros del contingut dels camps (p.ex: \nom=Nom)i després s’escriuen les dades personals i es crea una taula on es representen les qualificacions i, finalment s’escriu la mitjana arrodonida que també calcula un comandament del paquet datatool.

Fixeu-vos que dins la iteració hi ha el comandament \newpage que és el que fa que cada cop que s’acaba un registre es generi una pàgina nova on posar les dades del registre següent.

Val la pena estudiar el document tex font adjunt a l’article per veure les diferents possibilitats amb què podem treballar. També és interessant observar el PDF que en resulta on a les dues primeres pàgines hi ha la informació pel professorat i la resta del document serien els butlletins de qualificacions a repartir als estudiants.


catalatex_logo.png
Visualització Baixa






dades.csv
Baixa






mailmerge.pdf
Visualització Baixa






mailmerge.tex
Baixa





Publicat per primera vegada el dissabte 7 de juliol de 2012.

dimecres, 31 de juliol del 2013

Combinar i personalitzar correspondència amb KOMA-Script

Les cartes amb KOMA-Script són molt versàtils: combinació de correu

En un article anterior (Cartes amb Koma-script) hem vist com n’és de potent el paquet KOMA-Script en la formatació de les cartes. En aquest veurem, a més, com crear correspondència combinada amb una base de dades de destinataris i com personalitzar fins a cert punt les cartes.

El paquet scrlttr2 admet la incorporació de dades d’usuari des d’un fitxer amb extensió adr (destinataris.adr a l’exemple adjunt) formatat de la següent manera. Cada destinatari té associats 8 camps, dels quals alguns són obligatoris i altres optatius; vegem-ne l’estructura per a un destinatari:
\adrentry{Cognoms=#1}{Nom=#2}%
%{Adreça postal\\CP Població=#3}%
%{Telèfon=#4}%
%{h=home/d=dona=#5}{Tractament=#6}%
%{Càrrec=#7}{Clau_id}
Els camps optatius són el #5, el #6 i el #7 que, per la nostra conveniència els hem assignat a una clau per poder personalitzar després les cartes; la resta són obligatoris. El paquet permet afegir més camps optatius, però cal aleshores reanomenar el comandament d’\adrentry a \addrentry.

Què millor per aclarir-ho que un exemple:
\adrentry{Nito}{Helena}%
{13 Rue del Percebe\\75001 Paris}%
{010}%
{d}{Dra.}%
{Servei de diagnosi}{NITO}
Un cop tenim un fitxer amb tants comandaments \adrentry com destinataris ja podem  fer la combinació de correspondència. Primer hem de cridar-lo des del fitxer tex de la carta amb el comandament \input{destinataris.adr} i hem de reanomenar el comandament \adrentry:
\renewcommand*{\adrentry}[8]{\begin{letter}}...\end{letter}
Per indicar que la carta va adreçada a un conjunt de destinataris, a la carta en lloc d’usar les dades concretes d’un d’ells, utilitzem els paràmetres del comandament \adrentry: #2 pel Nom, #1 pels Cognoms, etc. Així en l’exemple que trobareu al fitxer tex font i que ha generat el PDF també adjunt l’ordre triat ha estat:
 {#6 #2 #1\\#7\\#3}
és a dir: a la primera línia del destinatari el Tractament (=#6), el Nom (=#2) i els Cognoms (=#1); a la línia de sota el Càrrec(#7) i per sota l’Adreça postal amb el CP i la Població(=#3) a baix de tot.

Quan processem el fitxer tex amb pdflatex, per exemple, obtenim un document PDF amb tantes cartes d’una o més pàgines com destinataris hi ha al fitxer d’adreces destinataris.adr.

La màgia de la personalització de les cartes ve de la mà d’una mica de programació. Fixeu-vos que les cartes dels destinataris femenins comencen per Benvolguda, mentre que les dels homes comencen per Benvolgut. Això ho hem aconseguit amb dues passes:

  1. Primer omplint el camp #5 de cada destinatari amb la lletra h quan es tracta d’un home o la d quan és una dona. 
  2. Al fitxer tex de la carta hi posem una condició segons el contingut d’aquest camp:

\ifx h#5 \opening{Benvolgut #2,} \fi
\ifx d#5 \opening{Benvolguda #2,} \fi
Quan el contingut del camp #5 és la lletra h escriu en masculí, però quan és una d escriu en femení. I LaTeX s’encarrega de fer tota la resta de feina.

Observeu en el PDF adjunt a aquest article el resultat obtingut en processar el fitxer tex font que trobareu, juntament amb el fitxer de destinataris, el logo i el fitxer de configuració, en el arxiu comprimit combinar_correspond.zip adjunt.

Publicat per primera vegada el divendres 1 de gener de 2010, dia de Cap d'any.

dimarts, 30 de juliol del 2013

Cartes amb KOMA-Script

En un article anterior (Cartes ) vàrem veure com es poden formatar cartes amb LaTeX per obtenir uns resultats professionals. En aquest veurem com obtenir encara uns resultats superiors amb l’ús de la classe scrlttr2 que forma part del paquet KOMA-Script.

Amb scrrlttr2 podem definir el contingut d’una sèrie de variables predefinides (com ara el nom del remitent, l’adreça, el telèfon, etc) amb el comandament \setkomavar.

Però també en podem definir de noves si ho fem a través d’un fitxer de configuració amb extensió lco on, a més, podem redefinir la disposició del text en la carta i la localització de les dades del remitent i afegir-hi un logo.

La classe scrrlttr2 té una sèrie d’opcions que en faciliten la configuració general, com ara on situar la numeració de la pàgina si se’n vol, l’aparició una línia de separació pel peu o l’encapçalament, la mida del full i de la lletra o la possibilitat de diferenciar i fer més gran la primera pàgina entre d’altres.

En els fitxers PDF adjunts es pot veure el resultat obtinguts sense fitxer de configuració i un altre PDF fet amb fitxer de configuració. Els documents tex fonts i el fitxer de configuració es troben en el fitxer comprimit fonts.zip.

Es pot trobar més informació sobre el fitxer de configuració en l’article Replacing LaTeX2e standard classes with KOMA-Script de la revista The PracTeX Journal.

Publicat per primera vegada el diumenge 27 de desembre de 2009.

dilluns, 15 de juliol del 2013

Cartes

LaTeX també és un sistema molt vàlid per a documents curts com les cartes.

Aquest és el primer d’una sèrie d’articles que dedicarem a les cartes amb LaTeX. Aquest processador de documents treballa amb diferents classes de documents: llibres (book), informes (report), articles (article) i els més senzills: cartes (letter).

L’estructura d’una carta és la més senzilla d’un document LaTeX. Comença amb la definició de document
\documentclass{letter} 
a continuació ve el preàmbul amb els paquets d’idioma, de tipus de lletra, d’encapçalament i peu (útil si la carta ocupa més d’una pàgina), etc.

El cos del document comença amb
\begin{document} 
seguit, en aquest cas, pel començament de la carta
\begin{letter}{dades del destinatari}.

Segueix un comandament específic per cartes, que és \opening{salutació} a la que segueix el text de la carta. Acaba amb el comandament \closing{comiat} i els imprescindibles  
\end{letter} 
\end{document}.

Adjunt a aquest article trobareu els dos exemples acostumats. Per una banda el fitxer font comentat en format tex i el resultat passat a PDF que, com sol ser habitual, és espectacular. Gaudiu-ne.

Publicat per primera vegada el 31/5/05