otrs-somconnexio 0.4.4__py2.py3-none-any.whl → 0.7.3__py2.py3-none-any.whl

otrs_somconnexio/responses/ticket_creation.py

@@ -1,4 +1,4 @@
-class OTRSCreationTicketResponse():
+class OTRSCreationTicketResponse:
     """
     This class is to map in object interface the response of Ticket creation call to the OTRS web
     service using the library PyOTRS.
@@ -6,18 +6,19 @@ class OTRSCreationTicketResponse():
     Dict returned:
         {'TicketNumber': '2018121900000025', 'TicketID': '1135', 'ArticleID': '3200'}
     """
+
     def __init__(self, otrs_response):
         self.response = otrs_response
 
     @property
     def id(self):
-        return self.response.get('TicketID')
+        return self.response.get("TicketID")
 
     @property
     def number(self):
-        return self.response.get('TicketNumber')
+        return self.response.get("TicketNumber")
 
     # Unused property.
     @property
     def article_id(self):
-        return self.response.get('ArticleID')
+        return self.response.get("ArticleID")

otrs_somconnexio/services/activate_change_tarriff_mobile_tickets.py

@@ -0,0 +1,13 @@
+# coding: utf-8
+from pyotrs.lib import DynamicField
+
+from .update_ticket_DF import UpdateTicketDF
+
+
+class ActivateChangeTariffMobileTickets(UpdateTicketDF):
+    """
+    Set DF enviaraMM to OTRS mobile tickets.
+    """
+
+    def _prepare_dynamic_fields(self):
+        return [DynamicField(name="enviatMMOV", value=1)]

otrs_somconnexio/services/base_get_ticket_by_number.py

@@ -0,0 +1,22 @@
+# coding: utf-8
+from otrs_somconnexio.client import OTRSClient
+
+
+class BaseGetTicketByNumber:
+    """ """
+
+    def __init__(self, ticket_number):
+        self.ticket_number = ticket_number
+        self.ticket = None
+        self.otrs_client = None
+
+    def _get_ticket(self):
+        if not self.otrs_client:
+            self.otrs_client = OTRSClient()
+        if not self.ticket:
+            self.ticket = self.otrs_client.get_ticket_by_number(
+                self.ticket_number, dynamic_fields=True
+            )
+
+    def run(self):
+        self._get_ticket()

otrs_somconnexio/services/change_to_confirm_ticket.py

@@ -0,0 +1,45 @@
+from otrs_somconnexio.otrs_models.ticket_types.base_change_ticket import (
+    BaseChangeTicket,
+)
+from otrs_somconnexio.otrs_models.configurations.changes.change_email import (
+    ChangeEmailContractsConfiguration,
+    ChangeEmailPersonalConfiguration,
+)
+from otrs_somconnexio.otrs_models.configurations.changes.change_iban import (
+    ChangeIbanTicketConfiguration,
+)
+
+
+class ChangeToConfirmTicket(BaseChangeTicket):
+    """
+    Set DF enviatOdooOV to True to OTRS change email/iban tickets.
+    """
+
+    QUEUES_IDS_TO_APPLIE_CHANGE = [
+        ChangeIbanTicketConfiguration.queue_id,
+        ChangeEmailContractsConfiguration.queue_id,
+        ChangeEmailPersonalConfiguration.queue_id,
+    ]
+
+    def __init__(self):
+        super(ChangeToConfirmTicket, self).__init__(
+            username=None, customer_code=None, fields_dict=None
+        )
+
+    def confirm(self, token):
+        ticket = self.get_by_IDOV(token)
+        if ticket.field_get("QueueID") in self.QUEUES_IDS_TO_APPLIE_CHANGE:
+            self.update(
+                ticket.field_get("TicketID"),
+            )
+        else:
+            raise Exception(
+                """
+Change confirmed for ticket in unexpected queue.
+- Ticket ID: {ticket_id}
+- QueueID: {queue_id}
+                """.format(
+                    ticket_id=ticket.field_get("TicketID"),
+                    queue_id=ticket.field_get("QueueID"),
+                )
+            )

