Difference between revisions of "Userlevel:Admin:Technical Documentation - Websites:Database Tables-Fields, sharehim main"

From ShareHim Documentation
Jump to: navigation, search
(Added value 2 for Receive newsletter field)
(Removed fields in people table)
Line 1,793: Line 1,793:
 
| <br>  
 
| <br>  
 
| Recommender comments  
 
| Recommender comments  
| <br>
 
| <br>
 
|-
 
| <br>
 
| Graphics equipment request
 
|
 
Possible values:<br>- not requested (0)<br>- requested (1)<br>- approved (2)<br>- not available (3)
 
 
| req. for speakers<br>
 
|-
 
| <br>
 
| Sponsorship
 
|
 
dropdown: Quiet Hour Ministries&#124;(Voice of Prophecy)
 
 
| req. for speakers
 
|-
 
| <br>
 
| Sponsorship commitment form approved
 
| when approved, show them on website
 
| <br>
 
|-
 
| <br>
 
| Sponsorship check sent date
 
 
| <br>  
 
| <br>  
 
| <br>
 
| <br>
Line 1,828: Line 1,804:
  
 
| req. for speakers<br>
 
| req. for speakers<br>
|-
 
| <br>
 
| Request hard copy notes
 
|
 
(this will effectively only be for their first event)
 
 
Possible values:<br>- not requested (0)<br>- requested (1)<br>- processed (2)
 
 
 
|-
 
|-
 
| <br>  
 
| <br>  
Line 1,935: Line 1,903:
 
| Receive newsletter?  
 
| Receive newsletter?  
 
|  
 
|  
Is person signed up for the Evangeliving newsletter?<br>
+
Is person signed up for the Evangeliving newsletter?<br>  
  
NULL: has not been set<br>0: no<br>1: yes, in e-mail format<br>2: yes, in hardcopy format<br>
+
NULL: has not been set<br>0: no<br>1: yes, in e-mail format<br>2: yes, in hardcopy format<br>  
  
 
| opt.<br>
 
| opt.<br>

Revision as of 10:54, 2 January 2012

Contents

Database Tables/Fields - sharehim_main

Divisions (main_divisions)

Containing the 13 SDA divisions in the world

divisionID
Division ID
req.
name
Name
req.
initials
Initials 3-letter abbreviation req.
mailing_addr
Mailing address

mailing_city
Mailing city

mailing_state
Mailing state/province

mailing_zip
Mailing zipcode

street_addr
Street address

street_city
Street city

street_state
Street state/province

street_zip
Street zipcode

country
Country

phone
Phone number multiple formats
fax
Fax multiple formats
coord_name
Campaign coordinator

coord_office_phone
Coord. office phone multiple formats
coord_home_phone
Coord. home phone multiple formats
coord_cell_phone
Coord. cell phone multiple formats
coord_email
Coord. e-mail

coord_pw
Coord. password

coord_approved
Coord. approved yes/no
division_secretaries
Division officers Comma-seperated list of e-mail addresses to which the service requests reminder will also be sent to.
comments
Comments

active
Active yes/no


Unions (main_unions)

List of all the unions within the 13 world divisions. Occasionally we pull the data from AdventistDirectory to update our list of unions.

unionID
Union ID

sda_orgID
SDA organisation ID 4-letter abbreviation originating from adventistdirectory.org
divisionID
Division ID Division this union belongs to

name
Name


Mailing address


Mailing city


Mailing state/province


Mailing zipcode


Street address


Street city


Street state/province


Street zipcode


Country


Phone number multiple formats

Fax multiple formats

Campaign coordinator


Coord. office phone multiple formats

Coord. home phone multiple formats

Coord. cell phone multiple formats

Coord. e-mail


Coord. password


Coord. approved yes/no

Union officers Comma-seperated list of e-mail addresses to which the service requests reminder will also be sent to.

Is participant in homeland program? yes/no

Not really used because all participating organizations will have a record in the conference table, even though it might be fake. ||


Comments


Active yes/no


Conferences or missions (main_conferences)

List of SDA conferences/missions/fields.


Conference/mission ID


SDA organisation ID (AdmFieldID) 4-letter abbreviation originating from adventistdirectory.org

SDA OrgMastID 6-letter abbreviation originating from adventistdirectory.org. This is the master ID from eadventist.com.

Union ID


Name


Name contracted Short name for the conference. Used in homeland system.

Mailing address


Mailing city


Mailing state/province


Mailing zipcode


Street address


Street city


Street state/province


Street zipcode


Country


Phone number multiple formats

Fax multiple formats

Conference e-mail


Campaign coordinator


Coord. office phone multiple formats

Coord. home phone multiple formats

Coord. cell phone multiple formats

Coord. e-mail


Coord. password


Coord. approved yes/no

Conference officers Comma-seperated list of e-mail addresses to which the service requests reminder will also be sent to.

Participant in homeland program? yes/no

Churches & pastors synchronization setting

Churches:
1 : pull from eAdventist.net
all others : pull from AdventistDirectory

Pastors:
0 : entered manually
1 : authorized to pull from eAdventist

((Can add more values for each different synchronization scheme we encounter with different conferences))



Allow pastor to do final acceptance of new applicants?

yes/no

1 : pastoral approval
0 : pastor's recommendation, conference-staff final approval

(fieldname should have been allow_pastors_approve_speakers!)



Last updated via eAdventist For non-NAD conferences this indicates last time we updated the church list from AdventistDirectory.org

Internal comments ONLY coadmin and admin may see/edit this.

Public comments


World map, X-coordinate For the Flash world map

World map, Y-coordinate For the Flash world map

Active yes/no

Conferences' Wire Information

Information used for wiring money to the different conferences.


Conference/mission ID


SWIFT code Only SWIFT or ABA can be filled. cond.

ABA number Only SWIFT or ABA can be filled. cond.

Bank account no.
req.

Name of account holder/owner
req.

Address of account holder
req.

Bank name
req.

Bank location
req.

Use correspondent/intermediary bank? yes/no req.

Correspondent bank name


Correspondent bank location


Correspondent SWIFT code Only SWIFT or ABA can be filled.

