Aggiungere opzioni di verifica avanzate durante la creazione di una bozza tramite l’API Adobe Workfront
Durante la creazione di una bozza nell’API di Workfront, puoi aggiungere opzioni di bozza avanzate.
Utilizza uno dei seguenti flussi di lavoro per aggiungere opzioni di correzione a una bozza utilizzando l’API:
-
(Consigliato) Crea una bozza semplice utilizzando l’API Workfront, quindi aggiungi opzioni di bozza avanzate alla bozza utilizzando l’API ProofHQ
-
Creare una bozza con opzioni di verifica avanzate utilizzando JSON nell’API di Workfront
Creare una bozza utilizzando le API Workfront e ProofHQ (consigliato) create-a-proof-using-the-workfront-and-proofhq-apis-recommended
Questa sezione descrive come creare una bozza con opzioni di verifica avanzate tramite l’API Workfront, utilizzando una combinazione di API Workfront e ProofHQ.
L’API ProofHQ include diverse azioni non disponibili per le bozze nell’API Workfront. Utilizzando queste azioni, puoi modificare o configurare la bozza con maggiore precisione di quanto non sia disponibile nell’API di Workfront.
Per una panoramica dell'API ProofHQ, vedere Panoramica di ProofHQ. È inoltre possibile fare riferimento alla documentazione di ProofHQ.
- L’API Workfront è un’API REST-ful. L’API ProofHQ è un’API SOAP.
- Le bozze create nell’API ProofHQ non vengono collegate automaticamente a Workfront. Pertanto, consigliamo di creare bozze nell’API Workfront prima di aggiornarle con l’API ProofHQ.
Creare una bozza con opzioni di verifica avanzate
-
Creare una bozza utilizzando l'azione
Document createProof
nell'API Workfront.note note NOTE Durante la creazione della bozza, impostare {}
come valore per il parametroadvancedProofingOptions
. -
Dopo aver creato la bozza, utilizza l’API ProofHQ per aggiungere opzioni avanzate.
Esempi
Questa sezione mostra alcuni aggiornamenti che è possibile apportare con l’API ProofHQ.
Esempi:
È possibile scaricare una bozza, contiene un messaggio ed è condivisa pubblicamente
La documentazione per questo endpoint è disponibile nella pagina ProofHQ API updateProof.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="https://{{soap_host}}/">
<soapenv:Header/>
<soapenv:Body>
<soap:updateProof>
<SessionID>{{session_id}}</SessionID>
<FileID>{{file_id}}</FileID>
<OwnerID>0</OwnerID>
<Name>{{proof_name}}}</Name>
<Subject>Email subject here</Subject>
<Message>Email message here</Message>
<EnableDownload>true</EnableDownload>
<EnableTeamURL>true</EnableTeamURL>
</soap:updateProof>
</soapenv:Body>
</soapenv:Envelope>
Aggiorna una fase in modo che non sia privata, non obbligatoria e richiede una sola approvazione
La documentazione per questo endpoint è disponibile nella pagina Aggiornamento API ProofHQWorkflowProofStage.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="https://{{soap_host}}/">
<soapenv:Header/>
<soapenv:Body>
<soap:updateWorkflowProofStage>
<SessionID>{{session_id}}</SessionID>
<FileID>{{proof_id}}</FileID>
<Stage>
<stage_id>{{stage_id}}</stage_id>
<name>{{stage_name}}</name>
<stage_one_decision_only>true</stage_one_decision_only>
<stage_private>false</stage_private>
<mandatory>false</mandatory>
</Stage>
</soap:updateWorkflowProofStage>
</soapenv:Body>
</soapenv:Envelope>
Aggiungi due destinatari a una bozza senza un decision maker primario
La documentazione per questo endpoint è disponibile nella pagina AddWorkflowProofReviewers dell'API ProofHQ.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:soap="https://{{soap_host}}/">
<soapenv:Header/>
<soapenv:Body>
<soap:addWorkflowProofReviewers>
<SessionID>{{session_id}}</SessionID>
<FileID>{{proof_id}}</FileID>
<Recipients>
<item>
<email>{{recipient_email_1}}</email>
<role>5</role>
<name>{{recipient_name_1}}</name>
<primary_decision_maker>false</primary_decision_maker>
<stage_id>{{stage_id}}</stage_id>
</item>
<item>
<email> {{recipient_email_2}} </email>
<role>5</role>
<name> {{recipient_name_2}} </name>
<primary_decision_maker>false</primary_decision_maker>
<stage_id>{{stage_id}}</stage_id>
</item>
</Recipients>
<SuppressNewProofNotification></SuppressNewProofNotification>
</soap:addWorkflowProofReviewers>
</soapenv:Body>
</soapenv:Envelope>
Creare una bozza utilizzando JSON nell’API di Workfront
Questa sezione descrive come creare una bozza con opzioni di verifica avanzate tramite l’API Workfront, utilizzando JSON come valore di parametro nell’API Workfront
Creare una bozza con opzioni di verifica avanzate
È possibile creare bozze tramite l'API Workfront utilizzando l'azione Document createProof
. Questa azione accetta il parametro advancedProofingOptions
, il cui tipo di valore è string
. Per includere opzioni di verifica avanzate nell'azione createProof
, è necessario immettere le opzioni nel parametro advancedProofingOptions
in formato JSON.
Esempio
Questo esempio mostra i campi e la formattazione che è possibile utilizzare durante la creazione del codice JSON per il parametro advancedProofingOptions
. Il file JSON advancedProofingOptions
può avere un numero di campi maggiore o minore di quello mostrato qui.
Esempio:
{
"stages": [
{
"name": "stage1",
"lockOn": 1,
"position": 1,
"isPrivate": false,
"activateOn": 1,
"recipients": [
{
"name": "",
"role": 5,
"email": "user1_email@example.com",
"recipient_id": "",
"notifications": 0,
"isPrimaryDecisionMaker": null
},
{
"name": "",
"role": 5,
"email": "user2_email@example.com",
"recipient_id": "",
"notifications": 0,
"isPrimaryDecisionMaker": false
}
],
"isMandatory": false,
"deadlineDate": null,
"deadlineTime": null,
"isOneApproval": true,
"activateOnDate": null,
"parentPosition": null,
"activateOnDecision": null,
"deadlineCalculateOn": null,
"deadlineBusinessDays": null
}
],
"message": "",
"subject": "",
"templates": [],
"hasMessage": true,
"canDownload": true,
"customfields": [],
"hasPublicSharing": true,
"isAutomatedWorkflow": true,
"stageBasedVisibility": 0
}