Add Or Update MARC Record

Start Add or Update MARC Record Process

POST /api/.../workflow

This method allows the caller to add or update MARC record for an existing bibliographic record.

This process suppresses some of the bibliographic record specific steps and related possible prompts or blocks of Update Bibliographic Record process. Suppressed steps:

  • ConfirmSave
  • ProcessDisplayInPAC
  • ValidateHeaderFields
  • CheckResourceEntitiesRequiredFields
  • CheckForDuplicateBibs
  • RemoveLinkedItemOTFBlock

    • See Possible Steps and Related Prompts or Blocks for the full list.

    Request Information

    Name Type Required Description
    WorkflowRequest DtoWorkflowRequest Yes Define this parameter in the request body.
    DtoWorkflowRequest
    Property Type Nullable Description
    WorkflowRequestType Int No Required. For update MARC record of a bib record, this must be set to 36 (SaveMarcCompareRecord).
    TxnBranchID Int No Transacting branch ID.
    TxnUserID Int No Transacting Polaris user ID.
    TxnWorkstationID Int No Transacting workstation ID.
    RequestExtension DtoWorkflowRequestExtension No An update MARC record of a bib record request requires a DtoMarcRecord object.
    WorkflowReplies List of DtoWorkflowReply Yes It is possible to pass in a list of replies for automated processing.
    DtoWorkflowRequestExtension
    Property Type Nullable Description
    WorkflowRequestExtensionType Int No The extension type must be a 12 (AddOrUpdateBibRecordData) for an update a bib record request
    Data Object No This must be an extension data object of type DtoMarcRecord

    See MARC Record for DtoMarcRecord detail.

    Example

    Request body
    application/json, text/json 
        {
        "WorkflowRequestType": 36,
        "TxnBranchID": "90",
        "TxnUserID": "1018",
        "TxnWorkstationID": "1164",
        "WorkflowReplies": null,
        "RequestExtension": {
            "WorkflowRequestExtensionType": 12,
            "Data": {
                "BibliographicRecordId": "1400752",
                "Record": {
                    "leader": "     cam 222     i 44500",
                    "controlfields": [
                        {
                            "tag": "001",
                            "data": "1400752",
                            "position": 1,
                            "type": "CF"
                        },
                    ],
                    "datafields": [
                        {
                            "tag": "010",
                            "ind1": " ",
                            "ind2": " ",
                            "subfields": [
                                {
                                    "code": "a",
                                    "data": "2019018578"
                                }
                            ],
                            "position": 5,
                            "type": "DF"
                        },
                    ]
                }
            }
        }
    }
    Response Information
    <== Answer from server - If MARC validation errors were found
    Server would like caller to prompt for more input. Display information is provided. 
                {
                "WorkflowRequestGuid": "34ad1205-d622-44fb-ad1c-fd6245298b1a",
                "WorkflowRequestType": 36,
                "WorkflowStatus": -3,
                "Prompt": {
                    "WorkflowPromptID": 86,
                    "Name": null,
                    "Description": null,
                    "WorkflowPromptType": 25,
                    "WorkflowPromptOptions": 6,
                    "DefaultPromptOption": 0,
                    "Title": "MARC Validation Results",
                    "Message": "The following validation errors were found. To ignore these errors, click continue.",
                    "AlternateMessage": "",
                    "AlternateYesText": "",
                    "AlternateNoText": "",
                    "AlternateCancelText": "",
                    "AlternateContinueText": "",
                    "PromptExtension": {
                        "WorkflowPromptExtensionType": 29,
                        "Data": {
                            "ValidationProcessingStep": 1,
                            "Errors": [
                                {
                                    "ErrorText": "Tag LDR position 9 value 2 is invalid",
                                    "ErrorType": 7,
                                    "ObjectType": 0,
                                    "ObjectID": 0
                                },
                                {
                                    "ErrorText": "Tag 900 is not defined",
                                    "ErrorType": 7,
                                    "ObjectType": 0,
                                    "ObjectID": 0
                                }
                            ],
                            "CanSave": true
                        }
                    }
                },
                "InformationMessages": [],
                "AnswerExtension": null,
                "CircTranType": 0,
                "ReceiptType": 0,
                "ReceiptUrl": "",
                "FineEReceiptSent": false,
                "ErrorCode": null
            }
    ==> Caller sends a reply to the server indicating they want to continue (PromptResult=5).
    PUT /api/.../workflow/34ad1205-d622-44fb-ad1c-fd6245298b1a 
                    {
                  "WorkflowPromptID": 86,
                  "WorkflowPromptResult": 5,
                  "ReplyValue": null,
                  "ReplyExtension": null
                }
    Example: DtoWorkflowAnswer - The bibliographic record has been updated.
    application/json, text/json 
                {
                "WorkflowRequestGuid": "34ad1205-d622-44fb-ad1c-fd6245298b1a",
                "WorkflowRequestType": 36,
                "WorkflowStatus": 1,
                "Prompt": null,
                "InformationMessages": [
                    {
                        "Type": 1,
                        "Title": "",
                        "Message": "The bibliographic record has been updated."
                    }
                ],
                "AnswerExtension": null,
                "CircTranType": 0,
                "ReceiptType": 0,
                "ReceiptUrl": "",
                "FineEReceiptSent": false,
                "ErrorCode": null
            }

    HTTP Response Codes

    Code Description
    200 OK. Success

    Required Permissions

    Permission IDs found here.

        AccessCatalogingSubsystem_Allow
    BibliographicRecords_Access
    BibliographicRecords_Modify