Current File : //lib/python2.7/site-packages/salt/modules/bamboohr.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l m
Z
d d l m Z
e j e � Z d � Z d � Z d d � Z d d
� Z d d d d � Z d d � Z d
� Z d d d d d d � Z d S( u�
Support for BambooHR
.. versionadded:: 2015.8.0
Requires a ``subdomain`` and an ``apikey`` in ``/etc/salt/minion``:
.. code-block: yaml
bamboohr:
apikey: 012345678901234567890
subdomain: mycompany
i ( t absolute_importt print_functiont unicode_literalsN( t six( t ElementTreec C@ s t � r
t St d f S( u5
Only load the module if apache is installed
uK The API key was not specified. Please specify it using the "apikey" config.( t _apikeyt Truet False( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyt __virtual__ s c C@ s t j d i � j d d � S( u
Get the API key
u bamboohru apikeyN( t __opts__t gett None( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyR & s u idc C@ s� i } t d d d d � \ } } t j | � } | j � } x� | D]� } | j d k r^ qC n xo | D]g } | j � d d } i | d 6} x/ | j � D]! }
|
j | |
j � d d <q� W| | | | <qe WqC W| S( u�
Show all employees for this company.
CLI Example:
salt myminion bamboohr.list_employees
By default, the return data will be keyed by ID. However, it can be ordered
by any other field. Keep in mind that if the field that is chosen contains
duplicate values (i.e., location is used, for a company which only has one
location), then each duplicate value will be overwritten by the previous.
Therefore, it is advisable to only sort by fields that are guaranteed to be
unique.
CLI Examples:
salt myminion bamboohr.list_employees order_by=id
salt myminion bamboohr.list_employees order_by=displayName
salt myminion bamboohr.list_employees order_by=workEmail
t actionu employeest commandu directoryi i u id( t _queryt ETt
fromstringt getchildrent tagt itemst text( t order_byt rett statust resultt roott directoryt catt itemt emp_idt emp_rett details( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyt list_employees- s
c C@ s� i } | d k r$ d j d � } n t d d d | d i | d 6� \ } } t j | � } | j � } i | d 6} x) | D]! } | j | | j � d d <q{ W| S( u4
Show all employees for this company.
CLI Example:
salt myminion bamboohr.show_employee 1138
By default, the fields normally returned from bamboohr.list_employees are
returned. These fields are:
- canUploadPhoto
- department
- displayName
- firstName
- id
- jobTitle
- lastName
- location
- mobilePhone
- nickname
- photoUploaded
- photoUrl
- workEmail
- workPhone
- workPhoneExtension
If needed, a different set of fields may be specified, separated by commas:
CLI Example:
salt myminion bamboohr.show_employee 1138 displayName,dateOfBirth
A list of available fields can be found at
http://www.bamboohr.com/api/documentation/employees.php
u ,u canUploadPhotou
departmentu displayNameu firstNameu idu jobTitleu lastNameu locationu mobilePhoneu nicknameu
photoUploadedu photoUrlu workEmailu workPhoneu workPhoneExtensionR u employeesR
t argsu fieldsi i N( u canUploadPhotou
departmentu displayNameu firstNameu idu jobTitleu lastNameu locationu mobilePhoneu nicknameu
photoUploadedu photoUrlu workEmailu workPhoneu workPhoneExtension( R t joinR R R R R R ( R t fieldsR R R R R R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyt
show_employeeR s8 $
c
C@ s� | d
k r? | d
k s$ | d
k r/ i d d 6Si | | 6} n* t | t j � ri t j j j | � } n d } x( | D] } | d j | | | � 7} qv Wd j | � } t d d d | d | d
d � \ } } t
| d j | j � � � S( u�
Update one or more items for this employee. Specifying an empty value will
clear it for that employee.
CLI Examples:
salt myminion bamboohr.update_employee 1138 nickname Curly
salt myminion bamboohr.update_employee 1138 nickname ''
salt myminion bamboohr.update_employee 1138 items='{"nickname": "Curly"}
salt myminion bamboohr.update_employee 1138 items='{"nickname": ""}
u' At least one key/value pair is requiredu Erroru u <field id="{0}">{1}</field>u <employee>{0}</employee>R u employeesR
t datat methodu POSTu ,N(
R t
isinstanceR t string_typest saltt utilst yamlt safe_loadt formatR R$ R" t keys( R t keyt valueR t xml_itemst pairR R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyt update_employee� s
c
C@ s� i } t d d d d � \ } } t j | � } | j � } x� | D]� } d } i } xC | j � D]5 } | d | | d <| d d k rb | d } qb qb Wx$ | j � D] } | j | | j <q� W| | | | <qC W| S( u�
Show all users for this company.
CLI Example:
salt myminion bamboohr.list_users
By default, the return data will be keyed by ID. However, it can be ordered
by any other field. Keep in mind that if the field that is chosen contains
duplicate values (i.e., location is used, for a company which only has one
location), then each duplicate value will be overwritten by the previous.
Therefore, it is advisable to only sort by fields that are guaranteed to be
unique.
CLI Examples:
salt myminion bamboohr.list_users order_by=id
salt myminion bamboohr.list_users order_by=email
R u metaR
u usersi i u idN( R R R R R R R R (
R R R R R t userst usert user_idt user_retR ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyt
list_users� s
c C@ s� i } t d d d d � \ } } t j | � } | j � } xt | D]l } d } i | j d 6} xC | j � D]5 } | d | | d <| d d k rl | d } ql ql W| | | <qC W| S(
ux
Show all meta data fields for this company.
CLI Example:
salt myminion bamboohr.list_meta_fields
R u metaR
u fieldsu namei i u idN( R R R R R R R ( R R R R R# t fieldt field_idt field_retR ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyt list_meta_fields� s
u GETc C@ s� t j d i � j d d � } d j | � } | r@ | | 7} n | r\ | d j | � 7} n t j d | � t | t � s� i } n d } t j j
j | | d t � d d d | d
| d t
d t d
t d t �} t j d | d � | d | d g S( ug
Make a web call to BambooHR
The password can be any random text, so we chose Salty text.
u bamboohru subdomainu0 https://api.bamboohr.com/api/gateway.php/{0}/v1/u /{0}u BambooHR URL: %st usernamet passwordu saltyporkt paramsR% t decodeR R t optsu! BambooHR Response Status Code: %su statusu textN( R R
R R- t logt debugR' t dictR) R* t httpt queryR R R ( R R
R! R& R% t subdomaint patht return_contentR ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyR � s0
( t __doc__t
__future__R R R t loggingt salt.utils.httpR) t salt.utils.yamlt salt.extR t salt._compatR R t getLoggert __name__RB R R R R R$ R3 R8 R< R ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/bamboohr.pyt <module> s& % G" %
Mini Shell