File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/bamboohr.cpython-310.pyc
Back
o ;jN � @ s� d Z ddlZddlm mZ ddlZddlZe� e �Z dd� Z dd� Z ddd �Zdd d �Zdd d �Zddd�Zdd� Zddd�ZdS )z� 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 � Nc C s t � rdS dS )z5 Only load the module if apache is installed T)FzKThe API key was not specified. Please specify it using the "apikey" config.)�_apikey� r r �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/bamboohr.py� __virtual__ s r c C s t �di ��dd�S )z Get the API key �bamboohrZapikeyN)�__opts__�getr r r r r $ s r �idc C s� i }t ddd�\}}t�|�}|D ]/}|jdkrq|D ]$}tt|�� ��}d|i}|D ] } | j|tt| �� ��< q+|||| < qq|S )a Show all employees for this company. CLI Example: .. code-block:: bash 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: .. code-block:: bash salt myminion bamboohr.list_employees order_by=id salt myminion bamboohr.list_employees order_by=displayName salt myminion bamboohr.list_employees order_by=workEmail � employees� directory��action�commandr )�_query�ET� fromstring�tag�next�iter�values�text) �order_by�ret�status�result�root�cat�item�emp_idZemp_ret�detailsr r r �list_employees+ s �r c C sb i }|du r d� d�}td| d|id�\}}t�|�}d| i}|D ] }|j|tt|�� ��< q!|S )ah Show all employees for this company. CLI Example: .. code-block:: bash 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: .. code-block:: bash 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 N�,)ZcanUploadPhotoZ departmentZ displayNameZ firstNamer ZjobTitleZlastName�locationZ mobilePhoneZnicknameZ photoUploadedZphotoUrlZ workEmailZ workPhoneZworkPhoneExtensionr �fields)r r �argsr )�joinr r r r r r r )r r# r r r r r r r r � show_employeeS s (� r& c C s� |du r|du s |du rddiS ||i}n t |t�r!tjj�|�}d}|D ]}|d|� d|| � d�7 }q%d|� d �}td | |d d �\}}t| d �|� � ��S )a� Update one or more items for this employee. Specifying an empty value will clear it for that employee. CLI Examples: .. code-block:: bash 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": ""} N�Errorz'At least one key/value pair is required� z <field id="z">z</field>z <employee>z </employee>r �POST)r r �data�methodr! ) � isinstance�str�salt�utilsZyamlZ safe_loadr r& r% �keys)r �key�value�itemsZ xml_items�pairr r r r r �update_employee� s" �r5 c C s� i }t ddd�\}}t�|�}|D ]0}d}i }|�� D ]}|d ||d < |d dkr/|d }q|D ]}|j||j< q2|||| < q|S )a� Show all users for this company. CLI Example: .. code-block:: bash 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: .. code-block:: bash salt myminion bamboohr.list_users order_by=id salt myminion bamboohr.list_users order_by=email �metaZusersr N� r r )r r r r3 r r ) r r r r r �userZuser_idZuser_retr r r r � list_users� s �r9 c C st i } t ddd�\}}t�|�}|D ]&}d}d|ji}|�� D ]}|d ||d < |d dkr2|d }q || |< q| S ) z� Show all meta data fields for this company. CLI Example: .. code-block:: bash salt myminion bamboohr.list_meta_fields r6 r# r N�namer7 r r )r r r r r3 )r r r r �fieldZfield_idZ field_retr r r r �list_meta_fields� s � r< �GETc C s� t �di ��dd�}d|� d�}| r|| 7 }|r |d|� �7 }t�d|� t|t�s,i }d}tjjj ||t � d||d d d t d � }t�d |d � |d |d gS )zg Make a web call to BambooHR The password can be any random text, so we chose Salty text. r � subdomainNz)https://api.bamboohr.com/api/gateway.php/z/v1/�/zBambooHR URL: %sZ saltyporkFT)�username�password�paramsr* �decoder r �optsz!BambooHR Response Status Code: %sr r ) r r �log�debugr, �dictr. r/ �http�queryr ) r r r$ r+ r* r> �pathZreturn_contentr r r r r � s0 � r )r )N)NNN)NNNr= N)�__doc__�loggingZxml.etree.ElementTreeZetreeZ ElementTreer Zsalt.utils.httpr. Zsalt.utils.yaml� getLogger�__name__rE r r r r& r5 r9 r< r r r r r �<module> s ( H $(
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings