Connector Guides › Connectors Guide › Connecting to Endpoints › CA ACF2 Connector › Secondary Authids › Administer Secondary Authids
Administer Secondary Authids
To administer Secondary Authids, there is a tab on ACF2 Accounts and Account Templates called Secondary Authids. This tab contains a list control containing the Secondary Authids assigned to the Account or Account Template. There are four buttons (three for Account) on this screen that provide the following functionality:
- Add Record(s) is always activated and provides a dialog screen for searching existing Secondary Authid records and assigning them to the Account or Account Template.
- Manual Add is always activated and provides a dialog screen to manually define a Secondary Authid to an Account or Account Template. The dialog contains a Sysid field and Secondary Authid field for an Account, and an additional Children field for an Account Template.
- Delete Record is activated when a record is selected in the list control, and will remove a Secondary Authid record from an Account or Account Template.
- Add/Del Children is only visible on an Account Template, and is activated when a record is selected in the list control. This button displays a dialog box that lets you maintain the list of Child Secondary Authids assigned to a Parent.
For account templates, Secondary Authids are classified as Parent and Child Secondary Authids. A Parent Secondary Authid is an XREF group record. The Secondary Authids that belong to this group are known as its Children, or Child Secondary Authids, which are XREF source records. When a Parent Secondary Authid is specified with a list of Children, any Account created from this Account Template will be assigned to one of the Child Secondary Authids, not the Parent. The Child Secondary Authid assigned to the Account is determined by the following algorithm:
The Child Secondary Authids are traversed in the order they are listed in the Account Template:
- If the Child Secondary Authid has room for another entry, the Account will be added to that record.
- If the record is full, then the next Child Secondary Authid is examined and if it has room, it is added to that one. This continues until a record is found that has room or does not exist.
- If a Child Secondary Authid is encountered that does not exist, then it will be created with the Account added to it, and it will be added to the Parent Secondary Authid as a Child.
If a Parent Secondary Authid is added to an Account Template with no Children specified, then that Parent record is treated as a Source record and the Account will be added to that record.
In this case, no Child Secondary Authids should ever exist.
