Tema anterior: createDocumentTema siguiente: deleteDocument


modifyDocument

Los siguientes parámetros se aplican al método modifyDocument:

Parámetro

Tipo

Descripción

SID

Entero

Identifica la sesión recuperada del inicio de sesión.

docId

Entero

Identifica el ID único del documento que desea modificar.

kdAttributes

Cadena[]

Especifica los pares nombre-valor para la actualización. Por ejemplo, “SUMMARY”, ”Texto de resumen”, “TITLE” y “Texto de título”.

Como parte del método modifyDocument, la siguiente tabla muestra ejemplos de valores de atributo válidos y frecuentemente utilizados para un documento. Los datos de la columna Tipo reflejan el tipo real, que se debe analizar para el método en el formato de cadena de la matriz de cadenas attrVals.

Parámetro

Tipo

Descripción

MODIFY_DATE

(Cadena)

Indica un campo especial utilizado para el "bloqueo de registro" con el fin de evitar que dos usuarios actualicen el documento al mismo tiempo. Debe introducir el valor MODIFY_DATE existente del documento. Si se deja en blanco, recibirá un mensaje de error informándole de que otro usuario ha actualizado el documento.

USER_DEF_ID

Cadena

Especifica cualquier ID que desee utilizar para representar el documento.

TITLE

Cadena

Indica el título del documento.

SUMMARY

Cadena

Indica el resumen del documento.

PROBLEM

Cadena

Indica el problema del documento.

RESOLUTION

Cadena

Indica la resolución del documento. Puede contener html.

STATUS_ID

Entero

Indica el ID de estado del documento. El valor predeterminado es 10 (borrador).

PRIORTY_ID

Entero

Indica el ID de prioridad del documento. El valor predeterminado es 20 (normal).

START_DATE

Fecha (cadena)

Indica la fecha en la que el documento se activa. También se utiliza junto con ExpirationDate. Se deja en blanco para no especificar ninguna fecha de inicio. De este modo, el documento se activa, a menos que se haya superado la fecha de vencimiento.

EXPIRATION_DATE

Fecha (cadena)

Indica la fecha en la que el documento vence. Se utiliza junto con StartDate. Se deja en blanco para no especificar ninguna fecha de vencimiento.

SD_PRODUCT_ID

Entero

Indica el ID de producto de CA SDM al que se va a asociar este documento.

ASSIGNEE_ID

UUID

Indica el ID único de CA SDM al que está asignado este documento.

SD_ASSET_ID

UUID

Indica el ID de activo de CA SDM al que se va a asociar este documento.

SD_ROOTCAUSE_ID

Entero

Indica el ID de causa raíz de CA SDM al que se va a asociar este documento.

SD_PRIORITY_ID

Entero

Indica el ID de prioridad de CA SDM al que se va a asociar este documento.

SD_SEVERITY_ID

Entero

Indica el ID de severidad de CA SDM al que se va a asociar este documento.

SD_IMPACT_ID

Entero

Indica el ID del impacto de CA SDM al que desea asociar este documento.

SD_URGENCY_ID

Entero

Especifica el ID de urgencia de CA SDM al que se va a asociar este documento.

AUTHOR_ID

UUID

Identifica el ID único del contacto que creó este documento. Si el autor no es un contacto interno, puede definir este campo en cero (0) y utilizar el parámetro Author en su lugar.

OWNER_ID

UUID

Identifica el ID único del contacto al que pertenece este documento.

SUBJECT_EXPERT_ID

UUID

Indica el ID único del contacto que es experto de este documento.

NOTES

Cadena

Indica las notas del documento.

READ_GROUP_LIST

Cadena

Indica la lista separada por guiones de los ID de grupo con permiso de lectura para este documento (por ejemplo: 1-3-4). Utilice A para asignar permisos a todos los usuarios.

WRITE_GROUP_LIST

Cadena

Indica la lista separada por guiones de los ID de grupo con permiso de escritura para este documento (por ejemplo: 1-3-4). Utilice A para asignar permisos a todos los usuarios.

INHERIT_PERMISSION

Boolean

Indica el estado del indicador de herencia de permisos. Defina este parámetro en verdadero si desea heredar permisos de la categoría en la que se está creando el documento. Si se define en verdadero, se omiten los parámetros ReadPermissions y WritePermissions.

DOC_TYPE_ID

Entero

Identifica el ID para el tipo de documento: documento normal o documento de árbol. El valor predeterminado es un documento normal.

HITS

Entero

Indica el número de veces que se ha visualizado un documento.

DOC_TEMPLATE_ID

Entero

Identifica el ID de la plantilla que desea asignar a este documento.

WF_TEMPLATE

Entero

Identifica el ID de la plantilla de workflow que desea asignar a este documento.

WF_ACTION

Cadena

Identifica la acción para el workflow que desea asignar a este documento. Por ejemplo, wf_unpublish permite que el documento se quede sin publicar.

WF_COMMENT

Cadena

Identifica el comentario para el workflow que desea asignar a este documento. Por ejemplo, no publicar.

WF_CONTACT_ID

UUID

Identifica el ID de usuario para el workflow que desea asignar a este documento.

WF_REJECT_TO_ID

Entero

Identifica el ID de tarea para el workflow que desea asignar a este documento y que coincide con su proceso de aprobación. Los ID de tarea se almacenan en la tabla CI_ACTIONS.

CUSTOM1

Cadena

Indica un campo personalizado.

CUSTOM2

Cadena

Indica un campo personalizado.

CUSTOM3

Cadena

Indica un campo personalizado.

CUSTOM4

Cadena

Indica un campo personalizado.

CUSTOM5

Cadena

Indica un campo personalizado.

CUSTOMNUM1

Doble

Indica un campo numérico personalizado.

CUSTOMNUM2

Doble

Indica un campo numérico personalizado.

Descripción

Modifica un documento.

Resultado

Un nodo <UDSObject> que describe el documento de conocimientos modificado.