otrs_somconnexio/services/get_mobile_related_tickets.py

@@ -0,0 +1,11 @@
+from otrs_somconnexio.services.base_get_ticket_by_number import BaseGetTicketByNumber
+
+
+class GetMobileRelatedTickets(BaseGetTicketByNumber):
+    def __init__(self, ticket_number, link_type="Normal"):
+        super().__init__(ticket_number)
+        self.link_type = link_type
+
+    def run(self):
+        super().run()
+        return self.otrs_client.get_linked_tickets(self.ticket.tid, self.link_type)

otrs_somconnexio/services/get_sharing_data_mobile_tickets.py

@@ -0,0 +1,65 @@
+from ..otrs_models.configurations.provision.mobile_ticket import (
+    MobileTicketPlatformIntroducedConfiguration as PIConf,
+    MobileTicketActivationScheduledConfiguration as ASConf,
+)
+from ..client import OTRSClient
+
+
+class GetSharingDataMobileTickets:
+    def __init__(self, ticket_id):
+        self.ticket_id = ticket_id
+        self.otrs_client = OTRSClient()
+
+    def run(self):
+        linked_tickets = [
+            t
+            for t in self.otrs_client.get_linked_tickets(self.ticket_id, "Normal")
+            if t.state in ["new", "open"]
+        ]
+
+        if not linked_tickets:
+            return {}
+
+        ticket_dict = {"provisioned": [], "ready": [], "unready": []}
+
+        for t in linked_tickets:
+            if t.queue_id == PIConf.queue_id:
+                ticket_dict["provisioned"].append(t)
+            elif t.queue_id == ASConf.queue_id:
+                ticket_dict["ready"].append(t)
+            else:
+                ticket_dict["unready"].append(t)
+
+        return {
+            "shared_bond_id": self._get_shared_bond_id(ticket_dict["provisioned"]),
+            "ready_mobile_tickets": [
+                self._extract_ticket_data(ticket) for ticket in ticket_dict["ready"]
+            ],
+            "unready_mobile_tickets": [
+                self._extract_ticket_data(ticket) for ticket in ticket_dict["unready"]
+            ],
+        }
+
+    def _get_shared_bond_id(self, provisioned_tickets):
+        shared_bond_ids = set(
+            t.shared_bond_id for t in provisioned_tickets if t.shared_bond_id
+        )
+        return list(shared_bond_ids)
+
+    def _extract_ticket_data(self, ticket):
+        return {
+            "ticket_id": ticket.id,
+            "ticket_number": ticket.number,
+            "mobile_service_type": ticket.service_type,
+            "phone_number": ticket.msisdn,
+            "product_code": ticket.product_code,
+            "international_minutes": ticket.international_minutes,
+            "fiber_contract_code": ticket.fiber_contract_code,
+            "ICC_SC": ticket.icc,
+            "donor_ICC": ticket.donor_icc,
+            "donor_operator": ticket.previous_provider,
+            "docid": ticket.previous_owner_docid,
+            "name": ticket.previous_owner_name,
+            "surname": ticket.previous_owner_surname,
+            "activation_date": ticket.activation_date,
+        }

otrs_somconnexio/services/get_ticket_title.py

@@ -0,0 +1,26 @@
+class GetTicketTitle:
+    service_type_trans_dict = {
+        "fiber": "fibra",
+        "mobile": "mòbil",
+        "adsl": "ADSL",
+        "4G": "4G",
+        "switchboard": "Centraleta Virtual",
+        "switchboard_header": "Centraleta Virtual Capçalera",
+    }
+
+    def __init__(self, technology, order_id, service_type):
+        self.technology = technology
+        self.order_id = order_id
+        self.service_type = service_type
+
+    def build(self):
+        if self.technology != "Mixta":
+            title = "Ticket#{} - Només {}".format(
+                self.order_id, self.service_type_trans_dict[self.service_type]
+            )
+        else:
+            title = "Ticket#{} - {} mixta".format(
+                self.order_id,
+                self.service_type_trans_dict[self.service_type].capitalize(),
+            )
+        return title