Correspondent ABA number Only SWIFT or ABA can be filled.

Account no. of beneficiary's bank (the bank above) at the correspondent bank

Conference accepted people

People's acceptance or rejection to preach in a specific conference. Only applicable to homeland date blocks.


Conference acceptance ID


Person ID
req.

Conference ID
req.

Acceptance status

Possible values:
- waiting
- accepted
- rejected

req.

Acceptance comments Values set by the system:

- "Done campaign" (when accepted) (value also used to unset it in case an qualifying event(s) are deleted, so it should not be modified)
- "Int'l recommended" (when accepted)
- "Auto-accepted eA pastor" (when automatically set to accepted by the Obtain Pastor Login procedure in login_link_pastor.php)

Values set AND used by the system (only when status=waiting):
- "Pastor: ?": pending pastor response
- "Pastor: yes": pastor consented
- "Pastor: caution: [a reason]": pastor cautioned

req. if rejected

Hub cities - Previously Hotel cities (main_hotels)


Hotel city ID


Conference/mission ID Only used for homeland (some hub cities for international campaigns also contain a conference because ALL records were assigned the ID when we created this field) req. for homeland

City


Hotel name
req.

Hotel address
req.

Hotel address (line 2)
req.

Hotel country
req.

Hotel phone multiple formats req.

Hotel fax multiple formats

Hotel e-mail


Hotel website


Price single room
req.

Price double room
req.

Price additional person amount or n/a req.

Breakfast included yes/no (note next field) req.

All meals included yes/no req.

Est. price additional meals
req.

Recomm. budget for meals outside hotel per day
req.

Aircondition

Possible values:
- 0 : no
- 1 : yes
- 2 : not necessary

req.

Transportation Info regarding getting from orientation to hotel city req.

Comments Public

Is non-hotel? yes/no

For homeland date blocks the hotel info is not required and this field should be set to yes (but not mandatory)



Active yes/no


Date blocks' hotels (main_dateblockhotels)


Date block hotel city ID


Date block ID
req.

Hotel city ID (= hub city)
req.

Cluster ID


Date block orientation ID Optional and ONLY used for linking a specific orientation to this hotel city in case the date block has multiple orientation sites.

Date blocks


Date block ID


Opening date
req.

Closing date
req.

Applications closing date Should be the final cut-off date for new applicants.

Date is inclusive, so after this date no new applications are accepted. When converted to a Unix timestamp we add one day minus one second, so that the calculation is correct AND if converted back to only a date it is still the same date.

req.

Data lock date After this date only administrators and co-administrators will be allowed to change all data concerning a date block:

- teams
- groups
- site info (incl. translations)
- hotel info
- orientation hotel info
- rank sites
- rank speakers

This date MUST be after applications closed date.

As of 2007-12-05 the detailed definition was:
- people cannot remove themselves from campaigns after this date, but all other accesslevels can (eventdelete.php).
- conference coordinators for international campaigns (not conference organizers) cannot do these things after this date (but admin and coadmin can always do all of these things):
* add campaign sites
* edit campaign sites
* add hub cities to a date block
* edit orientation hotel info
- people cannot themselves re-arrange their team and group membership after this date.
- ranking of sites and speakers can only be changed by admin and coadmin after this date.

(PS. Hotel reservation is locked on date block opening date)

req.

Campaign title (Homeland: Additional label) Usually the country wherein the campaigns will be held.

Homeland: optional additional label like "SWAU"

req. for international
opt. for homeland

Total sites Total number of campaign sites in this date block - must ALWAYS be kept up-to-date as available sites are calculated from this.

For homeland campaigns this is currently kept updated to equal the number sites that have been set up for this date. Would be more useful to only count the sites where a speaker had been matched...



Questions recipient LoginID of the person from External logins who will receive questions about this date block. This person will also be the lead date block manager.

Pre-campaign manager LoginID of a coadmin person from External logins who will be the pre-campaign manager if different from the lead manager.

Insurance reminder sent date, 1st


Insurance reminder sent date, 2nd


Service requests reminder sent date, 1st


Service requests reminder sent date, 2nd Just before the campaign

Last incomplete notification The date we last sent a notification to unions/conferences/campaign manager about incomplete information entered for this date block (if any)

Default sermon notes language (Material ID) dropdown; must be a CD set

Irrelevant for homeland campaigns. (Previously only used for in homeland: Divide homeland dateblocks into different languages on sign-up sheet for some conferences.) || req. for international


Default sermon graphics language (Material ID) dropdown; must be a CD set

Irrelevant for homeland campaigns. (Previously only used for in homeland: Displayed in the popup box for approving and selecting material for an applicant.) || req. for international opt. for homeland


Division secretaries Comma-seperated list of e-mail addresses for one or more division secretaries. Eg. they receive e-mail reminding about insurance.

Comments Extended public description of the date block

Note for applicants Special information for potential applicants before applying

Application monitors List of e-mail addresses (comma-seperated) to which an e-mail is sent everytime an application to this date block is submitted. Added because of problems in India where the division wants to monitor all applications, espacially STMs.

Hide date block details for the public? yes/no

Because of problems in India where the public should not be allowed seeing the information about the date block. ||


Media folder Base folder for uploading media files (pictures, video etc.)

Show predefined unions only yes/no

Only show predefined organizations down to the union level (= excl. conferences) In connection with the table Date blocks' predefined conferences. ||


Active yes/no

Date blocks' orientations


Date block orientation ID


Date block ID
req.

Orientation ID
req.

Orientation date

Date blocks' predefined conferences

This is used primarily before sites are added to the date block. After that we'll automatically know the conferences based on where the hotels are located. For homeland date blocks, though, we retain this information in order to have a quick way of determining the date blocks of a conference.


Date block predefined conference ID


Date block ID
req.

Conference ID
req.

Campaign sites (main_sites)

siteID
Campaign site ID

master_siteID
Master campaign site ID Record ID in master sites table that this site originates from
dateblockhotelID
Date block hotel city ID
req.
campaign_date
Campaign date

- Homeland: the date from the matching record in main_dateblocks
- International: null

