Argomento precedente: getDocument

Argomento successivo: modifyDocument

createDocument

I parametri seguenti sono validi per il metodo createDocument:

Parametro

Tipo

Descrizione

SID

Stringa

Identifica la sessione recuperata dall'accesso.

kdAttributes

String[]

Identifica un array di coppie nome-valore utilizzato per impostare i valori di attributo iniziali per il nuovo documento di conoscenza come mostrato di seguito:

"SUMMARY","Testo riepilogo",

"TITLE", "Testo titolo"

Come parte del metodo createDocument, la tabella seguente riporta degli esempi di valori di attributo validi, comunemente utilizzati per un documento. I dati nella colonna Tipo riflettono il tipo effettivo, che deve essere analizzato con il metodo in formato stringa nell'array di stringa attrVals.

Valore attributo

Tipo

Descrizione

PRIMARY_INDEX

Numero intero

Identifica l'ID di categoria in cui creare il documento. Utilizzare 1 per la categoria principale.

USER_DEF_ID

Stringa

Identifica l'ID da utilizzare per rappresentare il documento.

TITLE

Stringa

Identifica il titolo del documento.

SUMMARY

Stringa

Identifica il riepilogo del documento.

PROBLEM

Stringa

Identifica il problema del documento.

RESOLUTION

Stringa

Identifica la risoluzione del documento. Può contenere codice html.

STATUS_ID

Numero intero

Identifica l'ID stato per il documento. Il valore predefinito è 10 (Bozza).

PRIORITY_ID

Numero intero

Identifica l'ID priorità per il documento. Il valore predefinito è 20 (normale).

CREATION_DATE

Date (String)

Identifica la data e l'ora in cui il documento è stato creato. Lasciare vuoto per assegnare la data corrente.

MODIFY_DATE

Date (String)

Identifica la data e l'ora dell'ultima modifica apportata al documento. Lasciare vuoto per assegnare la data corrente.

START_DATE

Date (String)

Identifica la data in cui il documento diventa attivo e viene utilizzato insieme al parametro Expiration_Date. Lasciare vuoto per non specificare la data di inizio. Il documento diventa attivo a condizione che non sia stata raggiunta la data di scadenza.

EXPIRATION_DATE

Date (String)

Identifica la data in cui il documento scade e viene utilizzato insieme al parametro Start_Date. Lasciare vuoto per non specificare una data di scadenza.

PUBLISHED_DATE

Date (String)

Identifica la data e l'ora in cui il documento è stato pubblicato. Lasciare vuoto per assegnare la data corrente se lo stato è Pubblicato. Se lo stato è Non pubblicato, questo parametro viene ignorato.

SD_PRODUCT_ID

Numero intero

Identifica l'ID prodotto di CA SDM con cui associare il documento.

ASSIGNEE_ID

UUID

Identifica l'ID assegnatario univoco di CA SDM a cui è assegnato questo documento.

SD_ASSET_ID

UUID

Identifica l'ID asset di CA SDM con cui associare il documento.

SD_ROOTCAUSE_ID

Numero intero

Identifica l'ID causa principale di CA SDM con cui associare il documento.

SD_PRIORITY_ID

Numero intero

Identifica l'ID priorità di CA SDM con cui associare il documento.

SD_SEVERITY_ID

Numero intero

Identifica l'ID gravità di CA SDM con cui associare il documento.

SD_IMPACT_ID

Numero intero

Identifica l'ID impatto di CA SDM con cui associare il documento.

SD_URGENCY_ID

Numero intero

Identifica l'ID urgenza di CA SDM con cui associare il documento.

AUTHOR_ID

UUID

Identifica l'ID univoco del contatto che ha creato il documento. Se l'autore non è un contatto interno, è possibile impostare questo campo su zero (0) e utilizzare il parametro Author.

OWNER_ID

UUID

Identifica l'ID univoco del contatto a cui appartiene il documento.

SUBJECT_EXPERT_ID

UUID

Identifica l'ID univoco del contatto che rappresenta la persona esperta del documento.

NOTES

Stringa

Identifica le note per il documento.

READ_GROUP_LIST

Stringa

Identifica l'elenco di ID gruppo separati da trattini con autorizzazione in lettura per il documento (ad esempio: 1-3-4). Utilizzare A per assegnare autorizzazioni a chiunque.

WRITE_GROUP_LIST

Stringa

Identifica l'elenco di ID gruppo separati da trattini con autorizzazione in scrittura per il documento (ad esempio: 1-3-4). Utilizzare A per assegnare autorizzazioni a chiunque.

INHERITPERMISSIONS

Boolean

Indica lo stato del flag per ereditare le autorizzazioni dalla categoria utilizzata per creare il documento.

Impostare su True per ereditare le autorizzazioni. I parametri ReadPermissions e WritePermissions verranno ignorati.

DOC_TYPE_ID

Numero intero

Identifica l'ID che verrà associato al tipo di documento creato; un documento normale o un documento struttura. Il valore predefinito è un documento normale.

HITS

Numero intero

Identifica il numero di visualizzazioni del documento.

DOC_TEMPLATE_ID

Numero intero

Identifica l'ID del modello che si desidera assegnare a questo documento.

WF_TEMPLATE

Numero intero

Identifica l'ID del modello di flusso di lavoro che si desidera assegnare al documento.

CUSTOM1

Stringa

Specifica un campo personalizzato.

CUSTOM2

Stringa

Specifica un campo personalizzato.

CUSTOM3

Stringa

Specifica un campo personalizzato.

CUSTOM4

Stringa

Specifica un campo personalizzato.

CUSTOM5

Stringa

Specifica un campo personalizzato.

CUSTOM_NUM1

Double

Specifica un campo personalizzato numerico.

CUSTOM_NUM2

Double

Specifica un campo personalizzato numerico.

Descrizione

Crea un nuovo documento.

Valore restituito

Un nodo <UDSObject> che descrive il documento di conoscenza creato.