otrs_somconnexio/services/mapping_mobile_minutes.py

@@ -1,9 +1,9 @@
-class ServiceMappingMobileMinutes():
+class ServiceMappingMobileMinutes:
     SERVICES = {
-        '0min': '0',
-        '100min': '100',
-        '200min': '200',
-        'unlim': 'unlimited',
+        "0min": "0",
+        "100min": "100",
+        "200min": "200",
+        "unlim": "unlimited",
     }
 
     @classmethod

otrs_somconnexio/services/mapping_services.py

@@ -1,10 +1,12 @@
-class ServiceMappingServices():
+class ServiceMappingServices:
     SERVICES = {
-        'Mobile': 'mobile',
-        'Fibra': 'fiber',
-        'ADSL': 'adsl',
-        'ADSL+100min': 'adsl100',
-        'ADSL+1000min': 'adsl1000'
+        "Mobil": "mobile",
+        "Fibra": "fiber",
+        "ADSL": "adsl",
+        "ADSL+100min": "adsl100",
+        "ADSL+1000min": "adsl1000",
+        "4G": "4g",
+        "Mixta": "mixta",
     }
 
     @classmethod

otrs_somconnexio/services/move_sharing_data_mobile_tickets.py

@@ -0,0 +1,13 @@
+# coding: utf-8
+from pyotrs.lib import DynamicField
+
+from .update_ticket_DF import UpdateTicketDF
+
+
+class MoveSharingDataMobileTickets(UpdateTicketDF):
+    """
+    Set DF compartidesEnProvisio to OTRS mobile tickets.
+    """
+
+    def _prepare_dynamic_fields(self):
+        return [DynamicField(name="compartidesEnProvisio", value=1)]

otrs_somconnexio/services/search_tickets_mobile_change_tariff.py

@@ -0,0 +1,25 @@
+from otrs_somconnexio.otrs_models.configurations.changes.change_tariff import (
+    ChangeTariffSharedBondTicketConfiguration,
+    ChangeTariffTicketConfiguration,
+)
+from otrs_somconnexio.services.search_tickets_service import SearchTicketsService
+
+
+class SearchMobileChangeTariff:
+    def __init__(self, customer_code):
+        self.search_types = [
+            ChangeTariffTicketConfiguration,
+            ChangeTariffSharedBondTicketConfiguration,
+        ]
+        self.search_states = [
+            ChangeTariffTicketConfiguration.state,
+            ChangeTariffSharedBondTicketConfiguration.state,
+        ]
+        self.customer_code = customer_code
+
+    def search(self, df_dct, extra_states=[]):
+        states = sorted(list(set(self.search_states + extra_states)))
+        tickets_found = SearchTicketsService(self.search_types).search(
+            self.customer_code, states, df_dct
+        )
+        return tickets_found

otrs_somconnexio/services/search_tickets_service.py

