company

Tryton 8.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, 17 archivos XML, 16 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 5 modelo(s), entre ellos company.company, company.company.config, company.company.config.start, company.company.logo.cache, company.company.tax_identifier. 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 29 clases Python y declara o extiende 25 modelos. Utiliza Binary, Boolean, Date, Function, Integer, 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.company.logo.cache
• company.company.tax_identifier
• 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

• Binary
• Boolean
• Date
• Function
• Integer
• Many2Many
• Many2One
• One2Many
• Selection
• Text

Clases y métodos públicos detectados

Clases: Company, CompanyConfig, CompanyConfigStart, CompanyLogoCache, CompanyMultiValueMixin, CompanyReport, CompanyTaxIdentifier, CompanyValueMixin, Configuration, ConfigurationLang, ContactMechanism, ContactMechanismLanguage, Cron, CronCompany, Date, EmailTemplate, Employee, Erase, LetterReport, LogoValidationError, 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(), footer_used(), get_companies(), get_context(), get_employees(), get_logo(), get_logo_cm(), get_logo_in(), get_multivalue(), get_rec_name(), get_status_bar(), get_tax_identifier(), header_key(), header_used(), match(), multivalue_records(), on_change_companies(), on_change_company(), on_change_employees(), on_change_with_active(), on_change_with_company_party(), on_modification(), preprocess_values(), read(), run_once(), search_active(), search_rec_name(), set_multivalue(), today(), transition_add()

Mapa del código

Se detectaron 8 archivos Python, 17 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
• exceptions.py
• ir.py
• ir.xml
• message.xml
• model.py
• party.py
• res.py
• view/company_config_start_form.xml
• view/company_form.xml
• view/company_list.xml
• view/company_list_simple.xml
• view/company_tax_identifier_form.xml
• view/company_tax_identifier_list.xml
• view/cron_form.xml
• view/employee_form.xml
• view/employee_list_simple.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 8.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: Configuration · logo_size_max · 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/configuration.rst: The Company Module uses some settings from the [company] section of the
• • 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