Geavanceerde opties voor proefdrukken toevoegen bij het maken van een proefdruk via de Adobe Workfront API

Als u een proefdruk maakt in de Workfront API, kunt u geavanceerde proefdrukopties toevoegen.

Gebruik een van de volgende workflows om proefdrukopties aan een proefdruk toe te voegen met behulp van de API:

  • (Aanbevolen) Maak een eenvoudige proefdruk met de Workfront API en voeg vervolgens geavanceerde proefdrukopties toe aan de proefdruk met de API ProefHQ

  • Een proefdruk maken met geavanceerde opties voor proefdrukken met JSON in de Workfront API

In deze sectie wordt beschreven hoe u een proefdruk maakt met geavanceerde opties voor proefdrukken via de Workfront API, met behulp van een combinatie van Workfront- en ProofHQ-API's.

De API ProofHQ bevat een aantal acties die niet beschikbaar zijn voor proefdrukken in de Workfront API. Door deze acties te gebruiken, kunt u de proef wijzigen of vormen met nauwkeuriger dan beschikbaar in Workfront API.

Voor een overzicht van API ProofHQ, zie het Overzicht PoofHQ. U kunt ook naar de Documentatie ProofHQverwijzen.

NOTE
  • De Workfront API is een REST-ful API. De API ProofHQ is een SOAP API.
  • Proofs die zijn gemaakt in de API ProefHQ worden niet automatisch gekoppeld aan Workfront. Daarom raden we u aan proefdrukken te maken in de Workfront API voordat u ze bijwerkt met de API ProofHQ.

Een proefdruk maken met geavanceerde opties voor proefdrukken

  1. Maak een proefdruk met de handeling Document createProof in de Workfront API.

    note note
    NOTE
    Wanneer u de proefdruk maakt, stelt u {} in als de waarde voor de parameter advancedProofingOptions .
  2. Nadat de proefdruk is gemaakt, gebruikt u de API ProofHQ om geavanceerde opties toe te voegen.

Voorbeelden

In deze sectie worden enkele voorbeeldupdates weergegeven die u kunt maken met de API ProofHQ.

Voorbeelden:

A Bewijs kan worden gedownload, heeft een bericht, en wordt openbaar gedeeld

De documentatie voor dit eindpunt kan op ProofHQ API updateProofpagina worden gevonden.

<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>

werk een stadium bij zodat het niet privé, niet verplicht is, en vereist slechts één goedkeuring

De documentatie voor dit eindpunt kan op de ProofHQ API updateWorkflowProofStagepagina worden gevonden.

<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>

voeg twee ontvangers aan een bewijs zonder primaire besluitvormer toe

De documentatie voor dit eindpunt kan op ProofHQ API addWorkflowProofReviewerspagina worden gevonden.

<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>

Een proefdruk maken met JSON in de Workfront API

In deze sectie wordt beschreven hoe u een proefdruk maakt met geavanceerde opties voor proefdrukken via de Workfront API en JSON gebruikt als parameterwaarde in de Workfront API

Een proefdruk maken met geavanceerde opties voor proefdrukken

Met de handeling Document createProof kunt u proefdrukken maken via de Workfront API. Deze handeling accepteert de parameter advancedProofingOptions , die het waardetype string heeft. Als u geavanceerde proefdrukopties wilt opnemen in de createProof -actie, moet u de opties in de advancedProofingOptions -parameter invoeren in JSON-indeling.

NOTE
Het kan moeilijk zijn om de gebieden te voorspellen om in uw advancedProofingOptions JSON te omvatten. U kunt de netwerkgegevens van uw organisatie willen onderzoeken terwijl het gebruiken van geavanceerd proef in Workfront, en uw JSON baseren op de gebieden en de waarden die algemeen door uw organisatie worden gebruikt.
Omdat deze velden moeilijk te voorspellen zijn, raden we u aan een proefdruk te maken met de Workfront API en deze vervolgens bij te werken met de ProofHQ-API. Voor meer informatie, zie een proef creëren gebruikend Workfront en ProofHQ APIs (Geadviseerd)in dit artikel

Voorbeeld

In dit voorbeeld worden velden en opmaak weergegeven die u kunt gebruiken bij het maken van uw JSON voor de parameter advancedProofingOptions . Uw advancedProofingOptions JSON-bestand kan meer of minder velden hebben dan hier wordt weergegeven.

Voorbeeld:

{
    "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
}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43