- Publicity: Public Only All
sync-procs.tcl
API for managing synchronization of user data.
- Location:
- packages/acs-authentication/tcl/sync-procs.tcl
- Created:
- 2003-09-05
- Author:
- Lars Pind <lars@collaboraid.biz>
- CVS Identification:
$Id: sync-procs.tcl,v 1.44.2.7 2024/08/20 08:58:02 gustafn Exp $
Procedures in this file
- auth::sync::GetAcknowledgementDocument (private)
- auth::sync::GetDocument (private)
- auth::sync::GetElements (private)
- auth::sync::ProcessDocument (private)
- auth::sync::get_doc::file::GetDocument (private)
- auth::sync::get_doc::file::GetParameters (private)
- auth::sync::get_doc::file::register_impl (private)
- auth::sync::get_doc::file::unregister_impl (private)
- auth::sync::get_doc::http::GetDocument (private)
- auth::sync::get_doc::http::GetParameters (private)
- auth::sync::get_doc::http::register_impl (private)
- auth::sync::get_doc::http::unregister_impl (private)
- auth::sync::get_sync_elements (private)
- auth::sync::job::action (public)
- auth::sync::job::create_entry (public)
- auth::sync::job::end (public)
- auth::sync::job::end_get_document (public)
- auth::sync::job::get (public)
- auth::sync::job::get_authority_id (public)
- auth::sync::job::get_authority_id_flush (private)
- auth::sync::job::get_authority_id_not_cached (private)
- auth::sync::job::get_authority_id_seed (private)
- auth::sync::job::get_entries (public)
- auth::sync::job::get_entry (public)
- auth::sync::job::snapshot_delete_remaining (public)
- auth::sync::job::start (public)
- auth::sync::job::start_get_document (public)
- auth::sync::process_doc::ims::GetAcknowledgementDocument (private)
- auth::sync::process_doc::ims::GetElements (private)
- auth::sync::process_doc::ims::GetParameters (private)
- auth::sync::process_doc::ims::ProcessDocument (private)
- auth::sync::process_doc::ims::register_impl (private)
- auth::sync::process_doc::ims::unregister_impl (private)
- auth::sync::purge_jobs (public)
- auth::sync::sweeper (private)
Detailed information
auth::sync::GetAcknowledgementDocument (private)
auth::sync::GetAcknowledgementDocument -authority_id authority_id \ -job_id job_id -document document
Wrapper for the GetAckDocument operation of the auth_sync_process service contract.
- Switches:
- -authority_id (required)
- -job_id (required)
- -document (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::GetDocument (private)
auth::sync::GetDocument -authority_id authority_id
Wrapper for the GetDocument operation of the auth_sync_retrieve service contract.
- Switches:
- -authority_id (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::GetElements (private)
auth::sync::GetElements -authority_id authority_id
Wrapper for the GetElements operation of the auth_sync_process service contract.
- Switches:
- -authority_id (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_batch_ims_test
auth::sync::ProcessDocument (private)
auth::sync::ProcessDocument -authority_id authority_id -job_id job_id \ -document document
Wrapper for the ProcessDocument operation of the auth_sync_process service contract.
- Switches:
- -authority_id (required)
- -job_id (required)
- -document (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::get_doc::file::GetDocument (private)
auth::sync::get_doc::file::GetDocument parameters
Retrieve the document from local filesystem
- Parameters:
- parameters (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_file_get_document
auth::sync::get_doc::file::GetParameters (private)
auth::sync::get_doc::file::GetParameters
Parameters for FILE GetDocument implementation.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_get_parameters
auth::sync::get_doc::file::register_impl (private)
auth::sync::get_doc::file::register_impl
Register this implementation
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::get_doc::file::unregister_impl (private)
auth::sync::get_doc::file::unregister_impl
Unregister this implementation
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::get_doc::http::GetDocument (private)
auth::sync::get_doc::http::GetDocument parameters
Retrieve the document by HTTP
- Parameters:
- parameters (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_http_get_document
auth::sync::get_doc::http::GetParameters (private)
auth::sync::get_doc::http::GetParameters
Parameters for HTTP GetDocument implementation.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_get_parameters
auth::sync::get_doc::http::register_impl (private)
auth::sync::get_doc::http::register_impl
Register this implementation
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::get_doc::http::unregister_impl (private)
auth::sync::get_doc::http::unregister_impl
Unregister this implementation
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::get_sync_elements (private)
auth::sync::get_sync_elements [ -user_id user_id ] \ [ -authority_id authority_id ]
Get a Tcl list of the user profile elements controlled by the batch synchronization. These should not be editable by the user. Supply either user_id or authority_id. Authority_id is the most efficient.
- Switches:
- -user_id (optional)
- -authority_id (optional)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::job::action (public)
auth::sync::job::action -job_id job_id -operation operation \ -username username [ -array array ]
Inserts/updates/deletes a user, depending on the operation.
- Switches:
- -job_id (required)
- The job which this is part of for logging purposes.
- -operation (required)
- 'insert', 'update', 'delete', or 'snapshot'.
- -username (required)
- The username which this action refers to.
- -array (optional)
- Name of an array containing the relevant registration elements. Not required if this is a delete operation.
- Returns:
- entry_id of newly created entry
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_actions, sync_snapshot
auth::sync::job::create_entry (public)
auth::sync::job::create_entry -job_id job_id -operation operation \ -username username [ -user_id user_id ] [ -success ] \ [ -message message ] [ -element_messages element_messages ]
Record a batch job entry.
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- -operation (required)
- One of 'insert', 'update', or 'delete'.
- -username (required)
- The username of the user being inserted/updated/deleted.
- -user_id (optional)
- The user_id of the local user account, if known.
- -success (optional, boolean)
- Whether or not the operation went well.
- -message (optional)
- Any error message to stick into the log.
- -element_messages (optional)
- Returns:
- entry_id
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_start_end, auth_sync_process_ims_implementations
auth::sync::job::end (public)
auth::sync::job::end -job_id job_id [ -message message ]
Record the end of a batch job. Closes out the transaction log and sends out notifications.
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- -message (optional)
- Returns:
- array list with result of auth::sync::job::get.
- Author:
- Lars Pind <lars@collaboraid.biz>
- See Also:
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_start_end, sync_actions, sync_snapshot
auth::sync::job::end_get_document (public)
auth::sync::job::end_get_document -job_id job_id \ -doc_status doc_status [ -doc_message doc_message ] \ [ -document document ] [ -snapshot ]
Record the time that we've finished getting the document, and record the status.
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- -doc_status (required)
- -doc_message (optional)
- -document (optional)
- -snapshot (optional, boolean)
- Set this if this is a snapshot job, as opposed to an incremental ('event driven') job.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_start_end
auth::sync::job::get (public)
auth::sync::job::get -job_id job_id -array array
Get information about a batch job in an array.
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- -array (required)
- Name of an array into which you want the information.
- Author:
- Lars Pind <lars@collaboraid.biz>
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_batch_for_local, sync_batch_ims_example_doc, sync_batch_ims_test
auth::sync::job::get_authority_id (public)
auth::sync::job::get_authority_id -job_id job_id
Get the authority_id from a job_id. Cached.
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- Author:
- Lars Pind <lars@collaboraid.biz>
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_start_end
auth::sync::job::get_authority_id_flush (private)
auth::sync::job::get_authority_id_flush [ -job_id job_id ]
Flush cache
- Switches:
- -job_id (optional)
- The ID of the batch job you're ending.
- Author:
- Lars Pind <lars@collaboraid.biz>
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::job::get_authority_id_not_cached (private)
auth::sync::job::get_authority_id_not_cached job_id
Get the authority_id from a job_id. Not cached.
- Parameters:
- job_id (required)
- The ID of the batch job you're ending.
- Author:
- Lars Pind <lars@collaboraid.biz>
- See Also:
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::job::get_authority_id_seed (private)
auth::sync::job::get_authority_id_seed -job_id job_id \ -authority_id authority_id
Flush cache
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- -authority_id (required)
- Author:
- Lars Pind <lars@collaboraid.biz>
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::job::get_entries (public)
auth::sync::job::get_entries -job_id job_id
Get a list of entry_ids of the job log entries, ordered by entry_time.
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- Author:
- Lars Pind <lars@collaboraid.biz>
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_batch_ims_example_doc, sync_batch_ims_test
auth::sync::job::get_entry (public)
auth::sync::job::get_entry -entry_id entry_id -array array
Get information about a log entry
- Switches:
- -entry_id (required)
- -array (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_actions, sync_snapshot, sync_batch_ims_example_doc, sync_batch_ims_test
auth::sync::job::snapshot_delete_remaining (public)
auth::sync::job::snapshot_delete_remaining -job_id job_id
Deletes the users that weren't included in the snapshot.
- Switches:
- -job_id (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_snapshot
auth::sync::job::start (public)
auth::sync::job::start [ -job_id job_id ] -authority_id authority_id \ [ -interactive ] [ -creation_user creation_user ]
Record the beginning of a job.
- Switches:
- -job_id (optional)
- -authority_id (required)
- The ID of the authority you're trying to sync
- -interactive (optional, boolean)
- Set this if this is an interactive job, i.e. it's initiated by a user.
- -creation_user (optional)
- Returns:
- job_id An ID for the new batch job. Used when calling other procs in this API.
- Author:
- Lars Pind <lars@collaboraid.biz>
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_start_end, sync_actions, sync_snapshot, auth_sync_process_ims_implementations
auth::sync::job::start_get_document (public)
auth::sync::job::start_get_document -job_id job_id
Record the time that we're starting to get the document.
- Switches:
- -job_id (required)
- The ID of the batch job you're ending.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_start_end
auth::sync::process_doc::ims::GetAcknowledgementDocument (private)
auth::sync::process_doc::ims::GetAcknowledgementDocument job_id \ document parameters
Generates an record-wise acknowledgement document in home-brewed adaptation of the IMS Enterprise v 1.1 spec.
- Parameters:
- job_id (required)
- document (required)
- parameters (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- auth_sync_process_ims_implementations
auth::sync::process_doc::ims::GetElements (private)
auth::sync::process_doc::ims::GetElements parameters
Elements controlled by IMS Enterprise 1.1 auth_sync_process implementation.
- Parameters:
- parameters (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_batch_ims_test, auth_sync_process_ims_implementations
auth::sync::process_doc::ims::GetParameters (private)
auth::sync::process_doc::ims::GetParameters
Parameters for IMS Enterprise 1.1 auth_sync_process implementation.
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- auth_sync_process_ims_implementations
auth::sync::process_doc::ims::ProcessDocument (private)
auth::sync::process_doc::ims::ProcessDocument job_id document \ parameters
Process IMS Enterprise 1.1 document.
- Parameters:
- job_id (required)
- document (required)
- parameters (required)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- auth_sync_process_ims_implementations
auth::sync::process_doc::ims::register_impl (private)
auth::sync::process_doc::ims::register_impl
Register this implementation
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::process_doc::ims::unregister_impl (private)
auth::sync::process_doc::ims::unregister_impl
Unregister this implementation
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.
auth::sync::purge_jobs (public)
auth::sync::purge_jobs [ -num_days num_days ]
Purge jobs that are older than KeepBatchLogDays days.
- Switches:
- -num_days (optional)
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- sync_start_end
auth::sync::sweeper (private)
auth::sync::sweeper
- Partial Call Graph (max 5 caller/called nodes):
- Testcases:
- No testcase defined.