Saltar al contenido principal
Versión: Tryton 6.0 (LTS)

company

Tryton 6.0 · Referencia generada desde el código oficial

Esta página combina orientación editorial con evidencia extraída de la rama oficial indicada. Pruebe siempre el flujo con sus permisos y configuración.

Propósito​

El módulo company incorpora o amplía funciones relacionadas con company. Su alcance real se determina por los modelos, acciones y dependencias documentados a continuación; no debe activarse únicamente por su nombre.

Descripción oficial de la rama (idioma original)​

The Company Module allows the business that is using Tryton to be represented inside Tryton. This may be a single company or multiple companies. It also allows recording which employees belong to which companies and what their organisational structure is.

El análisis encontró 8 archivos Python, 12 archivos XML, 10 vistas, 13 acciones, 3 menús y 1 informes.

Guía funcional para el usuario

A quién le sirve​

Este módulo interesa a las personas responsables de los procesos relacionados con company, a quienes configuran la compañía y a quienes revisan sus resultados. Los administradores deben participar cuando se activen dependencias, permisos o secuencias.

Qué podrá hacer​

Al finalizar la configuración podrá reconocer los registros que aporta company, ejecutar sus acciones con el estado correcto, producir sus informes y comprender qué información termina compartiendo con otros módulos.

Requisitos y preparación​

Antes de activarlo confirme la compañía, moneda, usuarios y grupos aplicables. Instale y configure primero sus dependencias obligatorias. Si existen datos reales, ensaye la activación y actualización sobre una copia restaurada.

Active primero las dependencias, revise la configuración de la compañía y ensaye el flujo completo antes de usarlo en producción.

Dependencias obligatorias​

  • currency — debe estar instalado y configurado antes de probar este módulo.
  • ir — debe estar instalado y configurado antes de probar este módulo.
  • party — debe estar instalado y configurado antes de probar este módulo.
  • res — debe estar instalado y configurado antes de probar este módulo.

Integraciones opcionales​

  • —

Configuración inicial recomendada​

  • Active el módulo y vuelva a iniciar la sesión para cargar menús y permisos.
  • Revise las nuevas opciones de configuración de compañía y los valores por defecto.
  • Asigne grupos a usuarios de prueba aplicando mínimo privilegio.
  • Cree datos maestros pequeños y verificables antes de importar información masiva.
  • Ejecute un caso completo desde borrador hasta su estado final y revise los registros relacionados.

Objetos y conceptos del módulo​

  • company.company: agrupa 3 modelo(s), entre ellos company.company, company.company.config, company.company.config.start. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • company.employee: agrupa 1 modelo(s), entre ellos company.employee. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • ir.cron: agrupa 1 modelo(s), entre ellos ir.cron. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • ir.cron-company: agrupa 1 modelo(s), entre ellos ir.cron-company.company. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • ir.date: agrupa 1 modelo(s), entre ellos ir.date. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • ir.email: agrupa 1 modelo(s), entre ellos ir.email.template. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • ir.rule: agrupa 1 modelo(s), entre ellos ir.rule. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • ir.sequence: agrupa 2 modelo(s), entre ellos ir.sequence, ir.sequence.strict. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.configuration: agrupa 2 modelo(s), entre ellos party.configuration, party.configuration.party_lang. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.contact_mechanism: agrupa 2 modelo(s), entre ellos party.contact_mechanism, party.contact_mechanism.language. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.erase: agrupa 1 modelo(s), entre ellos party.erase. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.letter: agrupa 1 modelo(s), entre ellos party.letter. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.party: agrupa 2 modelo(s), entre ellos party.party, party.party.lang. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • party.replace: agrupa 1 modelo(s), entre ellos party.replace. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • res.user: agrupa 1 modelo(s), entre ellos res.user. Estos registros forman la información que el usuario consulta o modifica durante el proceso.
  • res.user-company: agrupa 2 modelo(s), entre ellos res.user-company.company, res.user-company.employee. Estos registros forman la información que el usuario consulta o modifica durante el proceso.

Flujo de trabajo habitual​

  1. Seleccione la compañía y fecha correctas antes de crear el documento.
  2. Complete primero los datos maestros y luego las líneas o detalles.
  3. Guarde y revise el registro antes de utilizarlo desde otro proceso.
  4. Revise advertencias, totales, documentos relacionados y trazabilidad.
  5. Genere el informe y compare su contenido con el registro antes de entregarlo.

Acciones, estados y asistentes​

  • company.company.config.start — asistente que reúne datos y ejecuta company › company › config › start. Verifique permisos, estado actual y registros relacionados antes de ejecutarla.

Controles antes de producción​

  • Defina quién crea, revisa, confirma, cancela y consulta.
  • Pruebe períodos cerrados, usuarios sin permisos y datos incompletos.
  • Verifique numeración, moneda, redondeo y zona horaria cuando correspondan.
  • Documente cómo corregir un error sin editar directamente la base de datos.
  • Incluya sus tablas y archivos en el procedimiento de copia y restauración.