@@ -0,0 +1,57 @@
+# coding: utf-8
+from pyotrs.lib import DynamicField
+
+from otrs_somconnexio.client import OTRSClient
+
+
+class SearchTicketsService:
+    """
+    Search by queueId, partner, states and DF OTRS tickets.
+    """
+
+    def __init__(self, configuration_class):
+        """
+        configuration_class: Any ticket configuration class from 'otrs-models/configurations'
+        folder in this package
+        """
+        self.configurations = configuration_class
+
+        if not isinstance(configuration_class, list):
+            self.configurations = [configuration_class]
+        else:
+            self.configurations = configuration_class
+
+    def search(self, customer_code=None, state_list=["new"], df_dct={}):
+        """
+        customer_code (str): filter tickets by their customer
+        df_dct (dict): key, value as list of DF with which we must search
+        If value is a list of values, the method will return any match
+        """
+
+        state_list = [state for state in state_list]
+
+        otrs_client = OTRSClient()
+
+        process_id_df = DynamicField(
+            "ProcessManagementProcessID",
+            search_patterns=list(map(lambda c: c.process_id, self.configurations)),
+        )
+        activity_id_df = DynamicField(
+            "ProcessManagementActivityID",
+            search_patterns=list(map(lambda c: c.activity_id, self.configurations)),
+        )
+        df_list = [process_id_df, activity_id_df]
+
+        for key, value in df_dct.items():
+            df_list.append(DynamicField(key, search_patterns=list(value)))
+
+        search_args = {
+            "dynamic_fields": df_list,
+            "QueueIDs": list(map(lambda c: c.queue_id, self.configurations)),
+            "States": state_list,
+        }
+
+        if customer_code:
+            search_args["CustomerID"] = customer_code
+
+        return otrs_client.search_tickets(**search_args)

otrs_somconnexio/services/set_SIM_recieved_mobile_ticket.py

@@ -0,0 +1,107 @@
+# coding: utf-8
+from datetime import date, timedelta
+from enum import Enum
+
+from pyotrs.lib import DynamicField
+
+from otrs_somconnexio.exceptions import TicketNotReadyToBeUpdatedWithSIMReceivedData
+from otrs_somconnexio.otrs_models.process_ticket.mobile import MobileProcessTicket
+from otrs_somconnexio.services.update_ticket_DF import UpdateTicketDF
+from otrs_somconnexio.otrs_models.configurations.provision.mobile_ticket import (
+    MobileTicketConfiguration,
+    MobileTicketPausedConfiguration,
+    MobileTicketCompletedConfiguration,
+    MobileTicketRequestedConfiguration
+)
+
+
+class GetSIM(Enum):
+    SIM_RECEIVED = 1
+    SIM_RECEIVED_AND_DADES = 2
+
+
+class SetSIMRecievedMobileTicket(UpdateTicketDF):
+    """
+    Set DF SIMRebuda to True to OTRS mobile tickets.
+    """
+
+    READY_QUEUES_IDS = (
+        MobileTicketCompletedConfiguration.queue_id,
+        MobileTicketConfiguration.queue_id,
+        MobileTicketPausedConfiguration.queue_id,
+        MobileTicketRequestedConfiguration.queue_id,
+    )
+
+    def __init__(
+        self,
+        ticket_number,
+        activation_date,
+        intro_date,
+    ):
+        self.scheduled_activation = False
+        self.activation_date = activation_date
+        self.intro_date = intro_date
+        super().__init__(ticket_number)
+        self._get_ticket()
+        self.mobile_process_ticket = MobileProcessTicket(self.ticket)
+        self.associated = self._has_associated_fibers()
+        self.portability = self._is_portability()
+        self.only_mobile = self._only_mobile()
+
+    def _only_mobile(self):
+        return self.mobile_process_ticket.service_technology != "mixta"
+
+    def _has_associated_fibers(self):
+        return bool(self.mobile_process_ticket.fiber_contract_code)
+
+    def _is_portability(self):
+        return self.mobile_process_ticket.mobile_service_type == "portabilitat"
+
+    def _is_ready(self):
+        # Si esta en las colas indicadas hacer las comprobaciones,
+        # en caso contrario no hacer nada y que el cron vuelva a pasar
+        if self.mobile_process_ticket.queue_id in self.READY_QUEUES_IDS:
+            return True
+        return False
+
+    def _get_response(self):
+        return self.scheduled_activation
+
+    def _check_doc(self):
+        return self.mobile_process_ticket.confirmed_documentation == "si"
+
+    def _prepare_dynamic_fields(self):
+        if not self._is_ready():
+            raise TicketNotReadyToBeUpdatedWithSIMReceivedData(self.ticket_number)
+
+        # Si tiene asociada y es alta nueva: Enviar SIM + Datas
+        # Si tiene asociada y es portability: Enviar SIM + Datas
+        # Si no tiene asociada y documentacion es true: Enviar SIM + Datas
+        # Si no tiene asociada y documentacion es false: Enviar SIM
+        if self.only_mobile:
+            if self.associated:
+                mode = GetSIM.SIM_RECEIVED_AND_DADES
+            else:
+                if self._check_doc():
+                    mode = GetSIM.SIM_RECEIVED_AND_DADES
+                else:
+                    mode = GetSIM.SIM_RECEIVED
+        else:
+            if not self.associated and self._check_doc() and not self.portability:
+                mode = GetSIM.SIM_RECEIVED_AND_DADES
+            else:
+                mode = GetSIM.SIM_RECEIVED
+
+        if mode == GetSIM.SIM_RECEIVED_AND_DADES:
+            self.scheduled_activation = date.today() + timedelta(days=7)
+            return [
+                DynamicField(name="SIMrebuda", value=1),
+                DynamicField(name="permetActivacio", value="si"),
+                DynamicField(
+                    name="dataActivacioLiniaMobil",
+                    value=str(self.activation_date),
+                ),
+                DynamicField(name="dataIntroPlataforma", value=str(self.intro_date)),
+            ]
+        elif mode == GetSIM.SIM_RECEIVED:
+            return [DynamicField(name="SIMrebuda", value=1)]

