peterennis / aegit_template

aegit_Template is a playground to test & learn to use aegit

You can find the aegit repostory here: https://github.com/peterennis/aegit

Quickstart

This is assuming you have already setup a GitHub account.

Minimum requirement is Microsoft Access 2010.

1. Fork this repo https://github.com/peterennis/aegit_Template
2. Clone it to your local workspace
3. In the project folder rename the file aegit_Template.accd to aegit_Template.accdb and run the file aegit_Template.accdb
   1. The file .gitignore is set to ignore accdb files so this work around allows the template file to be available.
4. Open aegit_Template.accdb and open the module aebasTEST_aegit_template_expClass in the VBA editor
5. Run the command aegit_Template_EXPORT in the Immediate Window
6. Run Compact and Repair

IMPORTANT - Make a backup copy of the database beforehand (Ctr-C, Ctrl-V OR File -> Save as -> Advanced -> Back Up Database)

8. Review the output in .\src and .\src\xml
9. Commit and push the changes to GitHub
10. Edit, Export, Compact (Backup), Commit, Rinse & Repeat

Using aegit with your own database

1. Fork aegit repo to your local workspace: https://github.com/peterennis/aegit

2. Import adaept revision control.accdb to your database and import module aebasChangeLog_aegit_expClass, aebasTEST_aegit_expClass, and also the class module aegit_expClass.

3. Rename TEMPLATE_EXPORT to [your database]_EXPORT

Update constants in the function, create appropriate files( src, xml, xmldata ) and point the paths to it.

4. Run the command [your database]_EXPORT in the Immediate Window

NOTE: The class is configured to EXCLUDE the aegit files from export.

NOTE: Your initial commit of changes will look similar to this Second Commit

If you look at src/frm_Dummy.frm.txt there is binary encoding for ImageData and that is a result of the "Name AutoCorrect Option" setting of Access. So get rid of it, then may you live long and prosper!

File -> Options -> Current Database -> Name AutoCorrect Options

Uncheck: Track name AutoCorrect info

Uncheck: Perform name AutoCorrect

aegit_template's Issues

Provide explanation of using decompile command file

Update aegit_Template version to 2.0.0

@kinsidar, Make it match with aegit.
Keep the file naming similar.

Ref: https://github.com/peterennis/aegit/blob/master/zip/adaept%20revision%20control%20accdb%20v200%2020171010.zip

Compare with:
https://github.com/peterennis/aegit_Template/blob/master/zip/aegit_Template_v158.zip

Update this ticket with your suggested file name before making a new PR.

Allow relative paths in the export

Access 64 Export

TBD - To be looked at when a test system is set up for Windows 10

Dependabot couldn't find a <anything>.(cs|vb|fs)proj for this project

Dependabot couldn't find a .(cs|vb|fs)proj for this project.

Dependabot requires a .(cs|vb|fs)proj to evaluate your project's current .NET dependencies. It had expected to find one at the path: /<anything>.(cs|vb|fs)proj.

If this isn't a .NET project, or if it is a library, you may wish to disable updates for it from within Dependabot.

You can mention @dependabot in the comments below to contact the Dependabot team.

Update README

Couple things for possible addition:

1. in depth explanation for step 3 in README:
   The file .gitignore is set to ignore accdb files so this work around allows the template file to be available.

2. Add steps to fork the aegit repo in instructions on how to use with your own database

Provide description for configuration to INCLUDE the aegit files in the export

Include notes in the readme

Refactor code changes made due to relative paths

there is binary encoding for ImageData and that is a result of the "Name AutoCorrect Option"

Prove it to me...

Error msg when running aegit_Template_EXPORT

4.Open the module aebasTEST_aegit_expClass in the VBA editor
5.Run the command aegit_Template_EXPORT <-------

error msg: Erl=0 Error 2220(Microsoft Access can't open the file '.\src\xml\tables_aeItems_DataMacro.xml'.) in procedure Output TableDataMacros of Class aegit_expClass

Update aegit_Template to use v200

@kinsidar
v2.0.0 release is here: https://github.com/peterennis/aegit/releases

1. Update aegit_Template to use the new class and modules
2. Export
3. Compact and repair using decompile tool
4. Compress the db and store in the zip folder using the naming standard
5. Rename access database file extension to .accd
6. Commit and verify
7. Send PR

Typos in readme

GitHub markdown needs a space between header and text e.g. ## Heading 2

GUID export shows as binary

Just export the text "GUID"

Explain setup for working with a linked backend database

NoBOM

error msg: Erl=0 Error5 in procedure NoBOM of Class aegit_expClass

GitBook cli is deprecated

Remove GitBook code and keep the md docs