* Understanding Plugin API, Trees, etc

[Ron Melby]

I am unsure of protocols here...but I have searched and can't find the info I am looking for on this matter

Mike, I see that you are building plugins in Burial Locations - Unique (13695), and have many.
I have the lua ref and manual now, but I see in this discussion, that you have mentioned functions on the order of:
fh....something.

It appears that there is a library of user defined functions somewhere and hopefully a listing reference.

I cannot find it. where is that located?

[tatewise]

Ron, in your other thread How to Handle People With Multiple Names (14343) I said:
If you are new to FH have a look at how_to:key_features_for_newcomers|> Key Features for Newcomers.
That refers to plugins:index|> Family Historian Plugins.
That has a Developer Guide containing plugins:getting_started|> Getting Started Writing Plugins.
That refers the FH API where fh... functions and methods are documented.

[Ron Melby]

Mike, I have looked at that page for all I am worth before I posted.

FH module or FH user defined or FH API or any sort of thing like that doesnt appear to be anywhere. no listing of FH modules I can see.... I go to knowledge base and enter into the search fhGetItemText() Nothing found

fhOutputResultSetColumn links to discussions. nothing found, no

No index or reference to these modules I see, unless they are in the unnamed code snippets somehow somewhere

I see where there is a path down somewhere with >FH API> in it but it is blacked out and not followable.

http://www.fhug.org.uk/forum/search.php ... umentation

I thought that somewhere there would be documentation like:

FHGetIndi (*rcd)
returns a record pointed to by *rcd or *null if not found.
FHGetMult (*RSLT)
returns a result set pointed to by *RSLT or *null if no records match the criteria, or *error if error

type of thing, (understanding I just pulled down the LUA reference and don't know this language yet.

I hate sounding so obtuse here, but you are brill in your answers, and maybe I am just too naifish to follow as of this mo.
Ron

[PeterR]

As it says in the Developer Guide mentioned above, in the FH Tools menu, if you select Plugins… and click on the More >> button then on the How to Write Plugins button you should be able to find find what you need.

[tatewise]

Firstly, in plugins:index|> Family Historian Plugins did you look at the plugins:about|> About Family Historian Plugins video that introduces the Plugins dialogue?

In plugins:getting_started|> Getting Started Writing Plugins it says to use the FH Tools » Plugins » More » How to Write Plugins command and later on How to Write Plugins > The Family Historian API that is where you find all the API details in FH itself not in the Knowledge Base.

[Ron Melby]

Yes, understand it is in the software.

I thought perhaps it would be online, because I thought modules might be added more often than updates are checked for, to get the latest and greatest.

I am at work (I own it) and dont have the software here on my computer.

maybe something I will have to do.

[tatewise]

No, the FH API is integral with the program and only updated with program version upgrades.

Perhaps you are confusing them with the Plugins themselves, which can be updated at any time, and is a major feature of FH.

[Ron Melby]

No. I got the plug ins figured out insofar as what their scam is. I go to the plugin all the time to update and look at new plugins.

I am not a heavy user of FH as of yet, because of two things. I am acclimating myself to it, and the way it shows a tree is very cumbersome for me.

RootsMagic-Essentials_22092015.png

RootsMagic layout (not the software) is more to my understanding and liking, in a broad (and most of mine are broad) tree, it is rather difficult to navigate and figure out how to get back. I expect I will become useful in the FH style though.

There may be a way to set up the screen something like that or like AQ or like Legacy, but I dont have it sorted yet.

[tatewise]

Since this is diverging further, I have started a new thread.

In the FH Focus Window just click on the Ancestors tab to see a Pedigree tree just like RootsWeb.

There is also the fhugdownloads:contents:compact_ancestors_diagram_v5|> Diagram Type ~ Compact Ancestor Tree.

For a little more detail just click on the Ancestor Diagram button in the main toolbar (next to the View Media button).

[Ron Melby]

Thank you. I am unused to the language used in these forums for their stuff, I am an IBM AS400 programmer, and would never consider that a compact tree (not in a bad way, but great, that is going to make it far more usable for me. The way this is working (genealogy) for me, is I work a bit here, because I get an email (all the folks are old) or a phone call with one little bit of info, then dont hear for a month and so I jump onto other little fixes here and there. The original gedcom came from someone who had been working with 4 or 5 different programs over many years, and had a burst of one of the old got stuff from LDS or site downloads, and accepted the info at the time. I have cleaned on it for 2 years now, not full time, but heavy time, and am almost in shape now, thanks to you....Have I told you that you are doing a great job today? I am about ready to settle into the using FH fulltime and not bothering to fix lines by hand, because it is mostly now (after you showed me the ) /Johnson/ /[Johnson]/ maneuver, and fixed my DUHHH with the 1 NAME 2 NAME ......... really in good shape and I have the known errors sort of localized and they are doozies.

for instance:
lets say I have a fams and I have this situation, I dream about this......
@F331@ FAM
@F663@ FAM

Those are the actual numbers, can I go look at just the fam directly by index and see what is in it?
Then, insuring the @I...@ line up with reality, can I detach the FAM from one Indi and give it to her sister intact?
The fams I think need to be swapped with 2 sisters, is what it looks like, and the husband on one, and I have no idea about the other husband (hes one of the Johnson clan) LOL. Would you rather I start new threads for these things or are you ok with this stream of conciousness?

[Ron Melby]

BTW I dont use roots magic. not for nothing.
While testing my hand built in FH it gave me some small fits, and I learned how it interpreted the standard.

When I did Roots magic earlier....
I had lines like this

1 TEXT
2 CONT
3 CONC
intermixed throughout

and just like FH they had a import with several checkboxes on handling conts and concs, and I checked them it told me I was a swell feller, and imported, and like FH they had a sort indi stuff by date ...... so all birt cens deat buri and so on are in order.

All the texts got cont-ed and the concs ended up at the end in some magic order but usually 50% or less in original order at the end of the text blocks. And when I saved it as export, I saved it over the original file name because of the first rule of reality:
1> NEVER back up your file when you are making mass changes. Just don't; you need this stress and heartache.

Took me 3 months of fixing and hours and hours and hours, wee both sides of the snore.

[tatewise]

I am not sure where we are regarding tree diagrams.
Are you saying both the RootsMagic Pedigree tree and the FH Focus Window > Ancestors tree are unsuitable for you?
It would be nice to draw one topic to a close before starting another.

Regarding your FAM situation, I suggest you stop working with the GEDCOM file and work with FH instead.
The FH fundamental database is the GEDCOM file.
You can see everything in the GEDCOM file via FH dialogues, but it ensures you use only valid GEDCOM.
i.e. you cannot make the 2 NAME versus 1 NAME mistake.

Let me take your example of:
0 @F331@ FAM
0 @F663@ FAM
You can see those records directly in FH.
First open the Records Window
i.e. click the icon on left below the Focus Window magnifying glass icon, or use View > Records Window.
Either click its Families tab, or if not shown then use View > Record Lists > Families.
That lists all the FAMily records with the husband and wife names, the Rec Id, and number of Children.
The Rec Id column shows numbers such as 331 and 663 from the @F331@ and @F663@ GEDCOM.
Click on the [+] on left and the HUSBand, WIFE, and CHILd links will be shown.

Records Window Families.png (82.6 KiB) Viewed 5748 times

The reason the CONC got messed up is they should be 2 CONC not 3 CONC.

Ron, I cannot keep up with you ramblings, please keep to one topic at a time.