---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ChangeCollisionHelper - Global

# ChangeCollisionHelper - Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

A inclusão de script ChangeCollisionHelper fornece métodos de ajuda encontrados no plug-in Gestão de mudanças - Collision Detector (com.snc.change.collision).

Use esses métodos em scripts do lado do servidor ou ao usar chamadas Ajax no cliente. Você deve ter o plug-in Gestão de mudanças - Collision Detector instalado para usar esses métodos.

## ChangeCollisionHelper -- addCiToChangeAffectedCis(cadeia de caracteres IC, cadeia de caracteres changeId) {#ariaid-title2}

Adiciona o IC à lista de ICs afetados pela mudança.
{#r_CCH-addCiToChgAffectedCis_S_S__table_xph_pw2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| IC | Cadeia de caracteres | O sys_id do item de configuração |
| changeId | Cadeia de caracteres | O sys_id do registro de mudança |
[Tabela 1. Parâmetros]

{#r_CCH-addCiToChgAffectedCis_S_S__table_xph_pw2_zt} {#r_CCH-addCiToChgAffectedCis_S_S__table_yph_pw2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 2. Retorna]

{#r_CCH-addCiToChgAffectedCis_S_S__table_yph_pw2_zt}

## ChangeCollisionHelper -- getAffectedCisByChangeId(cadeia de caracteres changeId) {#ariaid-title3}

Retorna os sys_ids do IC afetado para a mudança fornecida.
{#r_CCH-getAffectedCisByChangeId_S__table_r4y_bw2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| changeId | Cadeia de caracteres | O sys_id de um registro de mudança |
[Tabela 3. Parâmetros]

{#r_CCH-getAffectedCisByChangeId_S__table_r4y_bw2_zt} {#r_CCH-getAffectedCisByChangeId_S__table_s4y_bw2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de sys_ids de ICs afetados. |
[Tabela 4. Retorna]

{#r_CCH-getAffectedCisByChangeId_S__table_s4y_bw2_zt}

## ChangeCollisionHelper - getblackoutsByDate(GlideDateTime startDate, GlideDateTime endDate) {#ariaid-title4}

Retorna qualquer blackout que se sobreponha ao período definido por startDate e endDate.
{#r_CCH-getBlackoutsByDate_GDT_GDT__table_jhy_g52_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| startDate | GlideDateTime | A data de início |
| endDate | GlideDateTime | A data de término |
[Tabela 5. Parâmetros]

{#r_CCH-getBlackoutsByDate_GDT_GDT__table_jhy_g52_zt} {#r_CCH-getBlackoutsByDate_GDT_GDT__table_khy_g52_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de blackouts (blackoutId:stringSpan). |
[Tabela 6. Retorna]

{#r_CCH-getBlackoutsByDate_GDT_GDT__table_khy_g52_zt}

## ChangeCollisionHelper - getChangesWithAffectedCi(cadeia de caracteres ci, GlideDateTime startDate, GlideDateTime endDate) {#ariaid-title5}

Retorna mudanças programadas no intervalo de tempo (definido por startDate e endDate) que têm o IC fornecido na lista de ICs afetados.
{#r_CCH-getChgWAffectedCi_S_GDT_GDT__table_jfd_w52_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| IC | Cadeia de caracteres | O sys_id do item de configuração |
| startDate | GlideDateTime | A data de início |
| endDate | GlideDateTime | A data de término do período |
[Tabela 7. Parâmetros]

{#r_CCH-getChgWAffectedCi_S_GDT_GDT__table_jfd_w52_zt} {#r_CCH-getChgWAffectedCi_S_GDT_GDT__table_kfd_w52_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de sys_ids do registro de mudança |
[Tabela 8. Retorna]

{#r_CCH-getChgWAffectedCi_S_GDT_GDT__table_kfd_w52_zt}

## ChangeCollisionHelper - getChangesWithCi(cadeia de caracteres ci, GlideDateTime startDate, GlideDateTime endDate) {#ariaid-title6}

Retorna as mudanças que estão no intervalo de tempo (startDate, endDate) e que estão vinculadas ao IC fornecido.
{#r_CCH-getChangesWithCi_S_GDT_GDT__table_vht_4v2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| IC | Cadeia de caracteres | O sys_id do item de configuração |
| startDate | GlideDateTime | A data de início |
| endDate | GlideDateTime | A data de término do período |
[Tabela 9. Parâmetros]

{#r_CCH-getChangesWithCi_S_GDT_GDT__table_vht_4v2_zt} {#r_CCH-getChangesWithCi_S_GDT_GDT__table_wht_4v2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de sys_ids para registros de mudança |
[Tabela 10. Retorna]

{#r_CCH-getChangesWithCi_S_GDT_GDT__table_wht_4v2_zt}

## ChangeCollisionHelper -- getCiMaintenanceSchedule(String ci) {#ariaid-title7}

Retorna o cronograma de manutenção de um IC.
{#r_CCH-getCiMaintSched_S__table_kgl_vt2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| IC | Cadeia de caracteres | O sys_id do item de configuração |
[Tabela 11. Parâmetros]

{#r_CCH-getCiMaintSched_S__table_kgl_vt2_zt} {#r_CCH-getCiMaintSched_S__table_lgl_vt2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 12. Retorna]

{#r_CCH-getCiMaintSched_S__table_lgl_vt2_zt}

## ChangeCollisionHelper - getDependents(String ci) {#ariaid-title8}

Retorna todos os ICs que dependem do IC fornecido.
{#r_CCH-getDependants_S__table_phr_4x2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| IC | Cadeia de caracteres | O sys_id de um item de configuração |
[Tabela 13. Parâmetros]

{#r_CCH-getDependants_S__table_phr_4x2_zt} {#r_CCH-getDependants_S__table_qhr_4x2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de ICs |
[Tabela 14. Retorna]

{#r_CCH-getDependants_S__table_qhr_4x2_zt}

## ChangeCollisionHelper -- getDependencies(String ci) {#ariaid-title9}

Retorna todos os ICs dos quais o IC fornecido depende.
{#r_CCH-getDependencies_S__table_esm_xx2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| IC | Cadeia de caracteres | O sys_id do item de configuração |
[Tabela 15. Parâmetros]

{#r_CCH-getDependencies_S__table_esm_xx2_zt} {#r_CCH-getDependencies_S__table_fsm_xx2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Uma matriz de ICs |
[Tabela 16. Retorna]

{#r_CCH-getDependencies_S__table_fsm_xx2_zt}

## ChangeCollisionHelper - isCiInAffectedCis(cadeia de caracteres IC, cadeia de caracteres changeId) {#ariaid-title10}

Verifique se um IC já está na lista de ICs afetados da mudança.
{#r_CCH-isCiInAffectedCis_S_S__table_egt_cx2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| IC | Cadeia de caracteres | O sys_id do item de configuração |
| changeId | Cadeia de caracteres | O sys_id do registro de mudança |
[Tabela 17. Parâmetros]

{#r_CCH-isCiInAffectedCis_S_S__table_egt_cx2_zt} {#r_CCH-isCiInAffectedCis_S_S__table_fgt_cx2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o IC já estiver na lista de ICs afetados da mudança. |
[Tabela 18. Retorna]

{#r_CCH-isCiInAffectedCis_S_S__table_fgt_cx2_zt}

## ChangeCollisionHelper - isDateInCiMaintenanceWindows( GlideDateTime startDate, GlideDateTime endDate, String MaintenanceWindow) {#ariaid-title11}

Verifica se o período de tempo definido por startDate e endDate está dentro da janela de manutenção do IC.
{#r_CCH-isDateInCiMaintW_GDT_GDT_S__table_gjr_ys2_zt__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| startDate | GlideDateTime | A data de início |
| endDate | GlideDateTime | A data de término |
| janela de manutenção | Cadeia de caracteres | O sys_id do item de configuração |
[Tabela 19. Parâmetros]

{#r_CCH-isDateInCiMaintW_GDT_GDT_S__table_gjr_ys2_zt} {#r_CCH-isDateInCiMaintW_GDT_GDT_S__table_hjr_ys2_zt__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o intervalo de tempo estiver na janela de manutenção do IC |
[Tabela 20. Retorna]

{#r_CCH-isDateInCiMaintW_GDT_GDT_S__table_hjr_ys2_zt}