otrs_somconnexio/services/set_SIM_returned_mobile_ticket.py

@@ -0,0 +1,37 @@
+# coding: utf-8
+from pyotrs.lib import DynamicField
+
+from otrs_somconnexio.otrs_models.abstract_article import AbstractArticle
+from otrs_somconnexio.services.update_ticket_DF import UpdateTicketDF
+
+
+class SIMReturnedArticle(AbstractArticle):
+    def __init__(self):
+        self.subject = "PROCÉS DE DEVOLUCIÓ DE LA SIM"
+        self.body = "PROCÉS DE DEVOLUCIÓ DE LA SIM"
+
+
+class SetSIMReturnedMobileTicket(UpdateTicketDF):
+    """
+    Empty referenciaCorreus DF to OTRS mobile tickets.
+    """
+
+    def __init__(
+        self,
+        ticket_number,
+    ):
+        super().__init__(ticket_number)
+        self._get_ticket()
+
+    def _prepare_dynamic_fields(self):
+        return [
+            DynamicField(name="referenciaCorreus", value=""),
+            DynamicField(name="SIMrebuda", value=0),
+        ]
+
+    def run(self):
+        super(SetSIMReturnedMobileTicket, self).run()
+        self.otrs_client.update_ticket(
+            self.ticket.tid,
+            article=SIMReturnedArticle().call(),
+        )

otrs_somconnexio/services/set_fiber_contract_code_mobile_ticket.py

@@ -0,0 +1,21 @@
+# coding: utf-8
+from pyotrs.lib import DynamicField
+
+from .update_ticket_DF import UpdateTicketDF
+
+
+class SetFiberContractCodeMobileTicket(UpdateTicketDF):
+    """
+    Set DF OdooContractRefRelacionat to OTRS mobile tickets.
+    """
+
+    def __init__(self, ticket_number, fiber_contract_code):
+        self.fiber_contract_code = fiber_contract_code
+        super().__init__(ticket_number)
+
+    def _prepare_dynamic_fields(self):
+        return [
+            DynamicField(
+                name="OdooContractRefRelacionat", value=self.fiber_contract_code
+            )
+        ]

otrs_somconnexio/services/unblock_mobile_pack_ticket.py

