=================================================================== RCS file: /cvs/pta/pta_import.1,v retrieving revision 1.7 retrieving revision 1.10 diff -u -p -r1.7 -r1.10 --- pta/pta_import.1 2020/11/25 15:04:25 1.7 +++ pta/pta_import.1 2020/11/30 16:19:19 1.10 @@ -1,4 +1,4 @@ -.\" $Id: pta_import.1,v 1.7 2020/11/25 15:04:25 freda Exp $ +.\" $Id: pta_import.1,v 1.10 2020/11/30 16:19:19 freda Exp $ .\" .\" Copyright (c) 2020 Freda Bundchen .\" @@ -14,7 +14,7 @@ .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: November 25 2020 $ +.Dd $Mdocdate: November 30 2020 $ .Dt PTA_IMPORT 1 .Os .Sh NAME @@ -44,10 +44,14 @@ is exactly one of .It .Cm bbva_usa .It +.Cm capital_one_360 +.It .Cm capital_one_credit .It .Cm chase_credit .It +.Cm etrade_ira +.It .Cm optum_hsa .It .Cm sparkasse_camt @@ -56,12 +60,10 @@ is exactly one of .El .Pp and corresponds to an existing -.Pa import_ Ns Ar accountname Ns Pa .txt -configuration file in the current directory. +.Pa ./import/ Ns Ar accountname Ns Pa .txt +configuration file. .Ss Configuration file format -Each file of the form -.Pa import_ Ns Ar accountname Ns Pa .txt -in the current directory is a configuration file that contains rules +Each configuration file contains rules used to import transactions from a financial institution. Like all .Xr pta 1 @@ -79,6 +81,22 @@ The number in .Xr pta-accounts 5 of the bank or credit card account this CSV file contains entries for. This rule is required in every configuration file. +.It Ic COSTCENTER Ar costcenter_column +The column number in the CSV file containing the cost center. +Numbering starts from 1. +If this rule is not specified, no cost centers are assigned. +.It Ic DATE Ar date_column date_format +The column number in the CSV file containing the date. +Numbering starts from 1. +The +.Ar date_format +is one of +.Ic MM/DD/YY , +.Ic MM/DD/YYYY , +.Ic YYYY-MM-DD , +or +.Ic DD.MM.YY . +This rule is required in every configuration file. .It Ic DELIM Ar delimiter The character used to separate fields. This rule is required in every configuration file. @@ -90,6 +108,11 @@ line verbatim, or cause parsing to fail if it does not .It Ic IGNORE Ar regular_expression Skip all lines in the CSV file matching the .Ar regular_expression . +.It Ic QUANTITY Ar quantity_column +The column number in the CSV file containing the number of stock shares. +Numbering starts from 1. +If this rule is not specified, no information about the number of traded +securities is appended to the text string. .It Ic QUOTE Ar quote Expects that every field starts and ends with the .Ar quote @@ -108,12 +131,14 @@ rule. .El .Sh FILES .Bl -tag -width Ds -compact -.It Pa ./import_bbva_usa.txt -.It Pa ./import_capital_one_credit.txt -.It Pa ./import_chase_credit.txt -.It Pa ./import_sparkasse_camt.txt -.It Pa ./import_optum_hsa.txt -.It Pa ./import_wellsfargo.txt +.It Pa ./import/bbva_usa.txt +.It Pa ./import/capital_one_360.txt +.It Pa ./import/capital_one_credit.txt +.It Pa ./import/chase_credit.txt +.It Pa ./import/etrade_ira.txt +.It Pa ./import/optum_hsa.txt +.It Pa ./import/sparkasse_camt.txt +.It Pa ./import/wellsfargo.txt .El .Pp These files contain the header that the financial institution uses, the @@ -153,7 +178,7 @@ Suppose .Dl ,,,Automotive,,, 1111 AUTO .Pp is a sample entry in the -.Pa ./import_chase_credit.txt +.Pa ./import/chase_credit.txt file which uses headers of the form .Pp .Dl Transaction Date,Post Date,Description,Category,Type,Amount @@ -178,7 +203,7 @@ file contains .Dl "10/26/2020,10/26/2020,example.com*asldfkj,Shopping,Sale,-17.07" .Pp and -.Pa ./import_chase_credit.txt +.Pa ./import/chase_credit.txt contains .Bd -literal -offset Ds ACCOUNT 3234 @@ -233,7 +258,7 @@ Transaction Date,Post Date,Description,Category,Type,A .Ed .Pp and -.Pa ./import_chase_credit.txt +.Pa ./import/chase_credit.txt is given by .Bd -literal # Chase credit card header is @@ -289,22 +314,9 @@ has the following limitations: .Bl -dash .It Pattern recognition in the -.Pa import_accountname.txt +.Pa import/accountname.txt files is under continued development. .It -Only CSV files for these account types are supported: -.Bl -bullet -offset indent -compact -.It -.Cm BBVA USA bank accounts -.It -.Cm Capital One credit cards -.It -.Cm Chase credit cards -.It -.Cm Optum HSA bank accounts -.It -.Cm Sparkasse bank accounts -.It -.Cm Wells Fargo bank accounts -.El +User-defined configuration files are not currently +supported. .El