Lark Attendance icon

Lark Attendance

Lark Attendance Management

Actions22

Overview

The node "Lark Attendance" provides integration with Lark's Attendance Management system. Specifically, the "Query Statistics Settings" operation under the "Attendance Statistic" resource allows users to retrieve configuration or settings related to attendance statistics. This can be useful for organizations wanting to programmatically access how attendance data is aggregated or reported within their Lark workspace.

Common scenarios include:

  • Automating retrieval of attendance statistics configurations for reporting or auditing.
  • Integrating attendance statistics settings into custom dashboards or HR systems.
  • Dynamically adjusting workflows based on attendance statistics parameters.

Example: A company might use this node to fetch the current attendance statistics settings to ensure their internal reports align with the configured metrics in Lark Attendance.

Properties

Name Meaning
Authentication Method of authentication to use: either "Tenant Token" or "OAuth2".
Employee Type Specifies the type of employee ID used in the response's user_id field (e.g., employee number).
Locale Language/locale setting for the query request body, influencing localization of results.
Stats Type The type/category of statistics to query from the attendance system.
Custom Body JSON object allowing a fully custom request body to be sent instead of standard parameters.
Use Custom Body Boolean flag indicating whether to send the custom JSON body instead of the default one.

Output

The node outputs JSON data representing the queried attendance statistics settings. The structure typically includes details about the statistics configuration such as types, parameters, and possibly localized descriptions depending on the locale provided.

No binary data output is indicated.

Dependencies

  • Requires an API key credential or OAuth2 token for authenticating requests to Lark's Open APIs.
  • The base URL for API requests is https://open.larksuite.com/open-apis.
  • Proper permissions/scopes must be granted to the credentials to access attendance statistics.

Troubleshooting

  • Authentication errors: Ensure that the correct authentication method is selected and valid credentials are provided.
  • Invalid or missing parameters: If required fields like stats_type or locale are incorrect or missing, the API may return errors or empty results.
  • Custom Body usage: When using the custom body option, ensure the JSON is well-formed and matches the expected API schema.
  • API rate limits: Frequent calls may hit rate limits imposed by Lark; handle such errors by implementing retries or backoff.
  • Network issues: Verify network connectivity and that the base URL is reachable.

Links and References

Discussion