Diagnóstico y resolución de problemas​

  • Si no aparece el menú, compruebe activación, actualización de la lista de módulos, grupos y nueva sesión.
  • Si un campo no acepta un valor, revise su dominio, compañía, estado y dependencias configuradas.
  • Si un botón está oculto o deshabilitado, revise permisos y transición válida; no modifique el estado con SQL.
  • Si los resultados no coinciden, reproduzca un caso mínimo y compare registros relacionados antes y después.
  • Conserve el traceback completo, versión, módulos activos y datos mínimos para diagnosticar un error.

Guía para desarrolladores

Arquitectura y puntos de extensión​

El paquete contiene 26 clases Python y declara o extiende 23 modelos. Utiliza Date, Many2Many, Many2One, One2Many, Selection, Text. Los desarrolladores deben localizar primero si una clase crea un modelo nuevo o usa PoolMeta para extender uno existente, conservar las llamadas a super() y no duplicar reglas disponibles en las dependencias.

Modelos registrados o extendidos​

  • company.company
  • company.company.config
  • company.company.config.start
  • company.employee
  • ir.cron
  • ir.cron-company.company
  • ir.date
  • ir.email.template
  • ir.rule
  • ir.sequence
  • ir.sequence.strict
  • party.configuration
  • party.configuration.party_lang
  • party.contact_mechanism
  • party.contact_mechanism.language
  • party.erase
  • party.letter
  • party.party
  • party.party.lang
  • party.replace
  • res.user
  • res.user-company.company
  • res.user-company.employee

Tipos de campos utilizados​

  • Date
  • Many2Many
  • Many2One
  • One2Many
  • Selection
  • Text

Clases y métodos públicos detectados​

Clases: Company, CompanyConfig, CompanyConfigStart, CompanyMultiValueMixin, CompanyReport, CompanyValueMixin, Configuration, ConfigurationLang, ContactMechanism, ContactMechanismLanguage, Cron, CronCompany, Date, EmailTemplate, Employee, Erase, LetterReport, Party, PartyLang, Replace, Rule, Sequence, SequenceStrict, User, UserCompany, UserEmployee

Métodos: check_erase(), check_erase_company(), decorator(), default_companies(), default_company(), default_company_filter(), email_models(), end(), execute(), fields_to_replace(), get_context(), get_multivalue(), get_rec_name(), get_status_bar(), header_key(), multivalue_records(), on_change_company(), read(), run_once(), search_rec_name(), set_multivalue(), today(), transition_add(), write()

Mapa del código​

Se detectaron 8 archivos Python, 12 XML y 0 archivos explícitos de acceso. Los XML conectan modelos con vistas, menús, acciones e informes; los CSV de acceso establecen permisos iniciales.

  • __init__.py
  • company.py
  • company.xml
  • doc/conf.py
  • ir.py
  • ir.xml
  • model.py
  • party.py
  • res.py
  • setup.py
  • view/company_config_start_form.xml
  • view/company_form.xml
  • view/company_list.xml
  • view/cron_form.xml
  • view/employee_form.xml
  • view/employee_tree.xml
  • view/sequence_form.xml
  • view/sequence_tree.xml
  • view/user_form.xml
  • view/user_form_preferences.xml

Plan de pruebas​

  • Activación en una base vacía y actualización desde la revisión anterior.
  • Creación, modificación, copia y eliminación según estado y permisos.
  • Cada botón, transición y asistente con casos válidos e inválidos.
  • Reglas multicompañía, traducciones, zonas horarias y monedas aplicables.
  • Instalación conjunta con dependencias obligatorias e integraciones opcionales.
  • Copia y restauración de registros, adjuntos e informes producidos.

Compatibilidad y actualización​

Mantenga servidor y módulos en la serie 6.0. Antes de actualizar compare tryton.cfg, migraciones de __register__, cambios de estados, XML IDs y permisos. Una compilación exitosa no reemplaza una migración ensayada ni la conciliación funcional de datos.

Evidencia documental oficial​

Temas encontrados: Design · Company · Employee · User · Party · Reports · Letter · Company Module · API Reference · Company Multi-Values · Employee Fields · Company Reports · Usage · Setting your current company and employee

    • doc/design.rst: The Company Module introduces some new concepts, and extends other existing concepts:
    • doc/index.rst: The Company Module allows the business that is using Tryton to be represented inside Tryton. This may be a single company or multiple companies. It also allows recording which employees belong to which companies and what their organisational structure is.
    • doc/reference.rst: A ~trytond:trytond.model.MultiValueMixin that makes it simpler to create ~trytond:trytond.model.fields.MultiValue fields based on the Company <model-company.company> in the context. It does this by including the company from the context in the pattern by default.
    • doc/usage.rst: The Companies <model-company.company> and Employees <model-company.employee> on Tryton can be found under the [Company] main menu item.

Ver código fuente