This field can currently be used to determine if the campaign site is homeland or international.

req. for homeland.
currently prohibited for intl.
campaign_type
Campaign type

Possible options:
- NULL : regular campaign
- 'spk-init' : speaker-initiated campaign

Homeland only.


name
Site name

- International: full site name (req.)
- Homeland: only an optional additional label (req. for Speaker-Initiated Events though) that is added to the date (and the church name, which we get from the site's master site).

Tried to name variable 'campaign_label' when used in the homeland context.

see description
campaign_begin_time
Beginning time time (hh:mm:ss)

Homeland only.

req. for spk-init events
campaign_end_date
Ending date date

Homeland only.

req. for spk-init events
campaign_weekdays
Weekdays Comma-separated list of 3-letter abbreviation of the weekdays the campaign will be held.

Homeland only.

req. for spk-init events
city
Town/city
req.
site_addr
Address
Homeland:

req. for spk-init events

site_state
State
Homeland:

req. for spk-init events

site_zip
Zip
Homeland:

req. for spk-init events

site_phone
Phone Only used in intl. system
site_email
E-mail Only used in intl. system
site_website
Website Only used in intl. system
venue_type
Venue type church/rented hall/open field/stadium etc. according to table list_venue_types Intl:

always req. Homeland: req. for spk-init events

personeventID
Personevent ID Link to the speaker
graphics_lang
Sermon graphics language dropdown req.
lifeochrist_lang
Life of Christ video language dropdown req.
video_format
Desired video format NOT USED ANYMORE. No longer applicable because we now use DVDs instead of VHS tapes.

dropdown


congregations
Congregations number of congr. supp. this site

Only used in intl. system.

req.
membership
Membership total members in supp. congr.

Only used in intl. system.

req.
est_attendance
Est. attendance incl. SDA & non-SDA req.
baptismal_goal
Baptismal goal conservative number req.
km_from_hotel
Km from hotel
req.
pastor_workerIDs
Pastor Officer IDs Comma-separated list of officerIDs.

The pastors of this church (master site) from eAdventist at the time the site was set up or when a speaker was assigned. Automatically set by the system. ||

ranking
Ranking
req.
comments
Comments

planned_precamp_acts
Planned pre-campaign activities text

Homeland only.

campaign_status
Campaign status

Possible options:
- NULL
- 'await_approv'

Homeland only.

active
Active yes/no
copyof
Copy of site ID If this is a copy of another site the original site's ID is saved here
date_added Date added


Outreach Teams - Previous: Master Campaign sites (main_master_sites)

List of Outreach Teams

master_siteID
Master site ID

sda_orgID
SDA organization ID Reference to the church this OLT belongs to req. for all new records
conferenceID
Conference ID Conference this OLT is in req.
name
Name

Name of the OLT, usually the church name.

Usually renamed to 'olt_name' or 'church_name2' in SQL output. Also named 'church_name' occasionally but that is deprecated.

ms_personID
Person ID In case a personal team is created this holds the link to the person (used for speaker-initiated campaigns)
hotelID
Hotel ID 2009-11-16: deleted all values since homeland do not use hub cities anymore - field can be deleted entirely, once SQL queries have been checked

- search for "main_master_sites" and "'tblname' => 'master_sites'" and edit acl_add_master_site() and i_master_sites.php/php_functions_i_master_sites.php

city
City 2010-11-01: Is officially no longer used but I didn't dare deleted it in the database yet. Delete it later.

Search for "main_master_sites" to try to find location where it might still be used.

graphics_lang
Graphics language Default graphics language used within this OLT. Actually language is always decided by the site record.
lifeofchrist_lang
Life of Christ video language Default video language used within this OLT. Actually language is always decided by the site record.
comments
Comments

pw
Password Password OLT members can use to access information for this OLT. Not really used at the moment.
date_added
Date added

Outreach Leadership Team members

Table with all memberships for the Outreach Leadership Teams (main_olts)


OLT member ID


Person ID Person who is the member req.

Master site ID Team person is a member of req.

Is OLT clerk? yes/no

Date added
req. for all new records

Date removed Once this field has a value the member is considered removed.

Churches

List of churches we have retrieved from AdventistDirectory.org and eAdventist.net (= SDA-DB)


Church ID Our own auto-generated ID

SDA org ID OrgMastID from SDA-DB

SDA entity ID OMEntity from SDA-DB

Church name


Street address


Street city


Street state


Street zip


Country 2-letter ISO-3166 country code

Phone


Language


Ethnic group


Sector Our own sector value, set by the conference organizers

Latitude


Longitude


Parent SDA AdmFieldID

ID of parent conference.

(I believe we always have this one)


Parent SDA OrgMastID

ID of parent conference.

(this one we don't yet have for the churches we've retrieved through the webpages) CAN WE JUST DROP THIS FIELD BECAUSE IT SEEMS TO THE CHURCH'S SDAORGID REPLACED WITH "11" ON THE END?!


Parent is not a conference? yes/no

Inactive? yes/no

Date added Date added to our database.

Date modifed Date last modified in SDA-DB. Controls when we need to update this record.

Workers / Officers

List of officers (currently only pastors) we have retrieved from eAdventist.net (= SDA-DB) or other Adventist services/fields


Worker ID Our own auto-generated ID

Conference ID Conference the pastor is in.

Not used for NAD conferences, since Officer ID (from eAdventist) is used. If we change use assign_pastor_to_church() must be reviewed.



Officer ID ID originates from SDA-DB

This is the same ID as main_people. sda_membershipID. Used only for records coming from eAdventist.net.

cond.

Local ID The local conference's own ID for the person

First name
req.

Last name
req.

Suffix


Mailing address


Mailing city


Mailing state


Mailing zip


Mailing country 2-letter country name (ISO-3166)

E-mail


Alternative e-mail addresses Comma-separated list (with space between comma and next address) opt.

Cell phone


Allow SMS? Is ShareHim allowed to send the pastor an SMS to notify him about new applicants from his church?

Person ID Link to this person's record in our main people table if present. opt.

Default password Password that will be used to auto-create a login when this pastors tries to login

Date modified Date last modified in SDA-DB. Controls when we need to update this record. req.

Church offices

List of church offices (currently only pastors) we have retrieved from eAdventist.net (= SDA-DB)


Church office ID Our own auto-generated ID

Church SDA org ID OrgMastID of church

Worker ID


Officer ID From main_officers table

Office name Name of office the person holds.

NOTE!! If this is expanded to be anything else than pastors we need to change the method in assign_campaign_site() we use to determine if speaker is pastor as well in get_pastors_churches() and probably other functions as well (since they only check for the existence of a church office record and not the office name value) ||


Is evangelistic decision-maker? yes/no

In case a church has multiple pastors this can indicate which pastor is responsible for evangelistic decisions. Used to know which pastor we can ask to recommend a speaker. ||


Date modified Last date this record was modified in our own database.

Campaign site statistics


Campaign site ID


Statistical data serialize PHP array with statistics on attendance, Bible class attendance, and baptisms

(only used for international)

req.

Baptisms during campaign number

Entered by the speakers. (only used for international)



Adjusted baptisms during campaign number

Entered by the coordinators.



Projected baptisms within 6 months after the campaign (EXCL. those during campaign) number

Entered by the speakers (only used for international)



Actual baptisms within 6 months after the campaign (EXCL. those during campaign) number

Entered by the coordinators.



Did campaign with OLT? yes/no Homeland only

Number of meetings number Homeland only

Number of visitors number Homeland only

Planning another campaign?

Possible values:
0 : no
1 : yes
2 : maybe

Homeland only

Campaign site statistics per conference

This data "overrides" data entered for each individual campaign site.


Conference date block statistics ID


Date block ID
req.

Conference ID
req.

Total baptisms during campaign in this conference number

Baptisms within 6 months after the campaign in this conference (EXCL. those during campaign) number

People

Guest speakers, support team members


Person ID


SDA membership ID ID from eAdventist of OLT members and pastors.

(This ID is the same as main_officers.officerID. Brian: "Yes, the PersonID is the same Officer ID that we use for Pastors web service.")



Active person event ID


Legal firstname
req.

Legal lastname
req.

Title dropdown

Prefered to be set as the option "Pastor" is sometimes used to identify pastors.


Birth date
req.

Gender


Marital status dropdown

Mailing address
req.

Mailing city
req.

Mailing state/province
req.

Mailing zipcode
req.

Street address this is also their shipping address req.

Street city
req.

Street state/province
req.

Street zipcode
req.

Country
req.

Required for different reasons (and more I haven't written here): These people go in to the regular table of people where we have speakers and so on, and that field has always been required. Besides having a name without connected to a country can be pretty ambigious. The more information we have about a person the better. It also helps us to know which division they are in which is required in case they apply for a campaign.


E-mail also their username

Sometimes noemail@noemail.com or none@none.com has been put in if we don't know the address.

req. (except for special cases, eg. speakers assigned to past homeland campaigns, or check donations where we don't know the e-mail)

E-mail invalid date

If the e-mail address is not working register here the date it was discovered. Reminders, news letters etc. will not be sent to this person then.


Home phone multiple formats

Can have the value "Do not have" if person simply does not have this kind of number. || At least one phone number is required.


Office phone multiple formats

Can have the value "Do not have" if person simply does not have this kind of number. || At least one phone number is required.


Cell phone multiple formats

Can have the value "Do not have" if person simply does not have this kind of number. || At least one phone number is required.


Residence division dropdown req.

Residence union dropdown

Residence conference dropdown

Residence church text

Application date


Remmendation status

Possible values: (by sending fields/recommenders)
- NULL (when not recom. processed)
- waiting
- recommended
- unrecommended



Recommender

Pastor/layman/academy in NAD:
- stores the ID of the recommender to which an e-mail was sent at time of application

College students:
- college date block ID



Recommender comments


Sermon notes language

dropdown

VALIDATION:
- check if this from-language is available within the desired date block. If not, give option to select another language.

req. for speakers

Preferred CD format

Possible values:
- DVD (means using a DVD player)
- DVD-R (means using a computer)

(old values: CD, DVD-Combo)

req. for speakers

Done boot camp?

Has person taken the ShareHim boot camp training program?

Possible values:
- 0 : no
- 1 : yes
- 2 : is an ordained/licensed pastor
- 3 : is a retired pastor

(Being any type of pastor resolves to the same effect as saying yes)



Done a campaign? yes/no

Determined automatically by the system, cannot be manually set (as of today at least). No means only that we do not know if they have done a campaign. NOTE: now this does not only include international campaigns, even though the field name indicates that. Also having done a homeland campaign will now result in this being set to yes.



First campaign text

First ShareHim campaign that this person participated in as a speaker. Used for people applying for homeland campaigns.



Reference name Pastoral applicants: ministerial sectary

Lay applicants: pastor Academy students: academy & contact

req. for speakers

Reference home phone

Pastoral applicants: ministerial sectary

Lay applicants: pastor

Academy students: academy & contact

req. for speakers

Reference office phone

Pastoral applicants: ministerial sectary

Lay applicants: pastor

Academy students: academy


Reference cell phone

Pastoral applicants: ministerial sectary

Lay applicants: pastor

Academy students: academy


Reference e-mail

Pastoral applicants: ministerial sectary

Lay applicants: pastor

Academy students: academy

req. for speakers

Password


Comments


Receive newsletter?

Is person signed up for the Evangeliving newsletter?

NULL: has not been set
0: no
1: yes, in e-mail format
2: yes, in hardcopy format

opt.

Received mentorship material yes/no

Did we send them the mentorship material? ||


Portrait filename File for thumbnail image used in stories.

Portrait is authorized? yes/no

Outreach Leadership Team of master site ID The church with this master site ID that this person is an OLT member of

Outreach Leadership Team special status

number

0 = ordinary OLT member (default)
1 = is OLT leader
2 = is OLT secretary

NOTE: cannot move this field to main_olts because we have people set as leaders/secretaries who are not member of any particular OLT.


Is editor?

Possible values:
- executive (edit text/graphics, approve, add/delete stories)
- associate (edit text/graphics)
- text
- graphics
- advreview (Adventist Review editor)


Do not contact

date

When person should not receive any correspondence or be contacted, register the date this was set.


Reason for not contacting text

(eg. do not want info from us, is deceased etc.)

req. if "Do not contact" is set

Hide person from public?

number

0 = no
1 = yes
2 = yes and also hide from any logged in users not part of the same campaign
3 = yes and also hide from any logged in users except admins

NOTE!! CURRENTLY 1, 2 and 3 makes no difference on the website. All cause a behaviour equal to 3.

Should the person name and critical personal details (name, address, and phone numbers) be hidden from public/non-logged in users (or from logged in users except those participating in the same date block, or even everybody but admins and co-admins)?
If yes:
- hidden on mainly the campaign overview
- if they are organizers they are currently NOT hidden
- hidden in get_dateblock_people()
- hidden in get_people_availability()
- hidden in get_person_info()
- skip showing personal portrait on stories
- hidden in other functions too...

req.

Person requested check for duplicate Person indicated that they might already exist in our database.

Source

Indication of how this person originally got into the database. Possible values (also defined in main_peopleedit.php):
1 : applied internationally
2 : applied homeland acceptance
3 : homeland pastor
4 : made a donation/pledge
5 : conference organizer/sector leader
6 : OLT member
7 : signed up for newsletter
8 : order received from GoodSalt.com
9 : is translator for homeland system
10 : homeland speaker (assigned to past campaign => not accepted in conf)
11 : non-ShareHim related homeland speaker
12 : given a ShareSynch serial number (version C sermons)
99 : other manually added record


Person events (main_personevents)

personeventID
Person event ID

personID
Person ID

dateblockID
Date block ID Only for non-college/university applicants
eff_dateblockID
Effective date block ID Updated to always hold the effective date block ID for this event (also when event has been deleted)
categorymoved
Category

Possible values:
- pastor
- layman
- college
- academy
- stm
- organizer

collegedateblockIDmoved
College date block ID Only for college/university applicants
is_standby
Is standby

yes/no

Is this a standby event?

(Retained even though event is deleted)

clusterID
Cluster ID Only for speakers

(the link to groups must of course match this link.)

groupID
Group ID Only for speakers
teamID
Team ID Only for STMs - linking them to their speaker (Team ID in main_teams)
rankingID
Ranking ID

cospeaker
Associate speaker yes/no

(we know the main speaker by the team the associate speaker is member of) ||


Preferred hub city (date block hotel ID) The hub city the person him/herself wishes to go to

Site-funding required yes/no

CURRENTLY NOT USED (use 'funding_required' instead) MAY NEED TO USE IT THOUGH, INSTEAD OF CALCULATING IT WITH A JOIN TO main_groups ALL THE TIME! Is currently only set a group level and must be determine through field table main_groups. grp_funding_source


Site-funding fulfilled If fulfilled, it has the ID of the belonging log entry from sharehim_log.system_operations.operationID

Need housing? yes/no

Only used for homeland date blocks: Does the speaker need the host church to provide housing if the meeting is outside his area? ||


Acceptance status

Possible values: (by host fields)
- NULL
- accepted
- rejected

(Currently only used for homeland campaigns. Automatically accepted for international campaigns.)


Acceptance comments


Orientation, room ID Other people having the same number will be staying in the same room

Orientation, private accommodation yes/no

Hotel city, room ID Other people having the same number will be staying in the same room

Hotel city, private accommodation yes/no

Orientation city, flight arrival date
req. for suppl.

Orientation city, flight arrival time
req. for suppl.

Orientation city, airline
req. for suppl.

Orientation city, flight no.
req. for suppl.

Self-arranged travel to orientation yes/no

If yes none of the four fields above must be filled out ||


Hotel city, arrival airport


Hotel city, flight arrival date


Hotel city, flight arrival time


Hotel city, airline


Hotel city, flight no.


Last deposit reminder Days after application date that this reminder was last sent

Last site-funding reminder Days before opening date that this reminder was last sent (not necessarily the actual day, but the day according to the schedule (xday))

Last hotel reservation reminder Days before orientation that this reminder was last sent (not necessarily the actual day, but the day according to the schedule (xday))

Last flight arrival reminder Days before orientation that this reminder was last sent (not necessarily the actual day, but the day according to the schedule (xday))

Last generic reminder Days before orientation that this reminder was last sent (not necessarily the actual day, but the day according to the schedule (xday))

Last equipment rental reminder Days before orientation that this reminder was last sent (not necessarily the actual day, but the day according to the schedule (xday))

Consent form for minors

NULL = not a minor
1 = pending receiving the consent form
2 = consent form received
3 = is minor, parent/guardian is coming too


No sermon notes

yes/no

Whether or not the person should receive sermon notes/graphics for this event. Used with the "missing notes" report. This value is basically only informational. Extended to this use:

0 : nothing skipped
1 : skip sermon notes
2 : skip Jesus video
3 : skip both sermon notes and Jesus video

(3 is automatically set when setting a speaker for past homeland campaign or when setting a non-ShareHim-related speaker for a homeland campaign)


Reported on the first insurance/service requests report that we sent out? yes/no

Is deleted? yes/no

Is set to yes when we delete an event but keep the database record because material has been shipped concerning this event, and because we want to keep a historical record.


Is event request? yes/no (when person does not fill out the main application form, value is not changed but kept forever event if event is deleted)

Date added datetime

(Retained even though event is deleted)


Date deposit received

datetime

Date we have received the deposit for the direct campaign cost (international only). The field Site-funding required will determine if this is necessary. If it is, only after that point we initiate the application process.

Set to 2000-01-01 when bypassed by admins (when auto-approved was requested when event was added)

Set to 2000-01-02 for events before we implemented this procedure

Set to 2000-01-03 when event is in an individually funded group (where leader has already paid the deposit)


Date approved datetime (by administration)

Must have a value for the event to be considered approved, no matter what the category is.

Set to 2000-01-01 when it is unknown.

(Retained even though event is deleted)


Date standby expire date

The date the standby event will expire.


Date activated datetime

The date a standby event was activated.

(Retained even though event is deleted)


Date deleted datetime

Person comments

Internal comments only visible for administrators


Comment ID


Person ID
req.

Person event ID Possible to reference a comment to a person's event opt.

Comment
req.

Comment type

Possible values:
- 'phonecall'

opt.

Flag

dropdown

Possible values:
- 1 : encourage mentorship
- 2 : block all future participation
- 3 : block future intl. participation
- 4 : block future homeland participation

opt.

Date and time entered
req.

Submitter Local ID of user from table below

From table Origin table of this user

Personal salutations

Table with personal salutations for each user in the system


Person ID The person the salutation is for req.

From table The table the "owner" of this salutation is from.

Same format as $_SESSION['user_fromtable']

req.

From local ID The ID from the table the "owner" of this salutation is from. req.

Salutation The salutation itself. Must be the full line. req.

Colleges


College ID


Name


Initials Abbreviation of name

Street address For shipping equipment

Street city


Street state


Street zip


Country dropdown

Contact person


Contact e-mail


Contact phone


Password Use this to login and recommend students

Comments


Active yes/no

Colleges' date blocks

Bob Sr, 2008-07: College date-block information must remain read-only for all except for the administrative few.


College date block ID


College ID
req.

Dateblock ID
req.

Person event ID (leader) Only speakers opt.

Student sites to reserve equip. for numeric req.

Funding source


Date site-funding received date

Total site-funding amount received number

In USD.


Date travel funds requested The date we requested Quiet Hour Ministries to send the travel funds to the college/students. opt.

Last status reminder sent date

Comments
opt.

Recommenders

Only for North-American division


Recommender ID


Firstname


Lastname


E-mail


Phone


Password


Marker for last applicant a marker so we can cycle through these recommenders

Comments


Active yes/no

Translations

Per campaign site


Translation ID


Campaign site ID


From language dropdown acc. to available sermon notes language

Campaign material

Shipments that are due (or waiting for payment before they are due)


Shipment ID


Material ID


Personevent ID
req. to be a speaker

Shipper A main_ext_logins.loginID reference

Paid date

Set to 2000-01-01 if payment is n/a ||


Postpone date date

This item will not shown on the shipping list until this date ||


Shipped date


Shipped method


Shipped tracking no.


Royalty billed date

Only used for graphics CDs, reporting to It Is Written ||

Clusters

Spanning over the whole date block. Clusters are a larger scope compared to groups. Groups can be linked to clusters. Only speakers can be members of clusters.


Cluster ID


Date block ID


Cluster name For homeland date blocks this is not used for anything really - other than it shows up on the campaign overview.

Ranking enabled yes/no (for ranking people)

Cluster leaders


Cluster leader ID


Cluster ID


Person event ID (leader) Speakers or organizers

Groups

Spanning over the whole date block. Only speakers can be members of groups


Group ID


Date block ID


Cluster ID


Person event ID (leader) Only speakers

Group name


Contact name


Contact phone


Contact e-mail


Recommender personID


Reserved sites Will effectively always be filled out.

Funding source (site-funding)

Possible values:
- 'sharehim': ShareHim is responsible
- 'individually': each group member is responsible, but deposit for ALL must be received before any can apply
- ' indiv_owndep': each group member is responsible, all applicants must pay their own deposit at time of application
- 'collectively': group is responsible collectively

req.

Deposit received? yes/no

No one excepts organizers can apply before deposit has been received if funding source is 'individually'.


Partial payment date date

Has no effect if amount is not set or 0.

opt.

Partial payment amount number

Has no effect if date is not set.

opt.

Last site-fund reminder sent date

Show group on availability report? yes/no req.

Max subdivide Max number of hotel cities the group is allowed to span across. Default one. req.

Ranking enabled? yes/no (for ranking people)

Comments

Teams

Speaker linked with support team members


Team ID


Person event ID (speaker)

Orientation sites


Orientation ID


Date block ID


Orientation date
req.

Hotel name
req.

Hotel address
req.

Hotel address (line 2)
req.

Hotel country
req.

Hotel phone multiple formats req.

Hotel fax multiple formats

Hotel e-mail


Hotel website


Price single room
req.

Price double room
req.

Price additional person amount or n/a req.

Breakfast included yes/no (note next field) req.

All meals included yes/no req.

Est. price additional meals
req.

Recomm. budget for meals outside hotel per day
req.

Aircondition

Possible values:
- no (0)
- yes (1)
- not necessary (2)

req.

Transportation Info regarding getting to the orientation site req.

Orientation comments Public

Active yes/no

Equipment booking

Booking of equipment Time frame of booking is decided by the period of the date block


Booking ID


College date block ID
req. if no person ID

Speaker ID (= Person ID)
req. if no college date block ID

Case ID


Booking date The date the booking was made (just for the information)

Paid amount Only for non-student related

Paid date Set to 2000-01-01 if payment is n/a

Outbound date


Outbound method dropdown

Outbound tracking no. text (30)

Insurance text (100)

E-mail of person received the insurance information ||


Return date Date it was sent from the renter

Return method dropdown

Return tracking no. text (30)

If filled out it's a call tag, otherwise not


Return received date Date it was received by ShareHim

Equipment checked date

Equipment checked by initials text (10)

Comments

Equipment stock, cases


Case ID Manually entered and unique ID from inventory labels

Laptop ID


Projector ID


Case serial no. text (30)

Case purchase date


Case value


Invoice no. text (15)

Check no. numeric (15)

Comments


Down date

When the case is under repair or for another reason is not available for booking ||


Down status


Discharged date

When the case has been sold and we no longer have anything to do with it ||


Discharged status

Equipment stock, laptops


Laptop ID


Inventory ID Manually entered and unique ID from inventory labels

Equipment base ID ID of the equipment base where we administrate a set of graphics equipment

Model no. text (30)

Description text (30)

Serial no. text (30)

OS product key text (30)

Office product key text (30)

Service Tag text (30)

Express service code text (30)

Purchase date date

Laptop value numeric

Warranty type

dropdown:
- Next day service
- Next day service + complete care


Warranty expiration date date

Quote no. text (15)

Invoice no. text (15)

Check no. numeric (15)

Comments text

Down date

When the laptop is under repair or has been sold and hence not available for booking ||


AC adapter yes/no

Remote control yes/no

Remote control for mouse ||


Floppy drive yes/no

Equipment stock, projectors


Projector ID


Inventory ID Manually entered and unique ID from inventory labels

Model no. text (30)

Description text (30)

Serial no. text (30)

Warranty expiration date date

Purchase date date

Projector value


Invoice no. text (15)

Check no. numeric (15)

Comments


Down date

Power cord yes/no

Remote control yes/no

VGA cable yes/no

VCR cable yes/no

International adapters yes/no

Ground adapter yes/no

Extension cord yes/no

Material stock

Sermon notes/graphics, Life of Christ videos, etc. Note: The Life of Christ videos that are active and have no format were previously those records that were the PAL version. The inactive NTSC versions are kept for historic purposes.


Material ID


Material group

Current list:
- Notes/graphics CD
- Graphics CD
- Life of Christ video
- Hardcopy (language must correspond exactly with sermon languages)

Must not be changed without considering consequences for rest of the system. Some of these values are used hard-coded in the script code


Name


Code Short easy-to-read code identifying this product to use it when printing labels

Language dropdown

Format

NTSC/PAL/SECAM

CD/(DVD/VCD)


Qty in stock


Minimum qty in stock Espacially for Life of Christ videos

Available from Date from which this material will be available

Royalty organization

Current list:
- It Is Written
- Present Solutions

If royalties must be paid when issueing this item select here which organization it must be reported to.


Shipper ID of shipper (from external logins) (blank/null if internal)

Active yes/no

Stories


Story ID


Date block ID
req.

Story type

dropdown

Possible values:
- sitereport (report about campaign site)
- testimonial (personal testimony)

req.

Campaign site ID


Person event ID PersoneventID of the person who created this story, speaker or STMs

Purpose

dropdown:

- public (for publishing on website)

- internal (raw material for internal use)

req.

Headline self made headline/title on story

Narrative
req.

Copy of Narrative Copy of narrative before people changes an authorized story.

Keywords Optional additional keywords used when searching

Author name


Contact name Person to contact for further information about this story.

Contact phone Person to contact for further information about this story.

Contact e-mail Person to contact for further information about this story.

Author notes Scratch-board for author and/or editors. Not shown publicly.

Internal notes Scratch-board for editors.

Narrative authorized date

Don't display the story in public before it's authorized ||


Pictures authorized date

Content authorized date

Don't display the story in public before it's authorized ||


Authorized for display on Adventist Review website? yes/no (set by ShareHim)

Approved for display on Adventist Review website? null/yes/no (set by Adventist Review)

Labels: Approved/Disabled/Not reviewed ||


Show thumbnail? (for testimonies) yes/no

Show thumbnail of person (of course only effective if thumbnail is uploaded) ||


Is news item? yes/no

Show from (only news items) date (from now if blank)

Date is inclusive.


Show to (only news items) date (indefinitely if blank)

Date is exclusive.


Date added datetime req.

Date last modified datetime req.

Story pictures

Attached to the stories


Picture ID


Story ID
req.

Caption long text req.

Filename (given by the system)
req.

Original filename
req.

Is retouched? yes/no

Set to yes when original picture was retouched, either manually or cropped - as intermediate stage between original and final picture

req.

Sorting ID For rearranging the order of pictures

Upload date
req.

Active yes/no

Surveys

Evaluation forms filled out by the speakers and STMs.


Survey ID


Date block ID
req.

Person event ID
req.

No. of campaigns participated in Number of campaigns the person has participated in to date. req.

[questions] x13 1-5 or null

Comments


Date added date req.

Is reviewed? yes/no req.

Donations

Received donations


Donation ID


Person ID


Date received


Donation amount


Donation type


Pledge ID






...many more fields






Receipt sent Date receipt was sent.

If we don't know the date it is set to 2001-01-01. ||


Thank-you letter sent method Possible values:

- letter - email - authorize.net ||


Thank-you letter sent Date letter was sent.

If no letter was sent date is set to 2000-01-01. ||


Follow-Up done? yes/no

Used for non-sitefunding donations only ||





External logins

E.g. Caroline Conference, Quiet Hour, shippers


Login ID


Local ID numeric (ID from div, un, conf etc.)

Firstname


Lastname


Password


E-mail


Address 1


Address 2


Phone


Alternative/local phone An alternative phone number to campaign managers, mainly for entering local phone numbers that they use when they supervise campaigns. opt.

Alternative/local phone until The last date that the phone number is scheduled to be usable. req. if phone number is specified

Access level dropdown

Superadmin

0 / 1 / 2

1 = is superadmin
2 = is associate admin (lower than regular admin).

Only superadmin can see password, change information, add and delete users in external logins.

Only superadmin can emulate and set password (set_pw.php) for admin and coadmin.

Associate admins


Fulltime yes/no

If coadmins are full-time or part-time managers ||


Approved yes/no

Active


Comments

Password questions


Table


Local ID


Question


Answer

Field descriptions


Description ID


Table name


Field name


Public description


Internal description

News

Information shown on the main page of the website


News ID


Headline
req.

Story
req.

ShowFrom date

ShowTo date

Show all on home? yes/no

Show entire news item on the front page? (normally there is a max length for items shown there) || req.

ShareSynch Serial Numbers

Created serial numbers for the ShareSynch software


Serial Number ID Internal ID

Serial Number GS)-XXXX-XXXX req.

Expiration date date

Person ID Person this serial number is connected to

Person event ID Event this serial number is connected to (and that usually causes an expiration date)

Owner name


Owner e-mail


Activations allowed
req.

Is printed?
req.

Date created


Comments

ShareSynch activations

Activations that have been done for the different ShareSynch serial numbers


Activation ID


Serial Number
req.

Hardware ID
req.

Activation Code
req.

Activation date timestamp req.

Activation IP
req.

Hardware Operating System


ShareSynch software version


Reactivation dates The dates this activation code was resent or reactivated

Is withdrawn?

Possible values:
0 = is not withdrawn (default)
1 = withdrawn, allow re-activation
2 = withdrawn, disallow re-activation

Activation code can be withdrawn, either by the user deactivating the computer (1) or ShareHim revoking it (2).

In case of 2, the software needs to register that this activation code is now invalid, so that later attempts to use the same activation code we fail (but what if they format the hardware?!). But, if the code is then regranted, we can only reactivation the software through online activation, otherwise we can't be sure that the revoked code is now active again! Well, for a solid solution the hardware should actually be encrypted together with a date, so that the activation code would be different when the computer was reactivated, and then this whole matter woudn't be an issue. (Or we could also just issue a completely new serial number...)

req.

Comments

System settings


System administrator name General

System administrator e-mail General

E-mail sender name Name that will appear as sender on all e-mail automatically sent by the system

E-mail sender e-mail E-mail that will appear as sender on all e-mail automatically sent by the system

Days to resend unprocessed applicant Days after application date to resend recommendation e-mails for unprocessed applicants

Days to mark unproccessed applicant Number of days until applicant will be highlighted as 'not processed' in the unapproved applicants list

Days before orientation to ship Life of Christ video Days before orientation date that we issue the shipment

Days after date block closing date to remind about entering experience Only used for those who have received sponsorship

Days before opening date to send out e-mail reminding insurance coverage


Days before opening date to send out e-mail reminding service requests


E-mail recipient (name) of info on insurance coverage for participants


E-mail recipient (e-mail) of info on insurance coverage for participants


Insurance information e-mail recipient E-mail to which we send insurance information on shipped equipment

Case lock combination numeric (3)

Case lock on equipment cases ||


Min. days to opening date to allow person use key for bypassing closing date (because of insurance and service requests reports/reminders, so should therefore always be before we send out the last insurance/serv. req. reminder)

E-mail templates

E-mail templates for e-mails that are sent out automatically


E-mail template ID


Reference name identification name for this template

Subject Subject for the e-mail

Body Body for the e-mail

Email log, group e-mails

E-mails sent to group will be logged here


Log ID


Date


Time


Name


E-mail


Mail reference reference to the mail sent (an ID or a file reference)

Local ID numeric (ID from div, un, conf etc.)

From table the table the user originates from

Email log, service requests reports

E-mails sent to group will be logged here


Log ID


Date


Time


Local ID numeric (ID from div, un, conf etc.)

From table the table the user originates from

E-mail


CC Carbon Copy recipients

Attached files )

Date block ID


Target "host" or "sending" organization (division/union/conference)

Batch "first" or "second" batch of reports to this organization

Mail queue

Queues of e-mails that have been or are being sent


Mail queue ID


By local ID User who made the queue

By from table User who made the queue

Sender name


Sender e-mail


Query ID Query ID that this queue is based upon.

In case we want to make queues that are special and not based on a query this can just be left empty.


Custom subject


Attach files Serialized PHP array with documents to attach to the e-mails in this queue.

Use personal salutations? yes/no

Date added datetime

Date completed datetime

Is set when all e-mails in this queue have been sent.

System translations

Pieces of text used in the interface and which can be translated into other languages


Translation ID


Category Not really used

Tag The tag use in the PHP code

Langugage [en|es|da|...] The text for this tag in the given language

Sorting ID Not used

Explanation Any useful instructions for the translator about this piece of text

Date modified Timestamp for when the text or tag for the primary language (English) was last modified

System translators

Queues of e-mails that have been or are being sent


Translator ID


Language Two-letter abbreviation for the language

Person ID

Person ID from main_people of the person who is the translator for this language.

Set to 0 if we currently have no translator.


Last notified Last time translator was notified about new or changed text to be translated

System log

Table is placed in a separate database.


Operation ID


Date
Req.

Time
Req.

By name Name of user who caused this operation Req. if avail.

By local ID ...his local ID Req. if avail.

By from table ...originates from this table

Note: Because of programming mistake this field has incorrect values until 2006-08-22 after a user has emulated somebody. Unsure when problem started (maybe 2006-06-08 or 2006-03-27). || Req. if avail.


Visit ID VisitID from WebStory statistics

IP User's IP address at time of logging

Emulated by Full name of person who was emulating

Action Main name for for this action Req.

Subaction Subname for this action

For name Name of user/record this action was executed upon

NOTE: This can be either firstname lastname or lastname, firstname ||


For local ID ...caused upon this ID in the table below

For from table ...caused upon a record in this table

Person event ID PersoneventID of person it was caused upon (if applicable)

Date block ID DateblockID that this action is related to (if applicable)

Parameters Any extra parameters to log. Default format: field=value¤field=value...

If a field is fit for having a value but we don't have it readily available when making the logentry then we set the value to "N/A" (or "0" for number fields) so that we later can run some queries to easily replace all these "missing" information pieces.

List tables

Venue types

- eg.: Church, open field etc. - 'venueno' only added and sorted by for the sake of Tamara entering the data

Countries

- connected to which division it's in - including the ISO-3166 two-letter codes (where codes starting with underscore (_) is self-made in order to not have empty field) - do NOT change values here without thinking of implications to the system - certain country names are used hard-coded in the script code (eg. ship_material.php) - as of 2006-09-21 used in: - main_divisions - main_unions - main_conferences - main_orientations - main_hotels - main_colleges - main_people - the divisionID is taken from Jon Brauer's XML file "2006-08 OMCountries (Jon Brauer).xml".

Currencies

- code, name, rate, date of rate, and source of rate

Sponsors

- eg.: Quiet Hour Ministries, and later on maybe The Voice of Prophecy

Material groups

- eg.: Sermon notes, Graphics CD, Life of Christ video - make no possibility to edit records, only add (and maybe delete) - do NOT change values here without thinking of implications to the system - certain material groups are used hard-coded in the script code (ship_material.php)

Equipment bases

- the different locations at which we administrate a set of graphics equipment, eg. North Carolina

Shipping methods

- eg.: UPS, FedEx

US states

Titles

- eg.: Mr., Mrs. etc.

Access levels

- eg.: admin etc.