Revise existing opportunities after an upgrade

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 1 min. de leitura
  • Run a scheduled job to modify older opportunities so they can support parent-child opportunity line items.

    Antes de Iniciar

    Role required: admin

    Por Que e Quando Desempenhar Esta Tarefa

    The scheduled job helps update opportunity lines on the opportunities created on or before the Yokohama Q1 release. From Yokohama Q2 release onward, the opportunity lines follow a hierarchical parent-child structure. The hierarchy is achieved by adding new fields on an opportunity line and affects the pricing functionality. For the existing lines to incorporate the updated pricing functionality, the newly added fields must be populated and the hierarchical structure must be in place.

    Procedimento

    1. Navigate to All > System Definition > Scheduled Jobs.
    2. On the scheduled job menu, search for the Revise existing Opportunities on upgrade job.
    3. Open the job and select Execute Now.
    4. Navigate to All > System Logs > System Log > All.
    5. Confirm that the job has been completed by checking for the Opportunity Upgrade Job completed message.
      The log lists the total number of records processed, along with their success and failure count.
      Nota:
      If the job is abruptly stopped, the log displays Opportunity Upgrade Job encountered errors in addition to the error message.

    Resultado

    The scheduled job updates the open opportunities (not in any of the closed stages). The job works differently for opportunities that are synced to Quote than the ones that aren't.

    Exemplo

    For open, non-synced opportunities:
    1. The scheduled job updates the newly added Top Opportunity Line Item and Product Specification fields for all the opportunity lines.
    2. If a complex product offering has a child offering, the job creates child opportunity lines under the parent line. Newly created child lines contain correct values populated for the newly added fields.
    3. A subsequent pricing call is made to populate pricing fields for all the lines in the hierarchy.

    For open, synced opportunities:

    1. A scheduled job updates the newly added Top Opportunity Line Item field for all the opportunity lines.
    2. The Product Specification field, new hierarchy, and pricing fields for this line are updated only if any change is done on the corresponding synced quote line.
    Nota:
    After upgrading to the Yokohama Q2 release, run the scheduled job before working with Opportunity. Failure to do so results in inconsistent behavior in Opportunity and the related tables.