@@ -0,0 +1,48 @@
+# coding: utf-8
+from pyotrs.lib import DynamicField
+
+from otrs_somconnexio.services.update_ticket_DF import UpdateTicketDF
+
+
+class UnblockMobilePackTicket(UpdateTicketDF):
+    """
+    Unblock the mobile pack tickets.
+
+    Once the fiber provisioning is closed, we can start with the mobile provisioning to complete
+    the pack products.
+    Unblock is to change the DynamicField_recuperarProvisio to 1
+    """
+
+    def __init__(self, ticket_number, activation_date, introduced_date):
+        self.activation_date = activation_date
+        self.introduced_date = introduced_date
+        super().__init__(ticket_number)
+
+    def _prepare_dynamic_fields(self):
+        dynamic_fields = [
+            DynamicField(name="recuperarProvisio", value=1),
+            DynamicField(name="enviarNotificacio", value=0),
+        ]
+        if bool(self.ticket.dynamic_field_get("SIMrebuda").value):
+            dynamic_fields.append(
+                DynamicField(
+                    name="dataActivacioLiniaMobil", value=self.activation_date
+                ),
+            )
+            dynamic_fields.append(
+                DynamicField(name="dataIntroPlataforma", value=self.introduced_date),
+            )
+        return dynamic_fields
+
+    def run(self):
+        self._get_ticket()
+        if (
+            self.ticket.dynamic_field_get("dataIntroPlataforma").value
+            and self.ticket.dynamic_field_get("dataActivacioLiniaMobil").value
+        ):
+            return
+        self.otrs_client.update_ticket(
+            self.ticket.tid,
+            article=None,
+            dynamic_fields=self._prepare_dynamic_fields(),
+        )

otrs_somconnexio/services/update_process_ticket_with_coverage_tickets_info_service.py

@@ -7,17 +7,17 @@ class UpdateProcessTicketWithCoverageTicketsInfoService:
     """
     Update the process ticket adding articles with the coverage data.
 
-    Receives a TicketID (provisioning process ticket) and a list of coverage tickets.
-    From this list of tickets, it creates articles with the information required to
-    update the provisioning process ticket.
+    Receives a TicketID (provisioning process ticket) and an email.
+    Finds coverage tickets by email and creates articles with the information
+    required to update the provisioning process ticket.
     """
-    def __init__(self, ticket_id, coverage_tickets):
-        self.coverage_tickets = coverage_tickets
-        self.ticket_id = ticket_id
 
-    def run(self):
-        otrs_client = OTRSClient()
+    def __init__(self, ticket_id):
+        self.ticket_id = ticket_id
+        self.otrs_client = OTRSClient()
 
-        for ticket in self.coverage_tickets:
+    def run(self, email):
+        coverage_tickets = self.otrs_client.search_coverage_tickets_by_email(email)
+        for ticket in coverage_tickets:
             article = CoverageArticle(ticket).call()
-            otrs_client.update_ticket(self.ticket_id, article)
+            self.otrs_client.update_ticket(self.ticket_id, article)

otrs_somconnexio/services/update_ticket_DF.py

@@ -0,0 +1,18 @@
+# coding: utf-8
+from otrs_somconnexio.services.base_get_ticket_by_number import BaseGetTicketByNumber
+
+
+class UpdateTicketDF(BaseGetTicketByNumber):
+    """
+    Abstract service class to update a given OTRS ticket DF's.
+
+    Class method '_prepare_dynamic_fields' needs to be implemented in child classes
+    """
+
+    def run(self):
+        super().run()
+        self.otrs_client.update_ticket(
+            self.ticket.tid,
+            article=None,
+            dynamic_fields=self._prepare_dynamic_fields(),
+        )

otrs_somconnexio/services/update_ticket_with_provider_info.py

@@ -19,9 +19,8 @@ class UpdateTicketWithProviderInfo:
         pyOTRS_article = self.article.call()
 
         otrs_client.update_ticket(
-            self.ticket_id,
-            pyOTRS_article,
-            dynamic_fields=dynamic_fields)
+            self.ticket_id, pyOTRS_article, dynamic_fields=dynamic_fields
+        )
 
     def _df_list_from_dct(self, df_dct):