Employee Image
Use this service to import Employee Image information.
Connection Information
URL: https://<SPECTRUM-SERVER>:8482/employee/images
Authentication: Basic Authentication, Enhanced Authentication
Supported methods: POST
Supported formats: JSON
Sample JSON Body
{"employeeImages":[
{
"company_Code": "SP1",
"employee_Code": "536",
"drawer": "Resume",
"image_Type": "PDF",
"image_Description": "John Smith Resume",
"document_ID": "",
"image_File": "JVBERi0...NDY2NjQKJSVFT0YK"
},
{
"company_Code": "SP1",
"employee_Code": "536",
"drawer": "I9",
"image_Type": "PDF",
"image_Description": "I-9 Documentation",
"document_ID": "",
"image_File": "JVBERi0xLjMNJf////8NMSAw...w0lJUVPRg0="
}
]}
Assumptions and Dependencies
- The company_Code and employee_Code will be a valid record in employee master table.
- The drawer passed in must be non-blank and a valid drawer for the EMPLOYEE cabinet in that company.
- The document_ID can be blank, which will indicate that a new document is being added. If not blank, it must be a valid document_ID, and have a transactionID matching the company_Code, employee_Code, and drawer values.
- The Web Service will determine the applicable Path for the Image File by reading for the company-wide default "Path" variable specified in Document Imaging Installation
- Document Imaging offers an option to store images by Year and Period. The Web Service will automatically store imported work order images as if the DIPathByYearAndPeriod value variable is <blank>.
- The Web Service will generate a new Transaction_ID as a GUID.
- If document_ID is passed in, then the existing Transaction_ID will be used.
- The Web Service will insert a record for the incoming employee DI transaction into DI_MASTER_MC, as follows, if no document_ID is passed in:
- Company_Code = passed in
- Cabinet = "EMPLOYEE"
- Drawer = passed in
- Folder = employee_Code (with any leading blanks removed)
- Reference = new unique GUID
- Transaction_Description = image_Description passed in (if blank, use the drawer name and current date as 'mm/dd/yyyy')
- Keywords = tbd
- Transaction_ID = new unique GUID
- The Web Service will insert a record for the incoming employee image into DI_IMAGE_MASTER, as follows:
- Document_ID = Use text string from Import File, if specified
- However, if no Document ID is imported, the Web Service will generate unique Document ID.
- In the case where the Web Service generates the Document ID, the value will be returned to a 3rd party calling the web service.
- Image_Path = Path determined above
- Image_Filename = Unique file name devised by Web Service
- Create_Operator = Set to 3-character Spectrum Operator Code associated with the Authorization ID in Data Exchange Installation
- Create_Date = Set to current system date
- Create_Time = Set to current system time
- Change_Operator = <leave blank>
- Change_Date = <leave blank>
- Change_Time = <leave blank>
- Image_Description = Use text string from Import File. If blank, use transaction Description from above.
- Document_ID = Use text string from Import File, if specified
- The Web Service will determine the applicable Path for the Image File by reading for the company-wide default "Path" variable specified in Document Imaging Installation
- Image Cross-Reference Table:
- The Web Service will insert a record into the DI_IMAGE_XREF Table:
- Transaction_ID = same as field in DI_MASTER_MC
- Document_ID = Same value as above for DI_IMAGE_MASTER
- The Web Service will insert a record into the DI_IMAGE_XREF Table:
Field Descriptions
Element Name | Description | Req? | Type | Max | Format | Validation |
---|---|---|---|---|---|---|
Authorization_ID | Authorization ID to access the server | YES | Text | 20 | Data Exchange Installation screen | |
GUID | Unique reference number created by programming | Text | 36 | ** See GUID definition | ||
Company_Code | Company Code | YES | Text | 3 | Valid company in Spectrum | |
Employee_Code | Employee Code | YES | Text | 11 | Valid employee must exist in the specified company | |
Drawer | DI Drawer | YES | Text | 20 | Must be a valid Drawer in the EMPLOYEE cabinet for the specified company | |
Image_Type | File Extension | YES | Text | |||
Image_Description | Image Description | Text | 40 | *** See Assumptions and Dependencies | Update if modifying an existing record, unless blank passed in | |
Document_ID | Document ID | Text | 19 | *** See Assumptions and Dependencies | Must be unique in Spectrum | |
Image_File | Image File | YES | Base64 |